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