@xzzpig/pi-subagents 0.22.0 → 0.24.0

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