@xzzpig/pi-subagents 0.22.0 → 0.24.0

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 (1133) hide show
  1. package/CHANGELOG.md +346 -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-3G4JXNZ4.js +4130 -0
  14. package/bundle/chunk-3U633XDZ.js +749 -0
  15. package/bundle/chunk-4QFZZV3O.js +57 -0
  16. package/bundle/chunk-62OCY2S4.js +14 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-7K3Z6DM7.js +276 -0
  19. package/bundle/chunk-BGIYHF2W.js +138 -0
  20. package/bundle/chunk-CTPAE36Y.js +94 -0
  21. package/bundle/chunk-D4EHT5SJ.js +14 -0
  22. package/bundle/chunk-ED55MIC2.js +1681 -0
  23. package/bundle/chunk-F3NSN7UH.js +7331 -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-KD2IMFN4.js +1310 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LPVUHUZ7.js +5503 -0
  30. package/bundle/chunk-MYCL5QEJ.js +1372 -0
  31. package/bundle/chunk-NCWCVJLT.js +1768 -0
  32. package/bundle/chunk-NIXWDZZV.js +9 -0
  33. package/bundle/chunk-NTRJDXBC.js +4175 -0
  34. package/bundle/chunk-OFGSZBHP.js +16924 -0
  35. package/bundle/chunk-OTLRAB22.js +143 -0
  36. package/bundle/chunk-QXASAHIA.js +173 -0
  37. package/bundle/chunk-RB4GELQA.js +458 -0
  38. package/bundle/chunk-RK2HDPLK.js +1234 -0
  39. package/bundle/chunk-SW2VMNIU.js +526 -0
  40. package/bundle/chunk-T65XRVVM.js +940 -0
  41. package/bundle/chunk-U4ODUYAG.js +235 -0
  42. package/bundle/chunk-UFNSLL5D.js +9796 -0
  43. package/bundle/chunk-UKG4V45O.js +228 -0
  44. package/bundle/chunk-UQDHXMUG.js +264 -0
  45. package/bundle/chunk-V2KFIGFH.js +8774 -0
  46. package/bundle/chunk-VO3G7HI3.js +85 -0
  47. package/bundle/chunk-WPW4V6HM.js +227 -0
  48. package/bundle/chunk-WW76JRIX.js +175 -0
  49. package/bundle/chunk-XA3DY6UG.js +161 -0
  50. package/bundle/chunk-YFCK7H2S.js +129 -0
  51. package/bundle/chunk-YYREO77V.js +137 -0
  52. package/bundle/chunk-Z6TFJ6BR.js +400 -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/missions.md +2 -0
  70. package/docs/observability.md +20 -5
  71. package/docs/standalone-background.md +8 -6
  72. package/docs/tool-reference.md +18 -5
  73. package/docs/workflows.md +25 -7
  74. package/index.d.ts +3 -0
  75. package/index.js +14 -0
  76. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  77. package/package.json +107 -87
  78. package/skills/council-mode/SKILL.md +1 -4
  79. package/skills/pi-subagents/SKILL.md +130 -106
  80. package/skills/pi-subagents/references/orchestration.md +124 -0
  81. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  82. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  83. package/src/agents/advertised-agent-prompt.js +68 -0
  84. package/src/agents/agent-eject.d.ts +39 -0
  85. package/src/agents/agent-eject.js +263 -0
  86. package/src/agents/agent-management.d.ts +33 -0
  87. package/src/agents/agent-management.js +1541 -0
  88. package/src/agents/agent-memory.d.ts +48 -0
  89. package/src/agents/agent-memory.js +350 -0
  90. package/src/agents/agent-refinements.d.ts +99 -0
  91. package/src/agents/agent-refinements.js +568 -0
  92. package/src/agents/agent-scope.d.ts +3 -0
  93. package/src/agents/agent-scope.js +8 -0
  94. package/src/agents/agent-selection.d.ts +2 -0
  95. package/src/agents/agent-selection.js +22 -0
  96. package/src/agents/agent-serializer.d.ts +7 -0
  97. package/src/agents/agent-serializer.js +213 -0
  98. package/src/agents/agents.d.ts +352 -0
  99. package/src/agents/agents.js +2817 -0
  100. package/src/agents/builtin-names.d.ts +1 -0
  101. package/src/agents/builtin-names.js +16 -0
  102. package/src/agents/chain-serializer.d.ts +6 -0
  103. package/src/agents/chain-serializer.js +318 -0
  104. package/src/agents/frontmatter.d.ts +19 -0
  105. package/src/agents/frontmatter.js +166 -0
  106. package/src/agents/global-npm-root.d.ts +6 -0
  107. package/src/agents/global-npm-root.js +57 -0
  108. package/src/agents/identity.d.ts +7 -0
  109. package/src/agents/identity.js +29 -0
  110. package/src/agents/proactive-skills.d.ts +35 -0
  111. package/src/agents/proactive-skills.js +155 -0
  112. package/src/agents/runtime-agent-events.d.ts +26 -0
  113. package/src/agents/runtime-agent-events.js +52 -0
  114. package/src/agents/runtime-agent-registry.d.ts +66 -0
  115. package/src/agents/runtime-agent-registry.js +415 -0
  116. package/src/agents/runtime-discovery.d.ts +13 -0
  117. package/src/agents/runtime-discovery.js +27 -0
  118. package/src/agents/skills.d.ts +34 -0
  119. package/src/agents/skills.js +718 -0
  120. package/src/api/agent-management.d.ts +2 -0
  121. package/src/api/agent-management.js +2 -0
  122. package/src/api/agents.d.ts +6 -0
  123. package/src/api/agents.js +3 -0
  124. package/src/api/background-work.d.ts +41 -0
  125. package/src/api/background-work.js +171 -0
  126. package/src/api/capability-ceiling.d.ts +1 -0
  127. package/src/api/capability-ceiling.js +1 -0
  128. package/src/api/child-tool-plan.d.ts +1 -0
  129. package/src/api/child-tool-plan.js +1 -0
  130. package/src/api/control-channel.d.ts +1 -0
  131. package/src/api/control-channel.js +1 -0
  132. package/src/api/delegation.d.ts +132 -0
  133. package/src/api/delegation.js +8 -0
  134. package/src/api/external-job-provider.d.ts +57 -0
  135. package/src/api/external-job-provider.js +139 -0
  136. package/src/api/external-runs.d.ts +47 -0
  137. package/src/api/external-runs.js +245 -0
  138. package/src/api/inspectors.d.ts +20 -0
  139. package/src/api/inspectors.js +11 -0
  140. package/src/api/intercom-bridge.d.ts +1 -0
  141. package/src/api/intercom-bridge.js +1 -0
  142. package/src/api/preflight.d.ts +183 -0
  143. package/src/api/preflight.js +455 -0
  144. package/src/api/project-panes.d.ts +7 -0
  145. package/src/api/project-panes.js +7 -0
  146. package/src/api/required-child-extensions.d.ts +1 -0
  147. package/src/api/required-child-extensions.js +1 -0
  148. package/src/api/shared-types.d.ts +1 -0
  149. package/src/api/shared-types.js +1 -0
  150. package/src/api/supervisor-routing.d.ts +110 -0
  151. package/src/api/supervisor-routing.js +95 -0
  152. package/src/api/workflow-resources.d.ts +2 -0
  153. package/src/api/workflow-resources.js +1 -0
  154. package/src/extension/active-runs-prompt.d.ts +7 -0
  155. package/src/extension/active-runs-prompt.js +29 -0
  156. package/src/extension/config.d.ts +7 -0
  157. package/src/extension/config.js +290 -0
  158. package/src/extension/context-injection.d.ts +52 -0
  159. package/src/extension/context-injection.js +102 -0
  160. package/src/extension/control-notices.d.ts +18 -0
  161. package/src/extension/control-notices.js +29 -0
  162. package/src/extension/declaration-pinning.d.ts +18 -0
  163. package/src/extension/declaration-pinning.js +167 -0
  164. package/src/extension/doctor.d.ts +34 -0
  165. package/src/extension/doctor.js +236 -0
  166. package/src/extension/fanout-child.d.ts +6 -0
  167. package/src/extension/fanout-child.js +278 -0
  168. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  169. package/src/extension/herdr-pi-bridge.js +261 -0
  170. package/src/extension/index.d.ts +18 -0
  171. package/src/extension/index.js +1288 -0
  172. package/src/extension/public-execution.d.ts +71 -0
  173. package/src/extension/public-execution.js +214 -0
  174. package/src/extension/reply-workflow-script.d.ts +11 -0
  175. package/src/extension/reply-workflow-script.js +71 -0
  176. package/src/extension/rpc.d.ts +84 -0
  177. package/src/extension/rpc.js +729 -0
  178. package/src/extension/schemas.d.ts +276 -0
  179. package/src/extension/schemas.js +311 -0
  180. package/src/extension/steering-notices.d.ts +14 -0
  181. package/src/extension/steering-notices.js +22 -0
  182. package/src/extension/subagent-guide.d.ts +4 -0
  183. package/src/extension/subagent-guide.js +114 -0
  184. package/src/extension/subagent-options.d.ts +7 -0
  185. package/src/extension/subagent-options.js +64 -0
  186. package/src/extension/tool-activation.d.ts +7 -0
  187. package/src/extension/tool-activation.js +185 -0
  188. package/src/extension/tool-description.d.ts +19 -0
  189. package/src/extension/tool-description.js +169 -0
  190. package/src/extension/tool-result.d.ts +9 -0
  191. package/src/extension/tool-result.js +16 -0
  192. package/src/extension/upgrade-notice.d.ts +6 -0
  193. package/src/extension/upgrade-notice.js +42 -0
  194. package/src/inspectors/actions.d.ts +24 -0
  195. package/src/inspectors/actions.js +182 -0
  196. package/src/inspectors/ghostty/actions.d.ts +11 -0
  197. package/src/inspectors/ghostty/actions.js +62 -0
  198. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  199. package/src/inspectors/ghostty/plugin.js +23 -0
  200. package/src/inspectors/herdr/actions.d.ts +25 -0
  201. package/src/inspectors/herdr/actions.js +133 -0
  202. package/src/inspectors/herdr/client.d.ts +41 -0
  203. package/src/inspectors/herdr/client.js +129 -0
  204. package/src/inspectors/herdr/focus.d.ts +24 -0
  205. package/src/inspectors/herdr/focus.js +49 -0
  206. package/src/inspectors/herdr/plugin.d.ts +6 -0
  207. package/src/inspectors/herdr/plugin.js +14 -0
  208. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  209. package/src/inspectors/herdr/project-panes.js +610 -0
  210. package/src/inspectors/inspector-runner.d.ts +23 -0
  211. package/src/inspectors/inspector-runner.js +161 -0
  212. package/src/inspectors/plugins.d.ts +8 -0
  213. package/src/inspectors/plugins.js +82 -0
  214. package/src/inspectors/session-roots-codec.d.ts +15 -0
  215. package/src/inspectors/session-roots-codec.js +32 -0
  216. package/src/inspectors/shell-command.d.ts +1 -0
  217. package/src/inspectors/shell-command.js +16 -0
  218. package/src/inspectors/tmux/actions.d.ts +25 -0
  219. package/src/inspectors/tmux/actions.js +181 -0
  220. package/src/inspectors/tmux/client.d.ts +27 -0
  221. package/src/inspectors/tmux/client.js +64 -0
  222. package/src/inspectors/tmux/plugin.d.ts +7 -0
  223. package/src/inspectors/tmux/plugin.js +14 -0
  224. package/src/inspectors/types.d.ts +48 -0
  225. package/src/inspectors/types.js +1 -0
  226. package/src/integrations/herdr-status.d.ts +47 -0
  227. package/src/integrations/herdr-status.js +350 -0
  228. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  229. package/src/integrations/pi-web-session-liveness.js +53 -0
  230. package/src/integrations/program-status.d.ts +30 -0
  231. package/src/integrations/program-status.js +188 -0
  232. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  233. package/src/intercom/fork-supervisor-routing.js +392 -0
  234. package/src/intercom/intercom-bridge.d.ts +58 -0
  235. package/src/intercom/intercom-bridge.js +193 -0
  236. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  237. package/src/intercom/native-supervisor-channel.js +1184 -0
  238. package/src/intercom/result-intercom.d.ts +35 -0
  239. package/src/intercom/result-intercom.js +376 -0
  240. package/src/intercom/supervisor-ui.d.ts +29 -0
  241. package/src/intercom/supervisor-ui.js +49 -0
  242. package/src/missions/actions.d.ts +54 -0
  243. package/src/missions/actions.js +400 -0
  244. package/src/missions/goal-driver.d.ts +16 -0
  245. package/src/missions/goal-driver.js +171 -0
  246. package/src/missions/lifecycle.d.ts +50 -0
  247. package/src/missions/lifecycle.js +388 -0
  248. package/src/missions/store.d.ts +21 -0
  249. package/src/missions/store.js +605 -0
  250. package/src/missions/types.d.ts +169 -0
  251. package/src/missions/types.js +9 -0
  252. package/src/missions/workflow-state.d.ts +14 -0
  253. package/src/missions/workflow-state.js +273 -0
  254. package/src/policy/authority.d.ts +9 -0
  255. package/src/policy/authority.js +41 -0
  256. package/src/profiles/profiles.d.ts +134 -0
  257. package/src/profiles/profiles.js +526 -0
  258. package/src/runs/background/active-async-capacity.d.ts +115 -0
  259. package/src/runs/background/active-async-capacity.js +517 -0
  260. package/src/runs/background/active-run-index.d.ts +12 -0
  261. package/src/runs/background/active-run-index.js +157 -0
  262. package/src/runs/background/async-execution.d.ts +304 -0
  263. package/src/runs/background/async-execution.js +2206 -0
  264. package/src/runs/background/async-job-tracker.d.ts +37 -0
  265. package/src/runs/background/async-job-tracker.js +921 -0
  266. package/src/runs/background/async-resume.d.ts +60 -0
  267. package/src/runs/background/async-resume.js +707 -0
  268. package/src/runs/background/async-retention.d.ts +45 -0
  269. package/src/runs/background/async-retention.js +932 -0
  270. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  271. package/src/runs/background/async-status-snapshot.js +26 -0
  272. package/src/runs/background/async-status.d.ts +177 -0
  273. package/src/runs/background/async-status.js +710 -0
  274. package/src/runs/background/auto-drain.d.ts +16 -0
  275. package/src/runs/background/auto-drain.js +71 -0
  276. package/src/runs/background/await-async-run.d.ts +26 -0
  277. package/src/runs/background/await-async-run.js +83 -0
  278. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  279. package/src/runs/background/binary-bootstrap.js +69 -0
  280. package/src/runs/background/boot-id.d.ts +12 -0
  281. package/src/runs/background/boot-id.js +47 -0
  282. package/src/runs/background/calendar-schedule.d.ts +26 -0
  283. package/src/runs/background/calendar-schedule.js +93 -0
  284. package/src/runs/background/chain-append.d.ts +34 -0
  285. package/src/runs/background/chain-append.js +299 -0
  286. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  287. package/src/runs/background/chain-root-attachment.js +186 -0
  288. package/src/runs/background/completion-batcher.d.ts +51 -0
  289. package/src/runs/background/completion-batcher.js +119 -0
  290. package/src/runs/background/completion-dedupe.d.ts +13 -0
  291. package/src/runs/background/completion-dedupe.js +48 -0
  292. package/src/runs/background/completion-replay.d.ts +47 -0
  293. package/src/runs/background/completion-replay.js +266 -0
  294. package/src/runs/background/control-channel.d.ts +170 -0
  295. package/src/runs/background/control-channel.js +610 -0
  296. package/src/runs/background/fleet-view.d.ts +63 -0
  297. package/src/runs/background/fleet-view.js +666 -0
  298. package/src/runs/background/index-segment.d.ts +16 -0
  299. package/src/runs/background/index-segment.js +58 -0
  300. package/src/runs/background/inspect-rpc.d.ts +64 -0
  301. package/src/runs/background/inspect-rpc.js +422 -0
  302. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  303. package/src/runs/background/interrupted-elsewhere.js +68 -0
  304. package/src/runs/background/notify.d.ts +214 -0
  305. package/src/runs/background/notify.js +1001 -0
  306. package/src/runs/background/owned-process-tree.d.ts +10 -0
  307. package/src/runs/background/owned-process-tree.js +116 -0
  308. package/src/runs/background/parallel-groups.d.ts +3 -0
  309. package/src/runs/background/parallel-groups.js +46 -0
  310. package/src/runs/background/pid-namespace.d.ts +2 -0
  311. package/src/runs/background/pid-namespace.js +19 -0
  312. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  313. package/src/runs/background/process-terminal-candidate.js +96 -0
  314. package/src/runs/background/process-terminal.d.ts +21 -0
  315. package/src/runs/background/process-terminal.js +227 -0
  316. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  317. package/src/runs/background/result-delivery-ownership.js +38 -0
  318. package/src/runs/background/result-files.d.ts +63 -0
  319. package/src/runs/background/result-files.js +629 -0
  320. package/src/runs/background/result-watcher.d.ts +92 -0
  321. package/src/runs/background/result-watcher.js +819 -0
  322. package/src/runs/background/resume-guidance.d.ts +4 -0
  323. package/src/runs/background/resume-guidance.js +57 -0
  324. package/src/runs/background/retained-children.d.ts +24 -0
  325. package/src/runs/background/retained-children.js +128 -0
  326. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  327. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  328. package/src/runs/background/run-child-session.d.ts +123 -0
  329. package/src/runs/background/run-child-session.js +670 -0
  330. package/src/runs/background/run-id-query.d.ts +3 -0
  331. package/src/runs/background/run-id-query.js +6 -0
  332. package/src/runs/background/run-id-resolver.d.ts +22 -0
  333. package/src/runs/background/run-id-resolver.js +172 -0
  334. package/src/runs/background/run-status.d.ts +25 -0
  335. package/src/runs/background/run-status.js +850 -0
  336. package/src/runs/background/runner-aliases.d.ts +17 -0
  337. package/src/runs/background/runner-aliases.js +191 -0
  338. package/src/runs/background/runner-child-launch.d.ts +24 -0
  339. package/src/runs/background/runner-child-launch.js +72 -0
  340. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  341. package/src/runs/background/runner-child-sessions.js +34 -0
  342. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  343. package/src/runs/background/runner-http-dispatcher.js +115 -0
  344. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  345. package/src/runs/background/runner-startup-failure.js +46 -0
  346. package/src/runs/background/scheduled-runs.d.ts +127 -0
  347. package/src/runs/background/scheduled-runs.js +1265 -0
  348. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  349. package/src/runs/background/stale-run-reconciler.js +509 -0
  350. package/src/runs/background/steering.d.ts +51 -0
  351. package/src/runs/background/steering.js +246 -0
  352. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  353. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  354. package/src/runs/background/subagent-runner.d.ts +210 -0
  355. package/src/runs/background/subagent-runner.js +4963 -0
  356. package/src/runs/background/subagent-wait.d.ts +124 -0
  357. package/src/runs/background/subagent-wait.js +756 -0
  358. package/src/runs/background/terminal-run-index.d.ts +10 -0
  359. package/src/runs/background/terminal-run-index.js +209 -0
  360. package/src/runs/background/top-level-async.d.ts +7 -0
  361. package/src/runs/background/top-level-async.js +5 -0
  362. package/src/runs/background/wait-completions.d.ts +28 -0
  363. package/src/runs/background/wait-completions.js +264 -0
  364. package/src/runs/background/wait-config.d.ts +8 -0
  365. package/src/runs/background/wait-config.js +46 -0
  366. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  367. package/src/runs/background/wait-subscriptions.js +339 -0
  368. package/src/runs/background/wait-tool.d.ts +6 -0
  369. package/src/runs/background/wait-tool.js +48 -0
  370. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  371. package/src/runs/background/workflow-terminal-proof.js +116 -0
  372. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  373. package/src/runs/foreground/async-dismiss-action.js +82 -0
  374. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  375. package/src/runs/foreground/async-steering-action.js +294 -0
  376. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  377. package/src/runs/foreground/async-stop-action.js +213 -0
  378. package/src/runs/foreground/command-action.d.ts +12 -0
  379. package/src/runs/foreground/command-action.js +38 -0
  380. package/src/runs/foreground/execution.d.ts +10 -0
  381. package/src/runs/foreground/execution.js +2322 -0
  382. package/src/runs/foreground/foreground-control.d.ts +24 -0
  383. package/src/runs/foreground/foreground-control.js +138 -0
  384. package/src/runs/foreground/foreground-history.d.ts +25 -0
  385. package/src/runs/foreground/foreground-history.js +267 -0
  386. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  387. package/src/runs/foreground/prompt-audit.js +138 -0
  388. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  389. package/src/runs/foreground/subagent-executor.js +7986 -0
  390. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  391. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  392. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  393. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  394. package/src/runs/shared/abort-recovery.d.ts +26 -0
  395. package/src/runs/shared/abort-recovery.js +108 -0
  396. package/src/runs/shared/acceptance.d.ts +144 -0
  397. package/src/runs/shared/acceptance.js +1616 -0
  398. package/src/runs/shared/agent-contract.d.ts +5 -0
  399. package/src/runs/shared/agent-contract.js +35 -0
  400. package/src/runs/shared/async-status-projection.d.ts +100 -0
  401. package/src/runs/shared/async-status-projection.js +566 -0
  402. package/src/runs/shared/background-process-options.d.ts +4 -0
  403. package/src/runs/shared/background-process-options.js +6 -0
  404. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  405. package/src/runs/shared/capability-ceiling.js +179 -0
  406. package/src/runs/shared/chain-outputs.d.ts +18 -0
  407. package/src/runs/shared/chain-outputs.js +104 -0
  408. package/src/runs/shared/child-commands.d.ts +29 -0
  409. package/src/runs/shared/child-commands.js +254 -0
  410. package/src/runs/shared/child-hooks.d.ts +31 -0
  411. package/src/runs/shared/child-hooks.js +173 -0
  412. package/src/runs/shared/child-identity.d.ts +23 -0
  413. package/src/runs/shared/child-identity.js +40 -0
  414. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  415. package/src/runs/shared/child-launch-plan.js +88 -0
  416. package/src/runs/shared/child-launch.d.ts +128 -0
  417. package/src/runs/shared/child-launch.js +262 -0
  418. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  419. package/src/runs/shared/child-lifecycle.js +22 -0
  420. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  421. package/src/runs/shared/child-runtime-config.js +44 -0
  422. package/src/runs/shared/child-session.d.ts +178 -0
  423. package/src/runs/shared/child-session.js +726 -0
  424. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  425. package/src/runs/shared/child-tool-plan.js +430 -0
  426. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  427. package/src/runs/shared/claude-code-adapter.js +255 -0
  428. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  429. package/src/runs/shared/codex-exec-adapter.js +127 -0
  430. package/src/runs/shared/context-mode.d.ts +12 -0
  431. package/src/runs/shared/context-mode.js +38 -0
  432. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  433. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  434. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  435. package/src/runs/shared/dynamic-fanout.js +273 -0
  436. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  437. package/src/runs/shared/effective-system-prompt.js +23 -0
  438. package/src/runs/shared/extension-bindings.d.ts +25 -0
  439. package/src/runs/shared/extension-bindings.js +96 -0
  440. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  441. package/src/runs/shared/external-cli-contract.js +145 -0
  442. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  443. package/src/runs/shared/external-cli-preflight.js +159 -0
  444. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  445. package/src/runs/shared/external-cli-runner.js +425 -0
  446. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  447. package/src/runs/shared/external-job-bridge.js +486 -0
  448. package/src/runs/shared/external-job-runner.d.ts +44 -0
  449. package/src/runs/shared/external-job-runner.js +352 -0
  450. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  451. package/src/runs/shared/fast-mode-extension.js +8 -0
  452. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  453. package/src/runs/shared/fork-placed-env.js +13 -0
  454. package/src/runs/shared/git-environment.d.ts +2 -0
  455. package/src/runs/shared/git-environment.js +27 -0
  456. package/src/runs/shared/herdr-connection.d.ts +79 -0
  457. package/src/runs/shared/herdr-connection.js +269 -0
  458. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  459. package/src/runs/shared/herdr-external-adapters.js +404 -0
  460. package/src/runs/shared/herdr-machine.d.ts +59 -0
  461. package/src/runs/shared/herdr-machine.js +294 -0
  462. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  463. package/src/runs/shared/herdr-pane-host.js +155 -0
  464. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  465. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  466. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  467. package/src/runs/shared/herdr-placed-run.js +380 -0
  468. package/src/runs/shared/host-step-status.d.ts +33 -0
  469. package/src/runs/shared/host-step-status.js +244 -0
  470. package/src/runs/shared/lane-metadata.d.ts +23 -0
  471. package/src/runs/shared/lane-metadata.js +126 -0
  472. package/src/runs/shared/launch-cwd.d.ts +1 -0
  473. package/src/runs/shared/launch-cwd.js +16 -0
  474. package/src/runs/shared/local-machine-access.d.ts +5 -0
  475. package/src/runs/shared/local-machine-access.js +28 -0
  476. package/src/runs/shared/long-running-guard.d.ts +34 -0
  477. package/src/runs/shared/long-running-guard.js +256 -0
  478. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  479. package/src/runs/shared/mcp-config-sources.js +418 -0
  480. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  481. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  482. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  483. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  484. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  485. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  486. package/src/runs/shared/model-resolution.d.ts +109 -0
  487. package/src/runs/shared/model-resolution.js +411 -0
  488. package/src/runs/shared/model-scope.d.ts +68 -0
  489. package/src/runs/shared/model-scope.js +171 -0
  490. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  491. package/src/runs/shared/mutation-evidence.js +198 -0
  492. package/src/runs/shared/nested-events.d.ts +135 -0
  493. package/src/runs/shared/nested-events.js +1090 -0
  494. package/src/runs/shared/nested-path.d.ts +8 -0
  495. package/src/runs/shared/nested-path.js +34 -0
  496. package/src/runs/shared/nested-render.d.ts +20 -0
  497. package/src/runs/shared/nested-render.js +115 -0
  498. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  499. package/src/runs/shared/orca-progress-tabs.js +503 -0
  500. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  501. package/src/runs/shared/parallel-handoff.js +783 -0
  502. package/src/runs/shared/parallel-utils.d.ts +177 -0
  503. package/src/runs/shared/parallel-utils.js +125 -0
  504. package/src/runs/shared/partial-output.d.ts +24 -0
  505. package/src/runs/shared/partial-output.js +35 -0
  506. package/src/runs/shared/permissions.d.ts +12 -0
  507. package/src/runs/shared/permissions.js +92 -0
  508. package/src/runs/shared/pi-spawn.d.ts +31 -0
  509. package/src/runs/shared/pi-spawn.js +211 -0
  510. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  511. package/src/runs/shared/placed-run-owner.js +93 -0
  512. package/src/runs/shared/placement-host.d.ts +99 -0
  513. package/src/runs/shared/placement-host.js +157 -0
  514. package/src/runs/shared/process-signal.d.ts +15 -0
  515. package/src/runs/shared/process-signal.js +21 -0
  516. package/src/runs/shared/profile-extensions.d.ts +21 -0
  517. package/src/runs/shared/profile-extensions.js +122 -0
  518. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  519. package/src/runs/shared/profile-launch-env.js +90 -0
  520. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  521. package/src/runs/shared/readonly-drain-observation.js +50 -0
  522. package/src/runs/shared/rex-machine.d.ts +25 -0
  523. package/src/runs/shared/rex-machine.js +83 -0
  524. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  525. package/src/runs/shared/rex-pane-host.js +327 -0
  526. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  527. package/src/runs/shared/run-fanout-budget.js +258 -0
  528. package/src/runs/shared/run-ownership.d.ts +3 -0
  529. package/src/runs/shared/run-ownership.js +8 -0
  530. package/src/runs/shared/runner-launcher.d.ts +11 -0
  531. package/src/runs/shared/runner-launcher.js +24 -0
  532. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  533. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  534. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  535. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  536. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  537. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  538. package/src/runs/shared/session-lease.d.ts +69 -0
  539. package/src/runs/shared/session-lease.js +250 -0
  540. package/src/runs/shared/single-output.d.ts +90 -0
  541. package/src/runs/shared/single-output.js +349 -0
  542. package/src/runs/shared/spawn-budget.d.ts +20 -0
  543. package/src/runs/shared/spawn-budget.js +93 -0
  544. package/src/runs/shared/structured-output.d.ts +66 -0
  545. package/src/runs/shared/structured-output.js +483 -0
  546. package/src/runs/shared/subagent-control.d.ts +50 -0
  547. package/src/runs/shared/subagent-control.js +247 -0
  548. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  549. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  550. package/src/runs/shared/tool-availability.d.ts +16 -0
  551. package/src/runs/shared/tool-availability.js +29 -0
  552. package/src/runs/shared/tool-budget.d.ts +21 -0
  553. package/src/runs/shared/tool-budget.js +78 -0
  554. package/src/runs/shared/tool-timeout.d.ts +31 -0
  555. package/src/runs/shared/tool-timeout.js +73 -0
  556. package/src/runs/shared/usage-budget.d.ts +7 -0
  557. package/src/runs/shared/usage-budget.js +74 -0
  558. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  559. package/src/runs/shared/usage-reconciliation.js +71 -0
  560. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  561. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  562. package/src/runs/shared/workflow-graph.d.ts +31 -0
  563. package/src/runs/shared/workflow-graph.js +221 -0
  564. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  565. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  566. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  567. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  568. package/src/runs/shared/worktree-lock.d.ts +5 -0
  569. package/src/runs/shared/worktree-lock.js +40 -0
  570. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  571. package/src/runs/shared/worktree-setup-command.js +200 -0
  572. package/src/runs/shared/worktree.d.ts +181 -0
  573. package/src/runs/shared/worktree.js +1346 -0
  574. package/src/shared/accessible-dir.d.ts +11 -0
  575. package/src/shared/accessible-dir.js +39 -0
  576. package/src/shared/agent-stream-options.d.ts +5 -0
  577. package/src/shared/agent-stream-options.js +3 -0
  578. package/src/shared/artifacts.d.ts +22 -0
  579. package/src/shared/artifacts.js +272 -0
  580. package/src/shared/atomic-json.d.ts +19 -0
  581. package/src/shared/atomic-json.js +61 -0
  582. package/src/shared/capacity-resilient-json.d.ts +26 -0
  583. package/src/shared/capacity-resilient-json.js +86 -0
  584. package/src/shared/child-cache-retention.d.ts +29 -0
  585. package/src/shared/child-cache-retention.js +40 -0
  586. package/src/shared/child-session-name.d.ts +8 -0
  587. package/src/shared/child-session-name.js +40 -0
  588. package/src/shared/child-transcript.d.ts +37 -0
  589. package/src/shared/child-transcript.js +225 -0
  590. package/src/shared/completion-owner.d.ts +7 -0
  591. package/src/shared/completion-owner.js +13 -0
  592. package/src/shared/disabled-features.d.ts +93 -0
  593. package/src/shared/disabled-features.js +120 -0
  594. package/src/shared/display-text.d.ts +5 -0
  595. package/src/shared/display-text.js +154 -0
  596. package/src/shared/edit-distance.d.ts +4 -0
  597. package/src/shared/edit-distance.js +32 -0
  598. package/src/shared/extension-context.d.ts +21 -0
  599. package/src/shared/extension-context.js +39 -0
  600. package/src/shared/file-coalescer.d.ts +11 -0
  601. package/src/shared/file-coalescer.js +34 -0
  602. package/src/shared/file-lease.d.ts +10 -0
  603. package/src/shared/file-lease.js +106 -0
  604. package/src/shared/file-system-retry.d.ts +31 -0
  605. package/src/shared/file-system-retry.js +84 -0
  606. package/src/shared/fork-context.d.ts +64 -0
  607. package/src/shared/fork-context.js +185 -0
  608. package/src/shared/fork-session-cwd.d.ts +2 -0
  609. package/src/shared/fork-session-cwd.js +23 -0
  610. package/src/shared/formatters.d.ts +35 -0
  611. package/src/shared/formatters.js +137 -0
  612. package/src/shared/jsonl-writer.d.ts +20 -0
  613. package/src/shared/jsonl-writer.js +67 -0
  614. package/src/shared/launch-contract.d.ts +65 -0
  615. package/src/shared/launch-contract.js +145 -0
  616. package/src/shared/model-info.d.ts +55 -0
  617. package/src/shared/model-info.js +103 -0
  618. package/src/shared/model-response-aliases.d.ts +1 -0
  619. package/src/shared/model-response-aliases.js +15 -0
  620. package/src/shared/node-executable.d.ts +1 -0
  621. package/src/shared/node-executable.js +20 -0
  622. package/src/shared/opencode-session-headers.d.ts +12 -0
  623. package/src/shared/opencode-session-headers.js +26 -0
  624. package/src/shared/package-version.d.ts +2 -0
  625. package/src/shared/package-version.js +14 -0
  626. package/src/shared/parent-wake.d.ts +26 -0
  627. package/src/shared/parent-wake.js +68 -0
  628. package/src/shared/permission-profile.d.ts +26 -0
  629. package/src/shared/permission-profile.js +49 -0
  630. package/src/shared/prompt-resources.d.ts +5 -0
  631. package/src/shared/prompt-resources.js +10 -0
  632. package/src/shared/provider-diagnostics.d.ts +9 -0
  633. package/src/shared/provider-diagnostics.js +75 -0
  634. package/src/shared/pruned-fork.d.ts +34 -0
  635. package/src/shared/pruned-fork.js +434 -0
  636. package/src/shared/required-child-extensions.d.ts +34 -0
  637. package/src/shared/required-child-extensions.js +105 -0
  638. package/src/shared/runtime-module-path.d.ts +10 -0
  639. package/src/shared/runtime-module-path.js +16 -0
  640. package/src/shared/sandbox-profile.d.ts +12 -0
  641. package/src/shared/sandbox-profile.js +35 -0
  642. package/src/shared/session-file-trust.d.ts +1 -0
  643. package/src/shared/session-file-trust.js +20 -0
  644. package/src/shared/session-identity.d.ts +8 -0
  645. package/src/shared/session-identity.js +32 -0
  646. package/src/shared/session-succession.d.ts +4 -0
  647. package/src/shared/session-succession.js +24 -0
  648. package/src/shared/session-tokens.d.ts +2 -0
  649. package/src/shared/session-tokens.js +58 -0
  650. package/src/shared/settings-file-lease.d.ts +4 -0
  651. package/src/shared/settings-file-lease.js +38 -0
  652. package/src/shared/settings.d.ts +146 -0
  653. package/src/shared/settings.js +247 -0
  654. package/src/shared/shortcuts.d.ts +1 -0
  655. package/src/shared/shortcuts.js +17 -0
  656. package/src/shared/status-format.d.ts +9 -0
  657. package/src/shared/status-format.js +60 -0
  658. package/src/shared/thinking-ceiling.d.ts +13 -0
  659. package/src/shared/thinking-ceiling.js +37 -0
  660. package/src/shared/types.d.ts +2840 -0
  661. package/src/shared/types.js +276 -0
  662. package/src/shared/utf8.d.ts +5 -0
  663. package/src/shared/utf8.js +12 -0
  664. package/src/shared/utils.d.ts +83 -0
  665. package/src/shared/utils.js +612 -0
  666. package/src/shared/watch-strategy.d.ts +2 -0
  667. package/src/shared/watch-strategy.js +5 -0
  668. package/src/shared/workflow-child-permit.d.ts +58 -0
  669. package/src/shared/workflow-child-permit.js +159 -0
  670. package/src/slash/delegation-adapters.d.ts +154 -0
  671. package/src/slash/delegation-adapters.js +316 -0
  672. package/src/slash/delegation-json.d.ts +10 -0
  673. package/src/slash/delegation-json.js +117 -0
  674. package/src/slash/delegation-request.d.ts +12 -0
  675. package/src/slash/delegation-request.js +174 -0
  676. package/src/slash/prompt-template-bridge.d.ts +29 -0
  677. package/src/slash/prompt-template-bridge.js +399 -0
  678. package/src/slash/prompt-workflows.d.ts +21 -0
  679. package/src/slash/prompt-workflows.js +274 -0
  680. package/src/slash/selector.d.ts +47 -0
  681. package/src/slash/selector.js +117 -0
  682. package/src/slash/slash-bridge.d.ts +30 -0
  683. package/src/slash/slash-bridge.js +132 -0
  684. package/src/slash/slash-commands.d.ts +10 -0
  685. package/src/slash/slash-commands.js +1059 -0
  686. package/src/slash/slash-live-state.d.ts +21 -0
  687. package/src/slash/slash-live-state.js +263 -0
  688. package/src/slash/subagent-cost.d.ts +29 -0
  689. package/src/slash/subagent-cost.js +310 -0
  690. package/src/slash/subagents-admin.d.ts +3 -0
  691. package/src/slash/subagents-admin.js +481 -0
  692. package/src/tui/fleet-layout.d.ts +20 -0
  693. package/src/tui/fleet-layout.js +17 -0
  694. package/src/tui/fleet-native-transcript.d.ts +53 -0
  695. package/src/tui/fleet-native-transcript.js +339 -0
  696. package/src/tui/fleet-status.d.ts +92 -0
  697. package/src/tui/fleet-status.js +1132 -0
  698. package/src/tui/fleet-transcript.d.ts +64 -0
  699. package/src/tui/fleet-transcript.js +544 -0
  700. package/src/tui/fleet-viewport.d.ts +12 -0
  701. package/src/tui/fleet-viewport.js +35 -0
  702. package/src/tui/fleet.d.ts +196 -0
  703. package/src/tui/fleet.js +1588 -0
  704. package/src/tui/mouse-events.d.ts +21 -0
  705. package/src/tui/mouse-events.js +26 -0
  706. package/src/tui/render-helpers.d.ts +23 -0
  707. package/src/tui/render-helpers.js +100 -0
  708. package/src/tui/render.d.ts +66 -0
  709. package/src/tui/render.js +3707 -0
  710. package/src/tui/running-tone.d.ts +10 -0
  711. package/src/tui/running-tone.js +22 -0
  712. package/src/tui/subagent-messages.d.ts +22 -0
  713. package/src/tui/subagent-messages.js +270 -0
  714. package/src/ui-silent-marker.d.ts +20 -0
  715. package/src/ui-silent-marker.js +25 -0
  716. package/src/watchdog/change-signature.d.ts +7 -0
  717. package/src/watchdog/change-signature.js +243 -0
  718. package/src/watchdog/child-status.d.ts +53 -0
  719. package/src/watchdog/child-status.js +187 -0
  720. package/src/watchdog/diff-tool.d.ts +25 -0
  721. package/src/watchdog/diff-tool.js +104 -0
  722. package/src/watchdog/emission-guard.d.ts +36 -0
  723. package/src/watchdog/emission-guard.js +97 -0
  724. package/src/watchdog/guidance.d.ts +3 -0
  725. package/src/watchdog/guidance.js +19 -0
  726. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  727. package/src/watchdog/lsp-diagnostics.js +489 -0
  728. package/src/watchdog/model-selection.d.ts +24 -0
  729. package/src/watchdog/model-selection.js +167 -0
  730. package/src/watchdog/permission-arbiter.d.ts +20 -0
  731. package/src/watchdog/permission-arbiter.js +135 -0
  732. package/src/watchdog/register-child.d.ts +13 -0
  733. package/src/watchdog/register-child.js +128 -0
  734. package/src/watchdog/register-main.d.ts +11 -0
  735. package/src/watchdog/register-main.js +400 -0
  736. package/src/watchdog/render.d.ts +3 -0
  737. package/src/watchdog/render.js +33 -0
  738. package/src/watchdog/review.d.ts +36 -0
  739. package/src/watchdog/review.js +319 -0
  740. package/src/watchdog/rules.d.ts +21 -0
  741. package/src/watchdog/rules.js +58 -0
  742. package/src/watchdog/runtime.d.ts +195 -0
  743. package/src/watchdog/runtime.js +864 -0
  744. package/src/watchdog/scope.d.ts +14 -0
  745. package/src/watchdog/scope.js +44 -0
  746. package/src/watchdog/settings.d.ts +29 -0
  747. package/src/watchdog/settings.js +480 -0
  748. package/src/watchdog/tool-actions.d.ts +17 -0
  749. package/src/watchdog/tool-actions.js +150 -0
  750. package/src/watchdog/turn-delta.d.ts +15 -0
  751. package/src/watchdog/turn-delta.js +188 -0
  752. package/src/watchdog/types.d.ts +141 -0
  753. package/src/watchdog/types.js +27 -0
  754. package/src/watchdog/warning-format.d.ts +7 -0
  755. package/src/watchdog/warning-format.js +59 -0
  756. package/src/workflows/chat-progress.d.ts +37 -0
  757. package/src/workflows/chat-progress.js +129 -0
  758. package/src/workflows/host-command.d.ts +30 -0
  759. package/src/workflows/host-command.js +227 -0
  760. package/src/workflows/scripted-workflow.d.ts +204 -0
  761. package/src/workflows/scripted-workflow.js +1673 -0
  762. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  763. package/src/workflows/structured-workflow-scripts.js +179 -0
  764. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  765. package/src/workflows/workflow-auto-resume.js +102 -0
  766. package/src/workflows/workflow-checklist.d.ts +127 -0
  767. package/src/workflows/workflow-checklist.js +314 -0
  768. package/src/workflows/workflow-child-summary.d.ts +24 -0
  769. package/src/workflows/workflow-child-summary.js +195 -0
  770. package/src/workflows/workflow-launch-record.d.ts +27 -0
  771. package/src/workflows/workflow-launch-record.js +48 -0
  772. package/src/workflows/workflow-preflight.d.ts +58 -0
  773. package/src/workflows/workflow-preflight.js +288 -0
  774. package/src/workflows/workflow-receipt.d.ts +34 -0
  775. package/src/workflows/workflow-receipt.js +454 -0
  776. package/src/workflows/workflow-resources.d.ts +55 -0
  777. package/src/workflows/workflow-resources.js +271 -0
  778. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  779. package/src/workflows/workflow-resume-claim.js +210 -0
  780. package/src/workflows/workflow-resume.d.ts +56 -0
  781. package/src/workflows/workflow-resume.js +106 -0
  782. package/src/workflows/workflow-reuse.d.ts +61 -0
  783. package/src/workflows/workflow-reuse.js +186 -0
  784. package/src/workflows/workflow-revival.d.ts +33 -0
  785. package/src/workflows/workflow-revival.js +111 -0
  786. package/src/workflows/workflow-settlement.d.ts +84 -0
  787. package/src/workflows/workflow-settlement.js +203 -0
  788. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  789. package/src/workflows/workflow-stop-cause.js +8 -0
  790. package/workflow-script-worker.cjs +1342 -0
  791. package/index.ts +0 -18
  792. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  793. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  794. package/skills/pi-subagents/references/execution-controls.md +0 -561
  795. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  796. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  797. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  798. package/src/agents/advertised-agent-prompt.ts +0 -82
  799. package/src/agents/agent-eject.ts +0 -339
  800. package/src/agents/agent-management.ts +0 -1442
  801. package/src/agents/agent-memory.ts +0 -341
  802. package/src/agents/agent-refinements.ts +0 -624
  803. package/src/agents/agent-scope.ts +0 -10
  804. package/src/agents/agent-selection.ts +0 -25
  805. package/src/agents/agent-serializer.ts +0 -195
  806. package/src/agents/agents.ts +0 -3169
  807. package/src/agents/builtin-names.ts +0 -16
  808. package/src/agents/chain-serializer.ts +0 -285
  809. package/src/agents/frontmatter.ts +0 -153
  810. package/src/agents/global-npm-root.ts +0 -58
  811. package/src/agents/identity.ts +0 -30
  812. package/src/agents/proactive-skills.ts +0 -197
  813. package/src/agents/runtime-agent-events.ts +0 -70
  814. package/src/agents/runtime-agent-registry.ts +0 -457
  815. package/src/agents/runtime-discovery.ts +0 -39
  816. package/src/agents/skills.ts +0 -787
  817. package/src/api/agent-management.ts +0 -9
  818. package/src/api/agents.ts +0 -19
  819. package/src/api/background-work.ts +0 -206
  820. package/src/api/capability-ceiling.ts +0 -16
  821. package/src/api/child-tool-plan.ts +0 -5
  822. package/src/api/control-channel.ts +0 -4
  823. package/src/api/delegation.ts +0 -131
  824. package/src/api/external-job-provider.ts +0 -195
  825. package/src/api/external-runs.ts +0 -282
  826. package/src/api/inspectors.ts +0 -27
  827. package/src/api/intercom-bridge.ts +0 -3
  828. package/src/api/preflight.ts +0 -641
  829. package/src/api/project-panes.ts +0 -32
  830. package/src/api/required-child-extensions.ts +0 -6
  831. package/src/api/shared-types.ts +0 -29
  832. package/src/api/supervisor-routing.ts +0 -196
  833. package/src/api/workflow-resources.ts +0 -6
  834. package/src/extension/config.ts +0 -262
  835. package/src/extension/context-injection.ts +0 -123
  836. package/src/extension/control-notices.ts +0 -53
  837. package/src/extension/declaration-pinning.ts +0 -164
  838. package/src/extension/doctor.ts +0 -284
  839. package/src/extension/fanout-child.ts +0 -282
  840. package/src/extension/herdr-pi-bridge.ts +0 -166
  841. package/src/extension/index.ts +0 -1212
  842. package/src/extension/public-execution.ts +0 -262
  843. package/src/extension/reply-workflow-script.ts +0 -67
  844. package/src/extension/rpc.ts +0 -881
  845. package/src/extension/schemas.ts +0 -337
  846. package/src/extension/steering-notices.ts +0 -35
  847. package/src/extension/subagent-guide.ts +0 -127
  848. package/src/extension/subagent-options.ts +0 -47
  849. package/src/extension/tool-activation.ts +0 -147
  850. package/src/extension/tool-description.ts +0 -193
  851. package/src/extension/tool-result.ts +0 -19
  852. package/src/extension/upgrade-notice.ts +0 -40
  853. package/src/inspectors/actions.ts +0 -174
  854. package/src/inspectors/ghostty/actions.ts +0 -74
  855. package/src/inspectors/ghostty/plugin.ts +0 -29
  856. package/src/inspectors/herdr/actions.ts +0 -155
  857. package/src/inspectors/herdr/client.ts +0 -130
  858. package/src/inspectors/herdr/focus.ts +0 -55
  859. package/src/inspectors/herdr/plugin.ts +0 -20
  860. package/src/inspectors/herdr/project-panes.ts +0 -733
  861. package/src/inspectors/inspector-runner.ts +0 -153
  862. package/src/inspectors/plugins.ts +0 -76
  863. package/src/inspectors/session-roots-codec.ts +0 -31
  864. package/src/inspectors/shell-command.ts +0 -16
  865. package/src/inspectors/tmux/actions.ts +0 -204
  866. package/src/inspectors/tmux/client.ts +0 -85
  867. package/src/inspectors/tmux/plugin.ts +0 -21
  868. package/src/inspectors/types.ts +0 -51
  869. package/src/integrations/herdr-status.ts +0 -385
  870. package/src/integrations/pi-web-session-liveness.ts +0 -73
  871. package/src/integrations/program-status.ts +0 -215
  872. package/src/intercom/fork-supervisor-routing.ts +0 -533
  873. package/src/intercom/intercom-bridge.ts +0 -235
  874. package/src/intercom/native-supervisor-channel.ts +0 -1066
  875. package/src/intercom/result-intercom.ts +0 -433
  876. package/src/intercom/supervisor-ui.ts +0 -72
  877. package/src/missions/actions.ts +0 -433
  878. package/src/missions/goal-driver.ts +0 -177
  879. package/src/missions/lifecycle.ts +0 -367
  880. package/src/missions/store.ts +0 -613
  881. package/src/missions/types.ts +0 -190
  882. package/src/missions/workflow-state.ts +0 -281
  883. package/src/policy/authority.ts +0 -50
  884. package/src/profiles/profiles.ts +0 -674
  885. package/src/runs/background/active-async-capacity.ts +0 -548
  886. package/src/runs/background/active-run-index.ts +0 -155
  887. package/src/runs/background/async-execution.ts +0 -2479
  888. package/src/runs/background/async-job-tracker.ts +0 -869
  889. package/src/runs/background/async-resume.ts +0 -686
  890. package/src/runs/background/async-retention.ts +0 -953
  891. package/src/runs/background/async-status-snapshot.ts +0 -46
  892. package/src/runs/background/async-status.ts +0 -787
  893. package/src/runs/background/auto-drain.ts +0 -92
  894. package/src/runs/background/await-async-run.ts +0 -83
  895. package/src/runs/background/binary-bootstrap.ts +0 -67
  896. package/src/runs/background/calendar-schedule.ts +0 -90
  897. package/src/runs/background/chain-append.ts +0 -321
  898. package/src/runs/background/chain-root-attachment.ts +0 -263
  899. package/src/runs/background/completion-batcher.ts +0 -168
  900. package/src/runs/background/completion-dedupe.ts +0 -58
  901. package/src/runs/background/completion-replay.ts +0 -287
  902. package/src/runs/background/control-channel.ts +0 -659
  903. package/src/runs/background/fleet-view.ts +0 -692
  904. package/src/runs/background/index-segment.ts +0 -59
  905. package/src/runs/background/inspect-rpc.ts +0 -443
  906. package/src/runs/background/notify.ts +0 -1083
  907. package/src/runs/background/owned-process-tree.ts +0 -131
  908. package/src/runs/background/parallel-groups.ts +0 -45
  909. package/src/runs/background/pid-namespace.ts +0 -18
  910. package/src/runs/background/process-terminal-candidate.ts +0 -98
  911. package/src/runs/background/process-terminal.ts +0 -231
  912. package/src/runs/background/result-delivery-ownership.ts +0 -45
  913. package/src/runs/background/result-files.ts +0 -634
  914. package/src/runs/background/result-watcher.ts +0 -842
  915. package/src/runs/background/resume-guidance.ts +0 -56
  916. package/src/runs/background/retained-children.ts +0 -136
  917. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  918. package/src/runs/background/run-child-session.ts +0 -725
  919. package/src/runs/background/run-id-query.ts +0 -7
  920. package/src/runs/background/run-id-resolver.ts +0 -183
  921. package/src/runs/background/run-status.ts +0 -803
  922. package/src/runs/background/runner-aliases.ts +0 -183
  923. package/src/runs/background/runner-child-launch.ts +0 -96
  924. package/src/runs/background/runner-child-sessions.ts +0 -32
  925. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  926. package/src/runs/background/runner-startup-failure.ts +0 -56
  927. package/src/runs/background/scheduled-runs.ts +0 -1222
  928. package/src/runs/background/stale-run-reconciler.ts +0 -463
  929. package/src/runs/background/steering.ts +0 -260
  930. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  931. package/src/runs/background/subagent-runner.ts +0 -5251
  932. package/src/runs/background/subagent-wait.ts +0 -895
  933. package/src/runs/background/terminal-run-index.ts +0 -183
  934. package/src/runs/background/top-level-async.ts +0 -14
  935. package/src/runs/background/wait-completions.ts +0 -262
  936. package/src/runs/background/wait-config.ts +0 -50
  937. package/src/runs/background/wait-subscriptions.ts +0 -354
  938. package/src/runs/background/wait-tool.ts +0 -57
  939. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  940. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  941. package/src/runs/foreground/async-steering-action.ts +0 -276
  942. package/src/runs/foreground/async-stop-action.ts +0 -216
  943. package/src/runs/foreground/command-action.ts +0 -41
  944. package/src/runs/foreground/execution.ts +0 -2315
  945. package/src/runs/foreground/foreground-control.ts +0 -157
  946. package/src/runs/foreground/foreground-history.ts +0 -164
  947. package/src/runs/foreground/prompt-audit.ts +0 -172
  948. package/src/runs/foreground/subagent-executor.ts +0 -8252
  949. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  950. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  951. package/src/runs/shared/abort-recovery.ts +0 -119
  952. package/src/runs/shared/acceptance.ts +0 -1664
  953. package/src/runs/shared/agent-contract.ts +0 -38
  954. package/src/runs/shared/async-status-projection.ts +0 -664
  955. package/src/runs/shared/background-process-options.ts +0 -9
  956. package/src/runs/shared/capability-ceiling.ts +0 -214
  957. package/src/runs/shared/chain-outputs.ts +0 -116
  958. package/src/runs/shared/child-commands.ts +0 -229
  959. package/src/runs/shared/child-hooks.ts +0 -175
  960. package/src/runs/shared/child-identity.ts +0 -62
  961. package/src/runs/shared/child-launch-plan.ts +0 -163
  962. package/src/runs/shared/child-launch.ts +0 -389
  963. package/src/runs/shared/child-lifecycle.ts +0 -28
  964. package/src/runs/shared/child-runtime-config.ts +0 -136
  965. package/src/runs/shared/child-session.ts +0 -699
  966. package/src/runs/shared/child-tool-plan.ts +0 -599
  967. package/src/runs/shared/claude-code-adapter.ts +0 -288
  968. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  969. package/src/runs/shared/context-mode.ts +0 -44
  970. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  971. package/src/runs/shared/dynamic-fanout.ts +0 -297
  972. package/src/runs/shared/effective-system-prompt.ts +0 -33
  973. package/src/runs/shared/extension-bindings.ts +0 -103
  974. package/src/runs/shared/external-cli-contract.ts +0 -177
  975. package/src/runs/shared/external-cli-preflight.ts +0 -190
  976. package/src/runs/shared/external-cli-runner.ts +0 -437
  977. package/src/runs/shared/external-job-bridge.ts +0 -514
  978. package/src/runs/shared/external-job-runner.ts +0 -389
  979. package/src/runs/shared/fast-mode-extension.ts +0 -10
  980. package/src/runs/shared/fork-command-result.ts +0 -10
  981. package/src/runs/shared/git-environment.ts +0 -29
  982. package/src/runs/shared/herdr-connection.ts +0 -134
  983. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  984. package/src/runs/shared/herdr-machine.ts +0 -279
  985. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  986. package/src/runs/shared/herdr-placed-run.ts +0 -264
  987. package/src/runs/shared/host-step-status.ts +0 -231
  988. package/src/runs/shared/lane-metadata.ts +0 -126
  989. package/src/runs/shared/launch-cwd.ts +0 -16
  990. package/src/runs/shared/long-running-guard.ts +0 -221
  991. package/src/runs/shared/mcp-config-sources.ts +0 -426
  992. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  993. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  994. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  995. package/src/runs/shared/model-resolution.ts +0 -503
  996. package/src/runs/shared/model-scope.ts +0 -224
  997. package/src/runs/shared/mutation-evidence.ts +0 -199
  998. package/src/runs/shared/nested-events.ts +0 -1125
  999. package/src/runs/shared/nested-path.ts +0 -38
  1000. package/src/runs/shared/nested-render.ts +0 -127
  1001. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1002. package/src/runs/shared/parallel-handoff.ts +0 -789
  1003. package/src/runs/shared/parallel-utils.ts +0 -292
  1004. package/src/runs/shared/partial-output.ts +0 -48
  1005. package/src/runs/shared/permissions.ts +0 -86
  1006. package/src/runs/shared/pi-spawn.ts +0 -205
  1007. package/src/runs/shared/process-signal.ts +0 -35
  1008. package/src/runs/shared/profile-extensions.ts +0 -134
  1009. package/src/runs/shared/profile-launch-env.ts +0 -121
  1010. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1011. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1012. package/src/runs/shared/run-history.ts +0 -288
  1013. package/src/runs/shared/runner-launcher.ts +0 -25
  1014. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1015. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1016. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1017. package/src/runs/shared/session-lease.ts +0 -293
  1018. package/src/runs/shared/single-output.ts +0 -366
  1019. package/src/runs/shared/spawn-budget.ts +0 -128
  1020. package/src/runs/shared/structured-output.ts +0 -463
  1021. package/src/runs/shared/subagent-control.ts +0 -295
  1022. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1023. package/src/runs/shared/tool-availability.ts +0 -37
  1024. package/src/runs/shared/tool-budget.ts +0 -87
  1025. package/src/runs/shared/tool-timeout.ts +0 -93
  1026. package/src/runs/shared/usage-budget.ts +0 -65
  1027. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1028. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1029. package/src/runs/shared/workflow-graph.ts +0 -225
  1030. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1031. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1032. package/src/runs/shared/worktree-lock.ts +0 -29
  1033. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1034. package/src/runs/shared/worktree.ts +0 -1554
  1035. package/src/shared/accessible-dir.ts +0 -47
  1036. package/src/shared/agent-stream-options.ts +0 -5
  1037. package/src/shared/artifacts.ts +0 -281
  1038. package/src/shared/atomic-json.ts +0 -85
  1039. package/src/shared/capacity-resilient-json.ts +0 -102
  1040. package/src/shared/child-cache-retention.ts +0 -43
  1041. package/src/shared/child-session-name.ts +0 -48
  1042. package/src/shared/child-transcript.ts +0 -264
  1043. package/src/shared/completion-owner.ts +0 -14
  1044. package/src/shared/disabled-features.ts +0 -123
  1045. package/src/shared/display-text.ts +0 -150
  1046. package/src/shared/edit-distance.ts +0 -33
  1047. package/src/shared/extension-context.ts +0 -37
  1048. package/src/shared/file-coalescer.ts +0 -49
  1049. package/src/shared/file-lease.ts +0 -74
  1050. package/src/shared/file-system-retry.ts +0 -95
  1051. package/src/shared/fork-context.ts +0 -243
  1052. package/src/shared/fork-session-cwd.ts +0 -27
  1053. package/src/shared/formatters.ts +0 -142
  1054. package/src/shared/jsonl-writer.ts +0 -92
  1055. package/src/shared/launch-contract.ts +0 -206
  1056. package/src/shared/model-info.ts +0 -132
  1057. package/src/shared/model-response-aliases.ts +0 -13
  1058. package/src/shared/node-executable.ts +0 -21
  1059. package/src/shared/opencode-session-headers.ts +0 -30
  1060. package/src/shared/package-version.ts +0 -17
  1061. package/src/shared/parent-wake.ts +0 -79
  1062. package/src/shared/permission-profile.ts +0 -56
  1063. package/src/shared/prompt-resources.ts +0 -11
  1064. package/src/shared/pruned-fork.ts +0 -469
  1065. package/src/shared/required-child-extensions.ts +0 -115
  1066. package/src/shared/runtime-module-path.ts +0 -19
  1067. package/src/shared/sandbox-profile.ts +0 -37
  1068. package/src/shared/session-file-trust.ts +0 -19
  1069. package/src/shared/session-identity.ts +0 -10
  1070. package/src/shared/session-tokens.ts +0 -55
  1071. package/src/shared/settings-file-lease.ts +0 -36
  1072. package/src/shared/settings.ts +0 -412
  1073. package/src/shared/shortcuts.ts +0 -13
  1074. package/src/shared/status-format.ts +0 -55
  1075. package/src/shared/thinking-ceiling.ts +0 -46
  1076. package/src/shared/types.ts +0 -3105
  1077. package/src/shared/utf8.ts +0 -11
  1078. package/src/shared/utils.ts +0 -610
  1079. package/src/shared/watch-strategy.ts +0 -12
  1080. package/src/shared/workflow-child-permit.ts +0 -212
  1081. package/src/slash/delegation-adapters.ts +0 -452
  1082. package/src/slash/delegation-json.ts +0 -108
  1083. package/src/slash/delegation-request.ts +0 -176
  1084. package/src/slash/prompt-template-bridge.ts +0 -435
  1085. package/src/slash/prompt-workflows.ts +0 -298
  1086. package/src/slash/selector.ts +0 -147
  1087. package/src/slash/slash-bridge.ts +0 -192
  1088. package/src/slash/slash-commands.ts +0 -1096
  1089. package/src/slash/slash-live-state.ts +0 -310
  1090. package/src/slash/subagent-cost.ts +0 -317
  1091. package/src/slash/subagents-admin.ts +0 -489
  1092. package/src/tui/fleet-native-transcript.ts +0 -424
  1093. package/src/tui/fleet-status.ts +0 -1139
  1094. package/src/tui/fleet-transcript.ts +0 -591
  1095. package/src/tui/fleet.ts +0 -1618
  1096. package/src/tui/mouse-events.ts +0 -42
  1097. package/src/tui/render-helpers.ts +0 -111
  1098. package/src/tui/render.ts +0 -3824
  1099. package/src/tui/running-tone.ts +0 -28
  1100. package/src/tui/subagent-messages.ts +0 -305
  1101. package/src/ui-silent-marker.ts +0 -32
  1102. package/src/watchdog/change-signature.ts +0 -260
  1103. package/src/watchdog/child-status.ts +0 -225
  1104. package/src/watchdog/diff-tool.ts +0 -112
  1105. package/src/watchdog/emission-guard.ts +0 -125
  1106. package/src/watchdog/guidance.ts +0 -20
  1107. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1108. package/src/watchdog/model-selection.ts +0 -187
  1109. package/src/watchdog/permission-arbiter.ts +0 -154
  1110. package/src/watchdog/register-child.ts +0 -136
  1111. package/src/watchdog/register-main.ts +0 -425
  1112. package/src/watchdog/render.ts +0 -31
  1113. package/src/watchdog/review.ts +0 -362
  1114. package/src/watchdog/rules.ts +0 -70
  1115. package/src/watchdog/runtime.ts +0 -927
  1116. package/src/watchdog/scope.ts +0 -51
  1117. package/src/watchdog/settings.ts +0 -520
  1118. package/src/watchdog/tool-actions.ts +0 -156
  1119. package/src/watchdog/turn-delta.ts +0 -190
  1120. package/src/watchdog/types.ts +0 -186
  1121. package/src/watchdog/warning-format.ts +0 -72
  1122. package/src/workflows/chat-progress.ts +0 -152
  1123. package/src/workflows/host-command.ts +0 -235
  1124. package/src/workflows/scripted-workflow.ts +0 -2733
  1125. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1126. package/src/workflows/workflow-checklist.ts +0 -442
  1127. package/src/workflows/workflow-child-summary.ts +0 -172
  1128. package/src/workflows/workflow-preflight.ts +0 -297
  1129. package/src/workflows/workflow-receipt.ts +0 -390
  1130. package/src/workflows/workflow-resources.ts +0 -275
  1131. package/src/workflows/workflow-reuse.ts +0 -120
  1132. package/src/workflows/workflow-revival.ts +0 -123
  1133. package/src/workflows/workflow-settlement.ts +0 -252
@@ -0,0 +1,2322 @@
1
+ /**
2
+ * Core execution logic for running subagents
3
+ */
4
+ import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
5
+ import * as path from "node:path";
6
+ import { discoverAgents, formatUnknownAgentError, unknownAgentDiagnosticContext } from "../../agents/agents.js";
7
+ import { alignForkedSessionCwd } from "../../shared/fork-session-cwd.js";
8
+ import { buildEffectiveSystemPrompt } from "../shared/effective-system-prompt.js";
9
+ import { ensureArtifactsDir, formatOutputArtifactContent, getArtifactPaths, writeArtifact, writeMetadata, } from "../../shared/artifacts.js";
10
+ import { createChildTranscriptWriter } from "../../shared/child-transcript.js";
11
+ import { DEFAULT_MAX_OUTPUT, INTERCOM_DETACH_REQUEST_EVENT, INTERCOM_DETACH_RESPONSE_EVENT, truncateOutput, } from "../../shared/types.js";
12
+ import { DEFAULT_CONTROL_CONFIG, buildControlEvent, claimControlNotification, deriveActivityState, shouldEmitOpenToolAttention, shouldNotifyControlEvent, } from "../shared/subagent-control.js";
13
+ import { getFinalOutput, findLatestSessionFile, detectSubagentError, hasEmptyTerminalAssistantResponse, formatEmptyTerminalAssistantResponseError, extractToolArgsPreview, assistantMessageError, extractTextFromContent, MAX_STREAMED_RECENT_TOOLS, boundStreamedRecentTools, boundStreamedRecentOutput, boundStreamedToolCalls, } from "../../shared/utils.js";
14
+ import { resolveSkillsWithFallback } from "../../agents/skills.js";
15
+ import { createPartialOutputTracker, formatPartialOutput } from "../shared/partial-output.js";
16
+ import { effectiveToolTimeoutMs, formatToolTimeoutMessage, resolveToolTimeoutMs, toolTimeoutCallKey, toolTimeoutFromEnv } from "../shared/tool-timeout.js";
17
+ import { preflightLaunchCwd } from "../shared/launch-cwd.js";
18
+ import { createJsonlWriter } from "../../shared/jsonl-writer.js";
19
+ import { createOrcaProgressTab } from "../shared/orca-progress-tabs.js";
20
+ import { clearSandboxStartupDiagnostic, readSandboxStartupDiagnostic } from "../shared/sandbox-startup-diagnostics.js";
21
+ import { resolvePermissionRules } from "../shared/permissions.js";
22
+ import { applyThinkingSuffix, deriveForkPromptCacheKey, supervisorChannelDir } from "../shared/child-tool-plan.js";
23
+ import { retainsChildCommand } from "../shared/child-commands.js";
24
+ import { deriveChildSessionName } from "../../shared/child-session-name.js";
25
+ import { assertAgentAllowedByCapabilityCeiling, intersectSubagentCapabilityCeilings, resolveCurrentSubagentCapabilityCeiling } from "../shared/capability-ceiling.js";
26
+ import { qualifyModelWithProvider, resolveEffectiveThinking } from "../../shared/model-info.js";
27
+ import { assertThinkingWithinCeiling, intersectThinkingCeilings } from "../../shared/thinking-ceiling.js";
28
+ import { formatStructuredOutputRejectionError, MISSING_STRUCTURED_ACCEPTANCE_REPORT_ERROR, MISSING_STRUCTURED_OUTPUT_CALL_ERROR, STRUCTURED_OUTPUT_FOLLOW_UP } from "../shared/structured-output.js";
29
+ import { formatMidToolExitError, isOrdinaryToolForMidToolExit } from "../shared/process-signal.js";
30
+ import { formatChildToolDiagnostic } from "../shared/tool-availability.js";
31
+ import { formatChildModelResolutionDiagnostic, formatInheritedProviderDiagnostic, isChildModelResolutionFailure } from "../shared/model-resolution-diagnostic.js";
32
+ import { planAbortRecovery } from "../shared/abort-recovery.js";
33
+ import { buildTimeoutRecoverySummary, collectTrackedMutationEvidence, snapshotTrackedMutations } from "../shared/mutation-evidence.js";
34
+ import { captureSingleOutputSnapshot, extractChildWrittenOutput, finalizeSingleOutput, formatSavedOutputReference, hasSingleOutputChangedSinceSnapshot, isSettlementFatalOutputError, resolveSingleOutput, validateFileOnlyOutputMode } from "../shared/single-output.js";
35
+ import { formatSubagentModelVerificationError, isContextOverflow, resolveModelSelection, } from "../shared/model-resolution.js";
36
+ import { createMutatingFailureState, didMutatingToolFail, isMutatingTool, nextLongRunningTrigger, recordMutatingFailure, resetMutatingFailureState, resolveCurrentPath, shouldEscalateMutatingFailures, summarizeRecentMutatingFailures, } from "../shared/long-running-guard.js";
37
+ import { acceptanceFailureMessage, buildSkippedAcceptanceLedger, captureStagedIndexBaseline, evaluateAcceptance, formatAcceptancePrompt, resolveEffectiveAcceptance, stripAcceptanceReport, validateAcceptanceInput, typedVerifyOutput } from "../shared/acceptance.js";
38
+ import { PROMPT_REDACTED } from "../../shared/utils.js";
39
+ import { attachContractProjections, isAgentContract } from "../shared/agent-contract.js";
40
+ import { initialToolBudgetState, isToolBudgetBlockedMessage, toolBudgetState } from "../shared/tool-budget.js";
41
+ import { resolveWatchdogConfig } from "../../watchdog/settings.js";
42
+ import { resolveLaunchBinding } from "../../shared/launch-contract.js";
43
+ import { consumeWorkflowChildPermit } from "../../shared/workflow-child-permit.js";
44
+ import { projectChildLifecycle } from "../shared/child-lifecycle.js";
45
+ import { acceptChildWatchdogEvent, applyChildWatchdogMessage, childWatchdogIsActive, isChildWatchdogStatusEvent, resolveChildWatchdogConfig, } from "../../watchdog/child-status.js";
46
+ import { buildInProcessChildLaunch, createReportedChildSessionInput } from "../shared/child-launch.js";
47
+ import { childSessionFactory, childSessionHasQueuedMessages, projectChildSessionEventForJson } from "../shared/child-session.js";
48
+ import { reconcileAttemptUsage } from "../shared/usage-reconciliation.js";
49
+ import { clearProviderRetry, observeProviderDiagnostics, snapshotProviderDiagnostics } from "../../shared/provider-diagnostics.js";
50
+ import { isRexLocalMachine } from "../shared/rex-machine.js";
51
+ const artifactOutputByResult = new WeakMap();
52
+ const acceptanceOutputByResult = new WeakMap();
53
+ function emptyUsage() {
54
+ return { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: 0 };
55
+ }
56
+ function withRunContext(result, context) {
57
+ if (!context)
58
+ return result;
59
+ result.context = context;
60
+ return result;
61
+ }
62
+ function redactResultPrompt(result) {
63
+ result.task = PROMPT_REDACTED;
64
+ if (result.progress)
65
+ result.progress.task = PROMPT_REDACTED;
66
+ return result;
67
+ }
68
+ function sumUsage(target, source) {
69
+ target.input += source.input;
70
+ target.output += source.output;
71
+ target.cacheRead += source.cacheRead;
72
+ target.cacheWrite += source.cacheWrite;
73
+ target.cost += source.cost;
74
+ target.turns += source.turns;
75
+ }
76
+ function persistSingleResultMetadata(input) {
77
+ if (!input.enabled || !input.metadataPath)
78
+ return;
79
+ const target = input.result;
80
+ writeMetadata(input.metadataPath, {
81
+ runId: input.runId,
82
+ parentSessionId: input.parentSessionId,
83
+ agent: input.agent,
84
+ task: PROMPT_REDACTED,
85
+ exitCode: target.exitCode,
86
+ processSignal: target.processSignal,
87
+ usage: target.usage,
88
+ model: target.model,
89
+ requestedModel: target.requestedModel,
90
+ durationMs: target.progressSummary?.durationMs,
91
+ toolCount: target.progressSummary?.toolCount,
92
+ error: target.error,
93
+ agentContract: target.agentContract,
94
+ sandbox: target.sandbox,
95
+ launchContractDigest: target.launchContractDigest,
96
+ launchResolvedExtensions: target.launchResolvedExtensions,
97
+ runtimeAcknowledgedExtensions: target.runtimeAcknowledgedExtensions,
98
+ execution: target.execution,
99
+ acceptance: target.acceptance,
100
+ capabilityCeiling: target.capabilityCeiling,
101
+ capabilityAudit: target.capabilityAudit,
102
+ review: target.review,
103
+ effects: target.effects,
104
+ transcriptPath: target.transcriptPath,
105
+ transcriptError: target.transcriptError,
106
+ skills: target.skills,
107
+ skillsWarning: target.skillsWarning,
108
+ timestamp: Date.now(),
109
+ });
110
+ }
111
+ function resolveAttemptTimeout(options) {
112
+ if (options.timeoutMs === undefined)
113
+ return undefined;
114
+ const deadlineAt = options.deadlineAt ?? Date.now() + options.timeoutMs;
115
+ return {
116
+ timeoutMs: options.timeoutMs,
117
+ remainingMs: Math.max(0, deadlineAt - Date.now()),
118
+ message: `Subagent timed out after ${options.timeoutMs}ms.`,
119
+ };
120
+ }
121
+ function buildPendingAcceptanceLedger(acceptance) {
122
+ return {
123
+ status: "pending",
124
+ evidenceStatus: "pending",
125
+ explicit: acceptance.explicit,
126
+ effectiveAcceptance: acceptance,
127
+ inferredReason: acceptance.inferredReason,
128
+ criteria: acceptance.criteria,
129
+ runtimeChecks: [],
130
+ verifyRuns: [],
131
+ };
132
+ }
133
+ function buildInterruptedAcceptanceLedger(acceptance) {
134
+ const pending = buildPendingAcceptanceLedger(acceptance);
135
+ if (acceptance.level === "none") {
136
+ pending.status = "not-required";
137
+ pending.evidenceStatus = "not-required";
138
+ }
139
+ else {
140
+ pending.runtimeChecks = [{
141
+ id: "interrupted",
142
+ status: "not-applicable",
143
+ message: "Acceptance was not evaluated because the subagent was interrupted.",
144
+ }];
145
+ }
146
+ return pending;
147
+ }
148
+ function appendRecentOutput(progress, lines) {
149
+ if (lines.length === 0)
150
+ return;
151
+ progress.recentOutput.push(...lines.filter((line) => line.trim()));
152
+ if (progress.recentOutput.length > 50) {
153
+ progress.recentOutput.splice(0, progress.recentOutput.length - 50);
154
+ }
155
+ }
156
+ function stripAcceptanceReportsFromMessages(messages) {
157
+ for (const message of messages ?? []) {
158
+ if (message.role !== "assistant" || !Array.isArray(message.content))
159
+ continue;
160
+ for (const part of message.content) {
161
+ if (part.type === "text" && "text" in part && typeof part.text === "string") {
162
+ part.text = stripAcceptanceReport(part.text);
163
+ }
164
+ }
165
+ }
166
+ }
167
+ function snapshotProgress(progress) {
168
+ return {
169
+ ...progress,
170
+ task: PROMPT_REDACTED,
171
+ skills: progress.skills ? [...progress.skills] : undefined,
172
+ providerDiagnostics: snapshotProviderDiagnostics(progress.providerDiagnostics),
173
+ recentTools: boundStreamedRecentTools(progress.recentTools),
174
+ recentOutput: boundStreamedRecentOutput(progress.recentOutput),
175
+ };
176
+ }
177
+ function snapshotResult(result, progress) {
178
+ return {
179
+ ...result,
180
+ task: PROMPT_REDACTED,
181
+ messages: result.outputMode === "file-only" && result.savedOutputPath ? undefined : result.messages ? [...result.messages] : undefined,
182
+ usage: { ...result.usage },
183
+ providerDiagnostics: snapshotProviderDiagnostics(result.providerDiagnostics),
184
+ skills: result.skills ? [...result.skills] : undefined,
185
+ controlEvents: result.controlEvents ? result.controlEvents.map((event) => ({ ...event })) : undefined,
186
+ progress,
187
+ progressSummary: result.progressSummary ? { ...result.progressSummary } : undefined,
188
+ artifactPaths: result.artifactPaths ? { ...result.artifactPaths } : undefined,
189
+ truncation: result.truncation ? { ...result.truncation } : undefined,
190
+ outputReference: result.outputReference ? { ...result.outputReference } : undefined,
191
+ };
192
+ }
193
+ /**
194
+ * Streaming variant of snapshotResult for `onUpdate` progress events: it drops the
195
+ * unbounded `messages` transcript in favour of compact tool-call summaries so a
196
+ * single `tool_execution_update` event stays small; the parent records every
197
+ * one in its transcript and `events.jsonl`. Non-streaming consumers such as
198
+ * foreground detach receipts and terminal consumers use snapshotResult directly.
199
+ */
200
+ function snapshotStreamResult(result, progress) {
201
+ const snapshot = snapshotResult({ ...result, messages: undefined }, progress);
202
+ snapshot.toolCalls = boundStreamedToolCalls(result);
203
+ return snapshot;
204
+ }
205
+ function captureStructuredDelegationProgressState(progress, result) {
206
+ return {
207
+ providerDiagnostics: progress.providerDiagnostics,
208
+ currentTool: progress.currentTool,
209
+ currentToolArgs: progress.currentToolArgs,
210
+ recentOutput: [...progress.recentOutput],
211
+ recentTools: progress.recentTools.slice(-MAX_STREAMED_RECENT_TOOLS).map(({ tool, args }) => ({ tool, args })),
212
+ activityState: progress.activityState,
213
+ model: progress.model ?? result.model,
214
+ toolCount: progress.toolCount,
215
+ tokens: progress.tokens,
216
+ turnCount: progress.turnCount,
217
+ };
218
+ }
219
+ function structuredDelegationProgressChanged(previous, progress, result) {
220
+ // Observations replace internal diagnostics; no transcript walk or serialization on heartbeats.
221
+ if (previous.providerDiagnostics !== progress.providerDiagnostics
222
+ || previous.currentTool !== progress.currentTool
223
+ || previous.currentToolArgs !== progress.currentToolArgs
224
+ || previous.activityState !== progress.activityState
225
+ || previous.model !== (progress.model ?? result.model)
226
+ || previous.toolCount !== progress.toolCount
227
+ || previous.tokens !== progress.tokens
228
+ || previous.turnCount !== progress.turnCount
229
+ || previous.recentOutput.length !== progress.recentOutput.length)
230
+ return true;
231
+ for (let index = 0; index < progress.recentOutput.length; index++) {
232
+ if (previous.recentOutput[index] !== progress.recentOutput[index])
233
+ return true;
234
+ }
235
+ const recentToolsStart = Math.max(0, progress.recentTools.length - MAX_STREAMED_RECENT_TOOLS);
236
+ if (previous.recentTools.length !== progress.recentTools.length - recentToolsStart)
237
+ return true;
238
+ for (let index = recentToolsStart; index < progress.recentTools.length; index++) {
239
+ const previousTool = previous.recentTools[index - recentToolsStart];
240
+ const currentTool = progress.recentTools[index];
241
+ if (previousTool?.tool !== currentTool?.tool || previousTool?.args !== currentTool?.args)
242
+ return true;
243
+ }
244
+ return false;
245
+ }
246
+ function isCompleteUsageCounter(value) {
247
+ return typeof value === "number" && Number.isFinite(value) && value >= 0;
248
+ }
249
+ const STOPPED_BEFORE_COMPLETION_ERROR = "Subagent stopped before completion.";
250
+ const AFTER_COMPACTION_SETTLEMENT = Symbol("afterCompactionSettlement");
251
+ async function runSingleAttempt(runtimeCwd, agent, task, model, options, shared) {
252
+ const effectiveThinking = options.thinkingOverride ?? agent.thinking;
253
+ const modelArg = applyThinkingSuffix(model, effectiveThinking, options.thinkingOverride !== undefined);
254
+ assertThinkingWithinCeiling({ model: modelArg, configThinking: effectiveThinking, ceiling: options.thinkingCeiling, agent: agent.name, runId: options.runId });
255
+ const expectedModelForVerification = shared.verifyModel ? modelArg : undefined;
256
+ const resolvedThinking = resolveEffectiveThinking(modelArg, effectiveThinking);
257
+ // Display name for the child session: applied inside the child through its
258
+ // runtime config and echoed back on the result payload so hosts can label
259
+ // this run without reading the child's session file.
260
+ const childSessionName = deriveChildSessionName({ agent: agent.name, task: shared.originalTask ?? task });
261
+ const watchdogConfig = resolveWatchdogConfig(options.cwd ?? runtimeCwd);
262
+ const childWatchdog = watchdogConfig.ok
263
+ ? resolveChildWatchdogConfig({
264
+ config: watchdogConfig.config,
265
+ agent: agent.name,
266
+ runId: options.runId,
267
+ childIndex: options.index ?? 0,
268
+ })
269
+ : undefined;
270
+ const permissionRules = resolvePermissionRules(options.permissions, agent.permissions);
271
+ const sandbox = options.sandbox ?? agent.sandbox;
272
+ const permissionProfile = options.permissionProfile ?? agent.permissionProfile;
273
+ const permissionAuditPath = permissionRules && options.artifactsDir
274
+ ? path.join(options.artifactsDir, "permission-audit", `${options.runId}-${options.index ?? 0}.jsonl`)
275
+ : undefined;
276
+ let onWatchdogStatus;
277
+ const launch = buildInProcessChildLaunch({
278
+ machine: options.machine,
279
+ remoteSkillNames: options.skills ?? agent.skills,
280
+ remoteReads: options.remoteReads,
281
+ extensionBindings: options.extensionBindings,
282
+ requiredExtensions: options.requiredExtensions,
283
+ sessionEnabled: shared.sessionEnabled,
284
+ sessionDir: options.sessionDir,
285
+ sessionFile: options.sessionFile,
286
+ model: modelArg,
287
+ systemPromptMode: agent.systemPromptMode,
288
+ inheritProjectContext: agent.inheritProjectContext,
289
+ inheritGlobalContext: agent.inheritGlobalContext,
290
+ inheritSkills: agent.inheritSkills,
291
+ requireReadTool: Boolean(shared.resolvedSkillNames?.length),
292
+ tools: agent.tools,
293
+ excludeTools: agent.excludeTools,
294
+ allowNestedSubagents: agent.allowNestedSubagents,
295
+ descendantAllowedAgents: agent.allowedAgents,
296
+ extensions: agent.extensions,
297
+ subagentOnlyExtensions: agent.subagentOnlyExtensions,
298
+ // Exact terminal protocol belongs to session resources, not compactable history.
299
+ systemPrompt: shared.acceptancePrompt ? `${shared.systemPrompt}\n${shared.acceptancePrompt}` : shared.systemPrompt,
300
+ mcpDirectTools: agent.mcpDirectTools,
301
+ cwd: options.cwd ?? runtimeCwd,
302
+ intercomSessionName: options.intercomSessionName,
303
+ sessionName: childSessionName,
304
+ orchestratorIntercomTarget: options.orchestratorIntercomTarget,
305
+ runId: options.runId,
306
+ childAgentName: agent.name,
307
+ childIndex: options.index ?? 0,
308
+ nestedRoute: options.nestedRoute,
309
+ runFanoutBudget: options.runFanoutBudget,
310
+ parentSessionId: options.parentSessionId,
311
+ parentSessionFile: options.parentSessionFile,
312
+ forkCacheKey: options.context === "fork" ? deriveForkPromptCacheKey(options.parentSessionId) : undefined,
313
+ structuredOutput: options.structuredOutput,
314
+ fast: options.fast ?? agent.fast,
315
+ toolBudget: options.toolBudget,
316
+ permissionRules,
317
+ permissionAuditPath,
318
+ sandbox,
319
+ permissionProfile,
320
+ projectTrusted: options.projectTrusted,
321
+ trustedProjectCwd: options.trustedProjectCwd,
322
+ childWatchdog,
323
+ // registerChildWatchdog returns before reading the sink when no watchdog exists.
324
+ watchdogStatus: childWatchdog ? (event) => onWatchdogStatus?.(event) : undefined,
325
+ waitToolEnabled: options.waitToolEnabled,
326
+ waitToolDefaultTimeoutMs: options.waitToolDefaultTimeoutMs,
327
+ capabilityCeiling: options.capabilityCeiling,
328
+ thinkingCeiling: options.thinkingCeiling,
329
+ maxSubagentDepth: options.maxSubagentDepth,
330
+ runtimeSnapshotHost: options.runtimeSnapshotHost,
331
+ inherited: options.childRuntime,
332
+ host: "parent",
333
+ });
334
+ if (!options.machine && options.parentProviderRegistry)
335
+ launch.session.parentProviderRegistry = options.parentProviderRegistry;
336
+ const { toolPlan, capabilityAudit, warnings, launchResolvedExtensions, capture } = launch;
337
+ if (!shared.launchWarnings.emitted && warnings.length > 0) {
338
+ for (const warning of warnings)
339
+ console.warn(`[pi-subagents] ${warning}`);
340
+ shared.launchWarnings.emitted = true;
341
+ }
342
+ const effectiveSystemPrompt = shared.systemPrompt;
343
+ const fast = options.fast ?? agent.fast;
344
+ const { launchContractDigest } = resolveLaunchBinding({
345
+ agent,
346
+ task: shared.originalTask ?? task,
347
+ model: modelArg,
348
+ ...(fast !== undefined ? { fast } : {}),
349
+ ...(resolvedThinking ? { thinking: resolvedThinking } : {}),
350
+ systemPrompt: effectiveSystemPrompt,
351
+ systemPromptMode: agent.systemPromptMode,
352
+ inheritProjectContext: agent.inheritProjectContext,
353
+ inheritGlobalContext: agent.inheritGlobalContext,
354
+ inheritSkills: agent.inheritSkills,
355
+ sandbox,
356
+ permissionProfile,
357
+ skills: shared.resolvedSkillNames ?? [],
358
+ toolPlan,
359
+ ...(options.outputPath ? { outputPath: options.outputPath } : {}),
360
+ outputMode: options.outputMode ?? "inline",
361
+ ...(options.structuredOutput ? { structuredOutputSchema: options.structuredOutput.schema } : {}),
362
+ ...(options.extensionBindings ? { extensionBindings: options.extensionBindings } : {}),
363
+ });
364
+ const result = withRunContext({
365
+ index: options.index ?? 0,
366
+ agent: agent.name,
367
+ task: shared.originalTask ?? task,
368
+ ...(childSessionName ? { sessionName: childSessionName } : {}),
369
+ ...(options.agentContract ? { agentContract: options.agentContract } : {}),
370
+ ...(sandbox ? { sandbox } : {}),
371
+ ...(permissionProfile ? { permissionProfile } : {}),
372
+ launchContractDigest,
373
+ launchResolvedExtensions,
374
+ exitCode: 0,
375
+ outputState: "absent",
376
+ messages: [],
377
+ providerDiagnostics: shared.providerDiagnostics,
378
+ usage: emptyUsage(),
379
+ model: modelArg,
380
+ ...(resolvedThinking ? { thinking: resolvedThinking } : {}),
381
+ artifactPaths: shared.artifactPaths,
382
+ transcriptPath: shared.transcriptWriter ? shared.artifactPaths?.transcriptPath : undefined,
383
+ skills: shared.resolvedSkillNames,
384
+ skillsWarning: shared.skillsWarning,
385
+ ...(options.toolBudget ? { toolBudget: initialToolBudgetState(options.toolBudget) } : {}),
386
+ ...(options.capabilityCeiling ? { capabilityCeiling: options.capabilityCeiling } : {}),
387
+ ...(capabilityAudit ? { capabilityAudit } : {}),
388
+ }, options.context);
389
+ const startTime = Date.now();
390
+ const controlConfig = options.controlConfig ?? DEFAULT_CONTROL_CONFIG;
391
+ let interruptedByControl = false;
392
+ const allControlEvents = [];
393
+ let pendingControlEvents = [];
394
+ const emittedControlEventKeys = new Set();
395
+ const emitControlEvent = (event) => {
396
+ if (!shouldNotifyControlEvent(controlConfig, event))
397
+ return;
398
+ if (!claimControlNotification(controlConfig, event, emittedControlEventKeys))
399
+ return;
400
+ allControlEvents.push(event);
401
+ pendingControlEvents.push(event);
402
+ options.onControlEvent?.(event);
403
+ };
404
+ let inputUsageComplete = true;
405
+ let outputUsageComplete = true;
406
+ let cacheReadUsageComplete = true;
407
+ let cacheWriteUsageComplete = true;
408
+ const progress = {
409
+ providerDiagnostics: result.providerDiagnostics,
410
+ index: options.index ?? 0,
411
+ agent: agent.name,
412
+ ...(childSessionName ? { sessionName: childSessionName } : {}),
413
+ status: "running",
414
+ task,
415
+ skills: shared.resolvedSkillNames,
416
+ recentTools: [],
417
+ recentOutput: [...shared.attemptNotes],
418
+ toolCount: 0,
419
+ tokens: 0,
420
+ ...(modelArg ? { model: modelArg } : {}),
421
+ ...(resolvedThinking ? { thinking: resolvedThinking } : {}),
422
+ durationMs: 0,
423
+ lastActivityAt: startTime,
424
+ };
425
+ result.progress = progress;
426
+ const projectCompleteUsage = () => {
427
+ if (inputUsageComplete)
428
+ progress.inputTokens = result.usage.input;
429
+ else
430
+ delete progress.inputTokens;
431
+ if (outputUsageComplete)
432
+ progress.outputTokens = result.usage.output;
433
+ else
434
+ delete progress.outputTokens;
435
+ if (cacheReadUsageComplete)
436
+ progress.cacheRead = result.usage.cacheRead;
437
+ else
438
+ delete progress.cacheRead;
439
+ if (cacheWriteUsageComplete)
440
+ progress.cacheWrite = result.usage.cacheWrite;
441
+ else
442
+ delete progress.cacheWrite;
443
+ };
444
+ const attemptTimeout = resolveAttemptTimeout(options);
445
+ let timeoutCause;
446
+ if (attemptTimeout?.remainingMs === 0) {
447
+ result.exitCode = 1;
448
+ result.timedOut = true;
449
+ result.error = attemptTimeout.message;
450
+ result.finalOutput = attemptTimeout.message;
451
+ progress.status = "failed";
452
+ progress.error = attemptTimeout.message;
453
+ result.progressSummary = {
454
+ toolCount: progress.toolCount,
455
+ tokens: progress.tokens,
456
+ durationMs: progress.durationMs,
457
+ };
458
+ return result;
459
+ }
460
+ // A machine 'local' child edits this disk, so its local Git evidence is authoritative, as for an unplaced run.
461
+ const mutationCwd = isRexLocalMachine(options.machine) ? options.machine.cwd : options.cwd ?? runtimeCwd;
462
+ const mutationSnapshot = options.machine && !isRexLocalMachine(options.machine) ? { source: "tracked-files", trackedOnly: true, cwd: mutationCwd, dirtyFiles: [], fingerprints: {}, unavailable: "Local Git evidence is not authoritative for a pane-native remote run." } : snapshotTrackedMutations(mutationCwd);
463
+ let structuredOutputToolInvoked = false;
464
+ let structuredOutputMessageStartIndex;
465
+ let toolAvailabilityError;
466
+ let abortedBySignal = options.signal?.aborted === true;
467
+ let afterCompactionSettlement = false;
468
+ if (options.workflowChildPermitLaunch) {
469
+ const permitError = consumeWorkflowChildPermit(options.workflowChildPermitLaunch.permit, {
470
+ workflowRunId: options.workflowChildPermitLaunch.workflowRunId,
471
+ childKey: options.workflowChildPermitLaunch.childKey,
472
+ agent: agent.name,
473
+ launchContractDigest,
474
+ context: options.context ?? "fresh",
475
+ runner: "pi",
476
+ });
477
+ if (permitError) {
478
+ result.exitCode = 1;
479
+ result.error = permitError;
480
+ result.finalOutput = permitError;
481
+ progress.status = "failed";
482
+ progress.error = permitError;
483
+ return result;
484
+ }
485
+ }
486
+ const childSessions = options.childSessionFactory ?? childSessionFactory();
487
+ const partialOutput = createPartialOutputTracker();
488
+ let childPromptFailed = false;
489
+ const exitCode = await new Promise((resolve) => {
490
+ const jsonlWriter = createJsonlWriter(shared.jsonlPath, { pause() { }, resume() { } });
491
+ let session;
492
+ let messageBaseline;
493
+ let unsubscribe;
494
+ let sessionSettled = false;
495
+ let lifecycleFinished = false;
496
+ let detached = false;
497
+ let hostStopReason;
498
+ let intercomStarted = false;
499
+ let assistantError;
500
+ let removeAbortListener;
501
+ let removeInterruptListener;
502
+ let activityTimer;
503
+ let timeoutTimer;
504
+ let timeoutHardFinishTimer;
505
+ const clearTimeoutTimers = () => {
506
+ if (timeoutTimer) {
507
+ clearTimeout(timeoutTimer);
508
+ timeoutTimer = undefined;
509
+ }
510
+ if (timeoutHardFinishTimer) {
511
+ clearTimeout(timeoutHardFinishTimer);
512
+ timeoutHardFinishTimer = undefined;
513
+ }
514
+ };
515
+ const startup = new AbortController();
516
+ const abortChild = () => {
517
+ if (sessionSettled || lifecycleFinished)
518
+ return;
519
+ startup.abort();
520
+ if (!session)
521
+ return;
522
+ void session.abort().catch(() => {
523
+ // The session settles through its prompt promise; abort failures are not separately actionable.
524
+ });
525
+ };
526
+ const detachForeground = (reason) => {
527
+ if (detached || sessionSettled || lifecycleFinished || options.signal?.aborted)
528
+ return false;
529
+ const receiptProgress = snapshotProgress(progress);
530
+ receiptProgress.status = "detached";
531
+ receiptProgress.durationMs = Date.now() - startTime;
532
+ const receipt = snapshotResult(result, receiptProgress);
533
+ receipt.exitCode = -2;
534
+ receipt.detached = true;
535
+ receipt.detachedReason = reason;
536
+ receipt.finalOutput = reason === "intercom coordination"
537
+ ? "Detached for intercom coordination before task completion."
538
+ : reason === "user request"
539
+ ? "Detached at user request before task completion."
540
+ : `Detached for ${reason} before task completion.`;
541
+ receipt.outputMode = options.outputMode ?? "inline";
542
+ if (options.outputPath) {
543
+ receipt.outputSaveError = reason === "user request"
544
+ ? "Output file was not finalized because the subagent detached at user request."
545
+ : `Output file was not finalized because the subagent detached for ${reason}.`;
546
+ }
547
+ receipt.progressSummary = {
548
+ toolCount: receiptProgress.toolCount,
549
+ tokens: receiptProgress.tokens,
550
+ durationMs: receiptProgress.durationMs,
551
+ };
552
+ // The attempt is not detached until the outer coordinator has accepted and
553
+ // synchronously published the receipt. A persistence/callback failure must
554
+ // leave this attempt attached and abortable rather than orphaning it.
555
+ let accepted = false;
556
+ try {
557
+ accepted = options.onDetachReceipt?.(receipt) === true;
558
+ }
559
+ catch {
560
+ return false;
561
+ }
562
+ if (!accepted)
563
+ return false;
564
+ detached = true;
565
+ if (session)
566
+ session.detached = true;
567
+ return true;
568
+ };
569
+ // If the child emits a terminal assistant stop but its run never settles
570
+ // (a hook is stuck), abort it after a short grace period and then finish
571
+ // without it.
572
+ const FINAL_STOP_GRACE_MS = 1000;
573
+ const HARD_FINISH_MS = 3000;
574
+ let forcedTermination = false;
575
+ let cleanTerminalAssistantStopReceived = false;
576
+ let agentSettledReceived = false;
577
+ let queuedDrainHold = false;
578
+ let compactionStartedReceived = false;
579
+ let terminalAgentEndReceived = false;
580
+ let compactionAfterFinalOpen = false;
581
+ let finalDrainTimer;
582
+ let finalHardFinishTimer;
583
+ let watchdogTailTimer;
584
+ let childWatchdogState;
585
+ const updateChildWatchdogState = (snapshot) => {
586
+ childWatchdogState = snapshot;
587
+ result.watchdog = snapshot;
588
+ progress.watchdog = snapshot;
589
+ };
590
+ const clearWatchdogTailTimer = () => {
591
+ if (watchdogTailTimer) {
592
+ clearTimeout(watchdogTailTimer);
593
+ watchdogTailTimer = undefined;
594
+ }
595
+ };
596
+ const clearFinalDrainTimers = () => {
597
+ if (finalDrainTimer) {
598
+ clearTimeout(finalDrainTimer);
599
+ finalDrainTimer = undefined;
600
+ }
601
+ if (finalHardFinishTimer) {
602
+ clearTimeout(finalHardFinishTimer);
603
+ finalHardFinishTimer = undefined;
604
+ }
605
+ };
606
+ const observeQueuedDrainHold = () => {
607
+ if (childSessionHasQueuedMessages(session))
608
+ queuedDrainHold = true;
609
+ return queuedDrainHold;
610
+ };
611
+ const startFinalDrain = () => {
612
+ if (childWatchdogIsActive(childWatchdogState)) {
613
+ armWatchdogTail();
614
+ return;
615
+ }
616
+ if (sessionSettled || finalDrainTimer || lifecycleFinished)
617
+ return;
618
+ if (observeQueuedDrainHold())
619
+ return;
620
+ armFinalDrainTimer();
621
+ };
622
+ const armFinalDrainTimer = () => {
623
+ if (sessionSettled || finalDrainTimer || lifecycleFinished)
624
+ return;
625
+ finalDrainTimer = setTimeout(() => {
626
+ if (lifecycleFinished || sessionSettled)
627
+ return;
628
+ // Pi runs auto-compaction after the final agent_end and only then emits agent_settled.
629
+ if (capture.finalDrainHeld() || observeQueuedDrainHold() || compactionAfterFinalOpen) {
630
+ finalDrainTimer = undefined;
631
+ armFinalDrainTimer();
632
+ return;
633
+ }
634
+ forcedTermination = true;
635
+ if (!cleanTerminalAssistantStopReceived && !agentSettledReceived && !assistantError) {
636
+ result.error = result.error ?? `Subagent session did not settle within ${FINAL_STOP_GRACE_MS}ms after its terminal event. Aborting it.`;
637
+ }
638
+ abortChild();
639
+ finalHardFinishTimer = setTimeout(() => {
640
+ if (lifecycleFinished || sessionSettled)
641
+ return;
642
+ settle(undefined, true);
643
+ }, HARD_FINISH_MS);
644
+ }, FINAL_STOP_GRACE_MS);
645
+ };
646
+ function armWatchdogTail() {
647
+ if ((!cleanTerminalAssistantStopReceived && !agentSettledReceived) || watchdogTailTimer || lifecycleFinished || sessionSettled)
648
+ return;
649
+ watchdogTailTimer = setTimeout(() => {
650
+ watchdogTailTimer = undefined;
651
+ updateChildWatchdogState({
652
+ phase: "stale",
653
+ seq: (childWatchdogState?.seq ?? 0) + 1,
654
+ lastUpdate: Date.now(),
655
+ reason: "child watchdog tail timeout",
656
+ timedOut: true,
657
+ });
658
+ startFinalDrain();
659
+ fireUpdate();
660
+ }, childWatchdog?.watchdogTailTimeoutMs ?? 120_000);
661
+ watchdogTailTimer.unref?.();
662
+ }
663
+ const applyChildLifecycle = (action, event) => {
664
+ if (action === "cancel-drain") {
665
+ // After a clean final stop, a non-retrying agent_end may be the child's last event
666
+ // (Pi may not emit agent_settled), so it re-arms the drain instead of cancelling it.
667
+ terminalAgentEndReceived = event?.type === "agent_end" && event.willRetry !== true && cleanTerminalAssistantStopReceived;
668
+ agentSettledReceived = false;
669
+ clearFinalDrainTimers();
670
+ clearWatchdogTailTimer();
671
+ if (terminalAgentEndReceived) {
672
+ startFinalDrain();
673
+ return;
674
+ }
675
+ cleanTerminalAssistantStopReceived = false;
676
+ compactionAfterFinalOpen = false;
677
+ return;
678
+ }
679
+ if (action === "start-drain")
680
+ startFinalDrain();
681
+ };
682
+ const childLifecycleState = { compactionRetryActive: false };
683
+ const unsubscribeIntercomDetach = options.intercomEvents?.on?.(INTERCOM_DETACH_REQUEST_EVENT, (payload) => {
684
+ if (!options.allowIntercomDetach || sessionSettled)
685
+ return;
686
+ if (!payload || typeof payload !== "object")
687
+ return;
688
+ const event = payload;
689
+ const requestId = event.requestId;
690
+ if (typeof requestId !== "string" || requestId.length === 0)
691
+ return;
692
+ const hasRoute = event.runId !== undefined || event.agent !== undefined || event.childIndex !== undefined;
693
+ if (hasRoute) {
694
+ if (typeof event.runId === "string" && event.runId !== options.runId)
695
+ return;
696
+ if (typeof event.agent === "string" && event.agent !== agent.name)
697
+ return;
698
+ if (typeof event.childIndex === "number" && event.childIndex !== (options.index ?? 0))
699
+ return;
700
+ }
701
+ else if (!intercomStarted)
702
+ return;
703
+ const accepted = detachForeground("intercom coordination");
704
+ options.intercomEvents?.emit(INTERCOM_DETACH_RESPONSE_EVENT, { requestId, accepted, runId: options.runId, agent: agent.name, childIndex: options.index ?? 0 });
705
+ });
706
+ const finish = (code) => {
707
+ if (lifecycleFinished)
708
+ return;
709
+ lifecycleFinished = true;
710
+ clearFinalDrainTimers();
711
+ clearWatchdogTailTimer();
712
+ clearTimeoutTimers();
713
+ clearAllToolTimeouts();
714
+ if (activityTimer) {
715
+ clearInterval(activityTimer);
716
+ activityTimer = undefined;
717
+ }
718
+ unsubscribeIntercomDetach?.();
719
+ removeAbortListener?.();
720
+ removeInterruptListener?.();
721
+ unsubscribe?.();
722
+ onWatchdogStatus = undefined;
723
+ void jsonlWriter.close().catch(() => {
724
+ // JSONL artifact flush is best effort.
725
+ });
726
+ // Report the run only after the child's extensions have shut down.
727
+ void Promise.resolve().then(async () => {
728
+ if (code === 0 && !result.interrupted && !result.timedOut && !result.stopped && !abortedBySignal) {
729
+ try {
730
+ await session?.finishCommands?.();
731
+ }
732
+ catch (error) {
733
+ result.error = error instanceof Error ? error.message : String(error);
734
+ code = 1;
735
+ }
736
+ }
737
+ await session?.dispose();
738
+ }).catch(() => undefined).then(() => {
739
+ resolve(code);
740
+ });
741
+ };
742
+ const drainPendingControlEvents = () => {
743
+ if (pendingControlEvents.length === 0)
744
+ return undefined;
745
+ const events = pendingControlEvents;
746
+ pendingControlEvents = [];
747
+ return events;
748
+ };
749
+ let activeLongRunningNotified = false;
750
+ const pendingToolResultsByCallId = new Map();
751
+ let pendingToolResult;
752
+ // Pi host versions may represent one tool result as either a dedicated
753
+ // tool_result_end event or a message_end whose message role is toolResult.
754
+ // Remember correlated ids so normalizing both forms cannot duplicate output.
755
+ const handledToolResultIds = new Set();
756
+ const MAX_HANDLED_TOOL_RESULT_IDS = 1024;
757
+ let activeToolSequence = 0;
758
+ const activeToolCalls = new Map();
759
+ const activeToolKeysByName = new Map();
760
+ const latestActiveToolCall = () => [...activeToolCalls.values()].sort((left, right) => right.startedAt - left.startedAt)[0];
761
+ const refreshCurrentTool = () => {
762
+ const active = latestActiveToolCall();
763
+ if (!active) {
764
+ progress.currentTool = undefined;
765
+ progress.currentToolArgs = undefined;
766
+ progress.currentToolStartedAt = undefined;
767
+ progress.currentPath = undefined;
768
+ return;
769
+ }
770
+ progress.currentTool = active.tool;
771
+ progress.currentToolArgs = active.args;
772
+ progress.currentToolStartedAt = active.startedAt;
773
+ progress.currentPath = active.path;
774
+ };
775
+ const recordActiveToolCall = (event, args, now) => {
776
+ const key = toolTimeoutCallKey(event, ++activeToolSequence);
777
+ const path = resolveCurrentPath(event.toolName, args);
778
+ const active = {
779
+ key,
780
+ tool: event.toolName,
781
+ args: extractToolArgsPreview(args),
782
+ startedAt: now,
783
+ ...(path !== undefined ? { path } : {}),
784
+ };
785
+ activeToolCalls.set(key, active);
786
+ const keys = activeToolKeysByName.get(active.tool) ?? [];
787
+ keys.push(key);
788
+ activeToolKeysByName.set(active.tool, keys);
789
+ refreshCurrentTool();
790
+ return active;
791
+ };
792
+ const removeActiveToolCallKey = (key) => {
793
+ const active = activeToolCalls.get(key);
794
+ if (!active)
795
+ return undefined;
796
+ activeToolCalls.delete(key);
797
+ const keys = activeToolKeysByName.get(active.tool)?.filter((candidate) => candidate !== key) ?? [];
798
+ if (keys.length > 0)
799
+ activeToolKeysByName.set(active.tool, keys);
800
+ else
801
+ activeToolKeysByName.delete(active.tool);
802
+ return active;
803
+ };
804
+ const removeActiveToolCall = (event) => {
805
+ const key = typeof event.toolCallId === "string" && event.toolCallId.length > 0
806
+ ? `id:${event.toolCallId}`
807
+ : typeof event.toolName === "string"
808
+ ? activeToolKeysByName.get(event.toolName)?.[0]
809
+ : activeToolCalls.size === 1
810
+ ? [...activeToolCalls.keys()][0]
811
+ : undefined;
812
+ return key ? removeActiveToolCallKey(key) : undefined;
813
+ };
814
+ const openToolAttentionTarget = (now) => [...activeToolCalls.values()]
815
+ .filter((active) => !active.attentionEmitted && shouldEmitOpenToolAttention({ config: controlConfig, currentTool: active.tool, currentToolStartedAt: active.startedAt, now }))
816
+ .sort((left, right) => left.startedAt - right.startedAt)[0];
817
+ const mutatingFailures = createMutatingFailureState();
818
+ const mutatingFailureWindowMs = 5 * 60_000;
819
+ const currentToolDurationMs = (now) => progress.currentToolStartedAt ? Math.max(0, now - progress.currentToolStartedAt) : undefined;
820
+ const emitNeedsAttention = (now, input = {}) => {
821
+ if (!controlConfig.enabled)
822
+ return false;
823
+ const previous = progress.activityState;
824
+ progress.activityState = "needs_attention";
825
+ const event = buildControlEvent({
826
+ type: "needs_attention",
827
+ from: previous,
828
+ to: "needs_attention",
829
+ runId: options.runId,
830
+ agent: agent.name,
831
+ index: options.index,
832
+ ts: now,
833
+ lastActivityAt: progress.lastActivityAt,
834
+ message: input.message,
835
+ reason: input.reason ?? "idle",
836
+ turns: result.usage.turns,
837
+ tokens: progress.tokens,
838
+ toolCount: progress.toolCount,
839
+ currentTool: input.currentTool ?? progress.currentTool,
840
+ toolCallId: input.toolCallId,
841
+ hasCommandController: input.hasCommandController,
842
+ currentToolDurationMs: input.currentToolDurationMs ?? currentToolDurationMs(now),
843
+ currentPath: input.currentPath ?? progress.currentPath,
844
+ recentFailureSummary: input.recentFailureSummary,
845
+ taskPreview: task,
846
+ });
847
+ emitControlEvent(event);
848
+ return previous !== "needs_attention" || input.reason === "tool_open_threshold";
849
+ };
850
+ const emitActiveLongRunning = (now, reason) => {
851
+ if (!controlConfig.enabled || activeLongRunningNotified || progress.activityState === "needs_attention")
852
+ return false;
853
+ activeLongRunningNotified = true;
854
+ const previous = progress.activityState;
855
+ progress.activityState = "active_long_running";
856
+ emitControlEvent(buildControlEvent({
857
+ type: "active_long_running",
858
+ from: previous,
859
+ to: "active_long_running",
860
+ runId: options.runId,
861
+ agent: agent.name,
862
+ index: options.index,
863
+ ts: now,
864
+ message: `${agent.name} is still active but long-running`,
865
+ reason,
866
+ turns: result.usage.turns,
867
+ tokens: progress.tokens,
868
+ toolCount: progress.toolCount,
869
+ currentTool: progress.currentTool,
870
+ currentToolDurationMs: currentToolDurationMs(now),
871
+ currentPath: progress.currentPath,
872
+ elapsedMs: now - startTime,
873
+ taskPreview: task,
874
+ }));
875
+ return true;
876
+ };
877
+ const updateActivityState = (now) => {
878
+ if (!controlConfig.enabled)
879
+ return false;
880
+ const idleState = deriveActivityState({
881
+ config: controlConfig,
882
+ startedAt: startTime,
883
+ lastActivityAt: progress.lastActivityAt,
884
+ turnCount: progress.turnCount,
885
+ currentTool: progress.currentTool,
886
+ thinking: resolvedThinking,
887
+ now,
888
+ });
889
+ if (idleState === "needs_attention") {
890
+ return progress.activityState === "needs_attention" ? false : emitNeedsAttention(now);
891
+ }
892
+ const toolAttentionTarget = openToolAttentionTarget(now);
893
+ if (toolAttentionTarget) {
894
+ toolAttentionTarget.attentionEmitted = true;
895
+ const durationMs = Math.max(0, now - toolAttentionTarget.startedAt);
896
+ const toolCallId = toolAttentionTarget.key.startsWith("id:") ? toolAttentionTarget.key.slice(3) : undefined;
897
+ return emitNeedsAttention(now, {
898
+ message: `${agent.name} has had tool '${toolAttentionTarget.tool}' open for ${Math.floor(durationMs / 1000)}s`,
899
+ reason: "tool_open_threshold",
900
+ currentTool: toolAttentionTarget.tool,
901
+ toolCallId,
902
+ hasCommandController: Boolean(toolCallId && retainsChildCommand(supervisorChannelDir(options.runId, agent.name, options.index ?? 0), toolCallId)),
903
+ currentPath: toolAttentionTarget.path,
904
+ currentToolDurationMs: durationMs,
905
+ });
906
+ }
907
+ const activeReason = nextLongRunningTrigger(controlConfig, {
908
+ startedAt: startTime,
909
+ now,
910
+ turns: result.usage.turns,
911
+ tokens: progress.tokens,
912
+ });
913
+ return activeReason ? emitActiveLongRunning(now, activeReason) : false;
914
+ };
915
+ let lastStructuredDelegationProgressState;
916
+ const emitUpdateSnapshot = (text) => {
917
+ if (!options.onUpdate || sessionSettled)
918
+ return;
919
+ const progressSnapshot = snapshotProgress(progress);
920
+ const resultSnapshot = snapshotStreamResult(result, progressSnapshot);
921
+ const controlEvents = drainPendingControlEvents();
922
+ options.onUpdate({
923
+ content: [{ type: "text", text }],
924
+ details: {
925
+ mode: "single",
926
+ results: [resultSnapshot],
927
+ progress: [progressSnapshot],
928
+ controlEvents,
929
+ },
930
+ });
931
+ };
932
+ const fireUpdate = () => {
933
+ if (!options.onUpdate || sessionSettled)
934
+ return;
935
+ progress.durationMs = Date.now() - startTime;
936
+ if (options.suppressUnchangedDelegationUpdates) {
937
+ if (lastStructuredDelegationProgressState && !structuredDelegationProgressChanged(lastStructuredDelegationProgressState, progress, result))
938
+ return;
939
+ lastStructuredDelegationProgressState = captureStructuredDelegationProgressState(progress, result);
940
+ }
941
+ const output = result.timedOut && result.finalOutput ? result.finalOutput : getFinalOutput(result.messages ?? []);
942
+ emitUpdateSnapshot(output || "(running...)");
943
+ };
944
+ // Fork: shared, id-deduplicated tool-result completion. Pi hosts may
945
+ // deliver the same result either as a tool_result_end event or as a
946
+ // message_end whose message role is toolResult; both funnel through here
947
+ // so one result updates budget, output, and mutating-failure state once.
948
+ const handleToolResult = (message, completion, now) => {
949
+ const rawCallId = completion.toolCallId ?? message.toolCallId;
950
+ const callId = typeof rawCallId === "string" && rawCallId.length > 0 ? rawCallId : undefined;
951
+ if (callId) {
952
+ if (handledToolResultIds.has(callId))
953
+ return;
954
+ if (handledToolResultIds.size >= MAX_HANDLED_TOOL_RESULT_IDS) {
955
+ const oldest = handledToolResultIds.values().next().value;
956
+ if (typeof oldest === "string")
957
+ handledToolResultIds.delete(oldest);
958
+ }
959
+ handledToolResultIds.add(callId);
960
+ }
961
+ result.messages.push(message);
962
+ const resultText = extractTextFromContent(message.content);
963
+ const keyedSnapshot = callId ? pendingToolResultsByCallId.get(callId) : undefined;
964
+ if (callId && keyedSnapshot)
965
+ pendingToolResultsByCallId.delete(callId);
966
+ const toolSnapshot = keyedSnapshot ?? pendingToolResult;
967
+ if (!keyedSnapshot || pendingToolResult === keyedSnapshot)
968
+ pendingToolResult = undefined;
969
+ // The result event's own tool name is authoritative; the snapshot is a fallback.
970
+ const resultToolName = completion.toolName ?? message.toolName;
971
+ const blockedTool = (typeof resultToolName === "string" && resultToolName.length > 0
972
+ ? resultToolName
973
+ : undefined) ?? toolSnapshot?.tool;
974
+ const budgetBlocked = Boolean(options.toolBudget && isToolBudgetBlockedMessage(options.toolBudget, resultText, blockedTool));
975
+ if (options.toolBudget && budgetBlocked) {
976
+ result.toolBudgetBlocked = true;
977
+ result.toolBudget = toolBudgetState(options.toolBudget, Math.max(progress.toolCount, options.toolBudget.hard + 1), blockedTool);
978
+ }
979
+ appendRecentOutput(progress, resultText.split("\n").slice(-10));
980
+ if (toolSnapshot?.mutates && !budgetBlocked && message.role === "toolResult" && didMutatingToolFail(message)) {
981
+ recordMutatingFailure(mutatingFailures, {
982
+ tool: toolSnapshot.tool,
983
+ path: toolSnapshot.path,
984
+ error: resultText.split("\n").find((line) => line.trim())?.trim().slice(0, 180) ?? "mutating tool failed",
985
+ ts: now,
986
+ }, mutatingFailureWindowMs);
987
+ if (shouldEscalateMutatingFailures(mutatingFailures, controlConfig.failedToolAttemptsBeforeAttention)) {
988
+ emitNeedsAttention(now, {
989
+ message: `${agent.name} needs attention after repeated mutating tool failures`,
990
+ reason: "tool_failures",
991
+ currentTool: toolSnapshot.tool,
992
+ currentPath: toolSnapshot.path,
993
+ currentToolDurationMs: toolSnapshot.startedAt ? Math.max(0, now - toolSnapshot.startedAt) : undefined,
994
+ recentFailureSummary: summarizeRecentMutatingFailures(mutatingFailures),
995
+ });
996
+ }
997
+ }
998
+ else if (toolSnapshot?.mutates) {
999
+ resetMutatingFailureState(mutatingFailures);
1000
+ }
1001
+ fireUpdate();
1002
+ };
1003
+ const processEvent = (evt) => {
1004
+ if (lifecycleFinished)
1005
+ return;
1006
+ partialOutput.observe(evt);
1007
+ jsonlWriter.writeLine(JSON.stringify(projectChildSessionEventForJson(evt)));
1008
+ shared.transcriptWriter?.writeChildEvent(evt);
1009
+ shared.orcaProgressTab?.event(evt);
1010
+ if (evt.type === "compaction_start") {
1011
+ compactionStartedReceived = true;
1012
+ if (agentSettledReceived)
1013
+ afterCompactionSettlement = true;
1014
+ if (terminalAgentEndReceived)
1015
+ compactionAfterFinalOpen = true;
1016
+ }
1017
+ if (evt.type === "compaction_end" && evt.willRetry === true) {
1018
+ compactionStartedReceived = false;
1019
+ afterCompactionSettlement = false;
1020
+ }
1021
+ if (evt.type === "compaction_end" && evt.willRetry !== true && compactionAfterFinalOpen) {
1022
+ compactionAfterFinalOpen = false;
1023
+ clearFinalDrainTimers();
1024
+ startFinalDrain();
1025
+ }
1026
+ if (evt.type === "turn_start" || evt.type === "agent_start" || evt.type === "auto_retry_start") {
1027
+ queuedDrainHold = false;
1028
+ }
1029
+ if (evt.type === "agent_start" || evt.type === "auto_retry_start") {
1030
+ compactionStartedReceived = false;
1031
+ afterCompactionSettlement = false;
1032
+ }
1033
+ if (evt.type === "agent_start") {
1034
+ const diagnostic = capture.toolDiagnostic();
1035
+ if (diagnostic) {
1036
+ const message = formatChildToolDiagnostic(diagnostic, { host: "parent" });
1037
+ toolAvailabilityError = message;
1038
+ result.error = message;
1039
+ result.finalOutput = message;
1040
+ progress.status = "failed";
1041
+ progress.error = message;
1042
+ fireUpdate();
1043
+ abortChild();
1044
+ return;
1045
+ }
1046
+ }
1047
+ const lifecycleAction = projectChildLifecycle(evt, false, childLifecycleState);
1048
+ if (evt.type === "agent_settled" && lifecycleAction === "start-drain") {
1049
+ agentSettledReceived = true;
1050
+ afterCompactionSettlement = compactionStartedReceived;
1051
+ }
1052
+ applyChildLifecycle(lifecycleAction, evt);
1053
+ if (isChildWatchdogStatusEvent(evt)) {
1054
+ if (!childWatchdog)
1055
+ return;
1056
+ const next = acceptChildWatchdogEvent({
1057
+ current: childWatchdogState,
1058
+ event: evt,
1059
+ runId: options.runId,
1060
+ agent: agent.name,
1061
+ childIndex: options.index ?? 0,
1062
+ });
1063
+ if (!next)
1064
+ return;
1065
+ updateChildWatchdogState(next);
1066
+ if (childWatchdogIsActive(next)) {
1067
+ clearFinalDrainTimers();
1068
+ armWatchdogTail();
1069
+ }
1070
+ else {
1071
+ clearWatchdogTailTimer();
1072
+ if (cleanTerminalAssistantStopReceived || agentSettledReceived)
1073
+ startFinalDrain();
1074
+ }
1075
+ fireUpdate();
1076
+ return;
1077
+ }
1078
+ const now = Date.now();
1079
+ const providerDiagnostics = observeProviderDiagnostics(result.providerDiagnostics, evt, now);
1080
+ if (providerDiagnostics !== result.providerDiagnostics) {
1081
+ result.providerDiagnostics = providerDiagnostics;
1082
+ progress.providerDiagnostics = providerDiagnostics;
1083
+ // message_end already emits synchronously below; retry-only transitions need their own update.
1084
+ if (evt.type !== "message_end")
1085
+ fireUpdate();
1086
+ }
1087
+ progress.durationMs = now - startTime;
1088
+ progress.lastActivityAt = now;
1089
+ updateActivityState(now);
1090
+ if (evt.type === "tool_execution_start") {
1091
+ const toolArgs = evt.args && typeof evt.args === "object" && !Array.isArray(evt.args)
1092
+ ? evt.args
1093
+ : {};
1094
+ const activeTool = evt.toolName !== undefined ? recordActiveToolCall(evt, toolArgs, now) : undefined;
1095
+ if (evt.toolName !== undefined)
1096
+ armToolTimeout(evt);
1097
+ if (options.structuredOutput && evt.toolName === "structured_output") {
1098
+ structuredOutputToolInvoked = true;
1099
+ structuredOutputMessageStartIndex = result.messages?.length ?? 0;
1100
+ }
1101
+ if (options.allowIntercomDetach && (evt.toolName === "intercom" || evt.toolName === "contact_supervisor")) {
1102
+ intercomStarted = true;
1103
+ }
1104
+ progress.toolCount++;
1105
+ if (options.toolBudget) {
1106
+ result.toolBudget = toolBudgetState(options.toolBudget, progress.toolCount, result.toolBudget?.blockedTool);
1107
+ }
1108
+ const mutates = isMutatingTool(evt.toolName, toolArgs, agent.mutationTools);
1109
+ pendingToolResult = { tool: evt.toolName ?? "tool", path: activeTool?.path, mutates, startedAt: now };
1110
+ if (typeof evt.toolCallId === "string" && evt.toolCallId)
1111
+ pendingToolResultsByCallId.set(evt.toolCallId, pendingToolResult);
1112
+ fireUpdate();
1113
+ }
1114
+ if (evt.type === "tool_execution_end") {
1115
+ clearActiveToolTimeout(evt);
1116
+ const endedTool = removeActiveToolCall(evt);
1117
+ if (endedTool) {
1118
+ progress.recentTools.push({
1119
+ tool: endedTool.tool,
1120
+ args: endedTool.args,
1121
+ endMs: now,
1122
+ });
1123
+ }
1124
+ refreshCurrentTool();
1125
+ fireUpdate();
1126
+ }
1127
+ if (evt.type === "message_end" && evt.message) {
1128
+ if (evt.message.role === "toolResult") {
1129
+ // Fork: hosts that deliver tool results as message_end instead of
1130
+ // tool_result_end reach the same deduplicated completion path.
1131
+ handleToolResult(evt.message, evt, now);
1132
+ }
1133
+ else {
1134
+ result.messages.push(evt.message);
1135
+ if (childWatchdog) {
1136
+ const next = applyChildWatchdogMessage(childWatchdogState, evt.message);
1137
+ if (next)
1138
+ updateChildWatchdogState(next);
1139
+ }
1140
+ if (evt.message.role === "assistant") {
1141
+ result.usage.turns++;
1142
+ progress.turnCount = result.usage.turns;
1143
+ const toolCalls = Array.isArray(evt.message.content)
1144
+ ? evt.message.content.filter((part) => part.type === "toolCall")
1145
+ : [];
1146
+ const hasToolCall = toolCalls.length > 0;
1147
+ const terminalAssistantStop = evt.message.stopReason === "stop" && !hasToolCall;
1148
+ const u = evt.message.usage;
1149
+ inputUsageComplete &&= isCompleteUsageCounter(u?.input);
1150
+ outputUsageComplete &&= isCompleteUsageCounter(u?.output);
1151
+ cacheReadUsageComplete &&= isCompleteUsageCounter(u?.cacheRead);
1152
+ cacheWriteUsageComplete &&= isCompleteUsageCounter(u?.cacheWrite);
1153
+ if (u) {
1154
+ const window = (u.input || 0) + (u.cacheRead || 0);
1155
+ result.usage.input += u.input || 0;
1156
+ result.usage.output += u.output || 0;
1157
+ result.usage.cacheRead += u.cacheRead || 0;
1158
+ result.usage.cacheWrite += u.cacheWrite || 0;
1159
+ result.usage.cost += u.cost?.total || 0;
1160
+ progress.tokens = result.usage.input + result.usage.output;
1161
+ progress.window = window;
1162
+ progress.windowPeak = Math.max(progress.windowPeak ?? 0, window);
1163
+ }
1164
+ projectCompleteUsage();
1165
+ if (evt.message.model) {
1166
+ const observedModel = qualifyModelWithProvider(evt.message.model, evt.message.provider, options.availableModels);
1167
+ progress.model = observedModel;
1168
+ if (!result.model)
1169
+ result.model = observedModel;
1170
+ if (expectedModelForVerification && !hasToolCall) {
1171
+ const modelVerificationError = formatSubagentModelVerificationError(expectedModelForVerification, evt.message.model, options.availableModels, options.modelResponseAliases, session?.virtualModelId);
1172
+ if (modelVerificationError && !result.error)
1173
+ result.error = modelVerificationError;
1174
+ }
1175
+ }
1176
+ if (evt.message.errorMessage)
1177
+ assistantError = assistantMessageError(evt.message);
1178
+ else if (hasToolCall && evt.message.stopReason === "toolUse") {
1179
+ // A recovered request can finish via a terminating tool, without a text stop.
1180
+ assistantError = undefined;
1181
+ }
1182
+ const assistantText = extractTextFromContent(evt.message.content);
1183
+ appendRecentOutput(progress, assistantText.split("\n").slice(-10));
1184
+ // Final assistant message: start the settle drain window.
1185
+ if (terminalAssistantStop) {
1186
+ if (!evt.message.errorMessage && assistantText.trim())
1187
+ assistantError = undefined;
1188
+ cleanTerminalAssistantStopReceived ||= !evt.message.errorMessage;
1189
+ clearAllToolTimeouts();
1190
+ activeToolCalls.clear();
1191
+ activeToolKeysByName.clear();
1192
+ refreshCurrentTool();
1193
+ applyChildLifecycle(projectChildLifecycle(evt, true, childLifecycleState));
1194
+ }
1195
+ }
1196
+ updateActivityState(now);
1197
+ fireUpdate();
1198
+ }
1199
+ }
1200
+ if (evt.type === "tool_result_end" && evt.message) {
1201
+ const toolResultCompletion = {
1202
+ toolCallId: evt.message.toolCallId ?? evt.toolCallId,
1203
+ toolName: evt.message.toolName ?? evt.toolName,
1204
+ };
1205
+ clearActiveToolTimeout(toolResultCompletion);
1206
+ const endedTool = removeActiveToolCall(toolResultCompletion);
1207
+ if (endedTool) {
1208
+ progress.recentTools.push({
1209
+ tool: endedTool.tool,
1210
+ args: endedTool.args,
1211
+ endMs: now,
1212
+ });
1213
+ refreshCurrentTool();
1214
+ }
1215
+ // Fork: the shared, id-deduplicated tail (message push, budget,
1216
+ // mutating-failure tracking, output) lives in handleToolResult; hosts
1217
+ // may deliver the same result via message_end(role=toolResult).
1218
+ handleToolResult(evt.message, toolResultCompletion, now);
1219
+ }
1220
+ };
1221
+ // SAFETY: this callback is only ever invoked with child-watchdog status events
1222
+ // (declared as ChildWatchdogStatusEvent above); those carry the session-event
1223
+ // fields `processEvent` needs, and `processEvent` re-validates the shape with
1224
+ // `isChildWatchdogStatusEvent` before touching watchdog-specific fields.
1225
+ onWatchdogStatus = (event) => processEvent(event);
1226
+ fireUpdate();
1227
+ if (controlConfig.enabled || options.onUpdate) {
1228
+ activityTimer = setInterval(() => {
1229
+ if (sessionSettled || lifecycleFinished) {
1230
+ return;
1231
+ }
1232
+ updateActivityState(Date.now());
1233
+ fireUpdate();
1234
+ }, 1000);
1235
+ activityTimer.unref?.();
1236
+ }
1237
+ if (attemptTimeout) {
1238
+ timeoutTimer = setTimeout(() => {
1239
+ if (sessionSettled || lifecycleFinished || interruptedByControl || result.timedOut)
1240
+ return;
1241
+ result.timedOut = true;
1242
+ timeoutCause = attemptTimeout.message;
1243
+ clearAllToolTimeouts();
1244
+ result.error = attemptTimeout.message;
1245
+ result.finalOutput = attemptTimeout.message;
1246
+ progress.status = "failed";
1247
+ progress.error = attemptTimeout.message;
1248
+ progress.durationMs = Date.now() - startTime;
1249
+ fireUpdate();
1250
+ abortChild();
1251
+ timeoutHardFinishTimer = setTimeout(() => {
1252
+ if (sessionSettled || lifecycleFinished)
1253
+ return;
1254
+ settle(undefined, true);
1255
+ }, 4000);
1256
+ timeoutHardFinishTimer.unref?.();
1257
+ }, attemptTimeout.remainingMs);
1258
+ timeoutTimer.unref?.();
1259
+ }
1260
+ let toolTimeoutSequence = 0;
1261
+ const activeToolTimeouts = new Map();
1262
+ const activeToolTimeoutKeysByName = new Map();
1263
+ let toolTimeoutHardFinishTimer;
1264
+ const removeToolTimeoutKey = (key) => {
1265
+ const active = activeToolTimeouts.get(key);
1266
+ if (!active)
1267
+ return;
1268
+ clearTimeout(active.timer);
1269
+ activeToolTimeouts.delete(key);
1270
+ const keys = activeToolTimeoutKeysByName.get(active.toolName)?.filter((candidate) => candidate !== key) ?? [];
1271
+ if (keys.length > 0)
1272
+ activeToolTimeoutKeysByName.set(active.toolName, keys);
1273
+ else
1274
+ activeToolTimeoutKeysByName.delete(active.toolName);
1275
+ };
1276
+ const clearActiveToolTimeout = (event) => {
1277
+ const key = typeof event.toolCallId === "string" && event.toolCallId.length > 0
1278
+ ? `id:${event.toolCallId}`
1279
+ : typeof event.toolName === "string"
1280
+ ? activeToolTimeoutKeysByName.get(event.toolName)?.[0]
1281
+ : activeToolTimeouts.size === 1
1282
+ ? [...activeToolTimeouts.keys()][0]
1283
+ : undefined;
1284
+ if (key)
1285
+ removeToolTimeoutKey(key);
1286
+ };
1287
+ const clearAllToolTimeouts = () => {
1288
+ for (const key of [...activeToolTimeouts.keys()])
1289
+ removeToolTimeoutKey(key);
1290
+ if (toolTimeoutHardFinishTimer) {
1291
+ clearTimeout(toolTimeoutHardFinishTimer);
1292
+ toolTimeoutHardFinishTimer = undefined;
1293
+ }
1294
+ };
1295
+ const terminateForToolTimeout = (message) => {
1296
+ if (sessionSettled || lifecycleFinished || interruptedByControl || result.timedOut)
1297
+ return;
1298
+ clearTimeout(timeoutTimer);
1299
+ result.timedOut = true;
1300
+ timeoutCause = message;
1301
+ result.error = message;
1302
+ result.finalOutput = message;
1303
+ progress.status = "failed";
1304
+ progress.error = message;
1305
+ progress.durationMs = Date.now() - startTime;
1306
+ fireUpdate();
1307
+ abortChild();
1308
+ toolTimeoutHardFinishTimer = setTimeout(() => {
1309
+ if (sessionSettled || lifecycleFinished)
1310
+ return;
1311
+ settle(undefined, true);
1312
+ }, 4000);
1313
+ toolTimeoutHardFinishTimer.unref?.();
1314
+ };
1315
+ const armToolTimeout = (event) => {
1316
+ const timeoutForTool = effectiveToolTimeoutMs(event.toolName, options.toolTimeoutMs);
1317
+ if (timeoutForTool === undefined)
1318
+ return;
1319
+ const elapsed = Date.now() - startTime;
1320
+ const runRemaining = attemptTimeout ? Math.max(0, attemptTimeout.remainingMs - elapsed) : undefined;
1321
+ if (runRemaining !== undefined && timeoutForTool >= runRemaining)
1322
+ return;
1323
+ const key = toolTimeoutCallKey(event, ++toolTimeoutSequence);
1324
+ const toolName = event.toolName;
1325
+ const timer = setTimeout(() => {
1326
+ removeToolTimeoutKey(key);
1327
+ terminateForToolTimeout(formatToolTimeoutMessage(toolName, timeoutForTool));
1328
+ }, timeoutForTool);
1329
+ timer.unref?.();
1330
+ activeToolTimeouts.set(key, { toolName, timer });
1331
+ const keys = activeToolTimeoutKeysByName.get(toolName) ?? [];
1332
+ keys.push(key);
1333
+ activeToolTimeoutKeysByName.set(toolName, keys);
1334
+ };
1335
+ /** The child run ended (or was forced to end); fold in the captures and finish. */
1336
+ const settle = (promptError, forced = false) => {
1337
+ if (lifecycleFinished || sessionSettled)
1338
+ return;
1339
+ sessionSettled = true;
1340
+ clearFinalDrainTimers();
1341
+ const diagnostic = capture.toolDiagnostic();
1342
+ const toolDiagnosticError = diagnostic ? formatChildToolDiagnostic(diagnostic, { host: "parent" }) : undefined;
1343
+ toolAvailabilityError = toolDiagnosticError;
1344
+ result.runtimeAcknowledgedExtensions = capture.runtimeAcknowledgedExtensions();
1345
+ if (session?.machineEvidence)
1346
+ result.nativeMachine = { provider: session.machineEvidence.provider, machineId: session.machineEvidence.machineId, ...(session.machineEvidence.initial ? { initialGit: session.machineEvidence.initial } : {}), ...(session.machineEvidence.final ? { finalGit: session.machineEvidence.final } : {}) };
1347
+ let closeError = result.error ?? toolDiagnosticError ?? assistantError;
1348
+ const promptErrorMessage = promptError === undefined ? undefined : promptError instanceof Error ? promptError.message : String(promptError);
1349
+ if (promptError !== undefined)
1350
+ childPromptFailed = true;
1351
+ if (!closeError && promptErrorMessage !== undefined) {
1352
+ closeError = promptErrorMessage;
1353
+ }
1354
+ // A foreground child never loads the parent's ambient extensions. A model
1355
+ // whose provider the parent registry does not serve resolves as "not found"
1356
+ // before the child starts; a provider it does serve is inherited without its
1357
+ // extension's session hooks and can fail the first request. Keep the
1358
+ // original error first and add the host rule and remedies after it.
1359
+ if (promptErrorMessage !== undefined
1360
+ && closeError === promptErrorMessage
1361
+ && isChildModelResolutionFailure(promptErrorMessage)
1362
+ && (result.messages?.length ?? 0) === 0
1363
+ && result.usage.turns === 0
1364
+ && !launch.session.ambientExtensions) {
1365
+ closeError = `${promptErrorMessage}\n\n${formatChildModelResolutionDiagnostic({ agent: agent.name, model: launch.session.model, host: "parent", capabilityCeiling: launch.toolPlan.capabilityCeiling })}`;
1366
+ }
1367
+ else if (session?.inheritedProvider
1368
+ && closeError !== undefined
1369
+ && (closeError === promptErrorMessage || closeError === assistantError)
1370
+ && progress.toolCount === 0
1371
+ && (result.messages ?? []).every((message) => message.role !== "assistant" || message.stopReason === "error")) {
1372
+ closeError = `${closeError}\n\n${formatInheritedProviderDiagnostic({ agent: agent.name, model: launch.session.model, provider: session.inheritedProvider, capabilityCeiling: launch.toolPlan.capabilityCeiling })}`;
1373
+ }
1374
+ const forcedDrainAfterFinalSuccess = (forced || forcedTermination) && (cleanTerminalAssistantStopReceived || agentSettledReceived) && !closeError;
1375
+ const forcedDrainAfterEmptyTerminal = forcedDrainAfterFinalSuccess && hasEmptyTerminalAssistantResponse(result.messages ?? []);
1376
+ if (!closeError && (abortedBySignal || session?.shutDown || hostStopReason) && !result.interrupted && !result.timedOut) {
1377
+ closeError = hostStopReason ?? (session?.shutDown ? "Subagent stopped because the parent session shut down." : STOPPED_BEFORE_COMPLETION_ERROR);
1378
+ }
1379
+ if (hostStopReason && !result.interrupted && !result.timedOut)
1380
+ result.stopped = true;
1381
+ // A workflow child ended by the workflow's abort signal was stopped, not failed.
1382
+ if (options.abortedAsStopped && abortedBySignal && !session?.shutDown && !result.interrupted && !result.timedOut)
1383
+ result.stopped = true;
1384
+ if (!closeError && forced && !forcedDrainAfterFinalSuccess) {
1385
+ closeError = "Subagent session did not settle after it was aborted.";
1386
+ }
1387
+ const finalCode = forcedDrainAfterFinalSuccess && !forcedDrainAfterEmptyTerminal ? 0 : closeError || promptError !== undefined ? 1 : 0;
1388
+ if (!result.error && closeError)
1389
+ result.error = closeError;
1390
+ if (session && messageBaseline !== undefined) {
1391
+ result.usage = reconcileAttemptUsage(result.usage, session.messages, messageBaseline);
1392
+ progress.tokens = result.usage.input + result.usage.output;
1393
+ projectCompleteUsage();
1394
+ progress.turnCount = result.usage.turns;
1395
+ }
1396
+ finish(finalCode);
1397
+ };
1398
+ if (options.signal) {
1399
+ const kill = () => {
1400
+ if (sessionSettled || lifecycleFinished)
1401
+ return;
1402
+ abortedBySignal = true;
1403
+ abortChild();
1404
+ const hardTimer = setTimeout(() => {
1405
+ if (sessionSettled || lifecycleFinished)
1406
+ return;
1407
+ settle(undefined, true);
1408
+ }, 3000);
1409
+ hardTimer.unref?.();
1410
+ };
1411
+ if (options.signal.aborted)
1412
+ kill();
1413
+ else {
1414
+ options.signal.addEventListener("abort", kill, { once: true });
1415
+ removeAbortListener = () => options.signal?.removeEventListener("abort", kill);
1416
+ }
1417
+ }
1418
+ if (options.interruptSignal) {
1419
+ const interrupt = () => {
1420
+ if (sessionSettled || lifecycleFinished)
1421
+ return;
1422
+ if (result.timedOut)
1423
+ return;
1424
+ interruptedByControl = true;
1425
+ clearTimeoutTimers();
1426
+ clearAllToolTimeouts();
1427
+ progress.status = "running";
1428
+ progress.durationMs = Date.now() - startTime;
1429
+ result.interrupted = true;
1430
+ result.finalOutput = "Interrupted. Waiting for explicit next action.";
1431
+ progress.activityState = undefined;
1432
+ fireUpdate();
1433
+ abortChild();
1434
+ const hardTimer = setTimeout(() => {
1435
+ if (sessionSettled || lifecycleFinished)
1436
+ return;
1437
+ settle(undefined, true);
1438
+ }, 3000);
1439
+ hardTimer.unref?.();
1440
+ };
1441
+ if (options.interruptSignal.aborted)
1442
+ interrupt();
1443
+ else {
1444
+ options.interruptSignal.addEventListener("abort", interrupt, { once: true });
1445
+ removeInterruptListener = () => options.interruptSignal?.removeEventListener("abort", interrupt);
1446
+ }
1447
+ }
1448
+ // Publish only after every callback and cleanup guard captured by detach or
1449
+ // later lifecycle events has initialized. Consumers may invoke synchronously.
1450
+ try {
1451
+ options.onDetachReady?.((reason = "user request") => detachForeground(reason));
1452
+ }
1453
+ catch (error) {
1454
+ // A consumer callback is advisory. Keep the child attached and observable
1455
+ // rather than rejecting this attempt and orphaning its live session.
1456
+ appendRecentOutput(progress, [`Foreground detach callback failed: ${error instanceof Error ? error.message : String(error)}`]);
1457
+ }
1458
+ void (async () => {
1459
+ try {
1460
+ const input = createReportedChildSessionInput(launch, shared.transcriptWriter);
1461
+ input.signal = startup.signal;
1462
+ const created = await childSessions.create(input);
1463
+ if (lifecycleFinished) {
1464
+ void created.dispose();
1465
+ return;
1466
+ }
1467
+ session = created;
1468
+ const steer = created.steer.bind(created);
1469
+ const followUp = created.followUp.bind(created);
1470
+ created.steer = async (text) => {
1471
+ if (cleanTerminalAssistantStopReceived || agentSettledReceived)
1472
+ queuedDrainHold = true;
1473
+ return steer(text);
1474
+ };
1475
+ created.followUp = async (text) => {
1476
+ if (cleanTerminalAssistantStopReceived || agentSettledReceived)
1477
+ queuedDrainHold = true;
1478
+ return followUp(text);
1479
+ };
1480
+ created.detached = detached;
1481
+ unsubscribe = created.subscribe((event) => processEvent(event));
1482
+ if (abortedBySignal || interruptedByControl || result.timedOut) {
1483
+ abortChild();
1484
+ }
1485
+ options.onChildSession?.({
1486
+ steer: (text) => created.steer(text),
1487
+ followUp: (text) => created.followUp(text),
1488
+ stop: (reason) => {
1489
+ if (sessionSettled || lifecycleFinished)
1490
+ return;
1491
+ hostStopReason = reason;
1492
+ abortChild();
1493
+ },
1494
+ });
1495
+ messageBaseline = created.messages.length;
1496
+ // A runtime replacement can stop a child that detached while it was still being created.
1497
+ if (!hostStopReason)
1498
+ await created.prompt(`Task: ${task}`);
1499
+ // A structured child that finished normally without calling structured_output gets one more turn (#2997).
1500
+ if (options.structuredOutput
1501
+ && !structuredOutputToolInvoked
1502
+ && !sessionSettled
1503
+ && !lifecycleFinished
1504
+ && !hostStopReason
1505
+ && !created.shutDown
1506
+ && !abortedBySignal
1507
+ && !interruptedByControl
1508
+ && !result.timedOut
1509
+ && !forcedTermination
1510
+ && !result.error
1511
+ && !assistantError
1512
+ && !capture.toolDiagnostic()
1513
+ && !(progress.currentTool && isOrdinaryToolForMidToolExit(progress.currentTool))) {
1514
+ applyChildLifecycle("cancel-drain");
1515
+ await created.prompt(STRUCTURED_OUTPUT_FOLLOW_UP);
1516
+ }
1517
+ settle(undefined);
1518
+ }
1519
+ catch (error) {
1520
+ settle(error ?? new Error("Child session failed."));
1521
+ }
1522
+ })();
1523
+ });
1524
+ result.exitCode = exitCode;
1525
+ result.providerDiagnostics = clearProviderRetry(result.providerDiagnostics);
1526
+ progress.providerDiagnostics = result.providerDiagnostics;
1527
+ if (afterCompactionSettlement) {
1528
+ result[AFTER_COMPACTION_SETTLEMENT] = true;
1529
+ }
1530
+ if (interruptedByControl) {
1531
+ result.exitCode = 0;
1532
+ result.interrupted = true;
1533
+ result.error = undefined;
1534
+ result.finalOutput = result.finalOutput || "Interrupted. Waiting for explicit next action.";
1535
+ result.controlEvents = allControlEvents.length ? allControlEvents : undefined;
1536
+ progress.activityState = undefined;
1537
+ progress.durationMs = Date.now() - startTime;
1538
+ result.progressSummary = {
1539
+ toolCount: progress.toolCount,
1540
+ tokens: progress.tokens,
1541
+ durationMs: progress.durationMs,
1542
+ };
1543
+ return result;
1544
+ }
1545
+ if (progress.currentTool
1546
+ && isOrdinaryToolForMidToolExit(progress.currentTool)
1547
+ && !abortedBySignal
1548
+ && !result.timedOut
1549
+ && !result.stopped
1550
+ && !toolAvailabilityError) {
1551
+ result.exitCode = 1;
1552
+ result.error = formatMidToolExitError({ toolName: progress.currentTool });
1553
+ }
1554
+ if (result.error && result.exitCode === 0) {
1555
+ result.exitCode = 1;
1556
+ }
1557
+ let validatedStructuredOutput = false;
1558
+ if (options.structuredOutput) {
1559
+ result.structuredOutputSchemaPath = options.structuredOutput.schemaPath;
1560
+ result.structuredOutputPath = options.structuredOutput.outputPath;
1561
+ const structured = capture.structuredOutput();
1562
+ if (structuredOutputToolInvoked && structured.called) {
1563
+ result.structuredOutput = structured.value;
1564
+ const acceptanceMode = options.structuredOutput.acceptanceReportPath
1565
+ ? options.structuredOutput.acceptanceReportRequired ? "required" : "optional"
1566
+ : undefined;
1567
+ const acceptanceReportError = acceptanceMode === "required" && !structured.acceptanceReportProvided
1568
+ ? MISSING_STRUCTURED_ACCEPTANCE_REPORT_ERROR
1569
+ : undefined;
1570
+ result.structuredAcceptanceReport = acceptanceMode ? structured.acceptanceReport : undefined;
1571
+ result.structuredAcceptanceReportError = acceptanceReportError;
1572
+ writeStructuredOutputArtifacts(options.structuredOutput, structured.value, acceptanceMode ? structured.acceptanceReport : undefined);
1573
+ validatedStructuredOutput = true;
1574
+ }
1575
+ else if (result.exitCode === 0 && !result.error) {
1576
+ result.exitCode = 1;
1577
+ result.error = structuredOutputToolInvoked
1578
+ ? formatStructuredOutputRejectionError(result.messages ?? [])
1579
+ : MISSING_STRUCTURED_OUTPUT_CALL_ERROR;
1580
+ result.structuredOutputFailed = true;
1581
+ }
1582
+ }
1583
+ if (result.exitCode === 0 && !result.error) {
1584
+ const messages = result.messages ?? [];
1585
+ const finalText = getFinalOutput(messages);
1586
+ const errorMessages = validatedStructuredOutput
1587
+ ? messages.slice(structuredOutputMessageStartIndex ?? messages.length)
1588
+ : messages;
1589
+ const errInfo = detectSubagentError(errorMessages);
1590
+ const missingOutput = !finalText?.trim() && !validatedStructuredOutput;
1591
+ const terminalEmptyAfterUsefulWork = !validatedStructuredOutput
1592
+ && hasEmptyTerminalAssistantResponse(messages)
1593
+ && (progress.toolCount > 0 || Boolean(finalText?.trim()));
1594
+ if ((missingOutput || terminalEmptyAfterUsefulWork) && (!errInfo.hasError || hasEmptyTerminalAssistantResponse(messages))) {
1595
+ // A startup guard can block the first turn, which leaves no message to
1596
+ // inspect. Prefer the reason the blocked child published.
1597
+ const sandboxDiagnostic = readSandboxStartupDiagnostic(launch.sandboxDiagnosticsPath);
1598
+ result.exitCode = 1;
1599
+ if (sandboxDiagnostic) {
1600
+ result.error = sandboxDiagnostic.reason;
1601
+ result.startupBlocked = true;
1602
+ clearSandboxStartupDiagnostic(launch.sandboxDiagnosticsPath);
1603
+ }
1604
+ else {
1605
+ result.error = formatEmptyTerminalAssistantResponseError(messages);
1606
+ }
1607
+ }
1608
+ else if (errInfo.hasError) {
1609
+ result.exitCode = errInfo.exitCode ?? 1;
1610
+ result.error = errInfo.details
1611
+ ? `${errInfo.errorType} failed (exit ${errInfo.exitCode}): ${errInfo.details}`
1612
+ : `${errInfo.errorType} failed with exit code ${errInfo.exitCode}`;
1613
+ }
1614
+ }
1615
+ progress.status = result.exitCode === 0 ? "completed" : "failed";
1616
+ progress.durationMs = Date.now() - startTime;
1617
+ if (result.error) {
1618
+ progress.error = result.error;
1619
+ if (progress.currentTool) {
1620
+ progress.failedTool = progress.currentTool;
1621
+ }
1622
+ }
1623
+ result.progressSummary = {
1624
+ ...(childSessionName ? { sessionName: childSessionName } : {}),
1625
+ toolCount: progress.toolCount,
1626
+ tokens: progress.tokens,
1627
+ durationMs: progress.durationMs,
1628
+ };
1629
+ const remoteGitChanged = result.nativeMachine?.initialGit && result.nativeMachine.finalGit ? result.nativeMachine.initialGit.head !== result.nativeMachine.finalGit.head || result.nativeMachine.initialGit.dirty !== result.nativeMachine.finalGit.dirty : undefined;
1630
+ const mutationEvidence = result.nativeMachine && !isRexLocalMachine(options.machine) ? { source: "tracked-files", trackedOnly: true, changedFiles: [], attemptedMutation: remoteGitChanged === true, ...(remoteGitChanged === undefined ? { unavailable: "Remote Git before/after evidence was incomplete." } : {}) } : collectTrackedMutationEvidence(mutationSnapshot, mutationCwd);
1631
+ const acceptanceOutput = getFinalOutput(result.messages ?? []);
1632
+ const structuredText = result.structuredOutput === undefined ? undefined : JSON.stringify(result.structuredOutput, null, 2);
1633
+ let fullOutput = stripAcceptanceReport(acceptanceOutput);
1634
+ if (!fullOutput.trim() && structuredText !== undefined)
1635
+ fullOutput = structuredText;
1636
+ // Text still streaming when the child timed out or its session threw never reached
1637
+ // a completed message. Keep it, labeled; the run still fails and the text never
1638
+ // stands in for acceptance or a requested output file.
1639
+ const partialCause = result.timedOut
1640
+ ? "timeout"
1641
+ : childPromptFailed && !abortedBySignal && !result.interrupted && !result.stopped ? "child error" : undefined;
1642
+ const streamedPartial = partialCause ? partialOutput.text() : undefined;
1643
+ if (partialCause && streamedPartial) {
1644
+ const text = stripAcceptanceReport(streamedPartial);
1645
+ fullOutput = partialCause === "timeout" ? text : formatPartialOutput(text, partialCause);
1646
+ result.outputPartial = true;
1647
+ }
1648
+ result.outputState = fullOutput.trim() || result.structuredOutput !== undefined ? "present" : "absent";
1649
+ if (timeoutCause) {
1650
+ let requiredOutputMissing;
1651
+ if (options.outputMode === "file-only" && options.outputPath) {
1652
+ const outputChanged = hasSingleOutputChangedSinceSnapshot(options.outputPath, shared.outputSnapshot);
1653
+ requiredOutputMissing = outputChanged === undefined ? undefined : !outputChanged;
1654
+ }
1655
+ else if (options.structuredOutput) {
1656
+ requiredOutputMissing = !capture.structuredOutput().called;
1657
+ }
1658
+ result.timeoutRecovery = buildTimeoutRecoverySummary({
1659
+ termination: "timed-out",
1660
+ evidence: mutationEvidence,
1661
+ requiredOutputMissing,
1662
+ currentTool: progress.currentTool,
1663
+ currentToolArgs: progress.currentToolArgs,
1664
+ currentPath: progress.currentPath,
1665
+ sessionFile: options.sessionFile,
1666
+ transcriptPath: shared.transcriptWriter ? shared.artifactPaths?.transcriptPath : undefined,
1667
+ artifactPaths: shared.artifactPaths,
1668
+ });
1669
+ fullOutput = fullOutput.trim()
1670
+ ? `${timeoutCause}\n\n${result.timeoutRecovery.message}\n\nPartial output before timeout:\n${fullOutput}`
1671
+ : `${timeoutCause}\n\n${result.timeoutRecovery.message}`;
1672
+ }
1673
+ if (options.outputPath && result.exitCode === 0) {
1674
+ // The schema is the caller's contract: a bound output file holds the structured result, not closing prose.
1675
+ const resolvedOutput = resolveSingleOutput(options.outputPath, structuredText ?? fullOutput, shared.outputSnapshot, options.outputClaimPath);
1676
+ fullOutput = stripAcceptanceReport(resolvedOutput.fullOutput);
1677
+ result.savedOutputPath = resolvedOutput.savedPath;
1678
+ result.outputSaveError = resolvedOutput.saveError;
1679
+ if (isSettlementFatalOutputError(resolvedOutput, options.outputMode)) {
1680
+ result.exitCode = 1;
1681
+ result.error = result.error ? `${result.error}\n${resolvedOutput.saveError}` : resolvedOutput.saveError;
1682
+ progress.status = "failed";
1683
+ progress.error = result.error;
1684
+ }
1685
+ if (resolvedOutput.savedPath) {
1686
+ result.outputReference = formatSavedOutputReference(resolvedOutput.savedPath, fullOutput);
1687
+ if (result.outputState === "absent")
1688
+ result.outputState = "unknown";
1689
+ }
1690
+ }
1691
+ artifactOutputByResult.set(result, fullOutput);
1692
+ acceptanceOutputByResult.set(result, acceptanceOutput);
1693
+ result.outputMode = options.outputMode ?? "inline";
1694
+ result.finalOutput = options.outputMode === "file-only" && result.savedOutputPath && result.outputReference
1695
+ ? result.outputReference.message
1696
+ : fullOutput;
1697
+ result.controlEvents = allControlEvents.length ? allControlEvents : undefined;
1698
+ if (options.onUpdate) {
1699
+ const finalText = result.finalOutput || result.error || "(no output)";
1700
+ const progressSnapshot = snapshotProgress(progress);
1701
+ const resultSnapshot = snapshotStreamResult(result, progressSnapshot);
1702
+ options.onUpdate({
1703
+ content: [{ type: "text", text: finalText }],
1704
+ details: {
1705
+ mode: "single",
1706
+ results: [resultSnapshot],
1707
+ progress: [progressSnapshot],
1708
+ controlEvents: allControlEvents.length ? allControlEvents : undefined,
1709
+ },
1710
+ });
1711
+ }
1712
+ return result;
1713
+ }
1714
+ /** Keep the structured output artifact files other consumers read by path. */
1715
+ function writeStructuredOutputArtifacts(runtime, value, acceptanceReport) {
1716
+ try {
1717
+ mkdirSync(path.dirname(runtime.outputPath), { recursive: true });
1718
+ writeFileSync(runtime.outputPath, JSON.stringify(value), { mode: 0o600 });
1719
+ if (runtime.acceptanceReportPath) {
1720
+ if (acceptanceReport !== undefined)
1721
+ writeFileSync(runtime.acceptanceReportPath, JSON.stringify(acceptanceReport), { mode: 0o600 });
1722
+ else
1723
+ rmSync(runtime.acceptanceReportPath, { force: true });
1724
+ }
1725
+ }
1726
+ catch {
1727
+ // The captured value is already on the result; the file is observability only.
1728
+ }
1729
+ }
1730
+ /**
1731
+ * Run a subagent synchronously (blocking until complete)
1732
+ */
1733
+ async function runSyncCompletionInner(runtimeCwd, agents, agentName, task, options) {
1734
+ const effectiveCwd = options.cwd ?? runtimeCwd;
1735
+ const cwdError = preflightLaunchCwd(options.requestedCwd ?? effectiveCwd, effectiveCwd);
1736
+ if (cwdError) {
1737
+ return redactResultPrompt(withRunContext({
1738
+ index: options.index ?? 0,
1739
+ agent: agentName,
1740
+ task,
1741
+ exitCode: 1,
1742
+ messages: [],
1743
+ usage: emptyUsage(),
1744
+ error: cwdError,
1745
+ }, options.context));
1746
+ }
1747
+ options = {
1748
+ ...options,
1749
+ capabilityCeiling: intersectSubagentCapabilityCeilings(options.capabilityCeiling ?? resolveCurrentSubagentCapabilityCeiling(options.parentSessionId), options.childRuntime?.capabilityCeiling),
1750
+ };
1751
+ const childSessionName = deriveChildSessionName({ agent: agentName, task });
1752
+ const agent = agents.find((a) => a.name === agentName);
1753
+ if (!agent) {
1754
+ const diagnosticContext = options.unknownAgentDiagnosticContext
1755
+ ?? unknownAgentDiagnosticContext(discoverAgents(path.resolve(options.cwd ?? runtimeCwd), "both"));
1756
+ return redactResultPrompt(withRunContext({
1757
+ index: options.index ?? 0,
1758
+ agent: agentName,
1759
+ task,
1760
+ exitCode: 1,
1761
+ messages: [],
1762
+ usage: emptyUsage(),
1763
+ error: formatUnknownAgentError(agentName, diagnosticContext),
1764
+ }, options.context));
1765
+ }
1766
+ options = {
1767
+ ...options,
1768
+ thinkingCeiling: intersectThinkingCeilings(options.thinkingCeiling, agent.maxThinking, options.childRuntime?.thinkingCeiling),
1769
+ };
1770
+ try {
1771
+ assertAgentAllowedByCapabilityCeiling(agent.name, options.capabilityCeiling);
1772
+ }
1773
+ catch (error) {
1774
+ return redactResultPrompt(withRunContext({
1775
+ index: options.index ?? 0,
1776
+ agent: agent.name,
1777
+ task,
1778
+ exitCode: 1,
1779
+ messages: [],
1780
+ usage: emptyUsage(),
1781
+ error: error instanceof Error ? error.message : String(error),
1782
+ ...(options.capabilityCeiling ? { capabilityCeiling: options.capabilityCeiling } : {}),
1783
+ }, options.context));
1784
+ }
1785
+ const acceptanceErrors = validateAcceptanceInput(options.acceptance);
1786
+ if (acceptanceErrors.length > 0) {
1787
+ return redactResultPrompt(withRunContext({
1788
+ index: options.index ?? 0,
1789
+ agent: agentName,
1790
+ task,
1791
+ exitCode: 1,
1792
+ messages: [],
1793
+ usage: emptyUsage(),
1794
+ error: acceptanceErrors.join(" "),
1795
+ }, options.context));
1796
+ }
1797
+ const toolTimeout = resolveToolTimeoutMs({
1798
+ callValue: options.toolTimeoutMs,
1799
+ agentValue: agent.defaultToolTimeoutMs,
1800
+ configValue: options.configToolTimeoutMs,
1801
+ envValue: toolTimeoutFromEnv(),
1802
+ });
1803
+ if (toolTimeout.error) {
1804
+ return redactResultPrompt(withRunContext({
1805
+ index: options.index ?? 0,
1806
+ agent: agentName,
1807
+ task,
1808
+ exitCode: 1,
1809
+ messages: [],
1810
+ usage: emptyUsage(),
1811
+ error: toolTimeout.error,
1812
+ }, options.context));
1813
+ }
1814
+ options = { ...options, toolTimeoutMs: toolTimeout.toolTimeoutMs };
1815
+ const outputModeValidationError = validateFileOnlyOutputMode(options.outputMode, options.outputPath, `Single run (${agentName})`);
1816
+ if (outputModeValidationError) {
1817
+ return redactResultPrompt(withRunContext({
1818
+ index: options.index ?? 0,
1819
+ agent: agentName,
1820
+ task,
1821
+ exitCode: 1,
1822
+ messages: [],
1823
+ usage: emptyUsage(),
1824
+ outputMode: options.outputMode,
1825
+ error: outputModeValidationError,
1826
+ }, options.context));
1827
+ }
1828
+ const shareEnabled = options.share === true;
1829
+ const effectiveAcceptance = resolveEffectiveAcceptance({
1830
+ explicit: options.acceptance,
1831
+ agentName,
1832
+ acceptanceRole: agent.acceptanceRole,
1833
+ task,
1834
+ mode: options.acceptanceContext?.mode ?? "single",
1835
+ async: options.acceptanceContext?.async,
1836
+ dynamic: options.acceptanceContext?.dynamic,
1837
+ dynamicGroup: options.acceptanceContext?.dynamicGroup,
1838
+ agentContract: options.agentContract,
1839
+ });
1840
+ const acceptancePrompt = formatAcceptancePrompt(effectiveAcceptance, { reportOptional: isAgentContract(options.agentContract), structuredOutput: Boolean(options.structuredOutput?.acceptanceReportPath) });
1841
+ const taskWithAcceptance = acceptancePrompt ? `${task}\n${acceptancePrompt}` : task;
1842
+ options.onEffectivePrompt?.(taskWithAcceptance);
1843
+ const sessionEnabled = Boolean(options.sessionFile || options.sessionDir) || shareEnabled;
1844
+ if (options.context === "fork" && options.sessionFile && existsSync(options.sessionFile)) {
1845
+ alignForkedSessionCwd(options.sessionFile, options.cwd ?? runtimeCwd);
1846
+ }
1847
+ const skillNames = options.skills ?? agent.skills ?? [];
1848
+ const skillCwd = options.cwd ?? runtimeCwd;
1849
+ const { resolved: resolvedSkills, missing: missingSkills } = resolveSkillsWithFallback(skillNames, skillCwd, runtimeCwd, agent.skillPath, agent.filePath ? path.dirname(agent.filePath) : skillCwd);
1850
+ if (skillNames.some((skill) => skill.trim() === "pi-subagents") && missingSkills.includes("pi-subagents")) {
1851
+ return redactResultPrompt(withRunContext({
1852
+ index: options.index ?? 0,
1853
+ agent: agentName,
1854
+ task,
1855
+ exitCode: 1,
1856
+ messages: [],
1857
+ usage: emptyUsage(),
1858
+ error: "Skills not found: pi-subagents",
1859
+ }, options.context));
1860
+ }
1861
+ const systemPrompt = buildEffectiveSystemPrompt({ agent, resolvedSkills, cwd: skillCwd });
1862
+ const { model: selectedModel, requestedModel } = resolveModelSelection(options.modelOverride ?? agent.model, options.availableModels, agent.modelProvider ?? options.preferredModelProvider, {
1863
+ scope: options.modelScope,
1864
+ primaryModelFromParent: options.modelOverrideFromParent,
1865
+ origin: options.modelOrigin ?? (options.modelOverrideFromParent ? "inherited" : "configured"),
1866
+ });
1867
+ try {
1868
+ const model = applyThinkingSuffix(selectedModel, options.thinkingOverride ?? agent.thinking, options.thinkingOverride !== undefined);
1869
+ assertThinkingWithinCeiling({ model, configThinking: options.thinkingOverride ?? agent.thinking, ceiling: options.thinkingCeiling, agent: agent.name, runId: options.runId });
1870
+ }
1871
+ catch (error) {
1872
+ return redactResultPrompt(withRunContext({
1873
+ index: options.index ?? 0,
1874
+ agent: agent.name,
1875
+ task,
1876
+ exitCode: 1,
1877
+ messages: [],
1878
+ usage: emptyUsage(),
1879
+ error: error instanceof Error ? error.message : String(error),
1880
+ }, options.context));
1881
+ }
1882
+ const aggregateUsage = emptyUsage();
1883
+ const attemptNotes = [];
1884
+ const launchWarnings = { emitted: false };
1885
+ let totalToolCount = 0;
1886
+ let totalDurationMs = 0;
1887
+ let artifactPathsResult;
1888
+ let jsonlPath;
1889
+ let transcriptWriter;
1890
+ if (options.artifactsDir && options.artifactConfig?.enabled !== false) {
1891
+ artifactPathsResult = getArtifactPaths(options.artifactsDir, options.runId, agentName, options.index);
1892
+ ensureArtifactsDir(options.artifactsDir);
1893
+ if (options.artifactConfig?.includeInput !== false) {
1894
+ writeArtifact(artifactPathsResult.inputPath, `# Task for ${agentName}\n\n${PROMPT_REDACTED}; live Prompt Audit only.\n`);
1895
+ }
1896
+ if (options.artifactConfig?.includeJsonl !== false) {
1897
+ jsonlPath = artifactPathsResult.jsonlPath;
1898
+ }
1899
+ if (options.artifactConfig?.includeTranscript !== false) {
1900
+ transcriptWriter = createChildTranscriptWriter({
1901
+ transcriptPath: artifactPathsResult.transcriptPath,
1902
+ source: "foreground",
1903
+ runId: options.runId,
1904
+ agent: agentName,
1905
+ childIndex: options.index,
1906
+ cwd: options.cwd ?? runtimeCwd,
1907
+ });
1908
+ transcriptWriter.writeInitialUserMessage(`${PROMPT_REDACTED}; live Prompt Audit only.`);
1909
+ }
1910
+ }
1911
+ const orcaProgressTab = createOrcaProgressTab({
1912
+ cwd: options.cwd ?? runtimeCwd,
1913
+ runId: options.runId,
1914
+ agent: agentName,
1915
+ index: options.index ?? 0,
1916
+ });
1917
+ if (orcaProgressTab)
1918
+ options.onOrcaProgressTabCreated?.(orcaProgressTab);
1919
+ const persistResultMetadata = (target) => {
1920
+ persistSingleResultMetadata({
1921
+ metadataPath: artifactPathsResult?.metadataPath,
1922
+ enabled: options.artifactConfig?.enabled !== false && options.artifactConfig?.includeMetadata !== false,
1923
+ runId: options.runId,
1924
+ parentSessionId: options.parentSessionId,
1925
+ agent: agentName,
1926
+ task,
1927
+ result: target,
1928
+ });
1929
+ };
1930
+ let detachedReason;
1931
+ const logicalDeadline = options.deadlineAt ?? (options.timeoutMs === undefined ? undefined : Date.now() + options.timeoutMs);
1932
+ const attemptOptions = {
1933
+ ...options,
1934
+ deadlineAt: logicalDeadline,
1935
+ onDetachReceipt: (receipt) => {
1936
+ receipt.acceptance = buildPendingAcceptanceLedger(effectiveAcceptance);
1937
+ try {
1938
+ persistResultMetadata(receipt);
1939
+ }
1940
+ catch (error) {
1941
+ receipt.metadataSaveError = error instanceof Error ? error.message : String(error);
1942
+ }
1943
+ const accepted = options.onDetachReceipt?.(receipt) === true;
1944
+ if (accepted) {
1945
+ detachedReason = receipt.detachedReason;
1946
+ }
1947
+ return accepted;
1948
+ },
1949
+ };
1950
+ const candidate = selectedModel;
1951
+ const verifyModel = Boolean(candidate) && !options.modelOverrideFromParent;
1952
+ let lastResult;
1953
+ let recoveryPrompt = task;
1954
+ let stagedIndexBaseline;
1955
+ if (effectiveAcceptance.preserveStagedIndex) {
1956
+ try {
1957
+ stagedIndexBaseline = captureStagedIndexBaseline(options.cwd ?? runtimeCwd);
1958
+ }
1959
+ catch (error) {
1960
+ return redactResultPrompt(withRunContext({
1961
+ index: options.index ?? 0,
1962
+ agent: agentName,
1963
+ task,
1964
+ exitCode: 1,
1965
+ messages: [],
1966
+ usage: emptyUsage(),
1967
+ error: error instanceof Error ? error.message : String(error),
1968
+ }, options.context));
1969
+ }
1970
+ }
1971
+ for (let attemptIndex = 0; attemptIndex < 2; attemptIndex++) {
1972
+ const outputSnapshot = captureSingleOutputSnapshot(options.outputPath);
1973
+ const attemptResult = await runSingleAttempt(runtimeCwd, agent, recoveryPrompt, candidate, attemptOptions, {
1974
+ sessionEnabled,
1975
+ systemPrompt,
1976
+ acceptancePrompt,
1977
+ resolvedSkillNames: resolvedSkills.length > 0 ? resolvedSkills.map((skill) => skill.name) : undefined,
1978
+ skillsWarning: missingSkills.length > 0 ? `Skills not found: ${missingSkills.join(", ")}` : undefined,
1979
+ jsonlPath,
1980
+ artifactPaths: artifactPathsResult,
1981
+ transcriptWriter,
1982
+ attemptNotes,
1983
+ outputSnapshot,
1984
+ originalTask: task,
1985
+ orcaProgressTab,
1986
+ launchWarnings,
1987
+ verifyModel,
1988
+ providerDiagnostics: lastResult?.providerDiagnostics,
1989
+ });
1990
+ lastResult = attemptResult;
1991
+ sumUsage(aggregateUsage, attemptResult.usage);
1992
+ totalToolCount += attemptResult.progressSummary?.toolCount ?? 0;
1993
+ totalDurationMs += attemptResult.progressSummary?.durationMs ?? 0;
1994
+ if (attemptResult.exitCode === 0 && !attemptResult.error)
1995
+ break;
1996
+ const recovery = planAbortRecovery({
1997
+ messages: attemptResult.messages ?? [],
1998
+ error: attemptResult.error,
1999
+ processSignal: attemptResult.processSignal,
2000
+ sessionAvailable: Boolean(options.sessionFile && existsSync(options.sessionFile)),
2001
+ alreadyResumed: attemptIndex > 0,
2002
+ stopped: attemptResult.stopped || attemptResult.detached || Boolean(detachedReason) || Boolean(options.workflowChildPermitLaunch) || options.signal?.aborted,
2003
+ interrupted: attemptResult.interrupted || options.interruptSignal?.aborted,
2004
+ timedOut: attemptResult.timedOut,
2005
+ toolBudgetExhausted: attemptResult.toolBudgetBlocked,
2006
+ usageBudgetExhausted: false,
2007
+ structuredOutputFailed: attemptResult.structuredOutputFailed,
2008
+ acceptanceFailed: false,
2009
+ currentTool: attemptResult.progress?.currentTool,
2010
+ afterCompactionSettlement: attemptResult[AFTER_COMPACTION_SETTLEMENT],
2011
+ });
2012
+ if (recovery.action === "resume") {
2013
+ recoveryPrompt = recovery.prompt;
2014
+ attemptNotes.push("[abort-recovery] compaction abort after useful progress; resuming the retained child session once on the same model.");
2015
+ continue;
2016
+ }
2017
+ if (recovery.diagnostic) {
2018
+ attemptResult.error = attemptResult.error ? `${attemptResult.error}\n${recovery.diagnostic}` : recovery.diagnostic;
2019
+ }
2020
+ break;
2021
+ }
2022
+ if (!lastResult)
2023
+ throw new Error("Subagent did not produce a result.");
2024
+ if (isContextOverflow(lastResult.error))
2025
+ lastResult.contextOverflow = true;
2026
+ const result = withRunContext(lastResult ?? {
2027
+ index: options.index ?? 0,
2028
+ agent: agentName,
2029
+ task,
2030
+ exitCode: 1,
2031
+ messages: [],
2032
+ usage: emptyUsage(),
2033
+ error: "Subagent did not produce a result.",
2034
+ }, options.context);
2035
+ result.task = task;
2036
+ result.usage = aggregateUsage;
2037
+ result.requestedModel = requestedModel;
2038
+ result.progressSummary = {
2039
+ ...(childSessionName ? { sessionName: childSessionName } : {}),
2040
+ toolCount: totalToolCount,
2041
+ tokens: aggregateUsage.input + aggregateUsage.output,
2042
+ durationMs: totalDurationMs,
2043
+ };
2044
+ if (transcriptWriter)
2045
+ result.transcriptPath = artifactPathsResult?.transcriptPath;
2046
+ if (transcriptWriter?.getError())
2047
+ result.transcriptError = transcriptWriter.getError();
2048
+ try {
2049
+ if (artifactPathsResult && options.artifactConfig?.enabled !== false) {
2050
+ result.artifactPaths = artifactPathsResult;
2051
+ if (options.artifactConfig?.includeOutput !== false) {
2052
+ writeArtifact(artifactPathsResult.outputPath, formatOutputArtifactContent({
2053
+ output: artifactOutputByResult.get(result) ?? result.finalOutput ?? "",
2054
+ error: result.error,
2055
+ transcriptPath: result.transcriptPath,
2056
+ metadataPath: options.artifactConfig?.includeMetadata === false ? undefined : artifactPathsResult.metadataPath,
2057
+ }));
2058
+ }
2059
+ if (options.maxOutput) {
2060
+ const config = { ...DEFAULT_MAX_OUTPUT, ...options.maxOutput };
2061
+ const truncationResult = truncateOutput(result.finalOutput ?? "", config, artifactPathsResult.outputPath);
2062
+ if (truncationResult.truncated)
2063
+ result.truncation = truncationResult;
2064
+ }
2065
+ }
2066
+ else if (options.maxOutput) {
2067
+ const config = { ...DEFAULT_MAX_OUTPUT, ...options.maxOutput };
2068
+ const truncationResult = truncateOutput(result.finalOutput ?? "", config);
2069
+ if (truncationResult.truncated)
2070
+ result.truncation = truncationResult;
2071
+ }
2072
+ }
2073
+ catch (error) {
2074
+ const message = `Artifact output post-processing failed: ${error instanceof Error ? error.message : String(error)}`;
2075
+ result.outputSaveError = result.outputSaveError ? `${result.outputSaveError}\n${message}` : message;
2076
+ }
2077
+ if (options.sessionFile && (existsSync(options.sessionFile) || result.messages?.length)) {
2078
+ result.sessionFile = options.sessionFile;
2079
+ }
2080
+ else if (shareEnabled && options.sessionDir) {
2081
+ const sessionFile = findLatestSessionFile(options.sessionDir);
2082
+ if (sessionFile)
2083
+ result.sessionFile = sessionFile;
2084
+ }
2085
+ const childWrittenOutput = options.outputPath
2086
+ ? extractChildWrittenOutput(result.messages, options.outputPath, options.cwd ?? runtimeCwd)
2087
+ : undefined;
2088
+ try {
2089
+ if (result.interrupted && detachedReason === "user request") {
2090
+ // Only an accepted user-detach receipt needs a non-rejecting terminal
2091
+ // ledger. Attached and background execution retain their baseline
2092
+ // acceptance behavior.
2093
+ result.acceptance = buildInterruptedAcceptanceLedger(effectiveAcceptance);
2094
+ }
2095
+ else if (result.stopped) {
2096
+ result.acceptance = buildSkippedAcceptanceLedger(effectiveAcceptance, { id: "stopped", message: "Acceptance was not evaluated because the subagent was stopped." });
2097
+ }
2098
+ else if (result.timedOut) {
2099
+ result.acceptance = buildSkippedAcceptanceLedger(effectiveAcceptance, { id: "timeout", message: "Acceptance was not evaluated because the subagent timed out." });
2100
+ }
2101
+ else {
2102
+ result.acceptance = await evaluateAcceptance({
2103
+ acceptance: effectiveAcceptance,
2104
+ output: acceptanceOutputByResult.get(result) ?? result.finalOutput ?? "",
2105
+ report: result.structuredAcceptanceReport,
2106
+ reportError: result.structuredAcceptanceReportError,
2107
+ fileOutput: childWrittenOutput !== undefined && options.outputPath
2108
+ ? { content: childWrittenOutput, path: options.outputPath, authoritative: options.outputMode === "file-only", durable: result.savedOutputPath !== undefined }
2109
+ : undefined,
2110
+ cwd: options.cwd ?? runtimeCwd,
2111
+ stagedIndexBaseline,
2112
+ reportOptional: isAgentContract(options.agentContract),
2113
+ artifactsDir: options.artifactsDir,
2114
+ runId: options.runId,
2115
+ watchdog: result.watchdog,
2116
+ });
2117
+ }
2118
+ }
2119
+ catch (error) {
2120
+ const message = `Acceptance evaluation failed: ${error instanceof Error ? error.message : String(error)}`;
2121
+ result.acceptance = buildSkippedAcceptanceLedger(effectiveAcceptance, { id: "acceptance-evaluation", message });
2122
+ }
2123
+ const acceptanceFailure = acceptanceFailureMessage(result.acceptance);
2124
+ stripAcceptanceReportsFromMessages(result.messages);
2125
+ // A passing typed gate supplies the structured output for runs that have no
2126
+ // outputSchema of their own; preflight rejects the combination.
2127
+ const typedGate = typedVerifyOutput(result.acceptance);
2128
+ if (typedGate && result.structuredOutput === undefined && !acceptanceFailure && result.exitCode === 0) {
2129
+ result.structuredOutput = typedGate.value;
2130
+ }
2131
+ if (acceptanceFailure && result.acceptance.explicit && result.exitCode === 0 && !result.interrupted && !result.timedOut && !isAgentContract(options.agentContract)) {
2132
+ result.exitCode = 1;
2133
+ if (result.savedOutputPath) {
2134
+ result.finalOutput = finalizeSingleOutput({
2135
+ fullOutput: result.finalOutput ?? "",
2136
+ outputPath: options.outputPath,
2137
+ outputMode: result.outputMode,
2138
+ exitCode: result.exitCode,
2139
+ preserveSavedOutput: true,
2140
+ savedPath: result.savedOutputPath,
2141
+ outputReference: result.outputReference,
2142
+ }).displayOutput;
2143
+ }
2144
+ result.error = result.error ? `${result.error}\n${acceptanceFailure}` : acceptanceFailure;
2145
+ if (artifactPathsResult && options.artifactConfig?.enabled !== false && options.artifactConfig?.includeOutput !== false) {
2146
+ try {
2147
+ writeArtifact(artifactPathsResult.outputPath, formatOutputArtifactContent({
2148
+ output: artifactOutputByResult.get(result) ?? result.finalOutput ?? "",
2149
+ error: result.error,
2150
+ transcriptPath: result.transcriptPath,
2151
+ metadataPath: options.artifactConfig?.includeMetadata === false ? undefined : artifactPathsResult.metadataPath,
2152
+ }));
2153
+ }
2154
+ catch (error) {
2155
+ const message = `Artifact output post-processing failed: ${error instanceof Error ? error.message : String(error)}`;
2156
+ result.outputSaveError = result.outputSaveError ? `${result.outputSaveError}\n${message}` : message;
2157
+ }
2158
+ }
2159
+ if (result.progress) {
2160
+ result.progress.status = "failed";
2161
+ result.progress.error = result.error;
2162
+ }
2163
+ }
2164
+ if (isAgentContract(options.agentContract))
2165
+ attachContractProjections(result);
2166
+ redactResultPrompt(result);
2167
+ try {
2168
+ persistResultMetadata(result);
2169
+ }
2170
+ catch (error) {
2171
+ result.metadataSaveError = error instanceof Error ? error.message : String(error);
2172
+ }
2173
+ return result;
2174
+ }
2175
+ async function runSyncCompletion(runtimeCwd, agents, agentName, task, options) {
2176
+ let orcaProgressTab;
2177
+ try {
2178
+ const result = await runSyncCompletionInner(runtimeCwd, agents, agentName, task, {
2179
+ ...options,
2180
+ onOrcaProgressTabCreated: (tab) => { orcaProgressTab = tab; },
2181
+ });
2182
+ orcaProgressTab?.finish(result.stopped ? "stopped" : result.exitCode === 0 && !result.error ? "completed" : "failed", result.sessionFile);
2183
+ return result;
2184
+ }
2185
+ catch (error) {
2186
+ orcaProgressTab?.finish("failed");
2187
+ throw error;
2188
+ }
2189
+ }
2190
+ /**
2191
+ * Runs the authoritative completion pipeline independently from the foreground
2192
+ * receipt. Detachment is same-runtime only: it does not adopt or daemonize work.
2193
+ */
2194
+ export async function runSync(runtimeCwd, agents, agentName, task, options) {
2195
+ // Capture the strict contract before consumer-owned objects can be mutated
2196
+ // after a detached receipt is published.
2197
+ const strictContract = isAgentContract(options.agentContract);
2198
+ let detachedReason;
2199
+ let publishedReceipt;
2200
+ let activeDetachAttempt;
2201
+ let detachReadyPublished = false;
2202
+ let resolveReceipt;
2203
+ const receipt = new Promise((resolve) => { resolveReceipt = resolve; });
2204
+ const originSignal = options.signal;
2205
+ const originController = new AbortController();
2206
+ const forwardOriginAbort = () => {
2207
+ if (!detachedReason)
2208
+ originController.abort(originSignal?.reason);
2209
+ };
2210
+ if (originSignal?.aborted)
2211
+ forwardOriginAbort();
2212
+ else
2213
+ originSignal?.addEventListener("abort", forwardOriginAbort, { once: true });
2214
+ const completion = runSyncCompletion(runtimeCwd, agents, agentName, task, {
2215
+ ...options,
2216
+ signal: originController.signal,
2217
+ onDetachedExit: undefined,
2218
+ onDetachReceipt: (detachedReceipt) => {
2219
+ if (detachedReason || publishedReceipt)
2220
+ return false;
2221
+ // Keep the authoritative result, fallback snapshot, and caller receipt
2222
+ // separately owned while the completion pipeline remains live.
2223
+ publishedReceipt = structuredClone(detachedReceipt);
2224
+ const callerReceipt = structuredClone(detachedReceipt);
2225
+ // A strict contract was already validated before detach; normalize private
2226
+ // and caller snapshots to the only safely known version.
2227
+ publishedReceipt.agentContract = strictContract ? { version: 1 } : undefined;
2228
+ callerReceipt.agentContract = strictContract ? { version: 1 } : undefined;
2229
+ detachedReason = detachedReceipt.detachedReason ?? "user request";
2230
+ resolveReceipt(callerReceipt);
2231
+ return true;
2232
+ },
2233
+ onDetachReady: (detachAttempt) => {
2234
+ activeDetachAttempt = detachAttempt;
2235
+ if (detachReadyPublished)
2236
+ return;
2237
+ detachReadyPublished = true;
2238
+ options.onDetachReady?.((reason = "user request") => {
2239
+ if (detachedReason || originController.signal.aborted)
2240
+ return false;
2241
+ return activeDetachAttempt?.(reason) ?? false;
2242
+ });
2243
+ },
2244
+ });
2245
+ const authoritativeCompletion = completion.catch((error) => {
2246
+ if (!publishedReceipt || !detachedReason)
2247
+ throw error;
2248
+ const message = error instanceof Error ? error.message : String(error);
2249
+ const failureMessage = `Detached completion pipeline failed after receipt: ${message}`;
2250
+ const failedProgress = publishedReceipt.progress
2251
+ ? { ...publishedReceipt.progress, status: "failed", error: failureMessage }
2252
+ : {
2253
+ index: options.index ?? 0,
2254
+ agent: publishedReceipt.agent,
2255
+ status: "failed",
2256
+ task: publishedReceipt.task,
2257
+ recentTools: [],
2258
+ recentOutput: [],
2259
+ toolCount: publishedReceipt.progressSummary?.toolCount ?? 0,
2260
+ tokens: publishedReceipt.progressSummary?.tokens ?? 0,
2261
+ durationMs: publishedReceipt.progressSummary?.durationMs ?? 0,
2262
+ error: failureMessage,
2263
+ };
2264
+ const failedResult = redactResultPrompt({
2265
+ ...publishedReceipt,
2266
+ detached: undefined,
2267
+ detachedReason,
2268
+ exitCode: 1,
2269
+ error: failureMessage,
2270
+ finalOutput: failureMessage,
2271
+ progress: failedProgress,
2272
+ progressSummary: {
2273
+ toolCount: failedProgress.toolCount,
2274
+ tokens: failedProgress.tokens,
2275
+ durationMs: failedProgress.durationMs,
2276
+ },
2277
+ acceptance: publishedReceipt.acceptance
2278
+ ? buildSkippedAcceptanceLedger(publishedReceipt.acceptance.effectiveAcceptance, { id: "completion-pipeline", message: failureMessage })
2279
+ : undefined,
2280
+ });
2281
+ if (strictContract)
2282
+ attachContractProjections(failedResult);
2283
+ try {
2284
+ // Replace the provisional detach receipt metadata with the authoritative
2285
+ // terminal failure. Persistence remains best-effort and cannot orphan work.
2286
+ persistSingleResultMetadata({
2287
+ metadataPath: failedResult.artifactPaths?.metadataPath,
2288
+ enabled: options.artifactConfig?.enabled !== false && options.artifactConfig?.includeMetadata !== false,
2289
+ runId: options.runId,
2290
+ parentSessionId: options.parentSessionId,
2291
+ agent: failedResult.agent,
2292
+ task: failedResult.task,
2293
+ result: failedResult,
2294
+ });
2295
+ }
2296
+ catch (metadataError) {
2297
+ failedResult.metadataSaveError = metadataError instanceof Error ? metadataError.message : String(metadataError);
2298
+ }
2299
+ return failedResult;
2300
+ });
2301
+ let terminalCallbackInvoked = false;
2302
+ void authoritativeCompletion.then(async (terminalResult) => {
2303
+ if (!detachedReason || terminalCallbackInvoked)
2304
+ return;
2305
+ terminalCallbackInvoked = true;
2306
+ terminalResult.detached = undefined;
2307
+ terminalResult.detachedReason = detachedReason;
2308
+ try {
2309
+ await options.onDetachedExit?.(terminalResult);
2310
+ }
2311
+ catch {
2312
+ // The authoritative result has settled. Consumer callback failures are
2313
+ // contained here; each consumer owns cleanup through its own finally block.
2314
+ }
2315
+ }).catch(() => {
2316
+ // Attached completion rejection remains observable through the returned
2317
+ // promise without becoming an unhandled side-channel rejection.
2318
+ }).finally(() => {
2319
+ originSignal?.removeEventListener("abort", forwardOriginAbort);
2320
+ });
2321
+ return Promise.race([authoritativeCompletion, receipt]);
2322
+ }