@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,803 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { spawnSync } from "node:child_process";
3
+ import * as fs from "node:fs";
4
+ import * as os from "node:os";
5
+ import * as path from "node:path";
6
+ import { writeAtomicJson } from "../../shared/atomic-json.js";
7
+ import { PROJECT_SUBAGENTS_RELATIVE_DIR } from "../../shared/artifacts.js";
8
+ import { DEFAULT_STALE_TERMINAL_ACTIVE_MARKER_MS, activeRunMarkerAgeMs } from "../background/active-run-index.js";
9
+ import { getAgentDir } from "../../shared/utils.js";
10
+ import { isTerminalParallelHandoffChildStatus, readParallelHandoffManifest } from "./parallel-handoff.js";
11
+ import { MACHINE_DIFF_OPTIONS, validateWorktreePatchRepresentsCurrentWorktree } from "./worktree.js";
12
+ export const WORKTREE_CLEANUP_PLAN_VERSION = 1;
13
+ export const WORKTREE_CLEANUP_PLAN_TTL_MS = 30 * 60 * 1000;
14
+ const MAX_DISCOVERED_HANDOFFS = 256;
15
+ const MAX_PLAN_ENTRIES = 512;
16
+ const MAX_METADATA_FILE_BYTES = 2 * 1024 * 1024;
17
+ function runGit(cwd, args) {
18
+ try {
19
+ const result = spawnSync("git", ["-C", cwd, ...args], { encoding: "utf-8", windowsHide: true });
20
+ return {
21
+ stdout: result.stdout ?? "",
22
+ stderr: result.stderr ?? "",
23
+ status: result.status,
24
+ ...(result.error ? { error: result.error } : {}),
25
+ };
26
+ }
27
+ catch (error) {
28
+ return {
29
+ stdout: "",
30
+ stderr: "",
31
+ status: null,
32
+ error: error instanceof Error ? error : new Error(String(error)),
33
+ };
34
+ }
35
+ }
36
+ function gitFailure(result, command) {
37
+ return result.error?.message || result.stderr.trim() || result.stdout.trim() || `${command} failed`;
38
+ }
39
+ function runGitChecked(cwd, args) {
40
+ const result = runGit(cwd, args);
41
+ if (result.status !== 0)
42
+ throw new Error(gitFailure(result, `git -C ${cwd} ${args.join(" ")}`));
43
+ return result.stdout.trim();
44
+ }
45
+ function realpathExisting(candidate, nativeRealpath = fs.realpathSync.native, fallbackRealpath = fs.realpathSync) {
46
+ try {
47
+ return nativeRealpath(candidate);
48
+ }
49
+ catch {
50
+ return fallbackRealpath(candidate);
51
+ }
52
+ }
53
+ /** Internal test seam; this is not part of the public subagent tool API. */
54
+ export const __testables = { realpathExisting };
55
+ function comparablePath(candidate) {
56
+ let current = path.resolve(candidate);
57
+ const missingSegments = [];
58
+ let canonical = current;
59
+ while (true) {
60
+ try {
61
+ canonical = path.join(realpathExisting(current), ...missingSegments.reverse());
62
+ break;
63
+ }
64
+ catch {
65
+ const parent = path.dirname(current);
66
+ if (parent === current)
67
+ break;
68
+ missingSegments.push(path.basename(current));
69
+ current = parent;
70
+ }
71
+ }
72
+ const normalized = path.normalize(canonical);
73
+ return process.platform === "win32" ? normalized.toLowerCase() : normalized;
74
+ }
75
+ export function samePath(left, right) {
76
+ if (comparablePath(left) === comparablePath(right))
77
+ return true;
78
+ if (process.platform !== "win32")
79
+ return false;
80
+ // Git for Windows and Node can spell the same temp directory with different
81
+ // drive/short-name aliases. The directory identity is the final bounded
82
+ // fallback; never accept aliases when the filesystem cannot prove identity.
83
+ try {
84
+ const leftStat = fs.statSync(left, { bigint: true });
85
+ const rightStat = fs.statSync(right, { bigint: true });
86
+ return leftStat.dev !== 0n && leftStat.ino !== 0n && leftStat.dev === rightStat.dev && leftStat.ino === rightStat.ino;
87
+ }
88
+ catch {
89
+ return false;
90
+ }
91
+ }
92
+ function resolveExistingPath(candidate) {
93
+ try {
94
+ return realpathExisting(candidate);
95
+ }
96
+ catch {
97
+ return path.resolve(candidate);
98
+ }
99
+ }
100
+ function pathInside(root, candidate, strict = false) {
101
+ const normalizedRoot = comparablePath(root);
102
+ const normalizedCandidate = comparablePath(candidate);
103
+ if (!strict && normalizedRoot === normalizedCandidate)
104
+ return true;
105
+ const relative = path.relative(normalizedRoot, normalizedCandidate);
106
+ return relative !== ""
107
+ && relative !== ".."
108
+ && !relative.startsWith(`..${path.sep}`)
109
+ && !path.isAbsolute(relative);
110
+ }
111
+ function sha256(value) {
112
+ return createHash("sha256").update(value, "utf-8").digest("hex");
113
+ }
114
+ function validatePlanId(planId) {
115
+ if (!/^[A-Za-z0-9._-]+$/.test(planId) || planId === "." || planId === "..") {
116
+ throw new Error("worktree cleanup plan id must contain only letters, numbers, dots, underscores, or hyphens");
117
+ }
118
+ return planId;
119
+ }
120
+ export function resolveCleanupRepoRoot(repo) {
121
+ const requested = path.resolve(repo);
122
+ const toplevel = runGitChecked(requested, ["rev-parse", "--show-toplevel"]);
123
+ return realpathExisting(toplevel);
124
+ }
125
+ function resolveCleanupBaseDir(repoRoot, configuredBaseDir) {
126
+ const raw = configuredBaseDir ?? process.env.PI_SUBAGENTS_WORKTREE_DIR;
127
+ let dedicatedRoot;
128
+ if (raw === undefined || (configuredBaseDir === undefined && !raw.trim())) {
129
+ dedicatedRoot = path.join(path.dirname(repoRoot), "worktrees");
130
+ }
131
+ else {
132
+ const trimmed = raw.trim();
133
+ if (!trimmed)
134
+ throw new Error("worktree base directory cannot be empty");
135
+ const expanded = trimmed.startsWith("~/") ? path.join(os.homedir(), trimmed.slice(2)) : trimmed;
136
+ dedicatedRoot = path.isAbsolute(expanded) ? expanded : path.resolve(repoRoot, expanded);
137
+ }
138
+ return path.resolve(path.join(dedicatedRoot, path.basename(repoRoot)));
139
+ }
140
+ function cleanupContainmentInvalid(repoRoot, projectDir) {
141
+ const extensionsDir = path.join(getAgentDir(), "extensions");
142
+ return samePath(projectDir, repoRoot)
143
+ || pathInside(repoRoot, projectDir, true)
144
+ || pathInside(extensionsDir, projectDir);
145
+ }
146
+ export function parseGitWorktreeList(raw) {
147
+ const records = [];
148
+ let current;
149
+ const flush = () => {
150
+ if (current?.path)
151
+ records.push(current);
152
+ current = undefined;
153
+ };
154
+ for (const line of raw.split(/\r?\n/)) {
155
+ if (!line.trim()) {
156
+ flush();
157
+ continue;
158
+ }
159
+ if (line.startsWith("worktree ")) {
160
+ flush();
161
+ current = { path: line.slice("worktree ".length), head: "" };
162
+ continue;
163
+ }
164
+ if (!current)
165
+ continue;
166
+ if (line.startsWith("HEAD "))
167
+ current.head = line.slice("HEAD ".length).trim();
168
+ else if (line.startsWith("branch refs/heads/"))
169
+ current.branch = line.slice("branch refs/heads/".length).trim();
170
+ else if (line === "detached")
171
+ delete current.branch;
172
+ else if (line === "locked" || line.startsWith("locked "))
173
+ current.locked = true;
174
+ else if (line.startsWith("prunable "))
175
+ current.prunable = line.slice("prunable ".length).trim();
176
+ }
177
+ flush();
178
+ return records;
179
+ }
180
+ function listGitWorktrees(repoRoot) {
181
+ const result = runGit(repoRoot, ["worktree", "list", "--porcelain"]);
182
+ if (result.status !== 0)
183
+ throw new Error(gitFailure(result, `git -C ${repoRoot} worktree list --porcelain`));
184
+ return parseGitWorktreeList(result.stdout);
185
+ }
186
+ export function isRegisteredCleanupWorktree(repoRoot, candidate) {
187
+ return listGitWorktrees(repoRoot).some((tree) => samePath(tree.path, candidate));
188
+ }
189
+ function readJsonFile(filePath) {
190
+ return JSON.parse(fs.readFileSync(filePath, "utf-8"));
191
+ }
192
+ function isRecord(value) {
193
+ return Boolean(value) && typeof value === "object" && !Array.isArray(value);
194
+ }
195
+ function readManifest(manifestPath) {
196
+ try {
197
+ const stat = fs.lstatSync(manifestPath);
198
+ if (stat.isSymbolicLink() || !stat.isFile())
199
+ return { error: `parallel handoff manifest is not a regular file: ${manifestPath}` };
200
+ if (stat.size > MAX_METADATA_FILE_BYTES)
201
+ return { error: `parallel handoff manifest exceeds the ${MAX_METADATA_FILE_BYTES}-byte limit: ${manifestPath}` };
202
+ const parsed = readParallelHandoffManifest(manifestPath);
203
+ if (!parsed) {
204
+ return { error: `invalid parallel handoff manifest version or groups: ${manifestPath}` };
205
+ }
206
+ return { manifest: parsed };
207
+ }
208
+ catch (error) {
209
+ const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
210
+ if (code === "ENOENT")
211
+ return { error: `parallel handoff manifest not found: ${manifestPath}` };
212
+ return { error: `failed to read parallel handoff manifest ${manifestPath}: ${error instanceof Error ? error.message : String(error)}` };
213
+ }
214
+ }
215
+ function discoverHandoffPaths(repoRoot, input) {
216
+ const paths = [];
217
+ const warnings = [];
218
+ const add = (candidate) => {
219
+ const resolved = path.isAbsolute(candidate) ? path.resolve(candidate) : path.resolve(repoRoot, candidate);
220
+ if (!paths.some((existing) => comparablePath(existing) === comparablePath(resolved)))
221
+ paths.push(resolved);
222
+ };
223
+ if (input.handoffPath)
224
+ add(input.handoffPath);
225
+ for (const candidate of input.handoffPaths ?? [])
226
+ add(candidate);
227
+ // Project artifacts have a fixed, shallow handoff layout. Do not walk a temp
228
+ // or session root: those roots contain unrelated operator data and are not a
229
+ // source of ownership for cleanup candidates.
230
+ const artifactsDir = path.join(repoRoot, PROJECT_SUBAGENTS_RELATIVE_DIR, "artifacts");
231
+ const projectHandoffPath = path.join(artifactsDir, "handoff.json");
232
+ if (fs.existsSync(projectHandoffPath))
233
+ add(projectHandoffPath);
234
+ const handoffsDir = path.join(artifactsDir, "handoffs");
235
+ try {
236
+ const stat = fs.lstatSync(handoffsDir);
237
+ if (stat.isSymbolicLink() || !stat.isDirectory()) {
238
+ warnings.push(`ignored non-directory handoff metadata root: ${handoffsDir}`);
239
+ }
240
+ else {
241
+ const entries = fs.readdirSync(handoffsDir, { withFileTypes: true })
242
+ .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
243
+ .map((entry) => entry.name)
244
+ .sort()
245
+ .slice(0, MAX_DISCOVERED_HANDOFFS);
246
+ for (const entry of entries)
247
+ add(path.join(handoffsDir, entry));
248
+ if (entries.length === MAX_DISCOVERED_HANDOFFS)
249
+ warnings.push(`handoff metadata discovery capped at ${MAX_DISCOVERED_HANDOFFS} files`);
250
+ }
251
+ }
252
+ catch (error) {
253
+ const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
254
+ if (code !== "ENOENT")
255
+ warnings.push(`failed to inspect handoff metadata root ${handoffsDir}: ${error instanceof Error ? error.message : String(error)}`);
256
+ }
257
+ return { paths: paths.sort((left, right) => comparablePath(left).localeCompare(comparablePath(right))), warnings: [...new Set(warnings)].sort() };
258
+ }
259
+ function readStatusBesideManifest(manifestPath) {
260
+ const statusPath = path.join(path.dirname(manifestPath), "status.json");
261
+ try {
262
+ const stat = fs.lstatSync(statusPath);
263
+ if (stat.isSymbolicLink() || !stat.isFile())
264
+ return { statusPath, error: `async status is not a regular file: ${statusPath}` };
265
+ if (stat.size > MAX_METADATA_FILE_BYTES)
266
+ return { statusPath, error: `async status exceeds the ${MAX_METADATA_FILE_BYTES}-byte limit: ${statusPath}` };
267
+ const parsed = readJsonFile(statusPath);
268
+ if (!isRecord(parsed) || typeof parsed.state !== "string" || typeof parsed.runId !== "string") {
269
+ return { statusPath, error: `invalid async status beside manifest: ${statusPath}` };
270
+ }
271
+ return { status: parsed, statusPath };
272
+ }
273
+ catch (error) {
274
+ const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
275
+ if (code === "ENOENT")
276
+ return { statusPath };
277
+ return { statusPath, error: `failed to read async status ${statusPath}: ${error instanceof Error ? error.message : String(error)}` };
278
+ }
279
+ }
280
+ function manifestMetadata(manifestPath, manifest, warnings) {
281
+ const records = [];
282
+ const groups = manifest.groups.slice(0, MAX_PLAN_ENTRIES);
283
+ if (manifest.groups.length > groups.length)
284
+ warnings.push(`handoff group discovery capped at ${MAX_PLAN_ENTRIES} groups in ${manifestPath}`);
285
+ for (const group of groups) {
286
+ if (!isRecord(group) || !Array.isArray(group.cleanup?.tasks) || !Array.isArray(group.children)) {
287
+ warnings.push(`ignored malformed handoff group in ${manifestPath}`);
288
+ continue;
289
+ }
290
+ const statusInfo = readStatusBesideManifest(manifestPath);
291
+ const tasks = group.cleanup.tasks.slice(0, MAX_PLAN_ENTRIES);
292
+ if (group.cleanup.tasks.length > tasks.length)
293
+ warnings.push(`cleanup task discovery capped at ${MAX_PLAN_ENTRIES} tasks in ${manifestPath}`);
294
+ for (const task of tasks) {
295
+ if (!isRecord(task) || typeof task.path !== "string" || !task.path.trim() || typeof task.branch !== "string" || !task.branch.trim() || typeof task.index !== "number" || !Number.isInteger(task.index) || task.index < 0) {
296
+ warnings.push(`ignored malformed cleanup task in ${manifestPath}`);
297
+ continue;
298
+ }
299
+ const matchingChildren = group.children.filter((candidate) => isRecord(candidate) && candidate.taskIndex === task.index);
300
+ if (matchingChildren.length !== 1 || !isRecord(matchingChildren[0]) || typeof matchingChildren[0].status !== "string") {
301
+ warnings.push(`cleanup task ${task.index} does not have exactly one valid child metadata record in ${manifestPath}`);
302
+ continue;
303
+ }
304
+ records.push({
305
+ manifestPath,
306
+ manifest,
307
+ group,
308
+ task: task,
309
+ child: matchingChildren[0],
310
+ ...(statusInfo.status ? { status: statusInfo.status } : {}),
311
+ statusPath: statusInfo.statusPath,
312
+ ...(statusInfo.error ? { statusError: statusInfo.error } : {}),
313
+ });
314
+ }
315
+ }
316
+ return records;
317
+ }
318
+ function loadMetadata(input, repoRoot) {
319
+ const discovered = discoverHandoffPaths(repoRoot, input);
320
+ const records = [];
321
+ const warnings = [...discovered.warnings];
322
+ for (const manifestPath of discovered.paths) {
323
+ const result = readManifest(manifestPath);
324
+ if (!result.manifest) {
325
+ warnings.push(result.error);
326
+ continue;
327
+ }
328
+ const manifestRoot = resolveExistingPath(manifestPath);
329
+ if (manifestRoot !== manifestPath && fs.lstatSync(manifestPath).isSymbolicLink()) {
330
+ warnings.push(`ignored symlinked handoff manifest: ${manifestPath}`);
331
+ continue;
332
+ }
333
+ records.push(...manifestMetadata(manifestPath, result.manifest, warnings));
334
+ }
335
+ return { records, paths: discovered.paths, warnings: [...new Set(warnings)].sort() };
336
+ }
337
+ function inspectPath(candidate) {
338
+ const resolved = path.resolve(candidate);
339
+ try {
340
+ const stat = fs.lstatSync(resolved);
341
+ if (stat.isSymbolicLink())
342
+ return { resolved, missing: false, symlink: true, directory: false };
343
+ return { resolved, realpath: realpathExisting(resolved), missing: false, symlink: false, directory: stat.isDirectory() };
344
+ }
345
+ catch (error) {
346
+ const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
347
+ if (code === "ENOENT")
348
+ return { resolved, missing: true, symlink: false, directory: false };
349
+ return { resolved, missing: false, symlink: false, directory: false, error: error instanceof Error ? error.message : String(error) };
350
+ }
351
+ }
352
+ function metadataPath(manifestPath, candidate) {
353
+ return path.isAbsolute(candidate) ? path.resolve(candidate) : path.resolve(path.dirname(manifestPath), candidate);
354
+ }
355
+ function metadataRecordPath(record) {
356
+ return metadataPath(record.manifestPath, record.task.path);
357
+ }
358
+ function metadataPatchPath(record) {
359
+ const patchPath = record.child.patch?.path;
360
+ return typeof patchPath === "string" && patchPath.trim() ? metadataPath(record.manifestPath, patchPath) : undefined;
361
+ }
362
+ function metadataOutputPaths(record) {
363
+ return [record.child.outputPath, record.child.structuredOutputPath, record.child.sessionPath, record.child.patch?.path]
364
+ .filter((candidate) => typeof candidate === "string" && candidate.trim().length > 0)
365
+ .map((candidate) => metadataPath(record.manifestPath, candidate));
366
+ }
367
+ function metadataReportPaths(record) {
368
+ return [record.child.outputPath, record.child.structuredOutputPath, record.child.sessionPath]
369
+ .filter((candidate) => typeof candidate === "string" && candidate.trim().length > 0)
370
+ .map((candidate) => metadataPath(record.manifestPath, candidate));
371
+ }
372
+ function terminalRunState(status) {
373
+ return status === "complete" || status === "failed" || status === "partial" || status === "paused" || status === "stopped" || status === "rejected";
374
+ }
375
+ function inspectRunState(record, now, foregroundRunOwnership) {
376
+ if (record.statusError)
377
+ return { kind: "unknown", reason: record.statusError };
378
+ if (record.status) {
379
+ if (record.status.runId !== record.manifest.runId)
380
+ return { kind: "unknown", reason: `status run id '${record.status.runId}' does not match manifest run '${record.manifest.runId}'` };
381
+ if (record.status.state === "queued" || record.status.state === "running")
382
+ return { kind: "active", reason: `owning run is ${record.status.state}` };
383
+ if (!terminalRunState(record.status.state))
384
+ return { kind: "unknown", reason: `owning run has unknown state '${record.status.state}'` };
385
+ }
386
+ else if (record.manifest.source === "async") {
387
+ return { kind: "unknown", reason: `async status is missing beside ${record.manifestPath}` };
388
+ }
389
+ if (record.group.children.length === 0 || !record.group.children.every((child) => isTerminalParallelHandoffChildStatus(child.status))) {
390
+ return { kind: "active", reason: "owning handoff still has a non-terminal child" };
391
+ }
392
+ if (record.manifest.source === "foreground") {
393
+ try {
394
+ const ownership = foregroundRunOwnership?.(record.manifest.runId) ?? "unknown";
395
+ if (ownership === "active")
396
+ return { kind: "active", reason: "owning foreground run is still active" };
397
+ if (ownership !== "terminal")
398
+ return { kind: "unknown", reason: "foreground owning-run state is not provably terminal" };
399
+ return { kind: "terminal" };
400
+ }
401
+ catch (error) {
402
+ return { kind: "unknown", reason: `failed to inspect foreground owning run: ${error instanceof Error ? error.message : String(error)}` };
403
+ }
404
+ }
405
+ try {
406
+ const markerAge = activeRunMarkerAgeMs(path.dirname(record.statusPath), now);
407
+ if (markerAge !== undefined) {
408
+ if (markerAge <= DEFAULT_STALE_TERMINAL_ACTIVE_MARKER_MS)
409
+ return { kind: "active", reason: "owning run still has a recent active marker" };
410
+ return { kind: "stale", reason: `terminal active marker is stale (${Math.floor(markerAge / 1000)}s old)` };
411
+ }
412
+ }
413
+ catch (error) {
414
+ return { kind: "unknown", reason: `failed to inspect active-run marker: ${error instanceof Error ? error.message : String(error)}` };
415
+ }
416
+ return { kind: "terminal" };
417
+ }
418
+ function buildEntryBase(input) {
419
+ const recordedBaseDir = input.metadata?.task.recordedBaseDir;
420
+ const patchPath = input.metadata ? metadataPatchPath(input.metadata) : undefined;
421
+ return {
422
+ path: input.path,
423
+ branch: input.branch,
424
+ decision: "unknown",
425
+ state: "unknown",
426
+ reasons: [],
427
+ source: input.source,
428
+ ...(input.metadata ? { runId: input.metadata.manifest.runId, handoffPath: input.metadata.manifestPath, taskIndex: input.metadata.task.index } : {}),
429
+ ...(input.metadata?.group.baseCommit ? { baseCommit: input.metadata.group.baseCommit } : {}),
430
+ ...(patchPath ? { patchPath } : {}),
431
+ targetRef: input.targetHead,
432
+ preconditions: {
433
+ path: input.path,
434
+ branch: input.branch,
435
+ ...(input.git?.head ? { worktreeHead: input.git.head } : {}),
436
+ ...(input.metadata?.group.baseCommit ? { baseCommit: input.metadata.group.baseCommit } : {}),
437
+ ...(recordedBaseDir ? { recordedBaseDir } : {}),
438
+ targetRef: input.targetHead,
439
+ },
440
+ };
441
+ }
442
+ function blockedEntry(entry, state, decision, reason) {
443
+ return { ...entry, state, decision, reasons: [...entry.reasons, reason] };
444
+ }
445
+ function inspectStatus(worktreePath) {
446
+ const result = runGit(worktreePath, ["status", "--porcelain=v1", "--untracked-files=all"]);
447
+ if (result.status !== 0)
448
+ return { error: gitFailure(result, `git -C ${worktreePath} status --porcelain=v1`) };
449
+ const output = result.stdout;
450
+ return { output, digest: sha256(output) };
451
+ }
452
+ function resolveCommit(repoRoot, commit) {
453
+ const result = runGit(repoRoot, ["rev-parse", "--verify", `${commit}^{commit}`]);
454
+ if (result.status !== 0)
455
+ return { error: gitFailure(result, `git -C ${repoRoot} rev-parse ${commit}`) };
456
+ return { value: result.stdout.trim() };
457
+ }
458
+ function resolveBranchTip(repoRoot, branch) {
459
+ const result = runGit(repoRoot, ["rev-parse", "--verify", `refs/heads/${branch}^{commit}`]);
460
+ if (result.status !== 0)
461
+ return { error: gitFailure(result, `git -C ${repoRoot} rev-parse refs/heads/${branch}`) };
462
+ return { value: result.stdout.trim() };
463
+ }
464
+ function isPatchCaptured(record, worktreePath, baseCommit) {
465
+ const patchPath = metadataPatchPath(record);
466
+ if (!patchPath || record.child.patch?.error !== undefined || record.child.patch?.changed !== true)
467
+ return {};
468
+ const inspection = inspectPath(patchPath);
469
+ if (inspection.error)
470
+ return { error: `captured patch cannot be inspected: ${inspection.error}` };
471
+ if (inspection.missing || !inspection.realpath)
472
+ return { error: "captured handoff patch is missing" };
473
+ let patchStat;
474
+ try {
475
+ patchStat = fs.statSync(patchPath);
476
+ }
477
+ catch (error) {
478
+ return { error: `captured patch cannot be inspected: ${error instanceof Error ? error.message : String(error)}` };
479
+ }
480
+ if (!patchStat.isFile())
481
+ return { error: "captured handoff patch is not a file" };
482
+ if (pathInside(worktreePath, inspection.realpath))
483
+ return { error: "durable handoff patch lives inside the worktree" };
484
+ if (patchStat.size <= 0)
485
+ return { error: "captured handoff patch is empty" };
486
+ const validationError = validateWorktreePatchRepresentsCurrentWorktree(worktreePath, baseCommit, patchPath);
487
+ if (validationError)
488
+ return { error: `captured handoff patch failed validation: ${validationError}` };
489
+ return { path: patchPath };
490
+ }
491
+ function buildManagedEntry(input) {
492
+ const { repoRoot, baseDir, targetHead, rootPath, git, record, foregroundRunOwnership } = input;
493
+ const gitWorktreePath = path.resolve(git.path);
494
+ const metadataWorktreePath = metadataRecordPath(record);
495
+ const worktreePath = resolveExistingPath(metadataWorktreePath);
496
+ const entry = buildEntryBase({ path: worktreePath, branch: git.branch ?? "", source: "both", git, metadata: record, targetHead });
497
+ if (typeof record.manifest.runId !== "string" || !record.manifest.runId.trim())
498
+ return blockedEntry(entry, "unknown", "unknown", "handoff metadata has no valid owning run id");
499
+ if (record.manifest.source !== "foreground" && record.manifest.source !== "async")
500
+ return blockedEntry(entry, "unknown", "unknown", "handoff metadata has an unknown source");
501
+ if (typeof record.group.repoRoot !== "string" || !record.group.repoRoot.trim())
502
+ return blockedEntry(entry, "unknown", "unknown", "handoff metadata has no repository root");
503
+ if (!samePath(metadataWorktreePath, gitWorktreePath))
504
+ return blockedEntry(entry, "unknown", "unknown", "metadata worktree path does not identify the Git worktree");
505
+ const gitPathInspection = inspectPath(gitWorktreePath);
506
+ if (gitPathInspection.error)
507
+ return blockedEntry(entry, "unknown", "unknown", `Git worktree path could not be inspected: ${gitPathInspection.error}`);
508
+ if (gitPathInspection.missing)
509
+ return blockedEntry(entry, "stale", "unknown", "Git worktree path is missing from disk");
510
+ if (gitPathInspection.symlink)
511
+ return blockedEntry(entry, "unknown", "unknown", "Git worktree path is a symlink; cleanup requires a real directory");
512
+ const pathInspection = inspectPath(worktreePath);
513
+ if (pathInspection.error)
514
+ return blockedEntry(entry, "unknown", "unknown", `worktree path could not be inspected: ${pathInspection.error}`);
515
+ if (pathInspection.missing)
516
+ return blockedEntry(entry, "stale", "unknown", "worktree path is missing from disk");
517
+ if (pathInspection.symlink)
518
+ return blockedEntry(entry, "unknown", "unknown", "worktree path is a symlink; cleanup requires a real directory");
519
+ if (!pathInspection.directory || !pathInspection.realpath)
520
+ return blockedEntry(entry, "unknown", "unknown", "worktree path is not a directory");
521
+ const extensionsDir = path.join(getAgentDir(), "extensions");
522
+ if (pathInside(extensionsDir, pathInspection.realpath))
523
+ return blockedEntry(entry, "ineligible", "keep", `worktree real path is inside Pi extensions directory '${extensionsDir}'`);
524
+ if (input.containmentInvalid || !pathInside(baseDir, pathInspection.realpath, true))
525
+ return blockedEntry(entry, "ineligible", "keep", `worktree real path is outside configured base directory '${baseDir}'`);
526
+ const recordedBaseDir = record.task.recordedBaseDir;
527
+ if (typeof recordedBaseDir !== "string" || !path.isAbsolute(recordedBaseDir))
528
+ return blockedEntry(entry, "unknown", "keep", "handoff metadata has no creation-time base directory proof");
529
+ // Compare the saved canonical string, without following a newly replaced ancestor.
530
+ const creationRelative = path.relative(recordedBaseDir, pathInspection.realpath);
531
+ if (!creationRelative || creationRelative === ".." || creationRelative.startsWith(`..${path.sep}`) || path.isAbsolute(creationRelative))
532
+ return blockedEntry(entry, "ineligible", "keep", `worktree real path is outside its creation-time recorded base directory '${recordedBaseDir}'`);
533
+ if (rootPath === comparablePath(pathInspection.realpath))
534
+ return blockedEntry(entry, "ineligible", "keep", "worktree is the repository root");
535
+ if (git.locked)
536
+ return blockedEntry(entry, "ineligible", "keep", "Git worktree is locked");
537
+ if (!git.branch)
538
+ return blockedEntry(entry, "unknown", "unknown", "detached worktrees have no metadata-recorded branch");
539
+ if (record.task.branch !== git.branch)
540
+ return blockedEntry(entry, "unknown", "unknown", `metadata branch '${record.task.branch}' does not match Git branch '${git.branch}'`);
541
+ if (record.task.worktreeRemoved)
542
+ return blockedEntry(entry, "stale", "unknown", "handoff metadata already records this worktree as removed");
543
+ if (record.task.preserved !== true)
544
+ return blockedEntry(entry, "unknown", "unknown", "handoff metadata does not mark this worktree as preserved");
545
+ if (record.group.cleanup.state !== "partial")
546
+ return blockedEntry(entry, "unknown", "unknown", "handoff cleanup state does not indicate a preserved worktree pending cleanup");
547
+ const cleanupReason = typeof record.task.reason === "string" ? record.task.reason.toLowerCase() : "";
548
+ if (cleanupReason.includes("retained child resume"))
549
+ return blockedEntry(entry, "ineligible", "keep", "retained child resume still requires this worktree cwd");
550
+ if (cleanupReason.includes("cleanup pending durable handoff capture"))
551
+ return blockedEntry(entry, "ineligible", "keep", "durable handoff capture is still pending for this worktree");
552
+ if (record.group.repoRoot && comparablePath(resolveExistingPath(record.group.repoRoot)) !== comparablePath(repoRoot)) {
553
+ return blockedEntry(entry, "unknown", "unknown", "handoff repository root does not match the requested repository");
554
+ }
555
+ if (input.otherGitRecords.some((candidate) => candidate.branch === git.branch && comparablePath(candidate.path) !== comparablePath(git.path))) {
556
+ return blockedEntry(entry, "unknown", "unknown", "metadata-recorded branch is checked out in another Git worktree");
557
+ }
558
+ if (git.branch === input.otherGitRecords.find((candidate) => comparablePath(candidate.path) === rootPath)?.branch) {
559
+ return blockedEntry(entry, "ineligible", "keep", "metadata-recorded branch is checked out at the repository root");
560
+ }
561
+ const retainedSession = record.child.sessionPath ?? record.status?.steps?.[record.child.index]?.sessionFile ?? record.status?.sessionFile;
562
+ if (typeof retainedSession === "string" && retainedSession.trim())
563
+ return blockedEntry(entry, "ineligible", "keep", "retained child resume still has a recorded session dependency");
564
+ const runState = inspectRunState(record, input.now, foregroundRunOwnership);
565
+ if (runState.kind === "unknown")
566
+ return blockedEntry(entry, "unknown", "unknown", runState.reason ?? "owning run state is unknown");
567
+ if (runState.kind === "active")
568
+ return blockedEntry(entry, "active", "keep", runState.reason ?? "owning run is active");
569
+ if (runState.kind === "stale")
570
+ return blockedEntry(entry, "stale", "unknown", runState.reason ?? "terminal active marker is stale");
571
+ const baseCommit = record.group.baseCommit;
572
+ if (typeof baseCommit !== "string" || !baseCommit.trim())
573
+ return blockedEntry(entry, "unknown", "unknown", "handoff metadata has no base commit");
574
+ const resolvedBase = resolveCommit(repoRoot, baseCommit);
575
+ if (!resolvedBase.value)
576
+ return blockedEntry(entry, "unknown", "unknown", `handoff base commit is not a valid local commit: ${resolvedBase.error ?? "unknown error"}`);
577
+ entry.baseCommit = resolvedBase.value;
578
+ entry.preconditions.baseCommit = resolvedBase.value;
579
+ const branchTip = resolveBranchTip(repoRoot, git.branch);
580
+ if (!branchTip.value)
581
+ return blockedEntry(entry, "unknown", "unknown", `branch tip could not be resolved: ${branchTip.error ?? "unknown error"}`);
582
+ entry.preconditions.branchTip = branchTip.value;
583
+ entry.preconditions.worktreeHead = git.head;
584
+ if (branchTip.value !== git.head)
585
+ return blockedEntry(entry, "unknown", "unknown", "branch tip and worktree HEAD do not match");
586
+ const status = inspectStatus(worktreePath);
587
+ if (status.error)
588
+ return blockedEntry(entry, "unknown", "unknown", `git status failed: ${status.error}`);
589
+ entry.preconditions.statusDigest = status.digest;
590
+ if (status.output && status.output.trim())
591
+ return blockedEntry(entry, "dirty", "keep", "worktree has uncommitted or untracked changes");
592
+ const ignored = runGit(worktreePath, ["ls-files", "--others", "--ignored", "--exclude-standard", "-z"]);
593
+ if (ignored.status !== 0)
594
+ return blockedEntry(entry, "unknown", "unknown", `ignored-file inspection failed: ${gitFailure(ignored, "git ls-files")}`);
595
+ if (ignored.stdout)
596
+ return blockedEntry(entry, "ineligible", "keep", "worktree contains ignored files; cleanup preserves them");
597
+ const diff = runGit(worktreePath, ["diff", "--quiet", ...MACHINE_DIFF_OPTIONS, resolvedBase.value, "--"]);
598
+ if (diff.status !== 0 && diff.status !== 1)
599
+ return blockedEntry(entry, "unknown", "unknown", `git diff safety check failed: ${gitFailure(diff, "git diff")}`);
600
+ const ancestor = runGit(repoRoot, ["merge-base", "--is-ancestor", git.head, targetHead]);
601
+ if (ancestor.status !== 0 && ancestor.status !== 1)
602
+ return blockedEntry(entry, "unknown", "unknown", `local merge safety check failed: ${gitFailure(ancestor, "git merge-base --is-ancestor")}`);
603
+ const branchTipIsAncestor = ancestor.status === 0;
604
+ let divergenceSafe = diff.status === 0;
605
+ if (!divergenceSafe) {
606
+ const captured = isPatchCaptured(record, worktreePath, resolvedBase.value);
607
+ if (captured.error)
608
+ return blockedEntry(entry, "ineligible", "keep", captured.error);
609
+ if (captured.path) {
610
+ entry.patchPath = captured.path;
611
+ divergenceSafe = true;
612
+ }
613
+ else {
614
+ if (branchTipIsAncestor)
615
+ divergenceSafe = true;
616
+ else
617
+ return blockedEntry(entry, "ineligible", "keep", "committed divergence is neither preserved by a handoff patch nor merged into the local target HEAD");
618
+ }
619
+ }
620
+ if (!divergenceSafe)
621
+ return blockedEntry(entry, "unknown", "unknown", "worktree divergence safety could not be established");
622
+ for (const reportPath of [record.manifestPath, ...metadataReportPaths(record)]) {
623
+ const inspection = inspectPath(reportPath);
624
+ if (inspection.error)
625
+ return blockedEntry(entry, "unknown", "unknown", `durable handoff path could not be inspected: ${inspection.error}`);
626
+ const comparable = inspection.realpath ?? (inspection.symlink ? resolveExistingPath(reportPath) : inspection.resolved);
627
+ if (pathInside(pathInspection.realpath, comparable))
628
+ return blockedEntry(entry, "ineligible", "keep", `durable handoff path is inside the worktree: ${reportPath}`);
629
+ if (inspection.missing)
630
+ return blockedEntry(entry, "unknown", "unknown", `durable handoff path is missing: ${reportPath}`);
631
+ if (inspection.symlink)
632
+ return blockedEntry(entry, "unknown", "unknown", `durable handoff path is a symlink: ${reportPath}`);
633
+ }
634
+ for (const durablePath of metadataOutputPaths(record)) {
635
+ const inspection = inspectPath(durablePath);
636
+ const comparable = inspection.realpath ?? (inspection.symlink ? resolveExistingPath(durablePath) : inspection.resolved);
637
+ if (pathInside(pathInspection.realpath, comparable))
638
+ return blockedEntry(entry, "ineligible", "keep", `durable report or patch path is inside the worktree: ${durablePath}`);
639
+ }
640
+ entry.state = "safe";
641
+ entry.decision = "remove";
642
+ entry.willDeleteBranch = false;
643
+ entry.reasons.push("extension-owned metadata, terminal run, contained clean worktree, and local divergence checks passed");
644
+ if (!branchTipIsAncestor)
645
+ entry.reasons.push("local branch tip is not an ancestor of target HEAD; future apply must retain the branch");
646
+ return entry;
647
+ }
648
+ function buildUnknownGitEntry(input) {
649
+ const pathValue = resolveExistingPath(input.git.path);
650
+ const entry = buildEntryBase({ path: pathValue, branch: input.git.branch ?? "", source: "git", git: input.git, targetHead: input.targetHead });
651
+ return blockedEntry(entry, "unknown", "unknown", "no matching extension-owned handoff metadata was found");
652
+ }
653
+ function buildMissingMetadataEntry(input) {
654
+ if (input.record.task.worktreeRemoved && input.record.task.branchRemoved)
655
+ return undefined;
656
+ const pathValue = metadataRecordPath(input.record);
657
+ const entry = buildEntryBase({ path: pathValue, branch: input.record.task.branch, source: "metadata", metadata: input.record, targetHead: input.targetHead });
658
+ return blockedEntry(entry, "stale", "unknown", "handoff metadata records a worktree that is not present in Git worktree state");
659
+ }
660
+ export function worktreeCleanupContentPayload(plan) {
661
+ return {
662
+ version: plan.version,
663
+ repoRoot: plan.repoRoot,
664
+ baseDirs: plan.baseDirs,
665
+ metadataPaths: plan.metadataPaths,
666
+ entries: plan.entries,
667
+ pruneCandidates: plan.pruneCandidates,
668
+ ...(plan.warnings ? { warnings: plan.warnings } : {}),
669
+ };
670
+ }
671
+ function stableEntrySort(left, right) {
672
+ return comparablePath(left.path).localeCompare(comparablePath(right.path)) || left.branch.localeCompare(right.branch);
673
+ }
674
+ export function buildWorktreeCleanupPlan(input) {
675
+ if (typeof input.repo !== "string" || !input.repo.trim())
676
+ throw new Error("worktree cleanup plan requires a repository path");
677
+ const repoRoot = resolveCleanupRepoRoot(input.repo);
678
+ const now = input.now ?? Date.now();
679
+ if (!Number.isFinite(now))
680
+ throw new Error("worktree cleanup plan timestamp must be finite");
681
+ const baseDir = resolveCleanupBaseDir(repoRoot, input.worktreeBaseDir);
682
+ const containmentInvalid = cleanupContainmentInvalid(repoRoot, baseDir);
683
+ const gitRecords = listGitWorktrees(repoRoot);
684
+ const targetHead = runGitChecked(repoRoot, ["rev-parse", "HEAD"]);
685
+ const rootPath = comparablePath(repoRoot);
686
+ const metadata = loadMetadata(input, repoRoot);
687
+ const metadataByPath = new Map();
688
+ for (const record of metadata.records) {
689
+ const key = comparablePath(metadataRecordPath(record));
690
+ const records = metadataByPath.get(key) ?? [];
691
+ records.push(record);
692
+ metadataByPath.set(key, records);
693
+ }
694
+ const linkedGit = gitRecords.filter((record) => !samePath(record.path, repoRoot));
695
+ const entries = [];
696
+ const matchedMetadataRecords = new Set();
697
+ for (const git of linkedGit) {
698
+ if (input.candidatePaths && !input.candidatePaths.some((candidate) => samePath(candidate, git.path)))
699
+ continue;
700
+ const records = metadataByPath.get(comparablePath(git.path)) ?? (git.branch
701
+ ? metadata.records.filter((record) => record.task.branch === git.branch && samePath(metadataRecordPath(record), git.path))
702
+ : []);
703
+ if (records.length === 1)
704
+ matchedMetadataRecords.add(records[0]);
705
+ if (records.length !== 1)
706
+ entries.push(buildUnknownGitEntry({ git, targetHead }));
707
+ else
708
+ entries.push(buildManagedEntry({
709
+ repoRoot,
710
+ baseDir,
711
+ containmentInvalid,
712
+ targetHead,
713
+ rootPath,
714
+ git,
715
+ record: records[0],
716
+ otherGitRecords: gitRecords,
717
+ now,
718
+ foregroundRunOwnership: input.foregroundRunOwnership,
719
+ }));
720
+ }
721
+ const gitPathKeys = new Set(linkedGit.map((record) => comparablePath(record.path)));
722
+ for (const [key, records] of metadataByPath) {
723
+ if (gitPathKeys.has(key) || records.length !== 1 || matchedMetadataRecords.has(records[0]))
724
+ continue;
725
+ const missing = buildMissingMetadataEntry({ record: records[0], targetHead });
726
+ if (missing)
727
+ entries.push(missing);
728
+ }
729
+ entries.sort(stableEntrySort);
730
+ const warnings = metadata.warnings;
731
+ if (entries.length > MAX_PLAN_ENTRIES) {
732
+ warnings.push(`cleanup plan entry count capped at ${MAX_PLAN_ENTRIES}; remaining worktrees are not evaluated`);
733
+ entries.splice(MAX_PLAN_ENTRIES);
734
+ }
735
+ const pruneCandidates = entries
736
+ .filter((entry) => entry.decision === "unknown" && entry.state === "stale" && gitRecords.some((record) => record.prunable && comparablePath(record.path) === comparablePath(entry.path)))
737
+ .map((entry) => entry.path)
738
+ .sort((left, right) => comparablePath(left).localeCompare(comparablePath(right)));
739
+ const basePlan = {
740
+ version: WORKTREE_CLEANUP_PLAN_VERSION,
741
+ repoRoot,
742
+ baseDirs: [baseDir],
743
+ metadataPaths: metadata.paths,
744
+ entries,
745
+ pruneCandidates,
746
+ ...(warnings.length ? { warnings: [...new Set(warnings)].sort() } : {}),
747
+ };
748
+ const contentHash = sha256(JSON.stringify(worktreeCleanupContentPayload(basePlan)));
749
+ const planId = validatePlanId(input.planId ?? randomUUID());
750
+ return {
751
+ ...basePlan,
752
+ planId,
753
+ createdAt: now,
754
+ expiresAt: now + WORKTREE_CLEANUP_PLAN_TTL_MS,
755
+ contentHash,
756
+ };
757
+ }
758
+ export function worktreeCleanupPlanPath(repoRoot, planId) {
759
+ return path.join(repoRoot, PROJECT_SUBAGENTS_RELATIVE_DIR, "cleanup-plans", `${validatePlanId(planId)}.json`);
760
+ }
761
+ export function createWorktreeCleanupPlan(input) {
762
+ const plan = buildWorktreeCleanupPlan(input);
763
+ const planPath = worktreeCleanupPlanPath(plan.repoRoot, plan.planId);
764
+ writeAtomicJson(planPath, plan);
765
+ return { plan, planPath };
766
+ }
767
+ function formatPlanEntry(entry) {
768
+ const target = entry.branch ? `${entry.path} [${entry.branch}]` : entry.path;
769
+ return `- ${target}: ${entry.reasons.join("; ") || "no reason recorded"}`;
770
+ }
771
+ export function formatWorktreeCleanupPlan(created) {
772
+ const { plan, planPath } = created;
773
+ const removable = plan.entries.filter((entry) => entry.decision === "remove");
774
+ const kept = plan.entries.filter((entry) => entry.decision === "keep");
775
+ const unknown = plan.entries.filter((entry) => entry.decision === "unknown");
776
+ const section = (title, entries, empty) => [
777
+ title,
778
+ ...(entries.length ? entries.map(formatPlanEntry) : [`- ${empty}`]),
779
+ ];
780
+ const lines = [
781
+ `Worktree cleanup plan ${plan.planId}`,
782
+ `Repository: ${plan.repoRoot}`,
783
+ `Expires: ${new Date(plan.expiresAt).toISOString()}`,
784
+ `Entries: ${plan.entries.length}`,
785
+ "",
786
+ ...section("Will remove", removable, "none"),
787
+ "",
788
+ "Local branches: all retained, including after apply.",
789
+ "",
790
+ ...section("Will keep, with reasons", kept, "none"),
791
+ "",
792
+ ...section("Unknown, needs manual review", unknown, "none"),
793
+ "",
794
+ "Prune candidates",
795
+ ...(plan.pruneCandidates.length ? plan.pruneCandidates.map((candidate) => `- ${candidate}`) : ["- none (plan-only mode does not prune Git metadata)"]),
796
+ ...(plan.warnings?.length ? ["", "Warnings", ...plan.warnings.map((warning) => `- ${warning}`)] : []),
797
+ "",
798
+ `Plan saved: ${planPath}`,
799
+ "Plan-only mode: no worktrees or branches were removed.",
800
+ `Apply this reviewed plan: subagent({ action: "worktree.cleanup", options: { mode: "apply", repo: ${JSON.stringify(plan.repoRoot)}, planId: ${JSON.stringify(plan.planId)} } })`,
801
+ ];
802
+ return lines.join("\n");
803
+ }