@xzzpig/pi-subagents 0.21.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1132) hide show
  1. package/CHANGELOG.md +356 -0
  2. package/README.md +2 -2
  3. package/agents/evidence-auditor.md +1 -0
  4. package/agents/oracle.md +1 -0
  5. package/agents/reviewer.md +1 -0
  6. package/bundle/agent-management.js +16 -0
  7. package/bundle/agents.js +41 -0
  8. package/bundle/background-work.js +16 -0
  9. package/bundle/capability-ceiling.js +22 -0
  10. package/bundle/child-tool-plan.js +11 -0
  11. package/bundle/chunk-355ECEP2.js +1321 -0
  12. package/bundle/chunk-35GII5EF.js +637 -0
  13. package/bundle/chunk-3G4JXNZ4.js +4130 -0
  14. package/bundle/chunk-3U633XDZ.js +749 -0
  15. package/bundle/chunk-4QFZZV3O.js +57 -0
  16. package/bundle/chunk-62OCY2S4.js +14 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-7K3Z6DM7.js +276 -0
  19. package/bundle/chunk-BGIYHF2W.js +138 -0
  20. package/bundle/chunk-CTPAE36Y.js +94 -0
  21. package/bundle/chunk-D4EHT5SJ.js +14 -0
  22. package/bundle/chunk-ED55MIC2.js +1681 -0
  23. package/bundle/chunk-F3NSN7UH.js +7331 -0
  24. package/bundle/chunk-FJWI64H7.js +490 -0
  25. package/bundle/chunk-H36HBZB2.js +753 -0
  26. package/bundle/chunk-ICNYIALB.js +7347 -0
  27. package/bundle/chunk-KD2IMFN4.js +1310 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LPVUHUZ7.js +5503 -0
  30. package/bundle/chunk-MYCL5QEJ.js +1372 -0
  31. package/bundle/chunk-NCWCVJLT.js +1768 -0
  32. package/bundle/chunk-NIXWDZZV.js +9 -0
  33. package/bundle/chunk-NTRJDXBC.js +4175 -0
  34. package/bundle/chunk-OFGSZBHP.js +16924 -0
  35. package/bundle/chunk-OTLRAB22.js +143 -0
  36. package/bundle/chunk-QXASAHIA.js +173 -0
  37. package/bundle/chunk-RB4GELQA.js +458 -0
  38. package/bundle/chunk-RK2HDPLK.js +1234 -0
  39. package/bundle/chunk-SW2VMNIU.js +526 -0
  40. package/bundle/chunk-T65XRVVM.js +940 -0
  41. package/bundle/chunk-U4ODUYAG.js +235 -0
  42. package/bundle/chunk-UFNSLL5D.js +9796 -0
  43. package/bundle/chunk-UKG4V45O.js +228 -0
  44. package/bundle/chunk-UQDHXMUG.js +264 -0
  45. package/bundle/chunk-V2KFIGFH.js +8774 -0
  46. package/bundle/chunk-VO3G7HI3.js +85 -0
  47. package/bundle/chunk-WPW4V6HM.js +227 -0
  48. package/bundle/chunk-WW76JRIX.js +175 -0
  49. package/bundle/chunk-XA3DY6UG.js +161 -0
  50. package/bundle/chunk-YFCK7H2S.js +129 -0
  51. package/bundle/chunk-YYREO77V.js +137 -0
  52. package/bundle/chunk-Z6TFJ6BR.js +400 -0
  53. package/bundle/control-channel.js +11 -0
  54. package/bundle/delegation.js +14 -0
  55. package/bundle/external-job-provider.js +20 -0
  56. package/bundle/external-runs.js +21 -0
  57. package/bundle/index.js +30 -0
  58. package/bundle/inspectors.js +8 -0
  59. package/bundle/intercom-bridge.js +11 -0
  60. package/bundle/preflight.js +468 -0
  61. package/bundle/project-panes.js +28 -0
  62. package/bundle/required-child-extensions.js +6 -0
  63. package/bundle/shared-types.js +8 -0
  64. package/bundle/supervisor-routing.js +12 -0
  65. package/bundle/workflow-resources.js +7 -0
  66. package/docs/agents.md +42 -10
  67. package/docs/configuration.md +59 -14
  68. package/docs/extension-api.md +61 -9
  69. package/docs/fork-supervisor-routing.md +77 -0
  70. package/docs/missions.md +2 -0
  71. package/docs/observability.md +20 -5
  72. package/docs/standalone-background.md +8 -6
  73. package/docs/tool-reference.md +18 -5
  74. package/docs/workflows.md +25 -7
  75. package/index.d.ts +3 -0
  76. package/index.js +14 -0
  77. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  78. package/package.json +107 -86
  79. package/skills/council-mode/SKILL.md +1 -4
  80. package/skills/pi-subagents/SKILL.md +130 -106
  81. package/skills/pi-subagents/references/orchestration.md +124 -0
  82. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  83. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  84. package/src/agents/advertised-agent-prompt.js +68 -0
  85. package/src/agents/agent-eject.d.ts +39 -0
  86. package/src/agents/agent-eject.js +263 -0
  87. package/src/agents/agent-management.d.ts +33 -0
  88. package/src/agents/agent-management.js +1541 -0
  89. package/src/agents/agent-memory.d.ts +48 -0
  90. package/src/agents/agent-memory.js +350 -0
  91. package/src/agents/agent-refinements.d.ts +99 -0
  92. package/src/agents/agent-refinements.js +568 -0
  93. package/src/agents/agent-scope.d.ts +3 -0
  94. package/src/agents/agent-scope.js +8 -0
  95. package/src/agents/agent-selection.d.ts +2 -0
  96. package/src/agents/agent-selection.js +22 -0
  97. package/src/agents/agent-serializer.d.ts +7 -0
  98. package/src/agents/agent-serializer.js +213 -0
  99. package/src/agents/agents.d.ts +352 -0
  100. package/src/agents/agents.js +2817 -0
  101. package/src/agents/builtin-names.d.ts +1 -0
  102. package/src/agents/builtin-names.js +16 -0
  103. package/src/agents/chain-serializer.d.ts +6 -0
  104. package/src/agents/chain-serializer.js +318 -0
  105. package/src/agents/frontmatter.d.ts +19 -0
  106. package/src/agents/frontmatter.js +166 -0
  107. package/src/agents/global-npm-root.d.ts +6 -0
  108. package/src/agents/global-npm-root.js +57 -0
  109. package/src/agents/identity.d.ts +7 -0
  110. package/src/agents/identity.js +29 -0
  111. package/src/agents/proactive-skills.d.ts +35 -0
  112. package/src/agents/proactive-skills.js +155 -0
  113. package/src/agents/runtime-agent-events.d.ts +26 -0
  114. package/src/agents/runtime-agent-events.js +52 -0
  115. package/src/agents/runtime-agent-registry.d.ts +66 -0
  116. package/src/agents/runtime-agent-registry.js +415 -0
  117. package/src/agents/runtime-discovery.d.ts +13 -0
  118. package/src/agents/runtime-discovery.js +27 -0
  119. package/src/agents/skills.d.ts +34 -0
  120. package/src/agents/skills.js +718 -0
  121. package/src/api/agent-management.d.ts +2 -0
  122. package/src/api/agent-management.js +2 -0
  123. package/src/api/agents.d.ts +6 -0
  124. package/src/api/agents.js +3 -0
  125. package/src/api/background-work.d.ts +41 -0
  126. package/src/api/background-work.js +171 -0
  127. package/src/api/capability-ceiling.d.ts +1 -0
  128. package/src/api/capability-ceiling.js +1 -0
  129. package/src/api/child-tool-plan.d.ts +1 -0
  130. package/src/api/child-tool-plan.js +1 -0
  131. package/src/api/control-channel.d.ts +1 -0
  132. package/src/api/control-channel.js +1 -0
  133. package/src/api/delegation.d.ts +132 -0
  134. package/src/api/delegation.js +8 -0
  135. package/src/api/external-job-provider.d.ts +57 -0
  136. package/src/api/external-job-provider.js +139 -0
  137. package/src/api/external-runs.d.ts +47 -0
  138. package/src/api/external-runs.js +245 -0
  139. package/src/api/inspectors.d.ts +20 -0
  140. package/src/api/inspectors.js +11 -0
  141. package/src/api/intercom-bridge.d.ts +1 -0
  142. package/src/api/intercom-bridge.js +1 -0
  143. package/src/api/preflight.d.ts +183 -0
  144. package/src/api/preflight.js +455 -0
  145. package/src/api/project-panes.d.ts +7 -0
  146. package/src/api/project-panes.js +7 -0
  147. package/src/api/required-child-extensions.d.ts +1 -0
  148. package/src/api/required-child-extensions.js +1 -0
  149. package/src/api/shared-types.d.ts +1 -0
  150. package/src/api/shared-types.js +1 -0
  151. package/src/api/supervisor-routing.d.ts +110 -0
  152. package/src/api/supervisor-routing.js +95 -0
  153. package/src/api/workflow-resources.d.ts +2 -0
  154. package/src/api/workflow-resources.js +1 -0
  155. package/src/extension/active-runs-prompt.d.ts +7 -0
  156. package/src/extension/active-runs-prompt.js +29 -0
  157. package/src/extension/config.d.ts +7 -0
  158. package/src/extension/config.js +290 -0
  159. package/src/extension/context-injection.d.ts +52 -0
  160. package/src/extension/context-injection.js +102 -0
  161. package/src/extension/control-notices.d.ts +18 -0
  162. package/src/extension/control-notices.js +29 -0
  163. package/src/extension/declaration-pinning.d.ts +18 -0
  164. package/src/extension/declaration-pinning.js +167 -0
  165. package/src/extension/doctor.d.ts +34 -0
  166. package/src/extension/doctor.js +236 -0
  167. package/src/extension/fanout-child.d.ts +6 -0
  168. package/src/extension/fanout-child.js +278 -0
  169. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  170. package/src/extension/herdr-pi-bridge.js +261 -0
  171. package/src/extension/index.d.ts +18 -0
  172. package/src/extension/index.js +1288 -0
  173. package/src/extension/public-execution.d.ts +71 -0
  174. package/src/extension/public-execution.js +214 -0
  175. package/src/extension/reply-workflow-script.d.ts +11 -0
  176. package/src/extension/reply-workflow-script.js +71 -0
  177. package/src/extension/rpc.d.ts +84 -0
  178. package/src/extension/rpc.js +729 -0
  179. package/src/extension/schemas.d.ts +276 -0
  180. package/src/extension/schemas.js +311 -0
  181. package/src/extension/steering-notices.d.ts +14 -0
  182. package/src/extension/steering-notices.js +22 -0
  183. package/src/extension/subagent-guide.d.ts +4 -0
  184. package/src/extension/subagent-guide.js +114 -0
  185. package/src/extension/subagent-options.d.ts +7 -0
  186. package/src/extension/subagent-options.js +64 -0
  187. package/src/extension/tool-activation.d.ts +7 -0
  188. package/src/extension/tool-activation.js +185 -0
  189. package/src/extension/tool-description.d.ts +19 -0
  190. package/src/extension/tool-description.js +169 -0
  191. package/src/extension/tool-result.d.ts +9 -0
  192. package/src/extension/tool-result.js +16 -0
  193. package/src/extension/upgrade-notice.d.ts +6 -0
  194. package/src/extension/upgrade-notice.js +42 -0
  195. package/src/inspectors/actions.d.ts +24 -0
  196. package/src/inspectors/actions.js +182 -0
  197. package/src/inspectors/ghostty/actions.d.ts +11 -0
  198. package/src/inspectors/ghostty/actions.js +62 -0
  199. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  200. package/src/inspectors/ghostty/plugin.js +23 -0
  201. package/src/inspectors/herdr/actions.d.ts +25 -0
  202. package/src/inspectors/herdr/actions.js +133 -0
  203. package/src/inspectors/herdr/client.d.ts +41 -0
  204. package/src/inspectors/herdr/client.js +129 -0
  205. package/src/inspectors/herdr/focus.d.ts +24 -0
  206. package/src/inspectors/herdr/focus.js +49 -0
  207. package/src/inspectors/herdr/plugin.d.ts +6 -0
  208. package/src/inspectors/herdr/plugin.js +14 -0
  209. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  210. package/src/inspectors/herdr/project-panes.js +610 -0
  211. package/src/inspectors/inspector-runner.d.ts +23 -0
  212. package/src/inspectors/inspector-runner.js +161 -0
  213. package/src/inspectors/plugins.d.ts +8 -0
  214. package/src/inspectors/plugins.js +82 -0
  215. package/src/inspectors/session-roots-codec.d.ts +15 -0
  216. package/src/inspectors/session-roots-codec.js +32 -0
  217. package/src/inspectors/shell-command.d.ts +1 -0
  218. package/src/inspectors/shell-command.js +16 -0
  219. package/src/inspectors/tmux/actions.d.ts +25 -0
  220. package/src/inspectors/tmux/actions.js +181 -0
  221. package/src/inspectors/tmux/client.d.ts +27 -0
  222. package/src/inspectors/tmux/client.js +64 -0
  223. package/src/inspectors/tmux/plugin.d.ts +7 -0
  224. package/src/inspectors/tmux/plugin.js +14 -0
  225. package/src/inspectors/types.d.ts +48 -0
  226. package/src/inspectors/types.js +1 -0
  227. package/src/integrations/herdr-status.d.ts +47 -0
  228. package/src/integrations/herdr-status.js +350 -0
  229. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  230. package/src/integrations/pi-web-session-liveness.js +53 -0
  231. package/src/integrations/program-status.d.ts +30 -0
  232. package/src/integrations/program-status.js +188 -0
  233. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  234. package/src/intercom/fork-supervisor-routing.js +392 -0
  235. package/src/intercom/intercom-bridge.d.ts +58 -0
  236. package/src/intercom/intercom-bridge.js +193 -0
  237. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  238. package/src/intercom/native-supervisor-channel.js +1184 -0
  239. package/src/intercom/result-intercom.d.ts +35 -0
  240. package/src/intercom/result-intercom.js +376 -0
  241. package/src/intercom/supervisor-ui.d.ts +29 -0
  242. package/src/intercom/supervisor-ui.js +49 -0
  243. package/src/missions/actions.d.ts +54 -0
  244. package/src/missions/actions.js +400 -0
  245. package/src/missions/goal-driver.d.ts +16 -0
  246. package/src/missions/goal-driver.js +171 -0
  247. package/src/missions/lifecycle.d.ts +50 -0
  248. package/src/missions/lifecycle.js +388 -0
  249. package/src/missions/store.d.ts +21 -0
  250. package/src/missions/store.js +605 -0
  251. package/src/missions/types.d.ts +169 -0
  252. package/src/missions/types.js +9 -0
  253. package/src/missions/workflow-state.d.ts +14 -0
  254. package/src/missions/workflow-state.js +273 -0
  255. package/src/policy/authority.d.ts +9 -0
  256. package/src/policy/authority.js +41 -0
  257. package/src/profiles/profiles.d.ts +134 -0
  258. package/src/profiles/profiles.js +526 -0
  259. package/src/runs/background/active-async-capacity.d.ts +115 -0
  260. package/src/runs/background/active-async-capacity.js +517 -0
  261. package/src/runs/background/active-run-index.d.ts +12 -0
  262. package/src/runs/background/active-run-index.js +157 -0
  263. package/src/runs/background/async-execution.d.ts +304 -0
  264. package/src/runs/background/async-execution.js +2206 -0
  265. package/src/runs/background/async-job-tracker.d.ts +37 -0
  266. package/src/runs/background/async-job-tracker.js +921 -0
  267. package/src/runs/background/async-resume.d.ts +60 -0
  268. package/src/runs/background/async-resume.js +707 -0
  269. package/src/runs/background/async-retention.d.ts +45 -0
  270. package/src/runs/background/async-retention.js +932 -0
  271. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  272. package/src/runs/background/async-status-snapshot.js +26 -0
  273. package/src/runs/background/async-status.d.ts +177 -0
  274. package/src/runs/background/async-status.js +710 -0
  275. package/src/runs/background/auto-drain.d.ts +16 -0
  276. package/src/runs/background/auto-drain.js +71 -0
  277. package/src/runs/background/await-async-run.d.ts +26 -0
  278. package/src/runs/background/await-async-run.js +83 -0
  279. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  280. package/src/runs/background/binary-bootstrap.js +69 -0
  281. package/src/runs/background/boot-id.d.ts +12 -0
  282. package/src/runs/background/boot-id.js +47 -0
  283. package/src/runs/background/calendar-schedule.d.ts +26 -0
  284. package/src/runs/background/calendar-schedule.js +93 -0
  285. package/src/runs/background/chain-append.d.ts +34 -0
  286. package/src/runs/background/chain-append.js +299 -0
  287. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  288. package/src/runs/background/chain-root-attachment.js +186 -0
  289. package/src/runs/background/completion-batcher.d.ts +51 -0
  290. package/src/runs/background/completion-batcher.js +119 -0
  291. package/src/runs/background/completion-dedupe.d.ts +13 -0
  292. package/src/runs/background/completion-dedupe.js +48 -0
  293. package/src/runs/background/completion-replay.d.ts +47 -0
  294. package/src/runs/background/completion-replay.js +266 -0
  295. package/src/runs/background/control-channel.d.ts +170 -0
  296. package/src/runs/background/control-channel.js +610 -0
  297. package/src/runs/background/fleet-view.d.ts +63 -0
  298. package/src/runs/background/fleet-view.js +666 -0
  299. package/src/runs/background/index-segment.d.ts +16 -0
  300. package/src/runs/background/index-segment.js +58 -0
  301. package/src/runs/background/inspect-rpc.d.ts +64 -0
  302. package/src/runs/background/inspect-rpc.js +422 -0
  303. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  304. package/src/runs/background/interrupted-elsewhere.js +68 -0
  305. package/src/runs/background/notify.d.ts +214 -0
  306. package/src/runs/background/notify.js +1001 -0
  307. package/src/runs/background/owned-process-tree.d.ts +10 -0
  308. package/src/runs/background/owned-process-tree.js +116 -0
  309. package/src/runs/background/parallel-groups.d.ts +3 -0
  310. package/src/runs/background/parallel-groups.js +46 -0
  311. package/src/runs/background/pid-namespace.d.ts +2 -0
  312. package/src/runs/background/pid-namespace.js +19 -0
  313. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  314. package/src/runs/background/process-terminal-candidate.js +96 -0
  315. package/src/runs/background/process-terminal.d.ts +21 -0
  316. package/src/runs/background/process-terminal.js +227 -0
  317. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  318. package/src/runs/background/result-delivery-ownership.js +38 -0
  319. package/src/runs/background/result-files.d.ts +63 -0
  320. package/src/runs/background/result-files.js +629 -0
  321. package/src/runs/background/result-watcher.d.ts +92 -0
  322. package/src/runs/background/result-watcher.js +819 -0
  323. package/src/runs/background/resume-guidance.d.ts +4 -0
  324. package/src/runs/background/resume-guidance.js +57 -0
  325. package/src/runs/background/retained-children.d.ts +24 -0
  326. package/src/runs/background/retained-children.js +128 -0
  327. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  328. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  329. package/src/runs/background/run-child-session.d.ts +123 -0
  330. package/src/runs/background/run-child-session.js +670 -0
  331. package/src/runs/background/run-id-query.d.ts +3 -0
  332. package/src/runs/background/run-id-query.js +6 -0
  333. package/src/runs/background/run-id-resolver.d.ts +22 -0
  334. package/src/runs/background/run-id-resolver.js +172 -0
  335. package/src/runs/background/run-status.d.ts +25 -0
  336. package/src/runs/background/run-status.js +850 -0
  337. package/src/runs/background/runner-aliases.d.ts +17 -0
  338. package/src/runs/background/runner-aliases.js +191 -0
  339. package/src/runs/background/runner-child-launch.d.ts +24 -0
  340. package/src/runs/background/runner-child-launch.js +72 -0
  341. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  342. package/src/runs/background/runner-child-sessions.js +34 -0
  343. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  344. package/src/runs/background/runner-http-dispatcher.js +115 -0
  345. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  346. package/src/runs/background/runner-startup-failure.js +46 -0
  347. package/src/runs/background/scheduled-runs.d.ts +127 -0
  348. package/src/runs/background/scheduled-runs.js +1265 -0
  349. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  350. package/src/runs/background/stale-run-reconciler.js +509 -0
  351. package/src/runs/background/steering.d.ts +51 -0
  352. package/src/runs/background/steering.js +246 -0
  353. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  354. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  355. package/src/runs/background/subagent-runner.d.ts +210 -0
  356. package/src/runs/background/subagent-runner.js +4963 -0
  357. package/src/runs/background/subagent-wait.d.ts +124 -0
  358. package/src/runs/background/subagent-wait.js +756 -0
  359. package/src/runs/background/terminal-run-index.d.ts +10 -0
  360. package/src/runs/background/terminal-run-index.js +209 -0
  361. package/src/runs/background/top-level-async.d.ts +7 -0
  362. package/src/runs/background/top-level-async.js +5 -0
  363. package/src/runs/background/wait-completions.d.ts +28 -0
  364. package/src/runs/background/wait-completions.js +264 -0
  365. package/src/runs/background/wait-config.d.ts +8 -0
  366. package/src/runs/background/wait-config.js +46 -0
  367. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  368. package/src/runs/background/wait-subscriptions.js +339 -0
  369. package/src/runs/background/wait-tool.d.ts +6 -0
  370. package/src/runs/background/wait-tool.js +48 -0
  371. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  372. package/src/runs/background/workflow-terminal-proof.js +116 -0
  373. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  374. package/src/runs/foreground/async-dismiss-action.js +82 -0
  375. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  376. package/src/runs/foreground/async-steering-action.js +294 -0
  377. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  378. package/src/runs/foreground/async-stop-action.js +213 -0
  379. package/src/runs/foreground/command-action.d.ts +12 -0
  380. package/src/runs/foreground/command-action.js +38 -0
  381. package/src/runs/foreground/execution.d.ts +10 -0
  382. package/src/runs/foreground/execution.js +2322 -0
  383. package/src/runs/foreground/foreground-control.d.ts +24 -0
  384. package/src/runs/foreground/foreground-control.js +138 -0
  385. package/src/runs/foreground/foreground-history.d.ts +25 -0
  386. package/src/runs/foreground/foreground-history.js +267 -0
  387. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  388. package/src/runs/foreground/prompt-audit.js +138 -0
  389. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  390. package/src/runs/foreground/subagent-executor.js +7986 -0
  391. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  392. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  393. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  394. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  395. package/src/runs/shared/abort-recovery.d.ts +26 -0
  396. package/src/runs/shared/abort-recovery.js +108 -0
  397. package/src/runs/shared/acceptance.d.ts +144 -0
  398. package/src/runs/shared/acceptance.js +1616 -0
  399. package/src/runs/shared/agent-contract.d.ts +5 -0
  400. package/src/runs/shared/agent-contract.js +35 -0
  401. package/src/runs/shared/async-status-projection.d.ts +100 -0
  402. package/src/runs/shared/async-status-projection.js +566 -0
  403. package/src/runs/shared/background-process-options.d.ts +4 -0
  404. package/src/runs/shared/background-process-options.js +6 -0
  405. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  406. package/src/runs/shared/capability-ceiling.js +179 -0
  407. package/src/runs/shared/chain-outputs.d.ts +18 -0
  408. package/src/runs/shared/chain-outputs.js +104 -0
  409. package/src/runs/shared/child-commands.d.ts +29 -0
  410. package/src/runs/shared/child-commands.js +254 -0
  411. package/src/runs/shared/child-hooks.d.ts +31 -0
  412. package/src/runs/shared/child-hooks.js +173 -0
  413. package/src/runs/shared/child-identity.d.ts +23 -0
  414. package/src/runs/shared/child-identity.js +40 -0
  415. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  416. package/src/runs/shared/child-launch-plan.js +88 -0
  417. package/src/runs/shared/child-launch.d.ts +128 -0
  418. package/src/runs/shared/child-launch.js +262 -0
  419. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  420. package/src/runs/shared/child-lifecycle.js +22 -0
  421. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  422. package/src/runs/shared/child-runtime-config.js +44 -0
  423. package/src/runs/shared/child-session.d.ts +178 -0
  424. package/src/runs/shared/child-session.js +726 -0
  425. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  426. package/src/runs/shared/child-tool-plan.js +430 -0
  427. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  428. package/src/runs/shared/claude-code-adapter.js +255 -0
  429. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  430. package/src/runs/shared/codex-exec-adapter.js +127 -0
  431. package/src/runs/shared/context-mode.d.ts +12 -0
  432. package/src/runs/shared/context-mode.js +38 -0
  433. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  434. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  435. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  436. package/src/runs/shared/dynamic-fanout.js +273 -0
  437. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  438. package/src/runs/shared/effective-system-prompt.js +23 -0
  439. package/src/runs/shared/extension-bindings.d.ts +25 -0
  440. package/src/runs/shared/extension-bindings.js +96 -0
  441. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  442. package/src/runs/shared/external-cli-contract.js +145 -0
  443. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  444. package/src/runs/shared/external-cli-preflight.js +159 -0
  445. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  446. package/src/runs/shared/external-cli-runner.js +425 -0
  447. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  448. package/src/runs/shared/external-job-bridge.js +486 -0
  449. package/src/runs/shared/external-job-runner.d.ts +44 -0
  450. package/src/runs/shared/external-job-runner.js +352 -0
  451. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  452. package/src/runs/shared/fast-mode-extension.js +8 -0
  453. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  454. package/src/runs/shared/fork-placed-env.js +13 -0
  455. package/src/runs/shared/git-environment.d.ts +2 -0
  456. package/src/runs/shared/git-environment.js +27 -0
  457. package/src/runs/shared/herdr-connection.d.ts +79 -0
  458. package/src/runs/shared/herdr-connection.js +269 -0
  459. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  460. package/src/runs/shared/herdr-external-adapters.js +404 -0
  461. package/src/runs/shared/herdr-machine.d.ts +59 -0
  462. package/src/runs/shared/herdr-machine.js +294 -0
  463. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  464. package/src/runs/shared/herdr-pane-host.js +155 -0
  465. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  466. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  467. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  468. package/src/runs/shared/herdr-placed-run.js +380 -0
  469. package/src/runs/shared/host-step-status.d.ts +33 -0
  470. package/src/runs/shared/host-step-status.js +244 -0
  471. package/src/runs/shared/lane-metadata.d.ts +23 -0
  472. package/src/runs/shared/lane-metadata.js +126 -0
  473. package/src/runs/shared/launch-cwd.d.ts +1 -0
  474. package/src/runs/shared/launch-cwd.js +16 -0
  475. package/src/runs/shared/local-machine-access.d.ts +5 -0
  476. package/src/runs/shared/local-machine-access.js +28 -0
  477. package/src/runs/shared/long-running-guard.d.ts +34 -0
  478. package/src/runs/shared/long-running-guard.js +256 -0
  479. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  480. package/src/runs/shared/mcp-config-sources.js +418 -0
  481. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  482. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  483. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  484. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  485. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  486. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  487. package/src/runs/shared/model-resolution.d.ts +109 -0
  488. package/src/runs/shared/model-resolution.js +411 -0
  489. package/src/runs/shared/model-scope.d.ts +68 -0
  490. package/src/runs/shared/model-scope.js +171 -0
  491. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  492. package/src/runs/shared/mutation-evidence.js +198 -0
  493. package/src/runs/shared/nested-events.d.ts +135 -0
  494. package/src/runs/shared/nested-events.js +1090 -0
  495. package/src/runs/shared/nested-path.d.ts +8 -0
  496. package/src/runs/shared/nested-path.js +34 -0
  497. package/src/runs/shared/nested-render.d.ts +20 -0
  498. package/src/runs/shared/nested-render.js +115 -0
  499. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  500. package/src/runs/shared/orca-progress-tabs.js +503 -0
  501. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  502. package/src/runs/shared/parallel-handoff.js +783 -0
  503. package/src/runs/shared/parallel-utils.d.ts +177 -0
  504. package/src/runs/shared/parallel-utils.js +125 -0
  505. package/src/runs/shared/partial-output.d.ts +24 -0
  506. package/src/runs/shared/partial-output.js +35 -0
  507. package/src/runs/shared/permissions.d.ts +12 -0
  508. package/src/runs/shared/permissions.js +92 -0
  509. package/src/runs/shared/pi-spawn.d.ts +31 -0
  510. package/src/runs/shared/pi-spawn.js +211 -0
  511. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  512. package/src/runs/shared/placed-run-owner.js +93 -0
  513. package/src/runs/shared/placement-host.d.ts +99 -0
  514. package/src/runs/shared/placement-host.js +157 -0
  515. package/src/runs/shared/process-signal.d.ts +15 -0
  516. package/src/runs/shared/process-signal.js +21 -0
  517. package/src/runs/shared/profile-extensions.d.ts +21 -0
  518. package/src/runs/shared/profile-extensions.js +122 -0
  519. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  520. package/src/runs/shared/profile-launch-env.js +90 -0
  521. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  522. package/src/runs/shared/readonly-drain-observation.js +50 -0
  523. package/src/runs/shared/rex-machine.d.ts +25 -0
  524. package/src/runs/shared/rex-machine.js +83 -0
  525. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  526. package/src/runs/shared/rex-pane-host.js +327 -0
  527. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  528. package/src/runs/shared/run-fanout-budget.js +258 -0
  529. package/src/runs/shared/run-ownership.d.ts +3 -0
  530. package/src/runs/shared/run-ownership.js +8 -0
  531. package/src/runs/shared/runner-launcher.d.ts +11 -0
  532. package/src/runs/shared/runner-launcher.js +24 -0
  533. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  534. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  535. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  536. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  537. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  538. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  539. package/src/runs/shared/session-lease.d.ts +69 -0
  540. package/src/runs/shared/session-lease.js +250 -0
  541. package/src/runs/shared/single-output.d.ts +90 -0
  542. package/src/runs/shared/single-output.js +349 -0
  543. package/src/runs/shared/spawn-budget.d.ts +20 -0
  544. package/src/runs/shared/spawn-budget.js +93 -0
  545. package/src/runs/shared/structured-output.d.ts +66 -0
  546. package/src/runs/shared/structured-output.js +483 -0
  547. package/src/runs/shared/subagent-control.d.ts +50 -0
  548. package/src/runs/shared/subagent-control.js +247 -0
  549. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  550. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  551. package/src/runs/shared/tool-availability.d.ts +16 -0
  552. package/src/runs/shared/tool-availability.js +29 -0
  553. package/src/runs/shared/tool-budget.d.ts +21 -0
  554. package/src/runs/shared/tool-budget.js +78 -0
  555. package/src/runs/shared/tool-timeout.d.ts +31 -0
  556. package/src/runs/shared/tool-timeout.js +73 -0
  557. package/src/runs/shared/usage-budget.d.ts +7 -0
  558. package/src/runs/shared/usage-budget.js +74 -0
  559. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  560. package/src/runs/shared/usage-reconciliation.js +71 -0
  561. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  562. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  563. package/src/runs/shared/workflow-graph.d.ts +31 -0
  564. package/src/runs/shared/workflow-graph.js +221 -0
  565. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  566. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  567. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  568. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  569. package/src/runs/shared/worktree-lock.d.ts +5 -0
  570. package/src/runs/shared/worktree-lock.js +40 -0
  571. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  572. package/src/runs/shared/worktree-setup-command.js +200 -0
  573. package/src/runs/shared/worktree.d.ts +181 -0
  574. package/src/runs/shared/worktree.js +1346 -0
  575. package/src/shared/accessible-dir.d.ts +11 -0
  576. package/src/shared/accessible-dir.js +39 -0
  577. package/src/shared/agent-stream-options.d.ts +5 -0
  578. package/src/shared/agent-stream-options.js +3 -0
  579. package/src/shared/artifacts.d.ts +22 -0
  580. package/src/shared/artifacts.js +272 -0
  581. package/src/shared/atomic-json.d.ts +19 -0
  582. package/src/shared/atomic-json.js +61 -0
  583. package/src/shared/capacity-resilient-json.d.ts +26 -0
  584. package/src/shared/capacity-resilient-json.js +86 -0
  585. package/src/shared/child-cache-retention.d.ts +29 -0
  586. package/src/shared/child-cache-retention.js +40 -0
  587. package/src/shared/child-session-name.d.ts +8 -0
  588. package/src/shared/child-session-name.js +40 -0
  589. package/src/shared/child-transcript.d.ts +37 -0
  590. package/src/shared/child-transcript.js +225 -0
  591. package/src/shared/completion-owner.d.ts +7 -0
  592. package/src/shared/completion-owner.js +13 -0
  593. package/src/shared/disabled-features.d.ts +93 -0
  594. package/src/shared/disabled-features.js +120 -0
  595. package/src/shared/display-text.d.ts +5 -0
  596. package/src/shared/display-text.js +154 -0
  597. package/src/shared/edit-distance.d.ts +4 -0
  598. package/src/shared/edit-distance.js +32 -0
  599. package/src/shared/extension-context.d.ts +21 -0
  600. package/src/shared/extension-context.js +39 -0
  601. package/src/shared/file-coalescer.d.ts +11 -0
  602. package/src/shared/file-coalescer.js +34 -0
  603. package/src/shared/file-lease.d.ts +10 -0
  604. package/src/shared/file-lease.js +106 -0
  605. package/src/shared/file-system-retry.d.ts +31 -0
  606. package/src/shared/file-system-retry.js +84 -0
  607. package/src/shared/fork-context.d.ts +64 -0
  608. package/src/shared/fork-context.js +185 -0
  609. package/src/shared/fork-session-cwd.d.ts +2 -0
  610. package/src/shared/fork-session-cwd.js +23 -0
  611. package/src/shared/formatters.d.ts +35 -0
  612. package/src/shared/formatters.js +137 -0
  613. package/src/shared/jsonl-writer.d.ts +20 -0
  614. package/src/shared/jsonl-writer.js +67 -0
  615. package/src/shared/launch-contract.d.ts +65 -0
  616. package/src/shared/launch-contract.js +145 -0
  617. package/src/shared/model-info.d.ts +55 -0
  618. package/src/shared/model-info.js +103 -0
  619. package/src/shared/model-response-aliases.d.ts +1 -0
  620. package/src/shared/model-response-aliases.js +15 -0
  621. package/src/shared/node-executable.d.ts +1 -0
  622. package/src/shared/node-executable.js +20 -0
  623. package/src/shared/opencode-session-headers.d.ts +12 -0
  624. package/src/shared/opencode-session-headers.js +26 -0
  625. package/src/shared/package-version.d.ts +2 -0
  626. package/src/shared/package-version.js +14 -0
  627. package/src/shared/parent-wake.d.ts +26 -0
  628. package/src/shared/parent-wake.js +68 -0
  629. package/src/shared/permission-profile.d.ts +26 -0
  630. package/src/shared/permission-profile.js +49 -0
  631. package/src/shared/prompt-resources.d.ts +5 -0
  632. package/src/shared/prompt-resources.js +10 -0
  633. package/src/shared/provider-diagnostics.d.ts +9 -0
  634. package/src/shared/provider-diagnostics.js +75 -0
  635. package/src/shared/pruned-fork.d.ts +34 -0
  636. package/src/shared/pruned-fork.js +434 -0
  637. package/src/shared/required-child-extensions.d.ts +34 -0
  638. package/src/shared/required-child-extensions.js +105 -0
  639. package/src/shared/runtime-module-path.d.ts +10 -0
  640. package/src/shared/runtime-module-path.js +16 -0
  641. package/src/shared/sandbox-profile.d.ts +12 -0
  642. package/src/shared/sandbox-profile.js +35 -0
  643. package/src/shared/session-file-trust.d.ts +1 -0
  644. package/src/shared/session-file-trust.js +20 -0
  645. package/src/shared/session-identity.d.ts +8 -0
  646. package/src/shared/session-identity.js +32 -0
  647. package/src/shared/session-succession.d.ts +4 -0
  648. package/src/shared/session-succession.js +24 -0
  649. package/src/shared/session-tokens.d.ts +2 -0
  650. package/src/shared/session-tokens.js +58 -0
  651. package/src/shared/settings-file-lease.d.ts +4 -0
  652. package/src/shared/settings-file-lease.js +38 -0
  653. package/src/shared/settings.d.ts +146 -0
  654. package/src/shared/settings.js +247 -0
  655. package/src/shared/shortcuts.d.ts +1 -0
  656. package/src/shared/shortcuts.js +17 -0
  657. package/src/shared/status-format.d.ts +9 -0
  658. package/src/shared/status-format.js +60 -0
  659. package/src/shared/thinking-ceiling.d.ts +13 -0
  660. package/src/shared/thinking-ceiling.js +37 -0
  661. package/src/shared/types.d.ts +2840 -0
  662. package/src/shared/types.js +276 -0
  663. package/src/shared/utf8.d.ts +5 -0
  664. package/src/shared/utf8.js +12 -0
  665. package/src/shared/utils.d.ts +83 -0
  666. package/src/shared/utils.js +612 -0
  667. package/src/shared/watch-strategy.d.ts +2 -0
  668. package/src/shared/watch-strategy.js +5 -0
  669. package/src/shared/workflow-child-permit.d.ts +58 -0
  670. package/src/shared/workflow-child-permit.js +159 -0
  671. package/src/slash/delegation-adapters.d.ts +154 -0
  672. package/src/slash/delegation-adapters.js +316 -0
  673. package/src/slash/delegation-json.d.ts +10 -0
  674. package/src/slash/delegation-json.js +117 -0
  675. package/src/slash/delegation-request.d.ts +12 -0
  676. package/src/slash/delegation-request.js +174 -0
  677. package/src/slash/prompt-template-bridge.d.ts +29 -0
  678. package/src/slash/prompt-template-bridge.js +399 -0
  679. package/src/slash/prompt-workflows.d.ts +21 -0
  680. package/src/slash/prompt-workflows.js +274 -0
  681. package/src/slash/selector.d.ts +47 -0
  682. package/src/slash/selector.js +117 -0
  683. package/src/slash/slash-bridge.d.ts +30 -0
  684. package/src/slash/slash-bridge.js +132 -0
  685. package/src/slash/slash-commands.d.ts +10 -0
  686. package/src/slash/slash-commands.js +1059 -0
  687. package/src/slash/slash-live-state.d.ts +21 -0
  688. package/src/slash/slash-live-state.js +263 -0
  689. package/src/slash/subagent-cost.d.ts +29 -0
  690. package/src/slash/subagent-cost.js +310 -0
  691. package/src/slash/subagents-admin.d.ts +3 -0
  692. package/src/slash/subagents-admin.js +481 -0
  693. package/src/tui/fleet-layout.d.ts +20 -0
  694. package/src/tui/fleet-layout.js +17 -0
  695. package/src/tui/fleet-native-transcript.d.ts +53 -0
  696. package/src/tui/fleet-native-transcript.js +339 -0
  697. package/src/tui/fleet-status.d.ts +92 -0
  698. package/src/tui/fleet-status.js +1132 -0
  699. package/src/tui/fleet-transcript.d.ts +64 -0
  700. package/src/tui/fleet-transcript.js +544 -0
  701. package/src/tui/fleet-viewport.d.ts +12 -0
  702. package/src/tui/fleet-viewport.js +35 -0
  703. package/src/tui/fleet.d.ts +196 -0
  704. package/src/tui/fleet.js +1588 -0
  705. package/src/tui/mouse-events.d.ts +21 -0
  706. package/src/tui/mouse-events.js +26 -0
  707. package/src/tui/render-helpers.d.ts +23 -0
  708. package/src/tui/render-helpers.js +100 -0
  709. package/src/tui/render.d.ts +66 -0
  710. package/src/tui/render.js +3707 -0
  711. package/src/tui/running-tone.d.ts +10 -0
  712. package/src/tui/running-tone.js +22 -0
  713. package/src/tui/subagent-messages.d.ts +22 -0
  714. package/src/tui/subagent-messages.js +270 -0
  715. package/src/ui-silent-marker.d.ts +20 -0
  716. package/src/ui-silent-marker.js +25 -0
  717. package/src/watchdog/change-signature.d.ts +7 -0
  718. package/src/watchdog/change-signature.js +243 -0
  719. package/src/watchdog/child-status.d.ts +53 -0
  720. package/src/watchdog/child-status.js +187 -0
  721. package/src/watchdog/diff-tool.d.ts +25 -0
  722. package/src/watchdog/diff-tool.js +104 -0
  723. package/src/watchdog/emission-guard.d.ts +36 -0
  724. package/src/watchdog/emission-guard.js +97 -0
  725. package/src/watchdog/guidance.d.ts +3 -0
  726. package/src/watchdog/guidance.js +19 -0
  727. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  728. package/src/watchdog/lsp-diagnostics.js +489 -0
  729. package/src/watchdog/model-selection.d.ts +24 -0
  730. package/src/watchdog/model-selection.js +167 -0
  731. package/src/watchdog/permission-arbiter.d.ts +20 -0
  732. package/src/watchdog/permission-arbiter.js +135 -0
  733. package/src/watchdog/register-child.d.ts +13 -0
  734. package/src/watchdog/register-child.js +128 -0
  735. package/src/watchdog/register-main.d.ts +11 -0
  736. package/src/watchdog/register-main.js +400 -0
  737. package/src/watchdog/render.d.ts +3 -0
  738. package/src/watchdog/render.js +33 -0
  739. package/src/watchdog/review.d.ts +36 -0
  740. package/src/watchdog/review.js +319 -0
  741. package/src/watchdog/rules.d.ts +21 -0
  742. package/src/watchdog/rules.js +58 -0
  743. package/src/watchdog/runtime.d.ts +195 -0
  744. package/src/watchdog/runtime.js +864 -0
  745. package/src/watchdog/scope.d.ts +14 -0
  746. package/src/watchdog/scope.js +44 -0
  747. package/src/watchdog/settings.d.ts +29 -0
  748. package/src/watchdog/settings.js +480 -0
  749. package/src/watchdog/tool-actions.d.ts +17 -0
  750. package/src/watchdog/tool-actions.js +150 -0
  751. package/src/watchdog/turn-delta.d.ts +15 -0
  752. package/src/watchdog/turn-delta.js +188 -0
  753. package/src/watchdog/types.d.ts +141 -0
  754. package/src/watchdog/types.js +27 -0
  755. package/src/watchdog/warning-format.d.ts +7 -0
  756. package/src/watchdog/warning-format.js +59 -0
  757. package/src/workflows/chat-progress.d.ts +37 -0
  758. package/src/workflows/chat-progress.js +129 -0
  759. package/src/workflows/host-command.d.ts +30 -0
  760. package/src/workflows/host-command.js +227 -0
  761. package/src/workflows/scripted-workflow.d.ts +204 -0
  762. package/src/workflows/scripted-workflow.js +1673 -0
  763. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  764. package/src/workflows/structured-workflow-scripts.js +179 -0
  765. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  766. package/src/workflows/workflow-auto-resume.js +102 -0
  767. package/src/workflows/workflow-checklist.d.ts +127 -0
  768. package/src/workflows/workflow-checklist.js +314 -0
  769. package/src/workflows/workflow-child-summary.d.ts +24 -0
  770. package/src/workflows/workflow-child-summary.js +195 -0
  771. package/src/workflows/workflow-launch-record.d.ts +27 -0
  772. package/src/workflows/workflow-launch-record.js +48 -0
  773. package/src/workflows/workflow-preflight.d.ts +58 -0
  774. package/src/workflows/workflow-preflight.js +288 -0
  775. package/src/workflows/workflow-receipt.d.ts +34 -0
  776. package/src/workflows/workflow-receipt.js +454 -0
  777. package/src/workflows/workflow-resources.d.ts +55 -0
  778. package/src/workflows/workflow-resources.js +271 -0
  779. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  780. package/src/workflows/workflow-resume-claim.js +210 -0
  781. package/src/workflows/workflow-resume.d.ts +56 -0
  782. package/src/workflows/workflow-resume.js +106 -0
  783. package/src/workflows/workflow-reuse.d.ts +61 -0
  784. package/src/workflows/workflow-reuse.js +186 -0
  785. package/src/workflows/workflow-revival.d.ts +33 -0
  786. package/src/workflows/workflow-revival.js +111 -0
  787. package/src/workflows/workflow-settlement.d.ts +84 -0
  788. package/src/workflows/workflow-settlement.js +203 -0
  789. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  790. package/src/workflows/workflow-stop-cause.js +8 -0
  791. package/workflow-script-worker.cjs +1342 -0
  792. package/index.ts +0 -18
  793. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  794. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  795. package/skills/pi-subagents/references/execution-controls.md +0 -561
  796. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  797. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  798. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  799. package/src/agents/advertised-agent-prompt.ts +0 -82
  800. package/src/agents/agent-eject.ts +0 -339
  801. package/src/agents/agent-management.ts +0 -1442
  802. package/src/agents/agent-memory.ts +0 -341
  803. package/src/agents/agent-refinements.ts +0 -624
  804. package/src/agents/agent-scope.ts +0 -10
  805. package/src/agents/agent-selection.ts +0 -25
  806. package/src/agents/agent-serializer.ts +0 -195
  807. package/src/agents/agents.ts +0 -3169
  808. package/src/agents/builtin-names.ts +0 -16
  809. package/src/agents/chain-serializer.ts +0 -285
  810. package/src/agents/frontmatter.ts +0 -153
  811. package/src/agents/global-npm-root.ts +0 -58
  812. package/src/agents/identity.ts +0 -30
  813. package/src/agents/proactive-skills.ts +0 -197
  814. package/src/agents/runtime-agent-events.ts +0 -70
  815. package/src/agents/runtime-agent-registry.ts +0 -457
  816. package/src/agents/runtime-discovery.ts +0 -39
  817. package/src/agents/skills.ts +0 -787
  818. package/src/api/agent-management.ts +0 -9
  819. package/src/api/agents.ts +0 -19
  820. package/src/api/background-work.ts +0 -206
  821. package/src/api/capability-ceiling.ts +0 -16
  822. package/src/api/child-tool-plan.ts +0 -5
  823. package/src/api/control-channel.ts +0 -4
  824. package/src/api/delegation.ts +0 -131
  825. package/src/api/external-job-provider.ts +0 -195
  826. package/src/api/external-runs.ts +0 -282
  827. package/src/api/inspectors.ts +0 -27
  828. package/src/api/intercom-bridge.ts +0 -3
  829. package/src/api/preflight.ts +0 -641
  830. package/src/api/project-panes.ts +0 -32
  831. package/src/api/required-child-extensions.ts +0 -6
  832. package/src/api/shared-types.ts +0 -29
  833. package/src/api/workflow-resources.ts +0 -6
  834. package/src/extension/config.ts +0 -262
  835. package/src/extension/context-injection.ts +0 -123
  836. package/src/extension/control-notices.ts +0 -53
  837. package/src/extension/declaration-pinning.ts +0 -164
  838. package/src/extension/doctor.ts +0 -284
  839. package/src/extension/fanout-child.ts +0 -282
  840. package/src/extension/herdr-pi-bridge.ts +0 -166
  841. package/src/extension/index.ts +0 -1185
  842. package/src/extension/public-execution.ts +0 -262
  843. package/src/extension/reply-workflow-script.ts +0 -67
  844. package/src/extension/rpc.ts +0 -881
  845. package/src/extension/schemas.ts +0 -337
  846. package/src/extension/steering-notices.ts +0 -35
  847. package/src/extension/subagent-guide.ts +0 -127
  848. package/src/extension/subagent-options.ts +0 -47
  849. package/src/extension/tool-activation.ts +0 -147
  850. package/src/extension/tool-description.ts +0 -193
  851. package/src/extension/tool-result.ts +0 -19
  852. package/src/extension/upgrade-notice.ts +0 -40
  853. package/src/inspectors/actions.ts +0 -174
  854. package/src/inspectors/ghostty/actions.ts +0 -74
  855. package/src/inspectors/ghostty/plugin.ts +0 -29
  856. package/src/inspectors/herdr/actions.ts +0 -155
  857. package/src/inspectors/herdr/client.ts +0 -130
  858. package/src/inspectors/herdr/focus.ts +0 -55
  859. package/src/inspectors/herdr/plugin.ts +0 -20
  860. package/src/inspectors/herdr/project-panes.ts +0 -733
  861. package/src/inspectors/inspector-runner.ts +0 -153
  862. package/src/inspectors/plugins.ts +0 -76
  863. package/src/inspectors/session-roots-codec.ts +0 -31
  864. package/src/inspectors/shell-command.ts +0 -16
  865. package/src/inspectors/tmux/actions.ts +0 -204
  866. package/src/inspectors/tmux/client.ts +0 -85
  867. package/src/inspectors/tmux/plugin.ts +0 -21
  868. package/src/inspectors/types.ts +0 -51
  869. package/src/integrations/herdr-status.ts +0 -385
  870. package/src/integrations/pi-web-session-liveness.ts +0 -73
  871. package/src/integrations/program-status.ts +0 -215
  872. package/src/intercom/intercom-bridge.ts +0 -235
  873. package/src/intercom/native-supervisor-channel.ts +0 -1000
  874. package/src/intercom/result-intercom.ts +0 -433
  875. package/src/intercom/supervisor-ui.ts +0 -72
  876. package/src/missions/actions.ts +0 -433
  877. package/src/missions/goal-driver.ts +0 -177
  878. package/src/missions/lifecycle.ts +0 -367
  879. package/src/missions/store.ts +0 -613
  880. package/src/missions/types.ts +0 -190
  881. package/src/missions/workflow-state.ts +0 -281
  882. package/src/policy/authority.ts +0 -50
  883. package/src/profiles/profiles.ts +0 -674
  884. package/src/runs/background/active-async-capacity.ts +0 -548
  885. package/src/runs/background/active-run-index.ts +0 -155
  886. package/src/runs/background/async-execution.ts +0 -2479
  887. package/src/runs/background/async-job-tracker.ts +0 -869
  888. package/src/runs/background/async-resume.ts +0 -686
  889. package/src/runs/background/async-retention.ts +0 -953
  890. package/src/runs/background/async-status-snapshot.ts +0 -46
  891. package/src/runs/background/async-status.ts +0 -787
  892. package/src/runs/background/auto-drain.ts +0 -92
  893. package/src/runs/background/await-async-run.ts +0 -83
  894. package/src/runs/background/binary-bootstrap.ts +0 -67
  895. package/src/runs/background/calendar-schedule.ts +0 -90
  896. package/src/runs/background/chain-append.ts +0 -321
  897. package/src/runs/background/chain-root-attachment.ts +0 -263
  898. package/src/runs/background/completion-batcher.ts +0 -168
  899. package/src/runs/background/completion-dedupe.ts +0 -58
  900. package/src/runs/background/completion-replay.ts +0 -287
  901. package/src/runs/background/control-channel.ts +0 -659
  902. package/src/runs/background/fleet-view.ts +0 -692
  903. package/src/runs/background/index-segment.ts +0 -59
  904. package/src/runs/background/inspect-rpc.ts +0 -443
  905. package/src/runs/background/notify.ts +0 -1083
  906. package/src/runs/background/owned-process-tree.ts +0 -131
  907. package/src/runs/background/parallel-groups.ts +0 -45
  908. package/src/runs/background/pid-namespace.ts +0 -18
  909. package/src/runs/background/process-terminal-candidate.ts +0 -98
  910. package/src/runs/background/process-terminal.ts +0 -231
  911. package/src/runs/background/result-delivery-ownership.ts +0 -45
  912. package/src/runs/background/result-files.ts +0 -634
  913. package/src/runs/background/result-watcher.ts +0 -842
  914. package/src/runs/background/resume-guidance.ts +0 -56
  915. package/src/runs/background/retained-children.ts +0 -136
  916. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  917. package/src/runs/background/run-child-session.ts +0 -725
  918. package/src/runs/background/run-id-query.ts +0 -7
  919. package/src/runs/background/run-id-resolver.ts +0 -183
  920. package/src/runs/background/run-status.ts +0 -803
  921. package/src/runs/background/runner-aliases.ts +0 -183
  922. package/src/runs/background/runner-child-launch.ts +0 -96
  923. package/src/runs/background/runner-child-sessions.ts +0 -32
  924. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  925. package/src/runs/background/runner-startup-failure.ts +0 -56
  926. package/src/runs/background/scheduled-runs.ts +0 -1222
  927. package/src/runs/background/stale-run-reconciler.ts +0 -463
  928. package/src/runs/background/steering.ts +0 -260
  929. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  930. package/src/runs/background/subagent-runner.ts +0 -5251
  931. package/src/runs/background/subagent-wait.ts +0 -895
  932. package/src/runs/background/terminal-run-index.ts +0 -183
  933. package/src/runs/background/top-level-async.ts +0 -14
  934. package/src/runs/background/wait-completions.ts +0 -262
  935. package/src/runs/background/wait-config.ts +0 -50
  936. package/src/runs/background/wait-subscriptions.ts +0 -354
  937. package/src/runs/background/wait-tool.ts +0 -57
  938. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  939. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  940. package/src/runs/foreground/async-steering-action.ts +0 -276
  941. package/src/runs/foreground/async-stop-action.ts +0 -216
  942. package/src/runs/foreground/command-action.ts +0 -41
  943. package/src/runs/foreground/execution.ts +0 -2315
  944. package/src/runs/foreground/foreground-control.ts +0 -157
  945. package/src/runs/foreground/foreground-history.ts +0 -164
  946. package/src/runs/foreground/prompt-audit.ts +0 -172
  947. package/src/runs/foreground/subagent-executor.ts +0 -8227
  948. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  949. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  950. package/src/runs/shared/abort-recovery.ts +0 -119
  951. package/src/runs/shared/acceptance.ts +0 -1664
  952. package/src/runs/shared/agent-contract.ts +0 -38
  953. package/src/runs/shared/async-status-projection.ts +0 -664
  954. package/src/runs/shared/background-process-options.ts +0 -9
  955. package/src/runs/shared/capability-ceiling.ts +0 -214
  956. package/src/runs/shared/chain-outputs.ts +0 -116
  957. package/src/runs/shared/child-commands.ts +0 -229
  958. package/src/runs/shared/child-hooks.ts +0 -175
  959. package/src/runs/shared/child-identity.ts +0 -62
  960. package/src/runs/shared/child-launch-plan.ts +0 -163
  961. package/src/runs/shared/child-launch.ts +0 -389
  962. package/src/runs/shared/child-lifecycle.ts +0 -28
  963. package/src/runs/shared/child-runtime-config.ts +0 -136
  964. package/src/runs/shared/child-session.ts +0 -699
  965. package/src/runs/shared/child-tool-plan.ts +0 -599
  966. package/src/runs/shared/claude-code-adapter.ts +0 -288
  967. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  968. package/src/runs/shared/context-mode.ts +0 -44
  969. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  970. package/src/runs/shared/dynamic-fanout.ts +0 -297
  971. package/src/runs/shared/effective-system-prompt.ts +0 -33
  972. package/src/runs/shared/extension-bindings.ts +0 -103
  973. package/src/runs/shared/external-cli-contract.ts +0 -177
  974. package/src/runs/shared/external-cli-preflight.ts +0 -190
  975. package/src/runs/shared/external-cli-runner.ts +0 -437
  976. package/src/runs/shared/external-job-bridge.ts +0 -514
  977. package/src/runs/shared/external-job-runner.ts +0 -389
  978. package/src/runs/shared/fast-mode-extension.ts +0 -10
  979. package/src/runs/shared/fork-command-result.ts +0 -10
  980. package/src/runs/shared/git-environment.ts +0 -29
  981. package/src/runs/shared/herdr-connection.ts +0 -134
  982. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  983. package/src/runs/shared/herdr-machine.ts +0 -279
  984. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  985. package/src/runs/shared/herdr-placed-run.ts +0 -264
  986. package/src/runs/shared/host-step-status.ts +0 -231
  987. package/src/runs/shared/lane-metadata.ts +0 -126
  988. package/src/runs/shared/launch-cwd.ts +0 -16
  989. package/src/runs/shared/long-running-guard.ts +0 -221
  990. package/src/runs/shared/mcp-config-sources.ts +0 -426
  991. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  992. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  993. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  994. package/src/runs/shared/model-resolution.ts +0 -503
  995. package/src/runs/shared/model-scope.ts +0 -224
  996. package/src/runs/shared/mutation-evidence.ts +0 -199
  997. package/src/runs/shared/nested-events.ts +0 -1125
  998. package/src/runs/shared/nested-path.ts +0 -38
  999. package/src/runs/shared/nested-render.ts +0 -127
  1000. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1001. package/src/runs/shared/parallel-handoff.ts +0 -789
  1002. package/src/runs/shared/parallel-utils.ts +0 -292
  1003. package/src/runs/shared/partial-output.ts +0 -48
  1004. package/src/runs/shared/permissions.ts +0 -86
  1005. package/src/runs/shared/pi-spawn.ts +0 -205
  1006. package/src/runs/shared/process-signal.ts +0 -35
  1007. package/src/runs/shared/profile-extensions.ts +0 -134
  1008. package/src/runs/shared/profile-launch-env.ts +0 -121
  1009. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1010. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1011. package/src/runs/shared/run-history.ts +0 -288
  1012. package/src/runs/shared/runner-launcher.ts +0 -25
  1013. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1014. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1015. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1016. package/src/runs/shared/session-lease.ts +0 -293
  1017. package/src/runs/shared/single-output.ts +0 -366
  1018. package/src/runs/shared/spawn-budget.ts +0 -128
  1019. package/src/runs/shared/structured-output.ts +0 -463
  1020. package/src/runs/shared/subagent-control.ts +0 -295
  1021. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1022. package/src/runs/shared/tool-availability.ts +0 -37
  1023. package/src/runs/shared/tool-budget.ts +0 -87
  1024. package/src/runs/shared/tool-timeout.ts +0 -93
  1025. package/src/runs/shared/usage-budget.ts +0 -65
  1026. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1027. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1028. package/src/runs/shared/workflow-graph.ts +0 -225
  1029. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1030. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1031. package/src/runs/shared/worktree-lock.ts +0 -29
  1032. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1033. package/src/runs/shared/worktree.ts +0 -1554
  1034. package/src/shared/accessible-dir.ts +0 -47
  1035. package/src/shared/agent-stream-options.ts +0 -5
  1036. package/src/shared/artifacts.ts +0 -281
  1037. package/src/shared/atomic-json.ts +0 -85
  1038. package/src/shared/capacity-resilient-json.ts +0 -102
  1039. package/src/shared/child-cache-retention.ts +0 -43
  1040. package/src/shared/child-session-name.ts +0 -48
  1041. package/src/shared/child-transcript.ts +0 -264
  1042. package/src/shared/completion-owner.ts +0 -14
  1043. package/src/shared/disabled-features.ts +0 -123
  1044. package/src/shared/display-text.ts +0 -150
  1045. package/src/shared/edit-distance.ts +0 -33
  1046. package/src/shared/extension-context.ts +0 -37
  1047. package/src/shared/file-coalescer.ts +0 -49
  1048. package/src/shared/file-lease.ts +0 -74
  1049. package/src/shared/file-system-retry.ts +0 -95
  1050. package/src/shared/fork-context.ts +0 -243
  1051. package/src/shared/fork-session-cwd.ts +0 -27
  1052. package/src/shared/formatters.ts +0 -142
  1053. package/src/shared/jsonl-writer.ts +0 -92
  1054. package/src/shared/launch-contract.ts +0 -206
  1055. package/src/shared/model-info.ts +0 -132
  1056. package/src/shared/model-response-aliases.ts +0 -13
  1057. package/src/shared/node-executable.ts +0 -21
  1058. package/src/shared/opencode-session-headers.ts +0 -30
  1059. package/src/shared/package-version.ts +0 -17
  1060. package/src/shared/parent-wake.ts +0 -79
  1061. package/src/shared/permission-profile.ts +0 -56
  1062. package/src/shared/prompt-resources.ts +0 -11
  1063. package/src/shared/pruned-fork.ts +0 -469
  1064. package/src/shared/required-child-extensions.ts +0 -115
  1065. package/src/shared/runtime-module-path.ts +0 -19
  1066. package/src/shared/sandbox-profile.ts +0 -37
  1067. package/src/shared/session-file-trust.ts +0 -19
  1068. package/src/shared/session-identity.ts +0 -10
  1069. package/src/shared/session-tokens.ts +0 -55
  1070. package/src/shared/settings-file-lease.ts +0 -36
  1071. package/src/shared/settings.ts +0 -412
  1072. package/src/shared/shortcuts.ts +0 -13
  1073. package/src/shared/status-format.ts +0 -55
  1074. package/src/shared/thinking-ceiling.ts +0 -46
  1075. package/src/shared/types.ts +0 -3105
  1076. package/src/shared/utf8.ts +0 -11
  1077. package/src/shared/utils.ts +0 -610
  1078. package/src/shared/watch-strategy.ts +0 -12
  1079. package/src/shared/workflow-child-permit.ts +0 -212
  1080. package/src/slash/delegation-adapters.ts +0 -452
  1081. package/src/slash/delegation-json.ts +0 -108
  1082. package/src/slash/delegation-request.ts +0 -176
  1083. package/src/slash/prompt-template-bridge.ts +0 -434
  1084. package/src/slash/prompt-workflows.ts +0 -298
  1085. package/src/slash/selector.ts +0 -147
  1086. package/src/slash/slash-bridge.ts +0 -192
  1087. package/src/slash/slash-commands.ts +0 -1096
  1088. package/src/slash/slash-live-state.ts +0 -310
  1089. package/src/slash/subagent-cost.ts +0 -317
  1090. package/src/slash/subagents-admin.ts +0 -489
  1091. package/src/tui/fleet-native-transcript.ts +0 -424
  1092. package/src/tui/fleet-status.ts +0 -1139
  1093. package/src/tui/fleet-transcript.ts +0 -591
  1094. package/src/tui/fleet.ts +0 -1618
  1095. package/src/tui/mouse-events.ts +0 -42
  1096. package/src/tui/render-helpers.ts +0 -111
  1097. package/src/tui/render.ts +0 -3824
  1098. package/src/tui/running-tone.ts +0 -28
  1099. package/src/tui/subagent-messages.ts +0 -305
  1100. package/src/ui-silent-marker.ts +0 -32
  1101. package/src/watchdog/change-signature.ts +0 -260
  1102. package/src/watchdog/child-status.ts +0 -225
  1103. package/src/watchdog/diff-tool.ts +0 -112
  1104. package/src/watchdog/emission-guard.ts +0 -125
  1105. package/src/watchdog/guidance.ts +0 -20
  1106. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1107. package/src/watchdog/model-selection.ts +0 -187
  1108. package/src/watchdog/permission-arbiter.ts +0 -154
  1109. package/src/watchdog/register-child.ts +0 -136
  1110. package/src/watchdog/register-main.ts +0 -425
  1111. package/src/watchdog/render.ts +0 -31
  1112. package/src/watchdog/review.ts +0 -362
  1113. package/src/watchdog/rules.ts +0 -70
  1114. package/src/watchdog/runtime.ts +0 -927
  1115. package/src/watchdog/scope.ts +0 -51
  1116. package/src/watchdog/settings.ts +0 -520
  1117. package/src/watchdog/tool-actions.ts +0 -156
  1118. package/src/watchdog/turn-delta.ts +0 -190
  1119. package/src/watchdog/types.ts +0 -186
  1120. package/src/watchdog/warning-format.ts +0 -72
  1121. package/src/workflows/chat-progress.ts +0 -152
  1122. package/src/workflows/host-command.ts +0 -235
  1123. package/src/workflows/scripted-workflow.ts +0 -2733
  1124. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1125. package/src/workflows/workflow-checklist.ts +0 -442
  1126. package/src/workflows/workflow-child-summary.ts +0 -172
  1127. package/src/workflows/workflow-preflight.ts +0 -297
  1128. package/src/workflows/workflow-receipt.ts +0 -390
  1129. package/src/workflows/workflow-resources.ts +0 -275
  1130. package/src/workflows/workflow-reuse.ts +0 -120
  1131. package/src/workflows/workflow-revival.ts +0 -123
  1132. package/src/workflows/workflow-settlement.ts +0 -252
@@ -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
+ }