@xzzpig/pi-subagents 0.22.0 → 0.24.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1138) hide show
  1. package/CHANGELOG.md +355 -0
  2. package/README.md +2 -2
  3. package/agents/evidence-auditor.md +1 -0
  4. package/agents/oracle.md +1 -0
  5. package/agents/reviewer.md +1 -0
  6. package/bundle/agent-management.js +16 -0
  7. package/bundle/agents.js +41 -0
  8. package/bundle/background-work.js +16 -0
  9. package/bundle/capability-ceiling.js +22 -0
  10. package/bundle/child-tool-plan.js +11 -0
  11. package/bundle/chunk-355ECEP2.js +1321 -0
  12. package/bundle/chunk-35GII5EF.js +637 -0
  13. package/bundle/chunk-3U633XDZ.js +749 -0
  14. package/bundle/chunk-4QFZZV3O.js +57 -0
  15. package/bundle/chunk-62OCY2S4.js +14 -0
  16. package/bundle/chunk-6BJUEES3.js +276 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-BGIYHF2W.js +138 -0
  19. package/bundle/chunk-CTPAE36Y.js +94 -0
  20. package/bundle/chunk-D4EHT5SJ.js +14 -0
  21. package/bundle/chunk-ED55MIC2.js +1681 -0
  22. package/bundle/chunk-EUPJB4S7.js +5503 -0
  23. package/bundle/chunk-FG6SQJAR.js +940 -0
  24. package/bundle/chunk-FJWI64H7.js +490 -0
  25. package/bundle/chunk-H36HBZB2.js +753 -0
  26. package/bundle/chunk-ICNYIALB.js +7347 -0
  27. package/bundle/chunk-JEA2ZKUA.js +1372 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LMGQAJ3O.js +9872 -0
  30. package/bundle/chunk-LVWU2HOO.js +1234 -0
  31. package/bundle/chunk-NIXWDZZV.js +9 -0
  32. package/bundle/chunk-QXASAHIA.js +173 -0
  33. package/bundle/chunk-RB4GELQA.js +458 -0
  34. package/bundle/chunk-RU522D5W.js +1768 -0
  35. package/bundle/chunk-SLNMBXLL.js +7336 -0
  36. package/bundle/chunk-SW2VMNIU.js +526 -0
  37. package/bundle/chunk-TGLFTQWJ.js +143 -0
  38. package/bundle/chunk-TMHVDPYW.js +4132 -0
  39. package/bundle/chunk-U4ODUYAG.js +235 -0
  40. package/bundle/chunk-UKG4V45O.js +228 -0
  41. package/bundle/chunk-UQDHXMUG.js +264 -0
  42. package/bundle/chunk-V2KFIGFH.js +8774 -0
  43. package/bundle/chunk-VO3G7HI3.js +85 -0
  44. package/bundle/chunk-WPW4V6HM.js +227 -0
  45. package/bundle/chunk-WW76JRIX.js +175 -0
  46. package/bundle/chunk-X6LOM3Z4.js +4175 -0
  47. package/bundle/chunk-XA3DY6UG.js +161 -0
  48. package/bundle/chunk-Y6H2G6KX.js +1310 -0
  49. package/bundle/chunk-YFCK7H2S.js +129 -0
  50. package/bundle/chunk-YYREO77V.js +137 -0
  51. package/bundle/chunk-Z6TFJ6BR.js +400 -0
  52. package/bundle/chunk-ZWXU5SPQ.js +16932 -0
  53. package/bundle/control-channel.js +11 -0
  54. package/bundle/delegation.js +14 -0
  55. package/bundle/external-job-provider.js +20 -0
  56. package/bundle/external-runs.js +21 -0
  57. package/bundle/index.js +30 -0
  58. package/bundle/inspectors.js +8 -0
  59. package/bundle/intercom-bridge.js +11 -0
  60. package/bundle/preflight.js +468 -0
  61. package/bundle/project-panes.js +28 -0
  62. package/bundle/required-child-extensions.js +6 -0
  63. package/bundle/shared-types.js +8 -0
  64. package/bundle/supervisor-routing.js +12 -0
  65. package/bundle/workflow-resources.js +7 -0
  66. package/docs/agents.md +42 -10
  67. package/docs/configuration.md +59 -14
  68. package/docs/extension-api.md +61 -9
  69. package/docs/goal-auto-continuation-gate.md +26 -0
  70. package/docs/missions.md +2 -0
  71. package/docs/observability.md +20 -5
  72. package/docs/standalone-background.md +8 -6
  73. package/docs/tool-reference.md +18 -5
  74. package/docs/workflows.md +25 -7
  75. package/index.d.ts +3 -0
  76. package/index.js +14 -0
  77. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  78. package/package.json +107 -87
  79. package/skills/council-mode/SKILL.md +1 -4
  80. package/skills/pi-subagents/SKILL.md +130 -106
  81. package/skills/pi-subagents/references/orchestration.md +124 -0
  82. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  83. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  84. package/src/agents/advertised-agent-prompt.js +68 -0
  85. package/src/agents/agent-eject.d.ts +39 -0
  86. package/src/agents/agent-eject.js +263 -0
  87. package/src/agents/agent-management.d.ts +33 -0
  88. package/src/agents/agent-management.js +1541 -0
  89. package/src/agents/agent-memory.d.ts +48 -0
  90. package/src/agents/agent-memory.js +350 -0
  91. package/src/agents/agent-refinements.d.ts +99 -0
  92. package/src/agents/agent-refinements.js +568 -0
  93. package/src/agents/agent-scope.d.ts +3 -0
  94. package/src/agents/agent-scope.js +8 -0
  95. package/src/agents/agent-selection.d.ts +2 -0
  96. package/src/agents/agent-selection.js +22 -0
  97. package/src/agents/agent-serializer.d.ts +7 -0
  98. package/src/agents/agent-serializer.js +213 -0
  99. package/src/agents/agents.d.ts +352 -0
  100. package/src/agents/agents.js +2817 -0
  101. package/src/agents/builtin-names.d.ts +1 -0
  102. package/src/agents/builtin-names.js +16 -0
  103. package/src/agents/chain-serializer.d.ts +6 -0
  104. package/src/agents/chain-serializer.js +318 -0
  105. package/src/agents/frontmatter.d.ts +19 -0
  106. package/src/agents/frontmatter.js +166 -0
  107. package/src/agents/global-npm-root.d.ts +6 -0
  108. package/src/agents/global-npm-root.js +57 -0
  109. package/src/agents/identity.d.ts +7 -0
  110. package/src/agents/identity.js +29 -0
  111. package/src/agents/proactive-skills.d.ts +35 -0
  112. package/src/agents/proactive-skills.js +155 -0
  113. package/src/agents/runtime-agent-events.d.ts +26 -0
  114. package/src/agents/runtime-agent-events.js +52 -0
  115. package/src/agents/runtime-agent-registry.d.ts +66 -0
  116. package/src/agents/runtime-agent-registry.js +415 -0
  117. package/src/agents/runtime-discovery.d.ts +13 -0
  118. package/src/agents/runtime-discovery.js +27 -0
  119. package/src/agents/skills.d.ts +34 -0
  120. package/src/agents/skills.js +718 -0
  121. package/src/api/agent-management.d.ts +2 -0
  122. package/src/api/agent-management.js +2 -0
  123. package/src/api/agents.d.ts +6 -0
  124. package/src/api/agents.js +3 -0
  125. package/src/api/background-work.d.ts +41 -0
  126. package/src/api/background-work.js +171 -0
  127. package/src/api/capability-ceiling.d.ts +1 -0
  128. package/src/api/capability-ceiling.js +1 -0
  129. package/src/api/child-tool-plan.d.ts +1 -0
  130. package/src/api/child-tool-plan.js +1 -0
  131. package/src/api/control-channel.d.ts +1 -0
  132. package/src/api/control-channel.js +1 -0
  133. package/src/api/delegation.d.ts +132 -0
  134. package/src/api/delegation.js +8 -0
  135. package/src/api/external-job-provider.d.ts +57 -0
  136. package/src/api/external-job-provider.js +139 -0
  137. package/src/api/external-runs.d.ts +47 -0
  138. package/src/api/external-runs.js +245 -0
  139. package/src/api/inspectors.d.ts +20 -0
  140. package/src/api/inspectors.js +11 -0
  141. package/src/api/intercom-bridge.d.ts +1 -0
  142. package/src/api/intercom-bridge.js +1 -0
  143. package/src/api/preflight.d.ts +183 -0
  144. package/src/api/preflight.js +455 -0
  145. package/src/api/project-panes.d.ts +7 -0
  146. package/src/api/project-panes.js +7 -0
  147. package/src/api/required-child-extensions.d.ts +1 -0
  148. package/src/api/required-child-extensions.js +1 -0
  149. package/src/api/shared-types.d.ts +1 -0
  150. package/src/api/shared-types.js +1 -0
  151. package/src/api/supervisor-routing.d.ts +110 -0
  152. package/src/api/supervisor-routing.js +95 -0
  153. package/src/api/workflow-resources.d.ts +2 -0
  154. package/src/api/workflow-resources.js +1 -0
  155. package/src/extension/active-runs-prompt.d.ts +7 -0
  156. package/src/extension/active-runs-prompt.js +29 -0
  157. package/src/extension/config.d.ts +7 -0
  158. package/src/extension/config.js +290 -0
  159. package/src/extension/context-injection.d.ts +52 -0
  160. package/src/extension/context-injection.js +102 -0
  161. package/src/extension/control-notices.d.ts +18 -0
  162. package/src/extension/control-notices.js +29 -0
  163. package/src/extension/declaration-pinning.d.ts +18 -0
  164. package/src/extension/declaration-pinning.js +167 -0
  165. package/src/extension/doctor.d.ts +34 -0
  166. package/src/extension/doctor.js +236 -0
  167. package/src/extension/fanout-child.d.ts +6 -0
  168. package/src/extension/fanout-child.js +278 -0
  169. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  170. package/src/extension/herdr-pi-bridge.js +261 -0
  171. package/src/extension/index.d.ts +18 -0
  172. package/src/extension/index.js +1300 -0
  173. package/src/extension/public-execution.d.ts +71 -0
  174. package/src/extension/public-execution.js +214 -0
  175. package/src/extension/reply-workflow-script.d.ts +11 -0
  176. package/src/extension/reply-workflow-script.js +71 -0
  177. package/src/extension/rpc.d.ts +84 -0
  178. package/src/extension/rpc.js +729 -0
  179. package/src/extension/schemas.d.ts +276 -0
  180. package/src/extension/schemas.js +311 -0
  181. package/src/extension/steering-notices.d.ts +14 -0
  182. package/src/extension/steering-notices.js +22 -0
  183. package/src/extension/subagent-guide.d.ts +4 -0
  184. package/src/extension/subagent-guide.js +114 -0
  185. package/src/extension/subagent-options.d.ts +7 -0
  186. package/src/extension/subagent-options.js +64 -0
  187. package/src/extension/tool-activation.d.ts +7 -0
  188. package/src/extension/tool-activation.js +185 -0
  189. package/src/extension/tool-description.d.ts +19 -0
  190. package/src/extension/tool-description.js +169 -0
  191. package/src/extension/tool-result.d.ts +9 -0
  192. package/src/extension/tool-result.js +16 -0
  193. package/src/extension/upgrade-notice.d.ts +6 -0
  194. package/src/extension/upgrade-notice.js +42 -0
  195. package/src/goal-auto-continue-gate.d.ts +17 -0
  196. package/src/goal-auto-continue-gate.js +61 -0
  197. package/src/goal-auto-continue-state.d.ts +22 -0
  198. package/src/goal-auto-continue-state.js +20 -0
  199. package/src/inspectors/actions.d.ts +24 -0
  200. package/src/inspectors/actions.js +182 -0
  201. package/src/inspectors/ghostty/actions.d.ts +11 -0
  202. package/src/inspectors/ghostty/actions.js +62 -0
  203. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  204. package/src/inspectors/ghostty/plugin.js +23 -0
  205. package/src/inspectors/herdr/actions.d.ts +25 -0
  206. package/src/inspectors/herdr/actions.js +133 -0
  207. package/src/inspectors/herdr/client.d.ts +41 -0
  208. package/src/inspectors/herdr/client.js +129 -0
  209. package/src/inspectors/herdr/focus.d.ts +24 -0
  210. package/src/inspectors/herdr/focus.js +49 -0
  211. package/src/inspectors/herdr/plugin.d.ts +6 -0
  212. package/src/inspectors/herdr/plugin.js +14 -0
  213. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  214. package/src/inspectors/herdr/project-panes.js +610 -0
  215. package/src/inspectors/inspector-runner.d.ts +23 -0
  216. package/src/inspectors/inspector-runner.js +161 -0
  217. package/src/inspectors/plugins.d.ts +8 -0
  218. package/src/inspectors/plugins.js +82 -0
  219. package/src/inspectors/session-roots-codec.d.ts +15 -0
  220. package/src/inspectors/session-roots-codec.js +32 -0
  221. package/src/inspectors/shell-command.d.ts +1 -0
  222. package/src/inspectors/shell-command.js +16 -0
  223. package/src/inspectors/tmux/actions.d.ts +25 -0
  224. package/src/inspectors/tmux/actions.js +181 -0
  225. package/src/inspectors/tmux/client.d.ts +27 -0
  226. package/src/inspectors/tmux/client.js +64 -0
  227. package/src/inspectors/tmux/plugin.d.ts +7 -0
  228. package/src/inspectors/tmux/plugin.js +14 -0
  229. package/src/inspectors/types.d.ts +48 -0
  230. package/src/inspectors/types.js +1 -0
  231. package/src/integrations/herdr-status.d.ts +47 -0
  232. package/src/integrations/herdr-status.js +350 -0
  233. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  234. package/src/integrations/pi-web-session-liveness.js +53 -0
  235. package/src/integrations/program-status.d.ts +30 -0
  236. package/src/integrations/program-status.js +188 -0
  237. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  238. package/src/intercom/fork-supervisor-routing.js +392 -0
  239. package/src/intercom/intercom-bridge.d.ts +58 -0
  240. package/src/intercom/intercom-bridge.js +193 -0
  241. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  242. package/src/intercom/native-supervisor-channel.js +1184 -0
  243. package/src/intercom/result-intercom.d.ts +35 -0
  244. package/src/intercom/result-intercom.js +376 -0
  245. package/src/intercom/supervisor-ui.d.ts +29 -0
  246. package/src/intercom/supervisor-ui.js +49 -0
  247. package/src/missions/actions.d.ts +54 -0
  248. package/src/missions/actions.js +400 -0
  249. package/src/missions/goal-driver.d.ts +16 -0
  250. package/src/missions/goal-driver.js +171 -0
  251. package/src/missions/lifecycle.d.ts +50 -0
  252. package/src/missions/lifecycle.js +388 -0
  253. package/src/missions/store.d.ts +21 -0
  254. package/src/missions/store.js +605 -0
  255. package/src/missions/types.d.ts +169 -0
  256. package/src/missions/types.js +9 -0
  257. package/src/missions/workflow-state.d.ts +14 -0
  258. package/src/missions/workflow-state.js +273 -0
  259. package/src/policy/authority.d.ts +9 -0
  260. package/src/policy/authority.js +41 -0
  261. package/src/profiles/profiles.d.ts +134 -0
  262. package/src/profiles/profiles.js +526 -0
  263. package/src/runs/background/active-async-capacity.d.ts +115 -0
  264. package/src/runs/background/active-async-capacity.js +517 -0
  265. package/src/runs/background/active-run-index.d.ts +12 -0
  266. package/src/runs/background/active-run-index.js +157 -0
  267. package/src/runs/background/async-execution.d.ts +306 -0
  268. package/src/runs/background/async-execution.js +2210 -0
  269. package/src/runs/background/async-job-tracker.d.ts +37 -0
  270. package/src/runs/background/async-job-tracker.js +926 -0
  271. package/src/runs/background/async-resume.d.ts +60 -0
  272. package/src/runs/background/async-resume.js +707 -0
  273. package/src/runs/background/async-retention.d.ts +45 -0
  274. package/src/runs/background/async-retention.js +932 -0
  275. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  276. package/src/runs/background/async-status-snapshot.js +26 -0
  277. package/src/runs/background/async-status.d.ts +179 -0
  278. package/src/runs/background/async-status.js +712 -0
  279. package/src/runs/background/auto-drain.d.ts +16 -0
  280. package/src/runs/background/auto-drain.js +71 -0
  281. package/src/runs/background/await-async-run.d.ts +26 -0
  282. package/src/runs/background/await-async-run.js +83 -0
  283. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  284. package/src/runs/background/binary-bootstrap.js +69 -0
  285. package/src/runs/background/boot-id.d.ts +12 -0
  286. package/src/runs/background/boot-id.js +47 -0
  287. package/src/runs/background/calendar-schedule.d.ts +26 -0
  288. package/src/runs/background/calendar-schedule.js +93 -0
  289. package/src/runs/background/chain-append.d.ts +34 -0
  290. package/src/runs/background/chain-append.js +299 -0
  291. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  292. package/src/runs/background/chain-root-attachment.js +186 -0
  293. package/src/runs/background/completion-batcher.d.ts +51 -0
  294. package/src/runs/background/completion-batcher.js +119 -0
  295. package/src/runs/background/completion-dedupe.d.ts +13 -0
  296. package/src/runs/background/completion-dedupe.js +48 -0
  297. package/src/runs/background/completion-replay.d.ts +47 -0
  298. package/src/runs/background/completion-replay.js +266 -0
  299. package/src/runs/background/control-channel.d.ts +170 -0
  300. package/src/runs/background/control-channel.js +610 -0
  301. package/src/runs/background/fleet-view.d.ts +63 -0
  302. package/src/runs/background/fleet-view.js +666 -0
  303. package/src/runs/background/index-segment.d.ts +16 -0
  304. package/src/runs/background/index-segment.js +58 -0
  305. package/src/runs/background/inspect-rpc.d.ts +64 -0
  306. package/src/runs/background/inspect-rpc.js +422 -0
  307. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  308. package/src/runs/background/interrupted-elsewhere.js +68 -0
  309. package/src/runs/background/notify.d.ts +216 -0
  310. package/src/runs/background/notify.js +1006 -0
  311. package/src/runs/background/owned-process-tree.d.ts +10 -0
  312. package/src/runs/background/owned-process-tree.js +116 -0
  313. package/src/runs/background/parallel-groups.d.ts +3 -0
  314. package/src/runs/background/parallel-groups.js +46 -0
  315. package/src/runs/background/pid-namespace.d.ts +2 -0
  316. package/src/runs/background/pid-namespace.js +19 -0
  317. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  318. package/src/runs/background/process-terminal-candidate.js +96 -0
  319. package/src/runs/background/process-terminal.d.ts +21 -0
  320. package/src/runs/background/process-terminal.js +227 -0
  321. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  322. package/src/runs/background/result-delivery-ownership.js +38 -0
  323. package/src/runs/background/result-files.d.ts +63 -0
  324. package/src/runs/background/result-files.js +629 -0
  325. package/src/runs/background/result-watcher.d.ts +92 -0
  326. package/src/runs/background/result-watcher.js +819 -0
  327. package/src/runs/background/resume-guidance.d.ts +4 -0
  328. package/src/runs/background/resume-guidance.js +57 -0
  329. package/src/runs/background/retained-children.d.ts +24 -0
  330. package/src/runs/background/retained-children.js +128 -0
  331. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  332. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  333. package/src/runs/background/run-child-session.d.ts +123 -0
  334. package/src/runs/background/run-child-session.js +670 -0
  335. package/src/runs/background/run-id-query.d.ts +3 -0
  336. package/src/runs/background/run-id-query.js +6 -0
  337. package/src/runs/background/run-id-resolver.d.ts +22 -0
  338. package/src/runs/background/run-id-resolver.js +172 -0
  339. package/src/runs/background/run-status.d.ts +25 -0
  340. package/src/runs/background/run-status.js +850 -0
  341. package/src/runs/background/runner-aliases.d.ts +17 -0
  342. package/src/runs/background/runner-aliases.js +191 -0
  343. package/src/runs/background/runner-child-launch.d.ts +24 -0
  344. package/src/runs/background/runner-child-launch.js +72 -0
  345. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  346. package/src/runs/background/runner-child-sessions.js +34 -0
  347. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  348. package/src/runs/background/runner-http-dispatcher.js +115 -0
  349. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  350. package/src/runs/background/runner-startup-failure.js +46 -0
  351. package/src/runs/background/scheduled-runs.d.ts +127 -0
  352. package/src/runs/background/scheduled-runs.js +1265 -0
  353. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  354. package/src/runs/background/stale-run-reconciler.js +509 -0
  355. package/src/runs/background/steering.d.ts +51 -0
  356. package/src/runs/background/steering.js +246 -0
  357. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  358. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  359. package/src/runs/background/subagent-runner.d.ts +210 -0
  360. package/src/runs/background/subagent-runner.js +4963 -0
  361. package/src/runs/background/subagent-wait.d.ts +124 -0
  362. package/src/runs/background/subagent-wait.js +756 -0
  363. package/src/runs/background/terminal-run-index.d.ts +10 -0
  364. package/src/runs/background/terminal-run-index.js +209 -0
  365. package/src/runs/background/top-level-async.d.ts +7 -0
  366. package/src/runs/background/top-level-async.js +5 -0
  367. package/src/runs/background/wait-completions.d.ts +28 -0
  368. package/src/runs/background/wait-completions.js +264 -0
  369. package/src/runs/background/wait-config.d.ts +8 -0
  370. package/src/runs/background/wait-config.js +46 -0
  371. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  372. package/src/runs/background/wait-subscriptions.js +339 -0
  373. package/src/runs/background/wait-tool.d.ts +6 -0
  374. package/src/runs/background/wait-tool.js +48 -0
  375. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  376. package/src/runs/background/workflow-terminal-proof.js +116 -0
  377. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  378. package/src/runs/foreground/async-dismiss-action.js +82 -0
  379. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  380. package/src/runs/foreground/async-steering-action.js +294 -0
  381. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  382. package/src/runs/foreground/async-stop-action.js +213 -0
  383. package/src/runs/foreground/command-action.d.ts +12 -0
  384. package/src/runs/foreground/command-action.js +38 -0
  385. package/src/runs/foreground/execution.d.ts +10 -0
  386. package/src/runs/foreground/execution.js +2322 -0
  387. package/src/runs/foreground/foreground-control.d.ts +24 -0
  388. package/src/runs/foreground/foreground-control.js +138 -0
  389. package/src/runs/foreground/foreground-history.d.ts +25 -0
  390. package/src/runs/foreground/foreground-history.js +267 -0
  391. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  392. package/src/runs/foreground/prompt-audit.js +138 -0
  393. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  394. package/src/runs/foreground/subagent-executor.js +7990 -0
  395. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  396. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  397. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  398. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  399. package/src/runs/shared/abort-recovery.d.ts +26 -0
  400. package/src/runs/shared/abort-recovery.js +108 -0
  401. package/src/runs/shared/acceptance.d.ts +144 -0
  402. package/src/runs/shared/acceptance.js +1616 -0
  403. package/src/runs/shared/agent-contract.d.ts +5 -0
  404. package/src/runs/shared/agent-contract.js +35 -0
  405. package/src/runs/shared/async-status-projection.d.ts +100 -0
  406. package/src/runs/shared/async-status-projection.js +566 -0
  407. package/src/runs/shared/background-process-options.d.ts +4 -0
  408. package/src/runs/shared/background-process-options.js +6 -0
  409. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  410. package/src/runs/shared/capability-ceiling.js +179 -0
  411. package/src/runs/shared/chain-outputs.d.ts +18 -0
  412. package/src/runs/shared/chain-outputs.js +104 -0
  413. package/src/runs/shared/child-commands.d.ts +29 -0
  414. package/src/runs/shared/child-commands.js +254 -0
  415. package/src/runs/shared/child-hooks.d.ts +31 -0
  416. package/src/runs/shared/child-hooks.js +173 -0
  417. package/src/runs/shared/child-identity.d.ts +23 -0
  418. package/src/runs/shared/child-identity.js +40 -0
  419. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  420. package/src/runs/shared/child-launch-plan.js +88 -0
  421. package/src/runs/shared/child-launch.d.ts +128 -0
  422. package/src/runs/shared/child-launch.js +262 -0
  423. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  424. package/src/runs/shared/child-lifecycle.js +22 -0
  425. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  426. package/src/runs/shared/child-runtime-config.js +44 -0
  427. package/src/runs/shared/child-session.d.ts +178 -0
  428. package/src/runs/shared/child-session.js +726 -0
  429. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  430. package/src/runs/shared/child-tool-plan.js +430 -0
  431. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  432. package/src/runs/shared/claude-code-adapter.js +255 -0
  433. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  434. package/src/runs/shared/codex-exec-adapter.js +127 -0
  435. package/src/runs/shared/context-mode.d.ts +12 -0
  436. package/src/runs/shared/context-mode.js +38 -0
  437. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  438. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  439. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  440. package/src/runs/shared/dynamic-fanout.js +273 -0
  441. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  442. package/src/runs/shared/effective-system-prompt.js +23 -0
  443. package/src/runs/shared/extension-bindings.d.ts +25 -0
  444. package/src/runs/shared/extension-bindings.js +96 -0
  445. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  446. package/src/runs/shared/external-cli-contract.js +145 -0
  447. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  448. package/src/runs/shared/external-cli-preflight.js +159 -0
  449. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  450. package/src/runs/shared/external-cli-runner.js +425 -0
  451. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  452. package/src/runs/shared/external-job-bridge.js +486 -0
  453. package/src/runs/shared/external-job-runner.d.ts +44 -0
  454. package/src/runs/shared/external-job-runner.js +352 -0
  455. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  456. package/src/runs/shared/fast-mode-extension.js +8 -0
  457. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  458. package/src/runs/shared/fork-placed-env.js +13 -0
  459. package/src/runs/shared/git-environment.d.ts +2 -0
  460. package/src/runs/shared/git-environment.js +27 -0
  461. package/src/runs/shared/herdr-connection.d.ts +79 -0
  462. package/src/runs/shared/herdr-connection.js +269 -0
  463. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  464. package/src/runs/shared/herdr-external-adapters.js +404 -0
  465. package/src/runs/shared/herdr-machine.d.ts +59 -0
  466. package/src/runs/shared/herdr-machine.js +294 -0
  467. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  468. package/src/runs/shared/herdr-pane-host.js +155 -0
  469. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  470. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  471. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  472. package/src/runs/shared/herdr-placed-run.js +380 -0
  473. package/src/runs/shared/host-step-status.d.ts +33 -0
  474. package/src/runs/shared/host-step-status.js +244 -0
  475. package/src/runs/shared/lane-metadata.d.ts +23 -0
  476. package/src/runs/shared/lane-metadata.js +126 -0
  477. package/src/runs/shared/launch-cwd.d.ts +1 -0
  478. package/src/runs/shared/launch-cwd.js +16 -0
  479. package/src/runs/shared/local-machine-access.d.ts +5 -0
  480. package/src/runs/shared/local-machine-access.js +28 -0
  481. package/src/runs/shared/long-running-guard.d.ts +34 -0
  482. package/src/runs/shared/long-running-guard.js +256 -0
  483. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  484. package/src/runs/shared/mcp-config-sources.js +418 -0
  485. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  486. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  487. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  488. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  489. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  490. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  491. package/src/runs/shared/model-resolution.d.ts +109 -0
  492. package/src/runs/shared/model-resolution.js +411 -0
  493. package/src/runs/shared/model-scope.d.ts +68 -0
  494. package/src/runs/shared/model-scope.js +171 -0
  495. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  496. package/src/runs/shared/mutation-evidence.js +198 -0
  497. package/src/runs/shared/nested-events.d.ts +135 -0
  498. package/src/runs/shared/nested-events.js +1090 -0
  499. package/src/runs/shared/nested-path.d.ts +8 -0
  500. package/src/runs/shared/nested-path.js +34 -0
  501. package/src/runs/shared/nested-render.d.ts +20 -0
  502. package/src/runs/shared/nested-render.js +115 -0
  503. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  504. package/src/runs/shared/orca-progress-tabs.js +503 -0
  505. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  506. package/src/runs/shared/parallel-handoff.js +783 -0
  507. package/src/runs/shared/parallel-utils.d.ts +177 -0
  508. package/src/runs/shared/parallel-utils.js +125 -0
  509. package/src/runs/shared/partial-output.d.ts +24 -0
  510. package/src/runs/shared/partial-output.js +35 -0
  511. package/src/runs/shared/permissions.d.ts +12 -0
  512. package/src/runs/shared/permissions.js +92 -0
  513. package/src/runs/shared/pi-spawn.d.ts +31 -0
  514. package/src/runs/shared/pi-spawn.js +211 -0
  515. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  516. package/src/runs/shared/placed-run-owner.js +93 -0
  517. package/src/runs/shared/placement-host.d.ts +99 -0
  518. package/src/runs/shared/placement-host.js +157 -0
  519. package/src/runs/shared/process-signal.d.ts +15 -0
  520. package/src/runs/shared/process-signal.js +21 -0
  521. package/src/runs/shared/profile-extensions.d.ts +21 -0
  522. package/src/runs/shared/profile-extensions.js +122 -0
  523. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  524. package/src/runs/shared/profile-launch-env.js +90 -0
  525. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  526. package/src/runs/shared/readonly-drain-observation.js +50 -0
  527. package/src/runs/shared/rex-machine.d.ts +25 -0
  528. package/src/runs/shared/rex-machine.js +83 -0
  529. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  530. package/src/runs/shared/rex-pane-host.js +327 -0
  531. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  532. package/src/runs/shared/run-fanout-budget.js +258 -0
  533. package/src/runs/shared/run-ownership.d.ts +3 -0
  534. package/src/runs/shared/run-ownership.js +8 -0
  535. package/src/runs/shared/runner-launcher.d.ts +11 -0
  536. package/src/runs/shared/runner-launcher.js +24 -0
  537. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  538. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  539. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  540. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  541. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  542. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  543. package/src/runs/shared/session-lease.d.ts +69 -0
  544. package/src/runs/shared/session-lease.js +250 -0
  545. package/src/runs/shared/single-output.d.ts +90 -0
  546. package/src/runs/shared/single-output.js +349 -0
  547. package/src/runs/shared/spawn-budget.d.ts +20 -0
  548. package/src/runs/shared/spawn-budget.js +93 -0
  549. package/src/runs/shared/structured-output.d.ts +66 -0
  550. package/src/runs/shared/structured-output.js +483 -0
  551. package/src/runs/shared/subagent-control.d.ts +50 -0
  552. package/src/runs/shared/subagent-control.js +247 -0
  553. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  554. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  555. package/src/runs/shared/tool-availability.d.ts +16 -0
  556. package/src/runs/shared/tool-availability.js +29 -0
  557. package/src/runs/shared/tool-budget.d.ts +21 -0
  558. package/src/runs/shared/tool-budget.js +78 -0
  559. package/src/runs/shared/tool-timeout.d.ts +31 -0
  560. package/src/runs/shared/tool-timeout.js +73 -0
  561. package/src/runs/shared/usage-budget.d.ts +7 -0
  562. package/src/runs/shared/usage-budget.js +74 -0
  563. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  564. package/src/runs/shared/usage-reconciliation.js +71 -0
  565. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  566. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  567. package/src/runs/shared/workflow-graph.d.ts +31 -0
  568. package/src/runs/shared/workflow-graph.js +221 -0
  569. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  570. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  571. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  572. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  573. package/src/runs/shared/worktree-lock.d.ts +5 -0
  574. package/src/runs/shared/worktree-lock.js +40 -0
  575. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  576. package/src/runs/shared/worktree-setup-command.js +200 -0
  577. package/src/runs/shared/worktree.d.ts +181 -0
  578. package/src/runs/shared/worktree.js +1346 -0
  579. package/src/shared/accessible-dir.d.ts +11 -0
  580. package/src/shared/accessible-dir.js +39 -0
  581. package/src/shared/agent-stream-options.d.ts +5 -0
  582. package/src/shared/agent-stream-options.js +3 -0
  583. package/src/shared/artifacts.d.ts +22 -0
  584. package/src/shared/artifacts.js +272 -0
  585. package/src/shared/atomic-json.d.ts +19 -0
  586. package/src/shared/atomic-json.js +61 -0
  587. package/src/shared/capacity-resilient-json.d.ts +26 -0
  588. package/src/shared/capacity-resilient-json.js +86 -0
  589. package/src/shared/child-cache-retention.d.ts +29 -0
  590. package/src/shared/child-cache-retention.js +40 -0
  591. package/src/shared/child-session-name.d.ts +8 -0
  592. package/src/shared/child-session-name.js +40 -0
  593. package/src/shared/child-transcript.d.ts +37 -0
  594. package/src/shared/child-transcript.js +225 -0
  595. package/src/shared/completion-owner.d.ts +7 -0
  596. package/src/shared/completion-owner.js +13 -0
  597. package/src/shared/disabled-features.d.ts +93 -0
  598. package/src/shared/disabled-features.js +120 -0
  599. package/src/shared/display-text.d.ts +5 -0
  600. package/src/shared/display-text.js +154 -0
  601. package/src/shared/edit-distance.d.ts +4 -0
  602. package/src/shared/edit-distance.js +32 -0
  603. package/src/shared/extension-context.d.ts +21 -0
  604. package/src/shared/extension-context.js +39 -0
  605. package/src/shared/file-coalescer.d.ts +11 -0
  606. package/src/shared/file-coalescer.js +34 -0
  607. package/src/shared/file-lease.d.ts +10 -0
  608. package/src/shared/file-lease.js +106 -0
  609. package/src/shared/file-system-retry.d.ts +31 -0
  610. package/src/shared/file-system-retry.js +84 -0
  611. package/src/shared/fork-context.d.ts +64 -0
  612. package/src/shared/fork-context.js +185 -0
  613. package/src/shared/fork-session-cwd.d.ts +2 -0
  614. package/src/shared/fork-session-cwd.js +23 -0
  615. package/src/shared/formatters.d.ts +35 -0
  616. package/src/shared/formatters.js +137 -0
  617. package/src/shared/jsonl-writer.d.ts +20 -0
  618. package/src/shared/jsonl-writer.js +67 -0
  619. package/src/shared/launch-contract.d.ts +65 -0
  620. package/src/shared/launch-contract.js +145 -0
  621. package/src/shared/model-info.d.ts +55 -0
  622. package/src/shared/model-info.js +103 -0
  623. package/src/shared/model-response-aliases.d.ts +1 -0
  624. package/src/shared/model-response-aliases.js +15 -0
  625. package/src/shared/node-executable.d.ts +1 -0
  626. package/src/shared/node-executable.js +20 -0
  627. package/src/shared/opencode-session-headers.d.ts +12 -0
  628. package/src/shared/opencode-session-headers.js +26 -0
  629. package/src/shared/package-version.d.ts +2 -0
  630. package/src/shared/package-version.js +14 -0
  631. package/src/shared/parent-wake.d.ts +26 -0
  632. package/src/shared/parent-wake.js +68 -0
  633. package/src/shared/permission-profile.d.ts +26 -0
  634. package/src/shared/permission-profile.js +49 -0
  635. package/src/shared/prompt-resources.d.ts +5 -0
  636. package/src/shared/prompt-resources.js +10 -0
  637. package/src/shared/provider-diagnostics.d.ts +9 -0
  638. package/src/shared/provider-diagnostics.js +75 -0
  639. package/src/shared/pruned-fork.d.ts +34 -0
  640. package/src/shared/pruned-fork.js +434 -0
  641. package/src/shared/required-child-extensions.d.ts +34 -0
  642. package/src/shared/required-child-extensions.js +105 -0
  643. package/src/shared/runtime-module-path.d.ts +10 -0
  644. package/src/shared/runtime-module-path.js +16 -0
  645. package/src/shared/sandbox-profile.d.ts +12 -0
  646. package/src/shared/sandbox-profile.js +35 -0
  647. package/src/shared/session-file-trust.d.ts +1 -0
  648. package/src/shared/session-file-trust.js +20 -0
  649. package/src/shared/session-identity.d.ts +8 -0
  650. package/src/shared/session-identity.js +32 -0
  651. package/src/shared/session-succession.d.ts +4 -0
  652. package/src/shared/session-succession.js +24 -0
  653. package/src/shared/session-tokens.d.ts +2 -0
  654. package/src/shared/session-tokens.js +58 -0
  655. package/src/shared/settings-file-lease.d.ts +4 -0
  656. package/src/shared/settings-file-lease.js +38 -0
  657. package/src/shared/settings.d.ts +146 -0
  658. package/src/shared/settings.js +247 -0
  659. package/src/shared/shortcuts.d.ts +1 -0
  660. package/src/shared/shortcuts.js +17 -0
  661. package/src/shared/status-format.d.ts +9 -0
  662. package/src/shared/status-format.js +60 -0
  663. package/src/shared/thinking-ceiling.d.ts +13 -0
  664. package/src/shared/thinking-ceiling.js +37 -0
  665. package/src/shared/types.d.ts +2842 -0
  666. package/src/shared/types.js +276 -0
  667. package/src/shared/utf8.d.ts +5 -0
  668. package/src/shared/utf8.js +12 -0
  669. package/src/shared/utils.d.ts +83 -0
  670. package/src/shared/utils.js +612 -0
  671. package/src/shared/watch-strategy.d.ts +2 -0
  672. package/src/shared/watch-strategy.js +5 -0
  673. package/src/shared/workflow-child-permit.d.ts +58 -0
  674. package/src/shared/workflow-child-permit.js +159 -0
  675. package/src/slash/delegation-adapters.d.ts +154 -0
  676. package/src/slash/delegation-adapters.js +316 -0
  677. package/src/slash/delegation-json.d.ts +10 -0
  678. package/src/slash/delegation-json.js +117 -0
  679. package/src/slash/delegation-request.d.ts +12 -0
  680. package/src/slash/delegation-request.js +174 -0
  681. package/src/slash/prompt-template-bridge.d.ts +29 -0
  682. package/src/slash/prompt-template-bridge.js +399 -0
  683. package/src/slash/prompt-workflows.d.ts +21 -0
  684. package/src/slash/prompt-workflows.js +274 -0
  685. package/src/slash/selector.d.ts +47 -0
  686. package/src/slash/selector.js +117 -0
  687. package/src/slash/slash-bridge.d.ts +30 -0
  688. package/src/slash/slash-bridge.js +132 -0
  689. package/src/slash/slash-commands.d.ts +10 -0
  690. package/src/slash/slash-commands.js +1059 -0
  691. package/src/slash/slash-live-state.d.ts +21 -0
  692. package/src/slash/slash-live-state.js +263 -0
  693. package/src/slash/subagent-cost.d.ts +29 -0
  694. package/src/slash/subagent-cost.js +310 -0
  695. package/src/slash/subagents-admin.d.ts +3 -0
  696. package/src/slash/subagents-admin.js +481 -0
  697. package/src/tui/fleet-layout.d.ts +20 -0
  698. package/src/tui/fleet-layout.js +17 -0
  699. package/src/tui/fleet-native-transcript.d.ts +53 -0
  700. package/src/tui/fleet-native-transcript.js +339 -0
  701. package/src/tui/fleet-status.d.ts +92 -0
  702. package/src/tui/fleet-status.js +1132 -0
  703. package/src/tui/fleet-transcript.d.ts +64 -0
  704. package/src/tui/fleet-transcript.js +544 -0
  705. package/src/tui/fleet-viewport.d.ts +12 -0
  706. package/src/tui/fleet-viewport.js +35 -0
  707. package/src/tui/fleet.d.ts +196 -0
  708. package/src/tui/fleet.js +1588 -0
  709. package/src/tui/mouse-events.d.ts +21 -0
  710. package/src/tui/mouse-events.js +26 -0
  711. package/src/tui/render-helpers.d.ts +23 -0
  712. package/src/tui/render-helpers.js +100 -0
  713. package/src/tui/render.d.ts +66 -0
  714. package/src/tui/render.js +3707 -0
  715. package/src/tui/running-tone.d.ts +10 -0
  716. package/src/tui/running-tone.js +22 -0
  717. package/src/tui/subagent-messages.d.ts +22 -0
  718. package/src/tui/subagent-messages.js +270 -0
  719. package/src/ui-silent-marker.d.ts +20 -0
  720. package/src/ui-silent-marker.js +25 -0
  721. package/src/watchdog/change-signature.d.ts +7 -0
  722. package/src/watchdog/change-signature.js +243 -0
  723. package/src/watchdog/child-status.d.ts +53 -0
  724. package/src/watchdog/child-status.js +187 -0
  725. package/src/watchdog/diff-tool.d.ts +25 -0
  726. package/src/watchdog/diff-tool.js +104 -0
  727. package/src/watchdog/emission-guard.d.ts +36 -0
  728. package/src/watchdog/emission-guard.js +97 -0
  729. package/src/watchdog/guidance.d.ts +3 -0
  730. package/src/watchdog/guidance.js +19 -0
  731. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  732. package/src/watchdog/lsp-diagnostics.js +489 -0
  733. package/src/watchdog/model-selection.d.ts +24 -0
  734. package/src/watchdog/model-selection.js +167 -0
  735. package/src/watchdog/permission-arbiter.d.ts +20 -0
  736. package/src/watchdog/permission-arbiter.js +135 -0
  737. package/src/watchdog/register-child.d.ts +13 -0
  738. package/src/watchdog/register-child.js +128 -0
  739. package/src/watchdog/register-main.d.ts +11 -0
  740. package/src/watchdog/register-main.js +400 -0
  741. package/src/watchdog/render.d.ts +3 -0
  742. package/src/watchdog/render.js +33 -0
  743. package/src/watchdog/review.d.ts +36 -0
  744. package/src/watchdog/review.js +319 -0
  745. package/src/watchdog/rules.d.ts +21 -0
  746. package/src/watchdog/rules.js +58 -0
  747. package/src/watchdog/runtime.d.ts +195 -0
  748. package/src/watchdog/runtime.js +864 -0
  749. package/src/watchdog/scope.d.ts +14 -0
  750. package/src/watchdog/scope.js +44 -0
  751. package/src/watchdog/settings.d.ts +29 -0
  752. package/src/watchdog/settings.js +480 -0
  753. package/src/watchdog/tool-actions.d.ts +17 -0
  754. package/src/watchdog/tool-actions.js +150 -0
  755. package/src/watchdog/turn-delta.d.ts +15 -0
  756. package/src/watchdog/turn-delta.js +188 -0
  757. package/src/watchdog/types.d.ts +141 -0
  758. package/src/watchdog/types.js +27 -0
  759. package/src/watchdog/warning-format.d.ts +7 -0
  760. package/src/watchdog/warning-format.js +59 -0
  761. package/src/workflows/chat-progress.d.ts +37 -0
  762. package/src/workflows/chat-progress.js +129 -0
  763. package/src/workflows/host-command.d.ts +30 -0
  764. package/src/workflows/host-command.js +227 -0
  765. package/src/workflows/scripted-workflow.d.ts +204 -0
  766. package/src/workflows/scripted-workflow.js +1673 -0
  767. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  768. package/src/workflows/structured-workflow-scripts.js +179 -0
  769. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  770. package/src/workflows/workflow-auto-resume.js +102 -0
  771. package/src/workflows/workflow-checklist.d.ts +127 -0
  772. package/src/workflows/workflow-checklist.js +314 -0
  773. package/src/workflows/workflow-child-summary.d.ts +24 -0
  774. package/src/workflows/workflow-child-summary.js +195 -0
  775. package/src/workflows/workflow-launch-record.d.ts +27 -0
  776. package/src/workflows/workflow-launch-record.js +48 -0
  777. package/src/workflows/workflow-preflight.d.ts +58 -0
  778. package/src/workflows/workflow-preflight.js +288 -0
  779. package/src/workflows/workflow-receipt.d.ts +34 -0
  780. package/src/workflows/workflow-receipt.js +454 -0
  781. package/src/workflows/workflow-resources.d.ts +55 -0
  782. package/src/workflows/workflow-resources.js +271 -0
  783. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  784. package/src/workflows/workflow-resume-claim.js +210 -0
  785. package/src/workflows/workflow-resume.d.ts +56 -0
  786. package/src/workflows/workflow-resume.js +106 -0
  787. package/src/workflows/workflow-reuse.d.ts +61 -0
  788. package/src/workflows/workflow-reuse.js +186 -0
  789. package/src/workflows/workflow-revival.d.ts +33 -0
  790. package/src/workflows/workflow-revival.js +111 -0
  791. package/src/workflows/workflow-settlement.d.ts +84 -0
  792. package/src/workflows/workflow-settlement.js +203 -0
  793. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  794. package/src/workflows/workflow-stop-cause.js +8 -0
  795. package/workflow-script-worker.cjs +1342 -0
  796. package/index.ts +0 -18
  797. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  798. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  799. package/skills/pi-subagents/references/execution-controls.md +0 -561
  800. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  801. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  802. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  803. package/src/agents/advertised-agent-prompt.ts +0 -82
  804. package/src/agents/agent-eject.ts +0 -339
  805. package/src/agents/agent-management.ts +0 -1442
  806. package/src/agents/agent-memory.ts +0 -341
  807. package/src/agents/agent-refinements.ts +0 -624
  808. package/src/agents/agent-scope.ts +0 -10
  809. package/src/agents/agent-selection.ts +0 -25
  810. package/src/agents/agent-serializer.ts +0 -195
  811. package/src/agents/agents.ts +0 -3169
  812. package/src/agents/builtin-names.ts +0 -16
  813. package/src/agents/chain-serializer.ts +0 -285
  814. package/src/agents/frontmatter.ts +0 -153
  815. package/src/agents/global-npm-root.ts +0 -58
  816. package/src/agents/identity.ts +0 -30
  817. package/src/agents/proactive-skills.ts +0 -197
  818. package/src/agents/runtime-agent-events.ts +0 -70
  819. package/src/agents/runtime-agent-registry.ts +0 -457
  820. package/src/agents/runtime-discovery.ts +0 -39
  821. package/src/agents/skills.ts +0 -787
  822. package/src/api/agent-management.ts +0 -9
  823. package/src/api/agents.ts +0 -19
  824. package/src/api/background-work.ts +0 -206
  825. package/src/api/capability-ceiling.ts +0 -16
  826. package/src/api/child-tool-plan.ts +0 -5
  827. package/src/api/control-channel.ts +0 -4
  828. package/src/api/delegation.ts +0 -131
  829. package/src/api/external-job-provider.ts +0 -195
  830. package/src/api/external-runs.ts +0 -282
  831. package/src/api/inspectors.ts +0 -27
  832. package/src/api/intercom-bridge.ts +0 -3
  833. package/src/api/preflight.ts +0 -641
  834. package/src/api/project-panes.ts +0 -32
  835. package/src/api/required-child-extensions.ts +0 -6
  836. package/src/api/shared-types.ts +0 -29
  837. package/src/api/supervisor-routing.ts +0 -196
  838. package/src/api/workflow-resources.ts +0 -6
  839. package/src/extension/config.ts +0 -262
  840. package/src/extension/context-injection.ts +0 -123
  841. package/src/extension/control-notices.ts +0 -53
  842. package/src/extension/declaration-pinning.ts +0 -164
  843. package/src/extension/doctor.ts +0 -284
  844. package/src/extension/fanout-child.ts +0 -282
  845. package/src/extension/herdr-pi-bridge.ts +0 -166
  846. package/src/extension/index.ts +0 -1212
  847. package/src/extension/public-execution.ts +0 -262
  848. package/src/extension/reply-workflow-script.ts +0 -67
  849. package/src/extension/rpc.ts +0 -881
  850. package/src/extension/schemas.ts +0 -337
  851. package/src/extension/steering-notices.ts +0 -35
  852. package/src/extension/subagent-guide.ts +0 -127
  853. package/src/extension/subagent-options.ts +0 -47
  854. package/src/extension/tool-activation.ts +0 -147
  855. package/src/extension/tool-description.ts +0 -193
  856. package/src/extension/tool-result.ts +0 -19
  857. package/src/extension/upgrade-notice.ts +0 -40
  858. package/src/inspectors/actions.ts +0 -174
  859. package/src/inspectors/ghostty/actions.ts +0 -74
  860. package/src/inspectors/ghostty/plugin.ts +0 -29
  861. package/src/inspectors/herdr/actions.ts +0 -155
  862. package/src/inspectors/herdr/client.ts +0 -130
  863. package/src/inspectors/herdr/focus.ts +0 -55
  864. package/src/inspectors/herdr/plugin.ts +0 -20
  865. package/src/inspectors/herdr/project-panes.ts +0 -733
  866. package/src/inspectors/inspector-runner.ts +0 -153
  867. package/src/inspectors/plugins.ts +0 -76
  868. package/src/inspectors/session-roots-codec.ts +0 -31
  869. package/src/inspectors/shell-command.ts +0 -16
  870. package/src/inspectors/tmux/actions.ts +0 -204
  871. package/src/inspectors/tmux/client.ts +0 -85
  872. package/src/inspectors/tmux/plugin.ts +0 -21
  873. package/src/inspectors/types.ts +0 -51
  874. package/src/integrations/herdr-status.ts +0 -385
  875. package/src/integrations/pi-web-session-liveness.ts +0 -73
  876. package/src/integrations/program-status.ts +0 -215
  877. package/src/intercom/fork-supervisor-routing.ts +0 -533
  878. package/src/intercom/intercom-bridge.ts +0 -235
  879. package/src/intercom/native-supervisor-channel.ts +0 -1066
  880. package/src/intercom/result-intercom.ts +0 -433
  881. package/src/intercom/supervisor-ui.ts +0 -72
  882. package/src/missions/actions.ts +0 -433
  883. package/src/missions/goal-driver.ts +0 -177
  884. package/src/missions/lifecycle.ts +0 -367
  885. package/src/missions/store.ts +0 -613
  886. package/src/missions/types.ts +0 -190
  887. package/src/missions/workflow-state.ts +0 -281
  888. package/src/policy/authority.ts +0 -50
  889. package/src/profiles/profiles.ts +0 -674
  890. package/src/runs/background/active-async-capacity.ts +0 -548
  891. package/src/runs/background/active-run-index.ts +0 -155
  892. package/src/runs/background/async-execution.ts +0 -2479
  893. package/src/runs/background/async-job-tracker.ts +0 -869
  894. package/src/runs/background/async-resume.ts +0 -686
  895. package/src/runs/background/async-retention.ts +0 -953
  896. package/src/runs/background/async-status-snapshot.ts +0 -46
  897. package/src/runs/background/async-status.ts +0 -787
  898. package/src/runs/background/auto-drain.ts +0 -92
  899. package/src/runs/background/await-async-run.ts +0 -83
  900. package/src/runs/background/binary-bootstrap.ts +0 -67
  901. package/src/runs/background/calendar-schedule.ts +0 -90
  902. package/src/runs/background/chain-append.ts +0 -321
  903. package/src/runs/background/chain-root-attachment.ts +0 -263
  904. package/src/runs/background/completion-batcher.ts +0 -168
  905. package/src/runs/background/completion-dedupe.ts +0 -58
  906. package/src/runs/background/completion-replay.ts +0 -287
  907. package/src/runs/background/control-channel.ts +0 -659
  908. package/src/runs/background/fleet-view.ts +0 -692
  909. package/src/runs/background/index-segment.ts +0 -59
  910. package/src/runs/background/inspect-rpc.ts +0 -443
  911. package/src/runs/background/notify.ts +0 -1083
  912. package/src/runs/background/owned-process-tree.ts +0 -131
  913. package/src/runs/background/parallel-groups.ts +0 -45
  914. package/src/runs/background/pid-namespace.ts +0 -18
  915. package/src/runs/background/process-terminal-candidate.ts +0 -98
  916. package/src/runs/background/process-terminal.ts +0 -231
  917. package/src/runs/background/result-delivery-ownership.ts +0 -45
  918. package/src/runs/background/result-files.ts +0 -634
  919. package/src/runs/background/result-watcher.ts +0 -842
  920. package/src/runs/background/resume-guidance.ts +0 -56
  921. package/src/runs/background/retained-children.ts +0 -136
  922. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  923. package/src/runs/background/run-child-session.ts +0 -725
  924. package/src/runs/background/run-id-query.ts +0 -7
  925. package/src/runs/background/run-id-resolver.ts +0 -183
  926. package/src/runs/background/run-status.ts +0 -803
  927. package/src/runs/background/runner-aliases.ts +0 -183
  928. package/src/runs/background/runner-child-launch.ts +0 -96
  929. package/src/runs/background/runner-child-sessions.ts +0 -32
  930. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  931. package/src/runs/background/runner-startup-failure.ts +0 -56
  932. package/src/runs/background/scheduled-runs.ts +0 -1222
  933. package/src/runs/background/stale-run-reconciler.ts +0 -463
  934. package/src/runs/background/steering.ts +0 -260
  935. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  936. package/src/runs/background/subagent-runner.ts +0 -5251
  937. package/src/runs/background/subagent-wait.ts +0 -895
  938. package/src/runs/background/terminal-run-index.ts +0 -183
  939. package/src/runs/background/top-level-async.ts +0 -14
  940. package/src/runs/background/wait-completions.ts +0 -262
  941. package/src/runs/background/wait-config.ts +0 -50
  942. package/src/runs/background/wait-subscriptions.ts +0 -354
  943. package/src/runs/background/wait-tool.ts +0 -57
  944. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  945. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  946. package/src/runs/foreground/async-steering-action.ts +0 -276
  947. package/src/runs/foreground/async-stop-action.ts +0 -216
  948. package/src/runs/foreground/command-action.ts +0 -41
  949. package/src/runs/foreground/execution.ts +0 -2315
  950. package/src/runs/foreground/foreground-control.ts +0 -157
  951. package/src/runs/foreground/foreground-history.ts +0 -164
  952. package/src/runs/foreground/prompt-audit.ts +0 -172
  953. package/src/runs/foreground/subagent-executor.ts +0 -8252
  954. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  955. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  956. package/src/runs/shared/abort-recovery.ts +0 -119
  957. package/src/runs/shared/acceptance.ts +0 -1664
  958. package/src/runs/shared/agent-contract.ts +0 -38
  959. package/src/runs/shared/async-status-projection.ts +0 -664
  960. package/src/runs/shared/background-process-options.ts +0 -9
  961. package/src/runs/shared/capability-ceiling.ts +0 -214
  962. package/src/runs/shared/chain-outputs.ts +0 -116
  963. package/src/runs/shared/child-commands.ts +0 -229
  964. package/src/runs/shared/child-hooks.ts +0 -175
  965. package/src/runs/shared/child-identity.ts +0 -62
  966. package/src/runs/shared/child-launch-plan.ts +0 -163
  967. package/src/runs/shared/child-launch.ts +0 -389
  968. package/src/runs/shared/child-lifecycle.ts +0 -28
  969. package/src/runs/shared/child-runtime-config.ts +0 -136
  970. package/src/runs/shared/child-session.ts +0 -699
  971. package/src/runs/shared/child-tool-plan.ts +0 -599
  972. package/src/runs/shared/claude-code-adapter.ts +0 -288
  973. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  974. package/src/runs/shared/context-mode.ts +0 -44
  975. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  976. package/src/runs/shared/dynamic-fanout.ts +0 -297
  977. package/src/runs/shared/effective-system-prompt.ts +0 -33
  978. package/src/runs/shared/extension-bindings.ts +0 -103
  979. package/src/runs/shared/external-cli-contract.ts +0 -177
  980. package/src/runs/shared/external-cli-preflight.ts +0 -190
  981. package/src/runs/shared/external-cli-runner.ts +0 -437
  982. package/src/runs/shared/external-job-bridge.ts +0 -514
  983. package/src/runs/shared/external-job-runner.ts +0 -389
  984. package/src/runs/shared/fast-mode-extension.ts +0 -10
  985. package/src/runs/shared/fork-command-result.ts +0 -10
  986. package/src/runs/shared/git-environment.ts +0 -29
  987. package/src/runs/shared/herdr-connection.ts +0 -134
  988. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  989. package/src/runs/shared/herdr-machine.ts +0 -279
  990. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  991. package/src/runs/shared/herdr-placed-run.ts +0 -264
  992. package/src/runs/shared/host-step-status.ts +0 -231
  993. package/src/runs/shared/lane-metadata.ts +0 -126
  994. package/src/runs/shared/launch-cwd.ts +0 -16
  995. package/src/runs/shared/long-running-guard.ts +0 -221
  996. package/src/runs/shared/mcp-config-sources.ts +0 -426
  997. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  998. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  999. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  1000. package/src/runs/shared/model-resolution.ts +0 -503
  1001. package/src/runs/shared/model-scope.ts +0 -224
  1002. package/src/runs/shared/mutation-evidence.ts +0 -199
  1003. package/src/runs/shared/nested-events.ts +0 -1125
  1004. package/src/runs/shared/nested-path.ts +0 -38
  1005. package/src/runs/shared/nested-render.ts +0 -127
  1006. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1007. package/src/runs/shared/parallel-handoff.ts +0 -789
  1008. package/src/runs/shared/parallel-utils.ts +0 -292
  1009. package/src/runs/shared/partial-output.ts +0 -48
  1010. package/src/runs/shared/permissions.ts +0 -86
  1011. package/src/runs/shared/pi-spawn.ts +0 -205
  1012. package/src/runs/shared/process-signal.ts +0 -35
  1013. package/src/runs/shared/profile-extensions.ts +0 -134
  1014. package/src/runs/shared/profile-launch-env.ts +0 -121
  1015. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1016. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1017. package/src/runs/shared/run-history.ts +0 -288
  1018. package/src/runs/shared/runner-launcher.ts +0 -25
  1019. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1020. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1021. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1022. package/src/runs/shared/session-lease.ts +0 -293
  1023. package/src/runs/shared/single-output.ts +0 -366
  1024. package/src/runs/shared/spawn-budget.ts +0 -128
  1025. package/src/runs/shared/structured-output.ts +0 -463
  1026. package/src/runs/shared/subagent-control.ts +0 -295
  1027. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1028. package/src/runs/shared/tool-availability.ts +0 -37
  1029. package/src/runs/shared/tool-budget.ts +0 -87
  1030. package/src/runs/shared/tool-timeout.ts +0 -93
  1031. package/src/runs/shared/usage-budget.ts +0 -65
  1032. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1033. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1034. package/src/runs/shared/workflow-graph.ts +0 -225
  1035. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1036. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1037. package/src/runs/shared/worktree-lock.ts +0 -29
  1038. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1039. package/src/runs/shared/worktree.ts +0 -1554
  1040. package/src/shared/accessible-dir.ts +0 -47
  1041. package/src/shared/agent-stream-options.ts +0 -5
  1042. package/src/shared/artifacts.ts +0 -281
  1043. package/src/shared/atomic-json.ts +0 -85
  1044. package/src/shared/capacity-resilient-json.ts +0 -102
  1045. package/src/shared/child-cache-retention.ts +0 -43
  1046. package/src/shared/child-session-name.ts +0 -48
  1047. package/src/shared/child-transcript.ts +0 -264
  1048. package/src/shared/completion-owner.ts +0 -14
  1049. package/src/shared/disabled-features.ts +0 -123
  1050. package/src/shared/display-text.ts +0 -150
  1051. package/src/shared/edit-distance.ts +0 -33
  1052. package/src/shared/extension-context.ts +0 -37
  1053. package/src/shared/file-coalescer.ts +0 -49
  1054. package/src/shared/file-lease.ts +0 -74
  1055. package/src/shared/file-system-retry.ts +0 -95
  1056. package/src/shared/fork-context.ts +0 -243
  1057. package/src/shared/fork-session-cwd.ts +0 -27
  1058. package/src/shared/formatters.ts +0 -142
  1059. package/src/shared/jsonl-writer.ts +0 -92
  1060. package/src/shared/launch-contract.ts +0 -206
  1061. package/src/shared/model-info.ts +0 -132
  1062. package/src/shared/model-response-aliases.ts +0 -13
  1063. package/src/shared/node-executable.ts +0 -21
  1064. package/src/shared/opencode-session-headers.ts +0 -30
  1065. package/src/shared/package-version.ts +0 -17
  1066. package/src/shared/parent-wake.ts +0 -79
  1067. package/src/shared/permission-profile.ts +0 -56
  1068. package/src/shared/prompt-resources.ts +0 -11
  1069. package/src/shared/pruned-fork.ts +0 -469
  1070. package/src/shared/required-child-extensions.ts +0 -115
  1071. package/src/shared/runtime-module-path.ts +0 -19
  1072. package/src/shared/sandbox-profile.ts +0 -37
  1073. package/src/shared/session-file-trust.ts +0 -19
  1074. package/src/shared/session-identity.ts +0 -10
  1075. package/src/shared/session-tokens.ts +0 -55
  1076. package/src/shared/settings-file-lease.ts +0 -36
  1077. package/src/shared/settings.ts +0 -412
  1078. package/src/shared/shortcuts.ts +0 -13
  1079. package/src/shared/status-format.ts +0 -55
  1080. package/src/shared/thinking-ceiling.ts +0 -46
  1081. package/src/shared/types.ts +0 -3105
  1082. package/src/shared/utf8.ts +0 -11
  1083. package/src/shared/utils.ts +0 -610
  1084. package/src/shared/watch-strategy.ts +0 -12
  1085. package/src/shared/workflow-child-permit.ts +0 -212
  1086. package/src/slash/delegation-adapters.ts +0 -452
  1087. package/src/slash/delegation-json.ts +0 -108
  1088. package/src/slash/delegation-request.ts +0 -176
  1089. package/src/slash/prompt-template-bridge.ts +0 -435
  1090. package/src/slash/prompt-workflows.ts +0 -298
  1091. package/src/slash/selector.ts +0 -147
  1092. package/src/slash/slash-bridge.ts +0 -192
  1093. package/src/slash/slash-commands.ts +0 -1096
  1094. package/src/slash/slash-live-state.ts +0 -310
  1095. package/src/slash/subagent-cost.ts +0 -317
  1096. package/src/slash/subagents-admin.ts +0 -489
  1097. package/src/tui/fleet-native-transcript.ts +0 -424
  1098. package/src/tui/fleet-status.ts +0 -1139
  1099. package/src/tui/fleet-transcript.ts +0 -591
  1100. package/src/tui/fleet.ts +0 -1618
  1101. package/src/tui/mouse-events.ts +0 -42
  1102. package/src/tui/render-helpers.ts +0 -111
  1103. package/src/tui/render.ts +0 -3824
  1104. package/src/tui/running-tone.ts +0 -28
  1105. package/src/tui/subagent-messages.ts +0 -305
  1106. package/src/ui-silent-marker.ts +0 -32
  1107. package/src/watchdog/change-signature.ts +0 -260
  1108. package/src/watchdog/child-status.ts +0 -225
  1109. package/src/watchdog/diff-tool.ts +0 -112
  1110. package/src/watchdog/emission-guard.ts +0 -125
  1111. package/src/watchdog/guidance.ts +0 -20
  1112. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1113. package/src/watchdog/model-selection.ts +0 -187
  1114. package/src/watchdog/permission-arbiter.ts +0 -154
  1115. package/src/watchdog/register-child.ts +0 -136
  1116. package/src/watchdog/register-main.ts +0 -425
  1117. package/src/watchdog/render.ts +0 -31
  1118. package/src/watchdog/review.ts +0 -362
  1119. package/src/watchdog/rules.ts +0 -70
  1120. package/src/watchdog/runtime.ts +0 -927
  1121. package/src/watchdog/scope.ts +0 -51
  1122. package/src/watchdog/settings.ts +0 -520
  1123. package/src/watchdog/tool-actions.ts +0 -156
  1124. package/src/watchdog/turn-delta.ts +0 -190
  1125. package/src/watchdog/types.ts +0 -186
  1126. package/src/watchdog/warning-format.ts +0 -72
  1127. package/src/workflows/chat-progress.ts +0 -152
  1128. package/src/workflows/host-command.ts +0 -235
  1129. package/src/workflows/scripted-workflow.ts +0 -2733
  1130. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1131. package/src/workflows/workflow-checklist.ts +0 -442
  1132. package/src/workflows/workflow-child-summary.ts +0 -172
  1133. package/src/workflows/workflow-preflight.ts +0 -297
  1134. package/src/workflows/workflow-receipt.ts +0 -390
  1135. package/src/workflows/workflow-resources.ts +0 -275
  1136. package/src/workflows/workflow-reuse.ts +0 -120
  1137. package/src/workflows/workflow-revival.ts +0 -123
  1138. package/src/workflows/workflow-settlement.ts +0 -252
@@ -0,0 +1,783 @@
1
+ import { withHandoffWriteLock, withRepositoryWorktreeLock } from "./worktree-lock.js";
2
+ import * as fs from "node:fs";
3
+ import * as path from "node:path";
4
+ import { writeAtomicJson } from "../../shared/atomic-json.js";
5
+ import { stableJsonDigest } from "../../shared/launch-contract.js";
6
+ import { cleanupWorktrees, withWorktreeTransaction } from "./worktree.js";
7
+ import { assertWorkflowLaneKey, normalizeWorkflowLaneMetadata } from "./lane-metadata.js";
8
+ function optionalIdentity(value, label) {
9
+ if (value === undefined)
10
+ return undefined;
11
+ if (typeof value !== "string" || !value.trim())
12
+ throw new Error(`${label} must be a non-empty string.`);
13
+ return value.trim();
14
+ }
15
+ function nonNegativeIndex(value, label) {
16
+ if (!Number.isSafeInteger(value) || value < 0)
17
+ throw new Error(`${label} must be a non-negative integer.`);
18
+ return value;
19
+ }
20
+ function normalizeLaneBinding(value, label) {
21
+ if (!value || typeof value !== "object" || Array.isArray(value))
22
+ throw new Error(`${label} must be an object.`);
23
+ const binding = value;
24
+ const unknown = Object.keys(binding).filter((field) => !["index", "taskIndex", "workflowKey", "runId", "lane"].includes(field));
25
+ if (unknown.length > 0)
26
+ throw new Error(`${label} has unsupported fields: ${unknown.join(", ")}.`);
27
+ const index = nonNegativeIndex(binding.index, `${label}.index`);
28
+ const taskIndex = nonNegativeIndex(binding.taskIndex, `${label}.taskIndex`);
29
+ const workflowKey = optionalIdentity(binding.workflowKey, `${label}.workflowKey`);
30
+ const runId = optionalIdentity(binding.runId, `${label}.runId`);
31
+ const lane = normalizeWorkflowLaneMetadata(binding.lane, `${label}.lane`);
32
+ assertWorkflowLaneKey(lane, workflowKey, `${label}.lane`);
33
+ return {
34
+ index,
35
+ taskIndex,
36
+ ...(workflowKey ? { workflowKey } : {}),
37
+ ...(runId ? { runId } : {}),
38
+ ...(lane ? { lane } : {}),
39
+ };
40
+ }
41
+ function validateManifestIdentity(parsed, manifestPath) {
42
+ if (parsed.version !== 1 || !Array.isArray(parsed.groups)) {
43
+ throw new Error(`Invalid parallel handoff manifest: ${manifestPath}`);
44
+ }
45
+ if (typeof parsed.runId !== "string" || !parsed.runId.trim())
46
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': runId must be a non-empty string.`);
47
+ parsed.runId = parsed.runId.trim();
48
+ const workflowKeys = new Set();
49
+ const childRunIds = new Set();
50
+ const childIndexes = new Set();
51
+ for (const [groupIndex, group] of parsed.groups.entries()) {
52
+ if (!group || typeof group !== "object" || !Array.isArray(group.children) || !group.cleanup || !Array.isArray(group.cleanup.tasks))
53
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}] is malformed.`);
54
+ if (group.laneBindings !== undefined) {
55
+ if (!Array.isArray(group.laneBindings))
56
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].laneBindings must be an array.`);
57
+ const taskIndexes = new Set();
58
+ const cleanupIndexes = new Set(group.cleanup.tasks.map((task) => task.index));
59
+ group.laneBindings = group.laneBindings.map((binding, bindingIndex) => {
60
+ const normalized = normalizeLaneBinding(binding, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].laneBindings[${bindingIndex}]`);
61
+ if (taskIndexes.has(normalized.taskIndex))
62
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}] has duplicate lane binding taskIndex ${normalized.taskIndex}.`);
63
+ if (!cleanupIndexes.has(normalized.taskIndex))
64
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].laneBindings[${bindingIndex}] has no cleanup task for taskIndex ${normalized.taskIndex}.`);
65
+ taskIndexes.add(normalized.taskIndex);
66
+ return normalized;
67
+ });
68
+ }
69
+ const taskIndexes = new Set();
70
+ for (const [childIndex, child] of group.children.entries()) {
71
+ if (!child || typeof child !== "object" || !child.patch || typeof child.patch !== "object")
72
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}] is malformed.`);
73
+ const childRecord = child;
74
+ const index = nonNegativeIndex(childRecord.index, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].index`);
75
+ const taskIndex = nonNegativeIndex(childRecord.taskIndex, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].taskIndex`);
76
+ if (taskIndexes.has(taskIndex))
77
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}] has duplicate child taskIndex ${taskIndex}.`);
78
+ taskIndexes.add(taskIndex);
79
+ if (childIndexes.has(index))
80
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': duplicate child index ${index}.`);
81
+ childIndexes.add(index);
82
+ if (!group.cleanup.tasks.some((task) => task.index === taskIndex))
83
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}] has no cleanup task for taskIndex ${taskIndex}.`);
84
+ const workflowKey = optionalIdentity(childRecord.workflowKey, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].workflowKey`);
85
+ const runId = optionalIdentity(childRecord.runId, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].runId`);
86
+ const lane = normalizeWorkflowLaneMetadata(childRecord.lane, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].lane`);
87
+ assertWorkflowLaneKey(lane, workflowKey, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].lane`);
88
+ if (workflowKey && workflowKeys.has(workflowKey))
89
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': duplicate workflow key '${workflowKey}'.`);
90
+ if (workflowKey)
91
+ workflowKeys.add(workflowKey);
92
+ if (runId && childRunIds.has(runId))
93
+ throw new Error(`Invalid parallel handoff manifest '${manifestPath}': duplicate child run id '${runId}'.`);
94
+ if (runId)
95
+ childRunIds.add(runId);
96
+ if (lane)
97
+ childRecord.lane = lane;
98
+ if (workflowKey)
99
+ childRecord.workflowKey = workflowKey;
100
+ if (runId)
101
+ childRecord.runId = runId;
102
+ childRecord.index = index;
103
+ childRecord.taskIndex = taskIndex;
104
+ }
105
+ }
106
+ return parsed;
107
+ }
108
+ export function readParallelHandoffManifest(manifestPath) {
109
+ if (!fs.existsSync(manifestPath))
110
+ return undefined;
111
+ const parsed = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
112
+ return validateManifestIdentity(parsed, manifestPath);
113
+ }
114
+ export function resolveParallelHandoffChild(input) {
115
+ const manifest = readParallelHandoffManifest(input.manifestPath);
116
+ if (!manifest)
117
+ return undefined;
118
+ if (manifest.runId !== input.runId)
119
+ throw new Error(`Managed worktree handoff belongs to run '${manifest.runId}', not '${input.runId}'.`);
120
+ const workflowKey = input.workflowKey?.trim() || undefined;
121
+ const childRunId = input.childRunId?.trim() || undefined;
122
+ if (!workflowKey && !childRunId)
123
+ throw new Error("Parallel handoff child resolution requires workflowKey or childRunId.");
124
+ const matches = manifest.groups.flatMap((group) => group.children.map((child) => ({ group, child }))).filter(({ child }) => {
125
+ if (workflowKey && child.workflowKey !== workflowKey)
126
+ return false;
127
+ if (childRunId && child.runId !== childRunId)
128
+ return false;
129
+ return true;
130
+ });
131
+ if (matches.length > 1)
132
+ throw new Error(`Parallel handoff has multiple children matching workflow identity${workflowKey ? ` '${workflowKey}'` : ` '${childRunId}'`}.`);
133
+ return matches[0];
134
+ }
135
+ function resolveExistingPath(candidate) {
136
+ try {
137
+ return fs.realpathSync(candidate);
138
+ }
139
+ catch {
140
+ return path.resolve(candidate);
141
+ }
142
+ }
143
+ function pathInside(root, candidate) {
144
+ const relative = path.relative(root, candidate);
145
+ return relative === "" || (relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative));
146
+ }
147
+ export async function protectRetainedWorktreeForResume(manifestPath, runId, childIndex, signal) {
148
+ const original = readParallelHandoffManifest(manifestPath);
149
+ const group = original?.groups.find((item) => item.children.some((child) => child.index === childIndex));
150
+ if (!group)
151
+ throw new Error("Retained worktree handoff disappeared before resume admission.");
152
+ return withWorktreeTransaction(() => withRepositoryWorktreeLock(group.repoRoot, () => withHandoffWriteLock(manifestPath, () => {
153
+ signal?.throwIfAborted();
154
+ const cwd = resolveRetainedWorktreeCwd(manifestPath, runId, childIndex);
155
+ if (!cwd)
156
+ throw new Error("Retained worktree ownership disappeared before resume admission.");
157
+ const manifest = readParallelHandoffManifest(manifestPath);
158
+ const currentGroup = manifest.groups.find((item) => item.children.some((child) => child.index === childIndex));
159
+ const child = currentGroup.children.find((item) => item.index === childIndex);
160
+ const task = currentGroup.cleanup.tasks.find((item) => item.index === child.taskIndex);
161
+ task.preserved = true;
162
+ task.reason = "retained child resume requires managed worktree cwd";
163
+ manifest.updatedAt = Date.now();
164
+ writeAtomicJson(manifestPath, manifest);
165
+ return cwd;
166
+ }), { signal }));
167
+ }
168
+ export function resolveRetainedWorktreeCwd(manifestPath, runId, childIndex, recordedWorktreePath) {
169
+ const manifest = readParallelHandoffManifest(manifestPath);
170
+ if (manifest && manifest.runId !== runId)
171
+ throw new Error(`Managed worktree handoff belongs to run '${manifest.runId}', not '${runId}'.`);
172
+ const match = manifest?.groups
173
+ .flatMap((group) => group.children.map((child) => ({ group, child })))
174
+ .find(({ child }) => child.index === childIndex);
175
+ if (!manifest || !match) {
176
+ if (recordedWorktreePath)
177
+ throw new Error(`Async run '${runId}' child ${childIndex} ran in managed worktree ${recordedWorktreePath}, but its handoff has no resumable record yet. Retry after the run settles; if it already ended, inspect ${manifestPath}.`);
178
+ return undefined;
179
+ }
180
+ const cleanup = match.group.cleanup.tasks.find((task) => task.index === match.child.taskIndex);
181
+ if (!cleanup)
182
+ throw new Error(`Async run '${runId}' child ${childIndex} has no managed worktree cleanup record.`);
183
+ const relativeCwd = path.relative(resolveExistingPath(match.group.repoRoot), resolveExistingPath(manifest.cwd));
184
+ if (path.isAbsolute(relativeCwd) || relativeCwd === ".." || relativeCwd.startsWith(`..${path.sep}`))
185
+ throw new Error(`Async run '${runId}' has an invalid managed worktree cwd.`);
186
+ const requiredCwd = path.join(cleanup.path, relativeCwd);
187
+ if (cleanup.worktreeRemoved || cleanup.branchRemoved)
188
+ throw new Error(`Async run '${runId}' required managed worktree was removed: ${requiredCwd}`);
189
+ // The runner removes the worktree right after this marker, without the locks that guard resume admission.
190
+ if (cleanup.reason?.includes("pending durable handoff capture"))
191
+ throw new Error(`Async run '${runId}' child ${childIndex} is still finalizing its managed worktree: ${requiredCwd}. Retry after the run settles; if it already ended, inspect ${manifestPath}.`);
192
+ let worktreeRoot = "";
193
+ let resolvedRequiredCwd = "";
194
+ try {
195
+ const rootStat = fs.lstatSync(cleanup.path);
196
+ if (!rootStat.isDirectory() || rootStat.isSymbolicLink())
197
+ throw new Error("worktree root is not a directory");
198
+ worktreeRoot = fs.realpathSync(cleanup.path);
199
+ if (!fs.statSync(requiredCwd).isDirectory())
200
+ throw new Error("path is not a directory");
201
+ resolvedRequiredCwd = fs.realpathSync(requiredCwd);
202
+ }
203
+ catch (error) {
204
+ throw new Error(`Async run '${runId}' required managed worktree cwd is missing: ${requiredCwd}`, { cause: error instanceof Error ? error : undefined });
205
+ }
206
+ if (!pathInside(worktreeRoot, resolvedRequiredCwd))
207
+ throw new Error(`Async run '${runId}' has an invalid managed worktree cwd.`);
208
+ return requiredCwd;
209
+ }
210
+ function referenceFor(manifestPath, manifest) {
211
+ const children = manifest.groups.flatMap((group) => group.children);
212
+ return {
213
+ version: 1,
214
+ path: manifestPath,
215
+ groupCount: manifest.groups.length,
216
+ childCount: children.length,
217
+ changedPatches: children.filter((child) => child.patch.changed).length,
218
+ cleanupState: manifest.groups.every((group) => group.cleanup.state === "complete") ? "complete" : "partial",
219
+ ...(Object.prototype.hasOwnProperty.call(manifest, "cleanupEligibility")
220
+ ? { cleanupEligibility: trustedStoredCleanupEligibility(manifest) }
221
+ : {}),
222
+ };
223
+ }
224
+ const COMMIT_PATTERN = /^[0-9a-f]{40}$/i;
225
+ const MANIFEST_DIGEST_PATTERN = /^[0-9a-f]{64}$/i;
226
+ const MAX_ATTESTATION_ACTOR_LENGTH = 128;
227
+ const MAX_ATTESTATION_TIMESTAMP_LENGTH = 64;
228
+ const MAX_SUPERSESSION_ID_LENGTH = 128;
229
+ function boundedString(value, label, maxBytes) {
230
+ if (typeof value !== "string" || !value.trim())
231
+ throw new Error(`${label} must be a non-empty string.`);
232
+ const normalized = value.trim();
233
+ if (normalized.includes("\n") || normalized.includes("\r"))
234
+ throw new Error(`${label} must not contain newlines.`);
235
+ if (Buffer.byteLength(normalized, "utf-8") > maxBytes)
236
+ throw new Error(`${label} must be at most ${maxBytes} bytes.`);
237
+ return normalized;
238
+ }
239
+ function commitString(value, label) {
240
+ const normalized = boundedString(value, label, 64).toLowerCase();
241
+ if (!COMMIT_PATTERN.test(normalized))
242
+ throw new Error(`${label} must be a full 40-character commit SHA.`);
243
+ return normalized;
244
+ }
245
+ function manifestDigestString(value, label) {
246
+ const normalized = boundedString(value, label, 64).toLowerCase();
247
+ if (!MANIFEST_DIGEST_PATTERN.test(normalized))
248
+ throw new Error(`${label} must be a full 64-character SHA-256 digest.`);
249
+ return normalized;
250
+ }
251
+ function manifestFactsDigest(manifest) {
252
+ return stableJsonDigest({
253
+ version: manifest.version,
254
+ runId: manifest.runId,
255
+ mode: manifest.mode,
256
+ source: manifest.source,
257
+ cwd: manifest.cwd,
258
+ groups: manifest.groups,
259
+ });
260
+ }
261
+ function attestationTimestamp(value) {
262
+ const normalized = boundedString(value, "attestedAt", MAX_ATTESTATION_TIMESTAMP_LENGTH);
263
+ if (!Number.isFinite(Date.parse(normalized)))
264
+ throw new Error("attestedAt must be a valid timestamp.");
265
+ return normalized;
266
+ }
267
+ function normalizeMergeEvidence(value) {
268
+ if (!value || typeof value !== "object" || Array.isArray(value))
269
+ throw new Error("merge must be an object.");
270
+ const merge = value;
271
+ const prNumber = merge.prNumber;
272
+ if (typeof prNumber !== "number" || !Number.isInteger(prNumber) || prNumber < 1)
273
+ throw new Error("merge.prNumber must be a positive integer.");
274
+ const treeEquivalent = merge.treeEquivalent;
275
+ if (treeEquivalent !== true && treeEquivalent !== false && treeEquivalent !== "unknown")
276
+ throw new Error("merge.treeEquivalent must be true, false, or 'unknown'.");
277
+ const postMergeChecks = merge.postMergeChecks;
278
+ if (postMergeChecks !== "recorded" && postMergeChecks !== "unknown")
279
+ throw new Error("merge.postMergeChecks must be 'recorded' or 'unknown'.");
280
+ return {
281
+ prNumber,
282
+ reviewedHead: commitString(merge.reviewedHead, "merge.reviewedHead"),
283
+ mergeCommit: commitString(merge.mergeCommit, "merge.mergeCommit"),
284
+ treeEquivalent,
285
+ postMergeChecks,
286
+ attestedBy: boundedString(merge.attestedBy, "merge.attestedBy", MAX_ATTESTATION_ACTOR_LENGTH),
287
+ attestedAt: attestationTimestamp(merge.attestedAt),
288
+ ...(merge.manifestDigest === undefined ? {} : { manifestDigest: manifestDigestString(merge.manifestDigest, "merge.manifestDigest") }),
289
+ };
290
+ }
291
+ function normalizeSupersessionEvidence(value) {
292
+ if (!value || typeof value !== "object" || Array.isArray(value))
293
+ throw new Error("supersession must be an object.");
294
+ const supersession = value;
295
+ return {
296
+ supersededBy: boundedString(supersession.supersededBy, "supersession.supersededBy", MAX_SUPERSESSION_ID_LENGTH),
297
+ attestedBy: boundedString(supersession.attestedBy, "supersession.attestedBy", MAX_ATTESTATION_ACTOR_LENGTH),
298
+ attestedAt: attestationTimestamp(supersession.attestedAt),
299
+ ...(supersession.manifestDigest === undefined ? {} : { manifestDigest: manifestDigestString(supersession.manifestDigest, "supersession.manifestDigest") }),
300
+ };
301
+ }
302
+ function normalizeStoredCleanupEligibility(value) {
303
+ if (!value || typeof value !== "object" || Array.isArray(value))
304
+ return { state: "unknown" };
305
+ const eligibility = value;
306
+ if (eligibility.state === "active" || eligibility.state === "terminal-eligible" || eligibility.state === "superseded-eligible" || eligibility.state === "unknown") {
307
+ return { state: eligibility.state };
308
+ }
309
+ if (eligibility.state === "terminal-blocked" && typeof eligibility.reason === "string" && eligibility.reason.trim() && !eligibility.reason.includes("\n") && !eligibility.reason.includes("\r")) {
310
+ return { state: "terminal-blocked", reason: eligibility.reason.trim().slice(0, 256) };
311
+ }
312
+ return { state: "unknown" };
313
+ }
314
+ const STORED_CHILD_STATUSES = new Set(["pending", "running", "completed", "complete", "failed", "paused", "stopped", "detached", "rejected"]);
315
+ export function isTerminalParallelHandoffChildStatus(status) {
316
+ return status === "completed" || status === "complete" || status === "failed" || status === "paused" || status === "stopped" || status === "rejected";
317
+ }
318
+ function hasValidStoredLaneShape(manifest) {
319
+ if (!manifest || typeof manifest !== "object" || manifest.version !== 1 || typeof manifest.runId !== "string" || !manifest.runId.trim() || !Array.isArray(manifest.groups) || manifest.groups.length === 0)
320
+ return false;
321
+ let hasManagedTask = false;
322
+ const valid = manifest.groups.every((group) => {
323
+ if (!group || typeof group !== "object" || typeof group.baseCommit !== "string" || !group.baseCommit.trim() || typeof group.repoRoot !== "string" || !group.repoRoot.trim())
324
+ return false;
325
+ const cleanup = group.cleanup;
326
+ if (!cleanup || typeof cleanup !== "object" || (cleanup.state !== "complete" && cleanup.state !== "partial") || !Array.isArray(cleanup.tasks) || !Array.isArray(group.children))
327
+ return false;
328
+ if (cleanup.tasks.some((task) => !task || typeof task !== "object" || !Number.isSafeInteger(task.index) || task.index < 0 || typeof task.path !== "string" || !task.path.trim() || typeof task.branch !== "string" || !task.branch.trim()))
329
+ return false;
330
+ if (cleanup.tasks.length > 0)
331
+ hasManagedTask = true;
332
+ return group.children.every((child) => Boolean(child) && typeof child === "object" && typeof child.status === "string" && STORED_CHILD_STATUSES.has(child.status));
333
+ });
334
+ return valid && hasManagedTask;
335
+ }
336
+ function trustedStoredCleanupEligibility(manifest) {
337
+ const eligibility = normalizeStoredCleanupEligibility(manifest.cleanupEligibility);
338
+ if (!hasValidStoredLaneShape(manifest))
339
+ return { state: "unknown" };
340
+ if (hasActiveChildren(manifest))
341
+ return { state: "active" };
342
+ if (eligibility.state === "active")
343
+ return cleanupEligibilityForEvidence(manifest);
344
+ if (eligibility.state === "terminal-eligible" || eligibility.state === "superseded-eligible") {
345
+ const current = cleanupEligibilityForEvidence(manifest);
346
+ if (current.state === eligibility.state || (current.state === "terminal-blocked" && / evidence is stale$/.test(current.reason)))
347
+ return current;
348
+ return { state: "unknown" };
349
+ }
350
+ return eligibility;
351
+ }
352
+ function hasActiveChildren(manifest) {
353
+ return Array.isArray(manifest.groups) && manifest.groups.some((group) => {
354
+ if (!group || typeof group !== "object")
355
+ return false;
356
+ const children = Array.isArray(group.children) ? group.children : [];
357
+ if (children.length === 0 && Array.isArray(group.cleanup?.tasks) && group.cleanup.tasks.length > 0)
358
+ return true;
359
+ return children.some((child) => !child || typeof child !== "object" || !isTerminalParallelHandoffChildStatus(child.status));
360
+ });
361
+ }
362
+ function hasManagedWorktreeTasks(manifest) {
363
+ return manifest.groups.length > 0 && manifest.groups.some((group) => Array.isArray(group.cleanup?.tasks) && group.cleanup.tasks.length > 0);
364
+ }
365
+ function validateManifestForLaneEvidence(manifest, laneId) {
366
+ if (manifest.runId !== laneId)
367
+ throw new Error(`Lane '${laneId}' does not match manifest run '${manifest.runId}'.`);
368
+ if (!hasValidStoredLaneShape(manifest))
369
+ throw new Error("Lane manifest is malformed.");
370
+ if (!manifest.groups.length || !hasManagedWorktreeTasks(manifest))
371
+ throw new Error("Lane manifest has no managed worktree tasks.");
372
+ if (hasActiveChildren(manifest))
373
+ throw new Error("Lane has an active child owner; merge evidence must be recorded after local reconciliation.");
374
+ for (const group of manifest.groups) {
375
+ if (typeof group.repoRoot !== "string" || !group.repoRoot.trim())
376
+ throw new Error("Lane manifest has no valid repository root.");
377
+ if (group.cleanup.state !== "complete" && group.cleanup.state !== "partial")
378
+ throw new Error("Lane manifest has an invalid cleanup state.");
379
+ if (!Array.isArray(group.cleanup.tasks) || group.cleanup.tasks.some((task) => typeof task.path !== "string" || !task.path.trim() || typeof task.branch !== "string" || !task.branch.trim())) {
380
+ throw new Error("Lane manifest has an invalid cleanup task.");
381
+ }
382
+ if (!Array.isArray(group.children))
383
+ throw new Error("Lane manifest has invalid child records.");
384
+ for (const child of group.children) {
385
+ if (!STORED_CHILD_STATUSES.has(child.status)) {
386
+ throw new Error("Lane manifest has an invalid child status.");
387
+ }
388
+ }
389
+ }
390
+ }
391
+ function cleanupEligibilityForEvidence(manifest) {
392
+ if (hasActiveChildren(manifest))
393
+ return { state: "active" };
394
+ let merge;
395
+ if (manifest.merge) {
396
+ try {
397
+ merge = normalizeMergeEvidence(manifest.merge);
398
+ }
399
+ catch {
400
+ return { state: "terminal-blocked", reason: "stored merge evidence is invalid" };
401
+ }
402
+ }
403
+ if (manifest.supersession) {
404
+ try {
405
+ const supersession = normalizeSupersessionEvidence(manifest.supersession);
406
+ if (supersession.manifestDigest !== manifestFactsDigest(manifest))
407
+ return { state: "terminal-blocked", reason: "stored supersession evidence is stale" };
408
+ }
409
+ catch {
410
+ return { state: "terminal-blocked", reason: "stored supersession evidence is invalid" };
411
+ }
412
+ return { state: "superseded-eligible" };
413
+ }
414
+ if (!merge)
415
+ return { state: "terminal-blocked", reason: "no merge or supersession evidence recorded" };
416
+ if (merge.manifestDigest !== manifestFactsDigest(manifest))
417
+ return { state: "terminal-blocked", reason: "stored merge evidence is stale" };
418
+ if (merge.treeEquivalent !== true) {
419
+ return { state: "terminal-blocked", reason: merge.treeEquivalent === "unknown" ? "merged tree equivalence was not attested" : "merged tree is not equivalent to the reviewed head" };
420
+ }
421
+ if (merge.postMergeChecks !== "recorded")
422
+ return { state: "terminal-blocked", reason: "required post-merge checks were not recorded" };
423
+ return { state: "terminal-eligible" };
424
+ }
425
+ function sameMergeEvidence(left, right) {
426
+ return left.prNumber === right.prNumber
427
+ && left.reviewedHead === right.reviewedHead
428
+ && left.mergeCommit === right.mergeCommit
429
+ && left.treeEquivalent === right.treeEquivalent
430
+ && left.postMergeChecks === right.postMergeChecks
431
+ && left.attestedBy === right.attestedBy
432
+ && left.attestedAt === right.attestedAt;
433
+ }
434
+ function sameSupersessionEvidence(left, right) {
435
+ return left.supersededBy === right.supersededBy && left.attestedBy === right.attestedBy && left.attestedAt === right.attestedAt;
436
+ }
437
+ function firstRepositoryRoot(manifest) {
438
+ const repoRoot = Array.isArray(manifest.groups) ? manifest.groups[0]?.repoRoot : undefined;
439
+ return typeof repoRoot === "string" && repoRoot.trim() ? repoRoot.trim() : undefined;
440
+ }
441
+ function formatCleanupCommand(manifestPath, manifest) {
442
+ const repoRoot = firstRepositoryRoot(manifest);
443
+ return repoRoot ? `subagent({ action: "worktree.cleanup", options: { repo: ${JSON.stringify(repoRoot)}, handoffPath: ${JSON.stringify(manifestPath)}, mode: "plan" } })` : undefined;
444
+ }
445
+ export function formatStoredParallelHandoffCleanup(manifestPath, manifest) {
446
+ let stored = manifest;
447
+ if (!stored) {
448
+ try {
449
+ stored = readParallelHandoffManifest(manifestPath);
450
+ }
451
+ catch {
452
+ stored = undefined;
453
+ }
454
+ }
455
+ if (!stored)
456
+ return ["Cleanup eligibility: unknown", "Reason: lane manifest is missing or invalid; removal is not safe.", `Plan command: subagent({ action: "worktree.cleanup", options: { handoffPath: ${JSON.stringify(manifestPath)}, mode: "plan" } })`].join("\n");
457
+ const eligibility = trustedStoredCleanupEligibility(stored);
458
+ const lines = [`Cleanup eligibility: ${eligibility.state}`];
459
+ if (eligibility.state === "terminal-blocked")
460
+ lines.push(`Reason: ${eligibility.reason}`);
461
+ if (eligibility.state === "unknown")
462
+ lines.push("Reason: stored eligibility is missing or invalid; removal is not safe.");
463
+ if (eligibility.state === "active")
464
+ lines.push("Reason: a child owner is still active; removal is not safe.");
465
+ const command = formatCleanupCommand(manifestPath, stored);
466
+ if (command)
467
+ lines.push(`Plan command: ${command}`);
468
+ return lines.join("\n");
469
+ }
470
+ export function recordParallelHandoffMerge(...args) {
471
+ return withHandoffWriteLock(args[0].manifestPath, () => recordParallelHandoffMergeUnlocked(...args));
472
+ }
473
+ function recordParallelHandoffMergeUnlocked(input) {
474
+ const manifest = readParallelHandoffManifest(input.manifestPath);
475
+ if (!manifest)
476
+ throw new Error(`Parallel handoff manifest not found: ${input.manifestPath}`);
477
+ validateManifestForLaneEvidence(manifest, boundedString(input.laneId, "laneId", MAX_SUPERSESSION_ID_LENGTH));
478
+ if (hasActiveChildren(manifest))
479
+ throw new Error("Lane has an active child owner; merge evidence must be recorded after local reconciliation.");
480
+ const merge = { ...normalizeMergeEvidence(input.merge), manifestDigest: manifestFactsDigest(manifest) };
481
+ if (manifest.merge) {
482
+ const existing = normalizeMergeEvidence(manifest.merge);
483
+ if (existing.reviewedHead !== merge.reviewedHead)
484
+ throw new Error(`Lane manifest is stale: reviewed head is already recorded as ${existing.reviewedHead}.`);
485
+ if (!sameMergeEvidence(existing, merge))
486
+ throw new Error("Lane manifest already contains different merge evidence for this reviewed head.");
487
+ }
488
+ const reconciled = { ...manifest, merge };
489
+ delete reconciled.supersession;
490
+ const updated = { ...reconciled, cleanupEligibility: cleanupEligibilityForEvidence(reconciled), updatedAt: input.now ?? Date.now() };
491
+ writeAtomicJson(input.manifestPath, updated);
492
+ return { manifest: updated, reference: referenceFor(input.manifestPath, updated), text: formatStoredParallelHandoffCleanup(input.manifestPath, updated) };
493
+ }
494
+ export function recordParallelHandoffSupersession(...args) {
495
+ return withHandoffWriteLock(args[0].manifestPath, () => recordParallelHandoffSupersessionUnlocked(...args));
496
+ }
497
+ function recordParallelHandoffSupersessionUnlocked(input) {
498
+ const manifest = readParallelHandoffManifest(input.manifestPath);
499
+ if (!manifest)
500
+ throw new Error(`Parallel handoff manifest not found: ${input.manifestPath}`);
501
+ const laneId = boundedString(input.laneId, "laneId", MAX_SUPERSESSION_ID_LENGTH);
502
+ validateManifestForLaneEvidence(manifest, laneId);
503
+ if (hasActiveChildren(manifest))
504
+ throw new Error("Lane has an active child owner; supersession must be recorded after local reconciliation.");
505
+ const supersession = { ...normalizeSupersessionEvidence(input.supersession), manifestDigest: manifestFactsDigest(manifest) };
506
+ if (supersession.supersededBy === laneId)
507
+ throw new Error("supersession.supersededBy must identify a different replacement lane.");
508
+ if (manifest.supersession) {
509
+ const existing = normalizeSupersessionEvidence(manifest.supersession);
510
+ if (!sameSupersessionEvidence(existing, supersession))
511
+ throw new Error("Lane manifest already contains different supersession evidence.");
512
+ }
513
+ const updated = { ...manifest, supersession, cleanupEligibility: cleanupEligibilityForEvidence({ ...manifest, supersession }), updatedAt: input.now ?? Date.now() };
514
+ writeAtomicJson(input.manifestPath, updated);
515
+ return { manifest: updated, reference: referenceFor(input.manifestPath, updated), text: formatStoredParallelHandoffCleanup(input.manifestPath, updated) };
516
+ }
517
+ function safeHandoffAgentName(agent) {
518
+ return agent.replace(/[^\w.-]/g, "_");
519
+ }
520
+ function missingDiff(input) {
521
+ const patchPath = path.join(path.dirname(input.manifestPath), `missing-diff-step-${input.stepIndex}-task-${input.taskIndex}-${safeHandoffAgentName(input.agent)}.patch`);
522
+ try {
523
+ fs.mkdirSync(path.dirname(patchPath), { recursive: true });
524
+ fs.writeFileSync(patchPath, "", "utf-8");
525
+ }
526
+ catch {
527
+ // Handoff records the artifact failure below; patch creation remains best-effort.
528
+ }
529
+ return {
530
+ index: input.taskIndex,
531
+ agent: input.agent,
532
+ branch: input.branch ?? "",
533
+ diffStat: "",
534
+ filesChanged: 0,
535
+ insertions: 0,
536
+ deletions: 0,
537
+ patchPath,
538
+ error: "diff artifact unavailable; no patch was captured",
539
+ };
540
+ }
541
+ export function writeParallelHandoffGroup(...args) {
542
+ return withHandoffWriteLock(args[0].manifestPath, () => writeParallelHandoffGroupUnlocked(...args));
543
+ }
544
+ function writeParallelHandoffGroupUnlocked(input) {
545
+ const now = input.now ?? Date.now();
546
+ const existing = readParallelHandoffManifest(input.manifestPath);
547
+ if (existing && (existing.runId !== input.runId || existing.mode !== input.mode || existing.source !== input.source)) {
548
+ throw new Error(`Parallel handoff manifest belongs to a different run: ${input.manifestPath}`);
549
+ }
550
+ const laneBindings = input.laneBindings?.map((binding, index) => normalizeLaneBinding(binding, `parallel handoff lane binding ${index}`));
551
+ if (laneBindings) {
552
+ const taskIndexes = new Set();
553
+ for (const binding of laneBindings) {
554
+ if (taskIndexes.has(binding.taskIndex))
555
+ throw new Error(`Parallel handoff has duplicate lane binding taskIndex ${binding.taskIndex}.`);
556
+ if (!input.setup.worktrees.some((worktree) => worktree.index === binding.taskIndex))
557
+ throw new Error(`Parallel handoff lane binding taskIndex ${binding.taskIndex} has no managed worktree.`);
558
+ if (binding.index !== input.flatStartIndex + binding.taskIndex)
559
+ throw new Error(`Parallel handoff lane binding index ${binding.index} does not match taskIndex ${binding.taskIndex}.`);
560
+ taskIndexes.add(binding.taskIndex);
561
+ }
562
+ }
563
+ const bindingForTask = (taskIndex) => laneBindings?.find((binding) => binding.taskIndex === taskIndex);
564
+ const group = {
565
+ stepIndex: input.stepIndex,
566
+ baseCommit: input.setup.baseCommit,
567
+ repoRoot: input.setup.cwd,
568
+ children: input.results.map((result, taskIndex) => {
569
+ const binding = bindingForTask(taskIndex);
570
+ const runId = optionalIdentity(result.runId ?? binding?.runId, `parallel handoff child ${taskIndex}.runId`);
571
+ const lane = normalizeWorkflowLaneMetadata(result.lane ?? binding?.lane, `parallel handoff child ${taskIndex}.lane`);
572
+ const workflowKey = optionalIdentity(result.workflowKey ?? binding?.workflowKey, `parallel handoff child ${taskIndex}.workflowKey`);
573
+ assertWorkflowLaneKey(lane, workflowKey, `parallel handoff child ${taskIndex}.lane`);
574
+ const diff = input.diffs[taskIndex] ?? missingDiff({
575
+ manifestPath: input.manifestPath,
576
+ stepIndex: input.stepIndex,
577
+ taskIndex,
578
+ agent: result.agent,
579
+ branch: input.setup.worktrees[taskIndex]?.branch,
580
+ });
581
+ return {
582
+ index: input.flatStartIndex + taskIndex,
583
+ taskIndex,
584
+ agent: result.agent,
585
+ ...(workflowKey ? { workflowKey } : {}),
586
+ ...(runId ? { runId } : {}),
587
+ ...(lane ? { lane } : {}),
588
+ status: result.status,
589
+ summary: result.summary,
590
+ ...(result.outputPath ? { outputPath: result.outputPath } : {}),
591
+ ...(result.structuredOutput !== undefined ? { structuredOutput: result.structuredOutput } : {}),
592
+ ...(result.structuredOutputPath ? { structuredOutputPath: result.structuredOutputPath } : {}),
593
+ ...(result.sessionPath ? { sessionPath: result.sessionPath } : {}),
594
+ patch: {
595
+ path: diff.patchPath,
596
+ branch: diff.branch,
597
+ changed: diff.filesChanged > 0 || diff.insertions > 0 || diff.deletions > 0 || diff.diffStat.trim().length > 0,
598
+ diffStat: diff.diffStat,
599
+ filesChanged: diff.filesChanged,
600
+ insertions: diff.insertions,
601
+ deletions: diff.deletions,
602
+ ...(diff.error ? { error: diff.error } : {}),
603
+ },
604
+ };
605
+ }),
606
+ ...(laneBindings && laneBindings.length > 0 && input.results.length === 0 ? { laneBindings } : {}),
607
+ cleanup: input.cleanup ?? {
608
+ state: "partial",
609
+ pruned: false,
610
+ tasks: input.setup.worktrees.map((worktree) => ({
611
+ index: worktree.index,
612
+ path: worktree.path,
613
+ branch: worktree.branch,
614
+ ...(worktree.provider ? { provider: worktree.provider } : {}),
615
+ ...(worktree.naming ? { naming: worktree.naming } : {}),
616
+ ...(worktree.recordedBaseDir ? { recordedBaseDir: worktree.recordedBaseDir } : {}),
617
+ worktreeRemoved: false,
618
+ branchRemoved: false,
619
+ preserved: true,
620
+ reason: "cleanup pending durable handoff capture",
621
+ })),
622
+ },
623
+ };
624
+ for (const task of group.cleanup.tasks) {
625
+ const previous = existing?.groups.flatMap((item) => item.cleanup.tasks).find((item) => item.path === task.path && item.branch === task.branch);
626
+ if (previous?.worktreeRemoved)
627
+ task.worktreeRemoved = true;
628
+ if (previous?.branchRemoved)
629
+ task.branchRemoved = true;
630
+ if (!task.worktreeRemoved && previous?.reason?.includes("retained child resume")) {
631
+ task.preserved = true;
632
+ task.reason = previous.reason;
633
+ }
634
+ }
635
+ const groups = existing?.groups.filter((candidate) => candidate.stepIndex !== input.stepIndex) ?? [];
636
+ groups.push(group);
637
+ groups.sort((left, right) => left.stepIndex - right.stepIndex);
638
+ const manifestWithoutEligibility = {
639
+ version: 1,
640
+ runId: input.runId,
641
+ mode: input.mode,
642
+ source: input.source,
643
+ cwd: input.cwd,
644
+ createdAt: existing?.createdAt ?? now,
645
+ updatedAt: now,
646
+ groups,
647
+ ...(existing && Object.hasOwn(existing, "merge") ? { merge: existing.merge } : {}),
648
+ ...(existing && Object.hasOwn(existing, "supersession") ? { supersession: existing.supersession } : {}),
649
+ };
650
+ const carriesCleanupMetadata = existing !== undefined
651
+ && (Object.hasOwn(existing, "merge") || Object.hasOwn(existing, "supersession") || Object.hasOwn(existing, "cleanupEligibility"));
652
+ const manifest = {
653
+ ...manifestWithoutEligibility,
654
+ ...(carriesCleanupMetadata
655
+ ? { cleanupEligibility: cleanupEligibilityForEvidence(manifestWithoutEligibility) }
656
+ : {}),
657
+ };
658
+ writeAtomicJson(input.manifestPath, manifest);
659
+ return referenceFor(input.manifestPath, manifest);
660
+ }
661
+ export function parallelHandoffPath(baseDir, runId) {
662
+ return runId ? path.join(baseDir, "handoffs", `${runId}.json`) : path.join(baseDir, "handoff.json");
663
+ }
664
+ /** Synchronous onProgress projection shared by setup owners; snapshots are cumulative. */
665
+ export function writeWorktreeSetupHandoff(input) {
666
+ const { progress, ...handoff } = input;
667
+ const { setup, attempts, cleanup } = progress;
668
+ // Preflight has no allocation identity yet. Its original error belongs to the caller.
669
+ if (attempts.length === 0 && setup.worktrees.length === 0)
670
+ return undefined;
671
+ if (!setup.cwd || !setup.baseCommit)
672
+ throw new Error("Cannot publish worktree allocation evidence without repository and base commit.");
673
+ const diagnostic = (text) => text.slice(0, 512);
674
+ // Never copy argv, environment, Error objects or captured stdout/stderr into artifacts.
675
+ const commandEvidence = (command) => command && ({
676
+ pid: command.pid,
677
+ processGroupId: command.processGroupId,
678
+ ...(command.result ? {
679
+ status: command.result.status,
680
+ signal: command.result.signal,
681
+ failed: Boolean(command.result.error),
682
+ outputIncomplete: command.result.outputIncomplete,
683
+ processTree: command.result.processTree?.state,
684
+ } : {}),
685
+ });
686
+ const errors = [
687
+ `Worktree setup ${JSON.stringify({ runId: input.runId, stepIndex: input.stepIndex, phase: progress.phase,
688
+ unknown: Boolean(progress.unknown), command: commandEvidence(progress.command) })}`,
689
+ ...attempts.map((attempt) => {
690
+ const task = cleanup?.tasks.find((candidate) => candidate.index === attempt.index);
691
+ return `Allocation attempt ${JSON.stringify({ index: attempt.index, branch: attempt.branch,
692
+ path: attempt.path ?? null, validated: attempt.validated,
693
+ command: commandEvidence(attempt.command), hookCommand: commandEvidence(attempt.hookCommand),
694
+ ...(task ? { worktreeRemoved: task.worktreeRemoved, branchRemoved: task.branchRemoved,
695
+ preserved: task.preserved, reason: task.reason && diagnostic(task.reason), errors: task.errors?.map(diagnostic) } : {}),
696
+ })}`;
697
+ }),
698
+ ...(cleanup?.errors?.map(diagnostic) ?? []),
699
+ ...(progress.unknown ? ["Setup settlement unknown; manual reconciliation required."] : []),
700
+ ];
701
+ return writeParallelHandoffGroup({
702
+ ...handoff, setup, diffs: [], results: [],
703
+ laneBindings: input.laneBindings?.filter((binding) => setup.worktrees.some((worktree) => worktree.index === binding.taskIndex)),
704
+ cleanup: {
705
+ state: cleanup?.state ?? "partial",
706
+ pruned: cleanup?.pruned ?? false,
707
+ errors,
708
+ // An attempted native path is not a validated recovery task, even during rollback.
709
+ tasks: setup.worktrees.map((worktree) => {
710
+ const task = cleanup?.tasks.find((candidate) => candidate.index === worktree.index);
711
+ return task ? { ...task, reason: task.reason && diagnostic(task.reason), errors: task.errors?.map(diagnostic) } : {
712
+ index: worktree.index, path: worktree.path, branch: worktree.branch,
713
+ provider: worktree.provider, naming: worktree.naming, recordedBaseDir: worktree.recordedBaseDir,
714
+ worktreeRemoved: false, branchRemoved: false, preserved: true,
715
+ reason: "setup pending durable handoff capture",
716
+ };
717
+ }),
718
+ },
719
+ });
720
+ }
721
+ export function formatParallelHandoffReference(reference) {
722
+ return `Worktree handoff: ${reference.path} (${reference.childCount} children, ${reference.changedPatches} changed patches, cleanup ${reference.cleanupState})`;
723
+ }
724
+ export function formatParallelHandoffError(error) {
725
+ return `Worktree handoff unavailable: ${error instanceof Error ? error.message : String(error)}`;
726
+ }
727
+ export function discardPreservedWorktrees(...args) {
728
+ return withHandoffWriteLock(args[0], () => discardPreservedWorktreesUnlocked(...args));
729
+ }
730
+ function discardPreservedWorktreesUnlocked(manifestPath, authorization) {
731
+ const resolvedPath = path.resolve(manifestPath);
732
+ const manifest = readParallelHandoffManifest(resolvedPath);
733
+ if (!manifest)
734
+ throw new Error(`Parallel handoff manifest not found: ${resolvedPath}`);
735
+ let attempted = 0;
736
+ for (const group of manifest.groups) {
737
+ const pending = group.cleanup.tasks.filter((task) => task.preserved && (!task.worktreeRemoved || !task.branchRemoved));
738
+ if (pending.length === 0)
739
+ continue;
740
+ attempted += pending.length;
741
+ const report = cleanupWorktrees({
742
+ cwd: group.repoRoot,
743
+ baseCommit: group.baseCommit,
744
+ worktrees: pending.map((task) => ({
745
+ path: task.path,
746
+ agentCwd: task.path,
747
+ branch: task.branch,
748
+ ...(task.provider ? { provider: task.provider } : {}),
749
+ ...(task.naming ? { naming: task.naming } : {}),
750
+ ...(task.recordedBaseDir ? { recordedBaseDir: task.recordedBaseDir } : {}),
751
+ index: task.index,
752
+ nodeModulesLinked: false,
753
+ syntheticPaths: [],
754
+ })),
755
+ }, { kind: "discard", authorization });
756
+ const updates = new Map(report.tasks.map((task) => [task.index, task.worktreeRemoved && task.branchRemoved
757
+ ? task
758
+ : { ...task, preserved: true, reason: task.reason ?? "discard cleanup remains incomplete" }]));
759
+ group.cleanup = {
760
+ state: group.cleanup.tasks.every((task) => {
761
+ const next = updates.get(task.index) ?? task;
762
+ return next.worktreeRemoved && next.branchRemoved;
763
+ }) && report.pruned ? "complete" : "partial",
764
+ tasks: group.cleanup.tasks.map((task) => updates.get(task.index) ?? task),
765
+ pruned: report.pruned,
766
+ ...(report.errors ? { errors: report.errors } : {}),
767
+ };
768
+ }
769
+ manifest.updatedAt = Date.now();
770
+ writeAtomicJson(resolvedPath, manifest);
771
+ const remaining = manifest.groups.flatMap((group) => group.cleanup.tasks.map((task) => ({ group, task })))
772
+ .filter(({ task }) => task.preserved && (!task.worktreeRemoved || !task.branchRemoved));
773
+ const lines = attempted === 0
774
+ ? [`No preserved worktrees remain in ${resolvedPath}.`]
775
+ : [`Discard processed ${attempted} preserved worktree${attempted === 1 ? "" : "s"}.`, `Manifest: ${resolvedPath}`];
776
+ if (remaining.length > 0) {
777
+ lines.push("", "Some worktrees remain. Inspect and remove them manually if appropriate:");
778
+ for (const { group, task } of remaining) {
779
+ lines.push(` git -C ${JSON.stringify(group.repoRoot)} status --short`, ` git -C ${JSON.stringify(group.repoRoot)} worktree remove --force ${JSON.stringify(task.path)}`, ` git -C ${JSON.stringify(group.repoRoot)} branch -D ${JSON.stringify(task.branch)}`);
780
+ }
781
+ }
782
+ return { manifest, text: lines.join("\n") };
783
+ }