@xzzpig/pi-subagents 0.21.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1132) hide show
  1. package/CHANGELOG.md +356 -0
  2. package/README.md +2 -2
  3. package/agents/evidence-auditor.md +1 -0
  4. package/agents/oracle.md +1 -0
  5. package/agents/reviewer.md +1 -0
  6. package/bundle/agent-management.js +16 -0
  7. package/bundle/agents.js +41 -0
  8. package/bundle/background-work.js +16 -0
  9. package/bundle/capability-ceiling.js +22 -0
  10. package/bundle/child-tool-plan.js +11 -0
  11. package/bundle/chunk-355ECEP2.js +1321 -0
  12. package/bundle/chunk-35GII5EF.js +637 -0
  13. package/bundle/chunk-3G4JXNZ4.js +4130 -0
  14. package/bundle/chunk-3U633XDZ.js +749 -0
  15. package/bundle/chunk-4QFZZV3O.js +57 -0
  16. package/bundle/chunk-62OCY2S4.js +14 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-7K3Z6DM7.js +276 -0
  19. package/bundle/chunk-BGIYHF2W.js +138 -0
  20. package/bundle/chunk-CTPAE36Y.js +94 -0
  21. package/bundle/chunk-D4EHT5SJ.js +14 -0
  22. package/bundle/chunk-ED55MIC2.js +1681 -0
  23. package/bundle/chunk-F3NSN7UH.js +7331 -0
  24. package/bundle/chunk-FJWI64H7.js +490 -0
  25. package/bundle/chunk-H36HBZB2.js +753 -0
  26. package/bundle/chunk-ICNYIALB.js +7347 -0
  27. package/bundle/chunk-KD2IMFN4.js +1310 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LPVUHUZ7.js +5503 -0
  30. package/bundle/chunk-MYCL5QEJ.js +1372 -0
  31. package/bundle/chunk-NCWCVJLT.js +1768 -0
  32. package/bundle/chunk-NIXWDZZV.js +9 -0
  33. package/bundle/chunk-NTRJDXBC.js +4175 -0
  34. package/bundle/chunk-OFGSZBHP.js +16924 -0
  35. package/bundle/chunk-OTLRAB22.js +143 -0
  36. package/bundle/chunk-QXASAHIA.js +173 -0
  37. package/bundle/chunk-RB4GELQA.js +458 -0
  38. package/bundle/chunk-RK2HDPLK.js +1234 -0
  39. package/bundle/chunk-SW2VMNIU.js +526 -0
  40. package/bundle/chunk-T65XRVVM.js +940 -0
  41. package/bundle/chunk-U4ODUYAG.js +235 -0
  42. package/bundle/chunk-UFNSLL5D.js +9796 -0
  43. package/bundle/chunk-UKG4V45O.js +228 -0
  44. package/bundle/chunk-UQDHXMUG.js +264 -0
  45. package/bundle/chunk-V2KFIGFH.js +8774 -0
  46. package/bundle/chunk-VO3G7HI3.js +85 -0
  47. package/bundle/chunk-WPW4V6HM.js +227 -0
  48. package/bundle/chunk-WW76JRIX.js +175 -0
  49. package/bundle/chunk-XA3DY6UG.js +161 -0
  50. package/bundle/chunk-YFCK7H2S.js +129 -0
  51. package/bundle/chunk-YYREO77V.js +137 -0
  52. package/bundle/chunk-Z6TFJ6BR.js +400 -0
  53. package/bundle/control-channel.js +11 -0
  54. package/bundle/delegation.js +14 -0
  55. package/bundle/external-job-provider.js +20 -0
  56. package/bundle/external-runs.js +21 -0
  57. package/bundle/index.js +30 -0
  58. package/bundle/inspectors.js +8 -0
  59. package/bundle/intercom-bridge.js +11 -0
  60. package/bundle/preflight.js +468 -0
  61. package/bundle/project-panes.js +28 -0
  62. package/bundle/required-child-extensions.js +6 -0
  63. package/bundle/shared-types.js +8 -0
  64. package/bundle/supervisor-routing.js +12 -0
  65. package/bundle/workflow-resources.js +7 -0
  66. package/docs/agents.md +42 -10
  67. package/docs/configuration.md +59 -14
  68. package/docs/extension-api.md +61 -9
  69. package/docs/fork-supervisor-routing.md +77 -0
  70. package/docs/missions.md +2 -0
  71. package/docs/observability.md +20 -5
  72. package/docs/standalone-background.md +8 -6
  73. package/docs/tool-reference.md +18 -5
  74. package/docs/workflows.md +25 -7
  75. package/index.d.ts +3 -0
  76. package/index.js +14 -0
  77. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  78. package/package.json +107 -86
  79. package/skills/council-mode/SKILL.md +1 -4
  80. package/skills/pi-subagents/SKILL.md +130 -106
  81. package/skills/pi-subagents/references/orchestration.md +124 -0
  82. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  83. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  84. package/src/agents/advertised-agent-prompt.js +68 -0
  85. package/src/agents/agent-eject.d.ts +39 -0
  86. package/src/agents/agent-eject.js +263 -0
  87. package/src/agents/agent-management.d.ts +33 -0
  88. package/src/agents/agent-management.js +1541 -0
  89. package/src/agents/agent-memory.d.ts +48 -0
  90. package/src/agents/agent-memory.js +350 -0
  91. package/src/agents/agent-refinements.d.ts +99 -0
  92. package/src/agents/agent-refinements.js +568 -0
  93. package/src/agents/agent-scope.d.ts +3 -0
  94. package/src/agents/agent-scope.js +8 -0
  95. package/src/agents/agent-selection.d.ts +2 -0
  96. package/src/agents/agent-selection.js +22 -0
  97. package/src/agents/agent-serializer.d.ts +7 -0
  98. package/src/agents/agent-serializer.js +213 -0
  99. package/src/agents/agents.d.ts +352 -0
  100. package/src/agents/agents.js +2817 -0
  101. package/src/agents/builtin-names.d.ts +1 -0
  102. package/src/agents/builtin-names.js +16 -0
  103. package/src/agents/chain-serializer.d.ts +6 -0
  104. package/src/agents/chain-serializer.js +318 -0
  105. package/src/agents/frontmatter.d.ts +19 -0
  106. package/src/agents/frontmatter.js +166 -0
  107. package/src/agents/global-npm-root.d.ts +6 -0
  108. package/src/agents/global-npm-root.js +57 -0
  109. package/src/agents/identity.d.ts +7 -0
  110. package/src/agents/identity.js +29 -0
  111. package/src/agents/proactive-skills.d.ts +35 -0
  112. package/src/agents/proactive-skills.js +155 -0
  113. package/src/agents/runtime-agent-events.d.ts +26 -0
  114. package/src/agents/runtime-agent-events.js +52 -0
  115. package/src/agents/runtime-agent-registry.d.ts +66 -0
  116. package/src/agents/runtime-agent-registry.js +415 -0
  117. package/src/agents/runtime-discovery.d.ts +13 -0
  118. package/src/agents/runtime-discovery.js +27 -0
  119. package/src/agents/skills.d.ts +34 -0
  120. package/src/agents/skills.js +718 -0
  121. package/src/api/agent-management.d.ts +2 -0
  122. package/src/api/agent-management.js +2 -0
  123. package/src/api/agents.d.ts +6 -0
  124. package/src/api/agents.js +3 -0
  125. package/src/api/background-work.d.ts +41 -0
  126. package/src/api/background-work.js +171 -0
  127. package/src/api/capability-ceiling.d.ts +1 -0
  128. package/src/api/capability-ceiling.js +1 -0
  129. package/src/api/child-tool-plan.d.ts +1 -0
  130. package/src/api/child-tool-plan.js +1 -0
  131. package/src/api/control-channel.d.ts +1 -0
  132. package/src/api/control-channel.js +1 -0
  133. package/src/api/delegation.d.ts +132 -0
  134. package/src/api/delegation.js +8 -0
  135. package/src/api/external-job-provider.d.ts +57 -0
  136. package/src/api/external-job-provider.js +139 -0
  137. package/src/api/external-runs.d.ts +47 -0
  138. package/src/api/external-runs.js +245 -0
  139. package/src/api/inspectors.d.ts +20 -0
  140. package/src/api/inspectors.js +11 -0
  141. package/src/api/intercom-bridge.d.ts +1 -0
  142. package/src/api/intercom-bridge.js +1 -0
  143. package/src/api/preflight.d.ts +183 -0
  144. package/src/api/preflight.js +455 -0
  145. package/src/api/project-panes.d.ts +7 -0
  146. package/src/api/project-panes.js +7 -0
  147. package/src/api/required-child-extensions.d.ts +1 -0
  148. package/src/api/required-child-extensions.js +1 -0
  149. package/src/api/shared-types.d.ts +1 -0
  150. package/src/api/shared-types.js +1 -0
  151. package/src/api/supervisor-routing.d.ts +110 -0
  152. package/src/api/supervisor-routing.js +95 -0
  153. package/src/api/workflow-resources.d.ts +2 -0
  154. package/src/api/workflow-resources.js +1 -0
  155. package/src/extension/active-runs-prompt.d.ts +7 -0
  156. package/src/extension/active-runs-prompt.js +29 -0
  157. package/src/extension/config.d.ts +7 -0
  158. package/src/extension/config.js +290 -0
  159. package/src/extension/context-injection.d.ts +52 -0
  160. package/src/extension/context-injection.js +102 -0
  161. package/src/extension/control-notices.d.ts +18 -0
  162. package/src/extension/control-notices.js +29 -0
  163. package/src/extension/declaration-pinning.d.ts +18 -0
  164. package/src/extension/declaration-pinning.js +167 -0
  165. package/src/extension/doctor.d.ts +34 -0
  166. package/src/extension/doctor.js +236 -0
  167. package/src/extension/fanout-child.d.ts +6 -0
  168. package/src/extension/fanout-child.js +278 -0
  169. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  170. package/src/extension/herdr-pi-bridge.js +261 -0
  171. package/src/extension/index.d.ts +18 -0
  172. package/src/extension/index.js +1288 -0
  173. package/src/extension/public-execution.d.ts +71 -0
  174. package/src/extension/public-execution.js +214 -0
  175. package/src/extension/reply-workflow-script.d.ts +11 -0
  176. package/src/extension/reply-workflow-script.js +71 -0
  177. package/src/extension/rpc.d.ts +84 -0
  178. package/src/extension/rpc.js +729 -0
  179. package/src/extension/schemas.d.ts +276 -0
  180. package/src/extension/schemas.js +311 -0
  181. package/src/extension/steering-notices.d.ts +14 -0
  182. package/src/extension/steering-notices.js +22 -0
  183. package/src/extension/subagent-guide.d.ts +4 -0
  184. package/src/extension/subagent-guide.js +114 -0
  185. package/src/extension/subagent-options.d.ts +7 -0
  186. package/src/extension/subagent-options.js +64 -0
  187. package/src/extension/tool-activation.d.ts +7 -0
  188. package/src/extension/tool-activation.js +185 -0
  189. package/src/extension/tool-description.d.ts +19 -0
  190. package/src/extension/tool-description.js +169 -0
  191. package/src/extension/tool-result.d.ts +9 -0
  192. package/src/extension/tool-result.js +16 -0
  193. package/src/extension/upgrade-notice.d.ts +6 -0
  194. package/src/extension/upgrade-notice.js +42 -0
  195. package/src/inspectors/actions.d.ts +24 -0
  196. package/src/inspectors/actions.js +182 -0
  197. package/src/inspectors/ghostty/actions.d.ts +11 -0
  198. package/src/inspectors/ghostty/actions.js +62 -0
  199. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  200. package/src/inspectors/ghostty/plugin.js +23 -0
  201. package/src/inspectors/herdr/actions.d.ts +25 -0
  202. package/src/inspectors/herdr/actions.js +133 -0
  203. package/src/inspectors/herdr/client.d.ts +41 -0
  204. package/src/inspectors/herdr/client.js +129 -0
  205. package/src/inspectors/herdr/focus.d.ts +24 -0
  206. package/src/inspectors/herdr/focus.js +49 -0
  207. package/src/inspectors/herdr/plugin.d.ts +6 -0
  208. package/src/inspectors/herdr/plugin.js +14 -0
  209. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  210. package/src/inspectors/herdr/project-panes.js +610 -0
  211. package/src/inspectors/inspector-runner.d.ts +23 -0
  212. package/src/inspectors/inspector-runner.js +161 -0
  213. package/src/inspectors/plugins.d.ts +8 -0
  214. package/src/inspectors/plugins.js +82 -0
  215. package/src/inspectors/session-roots-codec.d.ts +15 -0
  216. package/src/inspectors/session-roots-codec.js +32 -0
  217. package/src/inspectors/shell-command.d.ts +1 -0
  218. package/src/inspectors/shell-command.js +16 -0
  219. package/src/inspectors/tmux/actions.d.ts +25 -0
  220. package/src/inspectors/tmux/actions.js +181 -0
  221. package/src/inspectors/tmux/client.d.ts +27 -0
  222. package/src/inspectors/tmux/client.js +64 -0
  223. package/src/inspectors/tmux/plugin.d.ts +7 -0
  224. package/src/inspectors/tmux/plugin.js +14 -0
  225. package/src/inspectors/types.d.ts +48 -0
  226. package/src/inspectors/types.js +1 -0
  227. package/src/integrations/herdr-status.d.ts +47 -0
  228. package/src/integrations/herdr-status.js +350 -0
  229. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  230. package/src/integrations/pi-web-session-liveness.js +53 -0
  231. package/src/integrations/program-status.d.ts +30 -0
  232. package/src/integrations/program-status.js +188 -0
  233. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  234. package/src/intercom/fork-supervisor-routing.js +392 -0
  235. package/src/intercom/intercom-bridge.d.ts +58 -0
  236. package/src/intercom/intercom-bridge.js +193 -0
  237. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  238. package/src/intercom/native-supervisor-channel.js +1184 -0
  239. package/src/intercom/result-intercom.d.ts +35 -0
  240. package/src/intercom/result-intercom.js +376 -0
  241. package/src/intercom/supervisor-ui.d.ts +29 -0
  242. package/src/intercom/supervisor-ui.js +49 -0
  243. package/src/missions/actions.d.ts +54 -0
  244. package/src/missions/actions.js +400 -0
  245. package/src/missions/goal-driver.d.ts +16 -0
  246. package/src/missions/goal-driver.js +171 -0
  247. package/src/missions/lifecycle.d.ts +50 -0
  248. package/src/missions/lifecycle.js +388 -0
  249. package/src/missions/store.d.ts +21 -0
  250. package/src/missions/store.js +605 -0
  251. package/src/missions/types.d.ts +169 -0
  252. package/src/missions/types.js +9 -0
  253. package/src/missions/workflow-state.d.ts +14 -0
  254. package/src/missions/workflow-state.js +273 -0
  255. package/src/policy/authority.d.ts +9 -0
  256. package/src/policy/authority.js +41 -0
  257. package/src/profiles/profiles.d.ts +134 -0
  258. package/src/profiles/profiles.js +526 -0
  259. package/src/runs/background/active-async-capacity.d.ts +115 -0
  260. package/src/runs/background/active-async-capacity.js +517 -0
  261. package/src/runs/background/active-run-index.d.ts +12 -0
  262. package/src/runs/background/active-run-index.js +157 -0
  263. package/src/runs/background/async-execution.d.ts +304 -0
  264. package/src/runs/background/async-execution.js +2206 -0
  265. package/src/runs/background/async-job-tracker.d.ts +37 -0
  266. package/src/runs/background/async-job-tracker.js +921 -0
  267. package/src/runs/background/async-resume.d.ts +60 -0
  268. package/src/runs/background/async-resume.js +707 -0
  269. package/src/runs/background/async-retention.d.ts +45 -0
  270. package/src/runs/background/async-retention.js +932 -0
  271. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  272. package/src/runs/background/async-status-snapshot.js +26 -0
  273. package/src/runs/background/async-status.d.ts +177 -0
  274. package/src/runs/background/async-status.js +710 -0
  275. package/src/runs/background/auto-drain.d.ts +16 -0
  276. package/src/runs/background/auto-drain.js +71 -0
  277. package/src/runs/background/await-async-run.d.ts +26 -0
  278. package/src/runs/background/await-async-run.js +83 -0
  279. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  280. package/src/runs/background/binary-bootstrap.js +69 -0
  281. package/src/runs/background/boot-id.d.ts +12 -0
  282. package/src/runs/background/boot-id.js +47 -0
  283. package/src/runs/background/calendar-schedule.d.ts +26 -0
  284. package/src/runs/background/calendar-schedule.js +93 -0
  285. package/src/runs/background/chain-append.d.ts +34 -0
  286. package/src/runs/background/chain-append.js +299 -0
  287. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  288. package/src/runs/background/chain-root-attachment.js +186 -0
  289. package/src/runs/background/completion-batcher.d.ts +51 -0
  290. package/src/runs/background/completion-batcher.js +119 -0
  291. package/src/runs/background/completion-dedupe.d.ts +13 -0
  292. package/src/runs/background/completion-dedupe.js +48 -0
  293. package/src/runs/background/completion-replay.d.ts +47 -0
  294. package/src/runs/background/completion-replay.js +266 -0
  295. package/src/runs/background/control-channel.d.ts +170 -0
  296. package/src/runs/background/control-channel.js +610 -0
  297. package/src/runs/background/fleet-view.d.ts +63 -0
  298. package/src/runs/background/fleet-view.js +666 -0
  299. package/src/runs/background/index-segment.d.ts +16 -0
  300. package/src/runs/background/index-segment.js +58 -0
  301. package/src/runs/background/inspect-rpc.d.ts +64 -0
  302. package/src/runs/background/inspect-rpc.js +422 -0
  303. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  304. package/src/runs/background/interrupted-elsewhere.js +68 -0
  305. package/src/runs/background/notify.d.ts +214 -0
  306. package/src/runs/background/notify.js +1001 -0
  307. package/src/runs/background/owned-process-tree.d.ts +10 -0
  308. package/src/runs/background/owned-process-tree.js +116 -0
  309. package/src/runs/background/parallel-groups.d.ts +3 -0
  310. package/src/runs/background/parallel-groups.js +46 -0
  311. package/src/runs/background/pid-namespace.d.ts +2 -0
  312. package/src/runs/background/pid-namespace.js +19 -0
  313. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  314. package/src/runs/background/process-terminal-candidate.js +96 -0
  315. package/src/runs/background/process-terminal.d.ts +21 -0
  316. package/src/runs/background/process-terminal.js +227 -0
  317. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  318. package/src/runs/background/result-delivery-ownership.js +38 -0
  319. package/src/runs/background/result-files.d.ts +63 -0
  320. package/src/runs/background/result-files.js +629 -0
  321. package/src/runs/background/result-watcher.d.ts +92 -0
  322. package/src/runs/background/result-watcher.js +819 -0
  323. package/src/runs/background/resume-guidance.d.ts +4 -0
  324. package/src/runs/background/resume-guidance.js +57 -0
  325. package/src/runs/background/retained-children.d.ts +24 -0
  326. package/src/runs/background/retained-children.js +128 -0
  327. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  328. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  329. package/src/runs/background/run-child-session.d.ts +123 -0
  330. package/src/runs/background/run-child-session.js +670 -0
  331. package/src/runs/background/run-id-query.d.ts +3 -0
  332. package/src/runs/background/run-id-query.js +6 -0
  333. package/src/runs/background/run-id-resolver.d.ts +22 -0
  334. package/src/runs/background/run-id-resolver.js +172 -0
  335. package/src/runs/background/run-status.d.ts +25 -0
  336. package/src/runs/background/run-status.js +850 -0
  337. package/src/runs/background/runner-aliases.d.ts +17 -0
  338. package/src/runs/background/runner-aliases.js +191 -0
  339. package/src/runs/background/runner-child-launch.d.ts +24 -0
  340. package/src/runs/background/runner-child-launch.js +72 -0
  341. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  342. package/src/runs/background/runner-child-sessions.js +34 -0
  343. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  344. package/src/runs/background/runner-http-dispatcher.js +115 -0
  345. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  346. package/src/runs/background/runner-startup-failure.js +46 -0
  347. package/src/runs/background/scheduled-runs.d.ts +127 -0
  348. package/src/runs/background/scheduled-runs.js +1265 -0
  349. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  350. package/src/runs/background/stale-run-reconciler.js +509 -0
  351. package/src/runs/background/steering.d.ts +51 -0
  352. package/src/runs/background/steering.js +246 -0
  353. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  354. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  355. package/src/runs/background/subagent-runner.d.ts +210 -0
  356. package/src/runs/background/subagent-runner.js +4963 -0
  357. package/src/runs/background/subagent-wait.d.ts +124 -0
  358. package/src/runs/background/subagent-wait.js +756 -0
  359. package/src/runs/background/terminal-run-index.d.ts +10 -0
  360. package/src/runs/background/terminal-run-index.js +209 -0
  361. package/src/runs/background/top-level-async.d.ts +7 -0
  362. package/src/runs/background/top-level-async.js +5 -0
  363. package/src/runs/background/wait-completions.d.ts +28 -0
  364. package/src/runs/background/wait-completions.js +264 -0
  365. package/src/runs/background/wait-config.d.ts +8 -0
  366. package/src/runs/background/wait-config.js +46 -0
  367. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  368. package/src/runs/background/wait-subscriptions.js +339 -0
  369. package/src/runs/background/wait-tool.d.ts +6 -0
  370. package/src/runs/background/wait-tool.js +48 -0
  371. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  372. package/src/runs/background/workflow-terminal-proof.js +116 -0
  373. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  374. package/src/runs/foreground/async-dismiss-action.js +82 -0
  375. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  376. package/src/runs/foreground/async-steering-action.js +294 -0
  377. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  378. package/src/runs/foreground/async-stop-action.js +213 -0
  379. package/src/runs/foreground/command-action.d.ts +12 -0
  380. package/src/runs/foreground/command-action.js +38 -0
  381. package/src/runs/foreground/execution.d.ts +10 -0
  382. package/src/runs/foreground/execution.js +2322 -0
  383. package/src/runs/foreground/foreground-control.d.ts +24 -0
  384. package/src/runs/foreground/foreground-control.js +138 -0
  385. package/src/runs/foreground/foreground-history.d.ts +25 -0
  386. package/src/runs/foreground/foreground-history.js +267 -0
  387. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  388. package/src/runs/foreground/prompt-audit.js +138 -0
  389. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  390. package/src/runs/foreground/subagent-executor.js +7986 -0
  391. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  392. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  393. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  394. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  395. package/src/runs/shared/abort-recovery.d.ts +26 -0
  396. package/src/runs/shared/abort-recovery.js +108 -0
  397. package/src/runs/shared/acceptance.d.ts +144 -0
  398. package/src/runs/shared/acceptance.js +1616 -0
  399. package/src/runs/shared/agent-contract.d.ts +5 -0
  400. package/src/runs/shared/agent-contract.js +35 -0
  401. package/src/runs/shared/async-status-projection.d.ts +100 -0
  402. package/src/runs/shared/async-status-projection.js +566 -0
  403. package/src/runs/shared/background-process-options.d.ts +4 -0
  404. package/src/runs/shared/background-process-options.js +6 -0
  405. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  406. package/src/runs/shared/capability-ceiling.js +179 -0
  407. package/src/runs/shared/chain-outputs.d.ts +18 -0
  408. package/src/runs/shared/chain-outputs.js +104 -0
  409. package/src/runs/shared/child-commands.d.ts +29 -0
  410. package/src/runs/shared/child-commands.js +254 -0
  411. package/src/runs/shared/child-hooks.d.ts +31 -0
  412. package/src/runs/shared/child-hooks.js +173 -0
  413. package/src/runs/shared/child-identity.d.ts +23 -0
  414. package/src/runs/shared/child-identity.js +40 -0
  415. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  416. package/src/runs/shared/child-launch-plan.js +88 -0
  417. package/src/runs/shared/child-launch.d.ts +128 -0
  418. package/src/runs/shared/child-launch.js +262 -0
  419. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  420. package/src/runs/shared/child-lifecycle.js +22 -0
  421. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  422. package/src/runs/shared/child-runtime-config.js +44 -0
  423. package/src/runs/shared/child-session.d.ts +178 -0
  424. package/src/runs/shared/child-session.js +726 -0
  425. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  426. package/src/runs/shared/child-tool-plan.js +430 -0
  427. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  428. package/src/runs/shared/claude-code-adapter.js +255 -0
  429. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  430. package/src/runs/shared/codex-exec-adapter.js +127 -0
  431. package/src/runs/shared/context-mode.d.ts +12 -0
  432. package/src/runs/shared/context-mode.js +38 -0
  433. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  434. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  435. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  436. package/src/runs/shared/dynamic-fanout.js +273 -0
  437. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  438. package/src/runs/shared/effective-system-prompt.js +23 -0
  439. package/src/runs/shared/extension-bindings.d.ts +25 -0
  440. package/src/runs/shared/extension-bindings.js +96 -0
  441. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  442. package/src/runs/shared/external-cli-contract.js +145 -0
  443. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  444. package/src/runs/shared/external-cli-preflight.js +159 -0
  445. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  446. package/src/runs/shared/external-cli-runner.js +425 -0
  447. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  448. package/src/runs/shared/external-job-bridge.js +486 -0
  449. package/src/runs/shared/external-job-runner.d.ts +44 -0
  450. package/src/runs/shared/external-job-runner.js +352 -0
  451. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  452. package/src/runs/shared/fast-mode-extension.js +8 -0
  453. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  454. package/src/runs/shared/fork-placed-env.js +13 -0
  455. package/src/runs/shared/git-environment.d.ts +2 -0
  456. package/src/runs/shared/git-environment.js +27 -0
  457. package/src/runs/shared/herdr-connection.d.ts +79 -0
  458. package/src/runs/shared/herdr-connection.js +269 -0
  459. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  460. package/src/runs/shared/herdr-external-adapters.js +404 -0
  461. package/src/runs/shared/herdr-machine.d.ts +59 -0
  462. package/src/runs/shared/herdr-machine.js +294 -0
  463. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  464. package/src/runs/shared/herdr-pane-host.js +155 -0
  465. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  466. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  467. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  468. package/src/runs/shared/herdr-placed-run.js +380 -0
  469. package/src/runs/shared/host-step-status.d.ts +33 -0
  470. package/src/runs/shared/host-step-status.js +244 -0
  471. package/src/runs/shared/lane-metadata.d.ts +23 -0
  472. package/src/runs/shared/lane-metadata.js +126 -0
  473. package/src/runs/shared/launch-cwd.d.ts +1 -0
  474. package/src/runs/shared/launch-cwd.js +16 -0
  475. package/src/runs/shared/local-machine-access.d.ts +5 -0
  476. package/src/runs/shared/local-machine-access.js +28 -0
  477. package/src/runs/shared/long-running-guard.d.ts +34 -0
  478. package/src/runs/shared/long-running-guard.js +256 -0
  479. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  480. package/src/runs/shared/mcp-config-sources.js +418 -0
  481. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  482. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  483. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  484. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  485. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  486. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  487. package/src/runs/shared/model-resolution.d.ts +109 -0
  488. package/src/runs/shared/model-resolution.js +411 -0
  489. package/src/runs/shared/model-scope.d.ts +68 -0
  490. package/src/runs/shared/model-scope.js +171 -0
  491. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  492. package/src/runs/shared/mutation-evidence.js +198 -0
  493. package/src/runs/shared/nested-events.d.ts +135 -0
  494. package/src/runs/shared/nested-events.js +1090 -0
  495. package/src/runs/shared/nested-path.d.ts +8 -0
  496. package/src/runs/shared/nested-path.js +34 -0
  497. package/src/runs/shared/nested-render.d.ts +20 -0
  498. package/src/runs/shared/nested-render.js +115 -0
  499. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  500. package/src/runs/shared/orca-progress-tabs.js +503 -0
  501. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  502. package/src/runs/shared/parallel-handoff.js +783 -0
  503. package/src/runs/shared/parallel-utils.d.ts +177 -0
  504. package/src/runs/shared/parallel-utils.js +125 -0
  505. package/src/runs/shared/partial-output.d.ts +24 -0
  506. package/src/runs/shared/partial-output.js +35 -0
  507. package/src/runs/shared/permissions.d.ts +12 -0
  508. package/src/runs/shared/permissions.js +92 -0
  509. package/src/runs/shared/pi-spawn.d.ts +31 -0
  510. package/src/runs/shared/pi-spawn.js +211 -0
  511. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  512. package/src/runs/shared/placed-run-owner.js +93 -0
  513. package/src/runs/shared/placement-host.d.ts +99 -0
  514. package/src/runs/shared/placement-host.js +157 -0
  515. package/src/runs/shared/process-signal.d.ts +15 -0
  516. package/src/runs/shared/process-signal.js +21 -0
  517. package/src/runs/shared/profile-extensions.d.ts +21 -0
  518. package/src/runs/shared/profile-extensions.js +122 -0
  519. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  520. package/src/runs/shared/profile-launch-env.js +90 -0
  521. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  522. package/src/runs/shared/readonly-drain-observation.js +50 -0
  523. package/src/runs/shared/rex-machine.d.ts +25 -0
  524. package/src/runs/shared/rex-machine.js +83 -0
  525. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  526. package/src/runs/shared/rex-pane-host.js +327 -0
  527. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  528. package/src/runs/shared/run-fanout-budget.js +258 -0
  529. package/src/runs/shared/run-ownership.d.ts +3 -0
  530. package/src/runs/shared/run-ownership.js +8 -0
  531. package/src/runs/shared/runner-launcher.d.ts +11 -0
  532. package/src/runs/shared/runner-launcher.js +24 -0
  533. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  534. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  535. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  536. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  537. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  538. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  539. package/src/runs/shared/session-lease.d.ts +69 -0
  540. package/src/runs/shared/session-lease.js +250 -0
  541. package/src/runs/shared/single-output.d.ts +90 -0
  542. package/src/runs/shared/single-output.js +349 -0
  543. package/src/runs/shared/spawn-budget.d.ts +20 -0
  544. package/src/runs/shared/spawn-budget.js +93 -0
  545. package/src/runs/shared/structured-output.d.ts +66 -0
  546. package/src/runs/shared/structured-output.js +483 -0
  547. package/src/runs/shared/subagent-control.d.ts +50 -0
  548. package/src/runs/shared/subagent-control.js +247 -0
  549. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  550. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  551. package/src/runs/shared/tool-availability.d.ts +16 -0
  552. package/src/runs/shared/tool-availability.js +29 -0
  553. package/src/runs/shared/tool-budget.d.ts +21 -0
  554. package/src/runs/shared/tool-budget.js +78 -0
  555. package/src/runs/shared/tool-timeout.d.ts +31 -0
  556. package/src/runs/shared/tool-timeout.js +73 -0
  557. package/src/runs/shared/usage-budget.d.ts +7 -0
  558. package/src/runs/shared/usage-budget.js +74 -0
  559. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  560. package/src/runs/shared/usage-reconciliation.js +71 -0
  561. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  562. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  563. package/src/runs/shared/workflow-graph.d.ts +31 -0
  564. package/src/runs/shared/workflow-graph.js +221 -0
  565. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  566. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  567. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  568. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  569. package/src/runs/shared/worktree-lock.d.ts +5 -0
  570. package/src/runs/shared/worktree-lock.js +40 -0
  571. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  572. package/src/runs/shared/worktree-setup-command.js +200 -0
  573. package/src/runs/shared/worktree.d.ts +181 -0
  574. package/src/runs/shared/worktree.js +1346 -0
  575. package/src/shared/accessible-dir.d.ts +11 -0
  576. package/src/shared/accessible-dir.js +39 -0
  577. package/src/shared/agent-stream-options.d.ts +5 -0
  578. package/src/shared/agent-stream-options.js +3 -0
  579. package/src/shared/artifacts.d.ts +22 -0
  580. package/src/shared/artifacts.js +272 -0
  581. package/src/shared/atomic-json.d.ts +19 -0
  582. package/src/shared/atomic-json.js +61 -0
  583. package/src/shared/capacity-resilient-json.d.ts +26 -0
  584. package/src/shared/capacity-resilient-json.js +86 -0
  585. package/src/shared/child-cache-retention.d.ts +29 -0
  586. package/src/shared/child-cache-retention.js +40 -0
  587. package/src/shared/child-session-name.d.ts +8 -0
  588. package/src/shared/child-session-name.js +40 -0
  589. package/src/shared/child-transcript.d.ts +37 -0
  590. package/src/shared/child-transcript.js +225 -0
  591. package/src/shared/completion-owner.d.ts +7 -0
  592. package/src/shared/completion-owner.js +13 -0
  593. package/src/shared/disabled-features.d.ts +93 -0
  594. package/src/shared/disabled-features.js +120 -0
  595. package/src/shared/display-text.d.ts +5 -0
  596. package/src/shared/display-text.js +154 -0
  597. package/src/shared/edit-distance.d.ts +4 -0
  598. package/src/shared/edit-distance.js +32 -0
  599. package/src/shared/extension-context.d.ts +21 -0
  600. package/src/shared/extension-context.js +39 -0
  601. package/src/shared/file-coalescer.d.ts +11 -0
  602. package/src/shared/file-coalescer.js +34 -0
  603. package/src/shared/file-lease.d.ts +10 -0
  604. package/src/shared/file-lease.js +106 -0
  605. package/src/shared/file-system-retry.d.ts +31 -0
  606. package/src/shared/file-system-retry.js +84 -0
  607. package/src/shared/fork-context.d.ts +64 -0
  608. package/src/shared/fork-context.js +185 -0
  609. package/src/shared/fork-session-cwd.d.ts +2 -0
  610. package/src/shared/fork-session-cwd.js +23 -0
  611. package/src/shared/formatters.d.ts +35 -0
  612. package/src/shared/formatters.js +137 -0
  613. package/src/shared/jsonl-writer.d.ts +20 -0
  614. package/src/shared/jsonl-writer.js +67 -0
  615. package/src/shared/launch-contract.d.ts +65 -0
  616. package/src/shared/launch-contract.js +145 -0
  617. package/src/shared/model-info.d.ts +55 -0
  618. package/src/shared/model-info.js +103 -0
  619. package/src/shared/model-response-aliases.d.ts +1 -0
  620. package/src/shared/model-response-aliases.js +15 -0
  621. package/src/shared/node-executable.d.ts +1 -0
  622. package/src/shared/node-executable.js +20 -0
  623. package/src/shared/opencode-session-headers.d.ts +12 -0
  624. package/src/shared/opencode-session-headers.js +26 -0
  625. package/src/shared/package-version.d.ts +2 -0
  626. package/src/shared/package-version.js +14 -0
  627. package/src/shared/parent-wake.d.ts +26 -0
  628. package/src/shared/parent-wake.js +68 -0
  629. package/src/shared/permission-profile.d.ts +26 -0
  630. package/src/shared/permission-profile.js +49 -0
  631. package/src/shared/prompt-resources.d.ts +5 -0
  632. package/src/shared/prompt-resources.js +10 -0
  633. package/src/shared/provider-diagnostics.d.ts +9 -0
  634. package/src/shared/provider-diagnostics.js +75 -0
  635. package/src/shared/pruned-fork.d.ts +34 -0
  636. package/src/shared/pruned-fork.js +434 -0
  637. package/src/shared/required-child-extensions.d.ts +34 -0
  638. package/src/shared/required-child-extensions.js +105 -0
  639. package/src/shared/runtime-module-path.d.ts +10 -0
  640. package/src/shared/runtime-module-path.js +16 -0
  641. package/src/shared/sandbox-profile.d.ts +12 -0
  642. package/src/shared/sandbox-profile.js +35 -0
  643. package/src/shared/session-file-trust.d.ts +1 -0
  644. package/src/shared/session-file-trust.js +20 -0
  645. package/src/shared/session-identity.d.ts +8 -0
  646. package/src/shared/session-identity.js +32 -0
  647. package/src/shared/session-succession.d.ts +4 -0
  648. package/src/shared/session-succession.js +24 -0
  649. package/src/shared/session-tokens.d.ts +2 -0
  650. package/src/shared/session-tokens.js +58 -0
  651. package/src/shared/settings-file-lease.d.ts +4 -0
  652. package/src/shared/settings-file-lease.js +38 -0
  653. package/src/shared/settings.d.ts +146 -0
  654. package/src/shared/settings.js +247 -0
  655. package/src/shared/shortcuts.d.ts +1 -0
  656. package/src/shared/shortcuts.js +17 -0
  657. package/src/shared/status-format.d.ts +9 -0
  658. package/src/shared/status-format.js +60 -0
  659. package/src/shared/thinking-ceiling.d.ts +13 -0
  660. package/src/shared/thinking-ceiling.js +37 -0
  661. package/src/shared/types.d.ts +2840 -0
  662. package/src/shared/types.js +276 -0
  663. package/src/shared/utf8.d.ts +5 -0
  664. package/src/shared/utf8.js +12 -0
  665. package/src/shared/utils.d.ts +83 -0
  666. package/src/shared/utils.js +612 -0
  667. package/src/shared/watch-strategy.d.ts +2 -0
  668. package/src/shared/watch-strategy.js +5 -0
  669. package/src/shared/workflow-child-permit.d.ts +58 -0
  670. package/src/shared/workflow-child-permit.js +159 -0
  671. package/src/slash/delegation-adapters.d.ts +154 -0
  672. package/src/slash/delegation-adapters.js +316 -0
  673. package/src/slash/delegation-json.d.ts +10 -0
  674. package/src/slash/delegation-json.js +117 -0
  675. package/src/slash/delegation-request.d.ts +12 -0
  676. package/src/slash/delegation-request.js +174 -0
  677. package/src/slash/prompt-template-bridge.d.ts +29 -0
  678. package/src/slash/prompt-template-bridge.js +399 -0
  679. package/src/slash/prompt-workflows.d.ts +21 -0
  680. package/src/slash/prompt-workflows.js +274 -0
  681. package/src/slash/selector.d.ts +47 -0
  682. package/src/slash/selector.js +117 -0
  683. package/src/slash/slash-bridge.d.ts +30 -0
  684. package/src/slash/slash-bridge.js +132 -0
  685. package/src/slash/slash-commands.d.ts +10 -0
  686. package/src/slash/slash-commands.js +1059 -0
  687. package/src/slash/slash-live-state.d.ts +21 -0
  688. package/src/slash/slash-live-state.js +263 -0
  689. package/src/slash/subagent-cost.d.ts +29 -0
  690. package/src/slash/subagent-cost.js +310 -0
  691. package/src/slash/subagents-admin.d.ts +3 -0
  692. package/src/slash/subagents-admin.js +481 -0
  693. package/src/tui/fleet-layout.d.ts +20 -0
  694. package/src/tui/fleet-layout.js +17 -0
  695. package/src/tui/fleet-native-transcript.d.ts +53 -0
  696. package/src/tui/fleet-native-transcript.js +339 -0
  697. package/src/tui/fleet-status.d.ts +92 -0
  698. package/src/tui/fleet-status.js +1132 -0
  699. package/src/tui/fleet-transcript.d.ts +64 -0
  700. package/src/tui/fleet-transcript.js +544 -0
  701. package/src/tui/fleet-viewport.d.ts +12 -0
  702. package/src/tui/fleet-viewport.js +35 -0
  703. package/src/tui/fleet.d.ts +196 -0
  704. package/src/tui/fleet.js +1588 -0
  705. package/src/tui/mouse-events.d.ts +21 -0
  706. package/src/tui/mouse-events.js +26 -0
  707. package/src/tui/render-helpers.d.ts +23 -0
  708. package/src/tui/render-helpers.js +100 -0
  709. package/src/tui/render.d.ts +66 -0
  710. package/src/tui/render.js +3707 -0
  711. package/src/tui/running-tone.d.ts +10 -0
  712. package/src/tui/running-tone.js +22 -0
  713. package/src/tui/subagent-messages.d.ts +22 -0
  714. package/src/tui/subagent-messages.js +270 -0
  715. package/src/ui-silent-marker.d.ts +20 -0
  716. package/src/ui-silent-marker.js +25 -0
  717. package/src/watchdog/change-signature.d.ts +7 -0
  718. package/src/watchdog/change-signature.js +243 -0
  719. package/src/watchdog/child-status.d.ts +53 -0
  720. package/src/watchdog/child-status.js +187 -0
  721. package/src/watchdog/diff-tool.d.ts +25 -0
  722. package/src/watchdog/diff-tool.js +104 -0
  723. package/src/watchdog/emission-guard.d.ts +36 -0
  724. package/src/watchdog/emission-guard.js +97 -0
  725. package/src/watchdog/guidance.d.ts +3 -0
  726. package/src/watchdog/guidance.js +19 -0
  727. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  728. package/src/watchdog/lsp-diagnostics.js +489 -0
  729. package/src/watchdog/model-selection.d.ts +24 -0
  730. package/src/watchdog/model-selection.js +167 -0
  731. package/src/watchdog/permission-arbiter.d.ts +20 -0
  732. package/src/watchdog/permission-arbiter.js +135 -0
  733. package/src/watchdog/register-child.d.ts +13 -0
  734. package/src/watchdog/register-child.js +128 -0
  735. package/src/watchdog/register-main.d.ts +11 -0
  736. package/src/watchdog/register-main.js +400 -0
  737. package/src/watchdog/render.d.ts +3 -0
  738. package/src/watchdog/render.js +33 -0
  739. package/src/watchdog/review.d.ts +36 -0
  740. package/src/watchdog/review.js +319 -0
  741. package/src/watchdog/rules.d.ts +21 -0
  742. package/src/watchdog/rules.js +58 -0
  743. package/src/watchdog/runtime.d.ts +195 -0
  744. package/src/watchdog/runtime.js +864 -0
  745. package/src/watchdog/scope.d.ts +14 -0
  746. package/src/watchdog/scope.js +44 -0
  747. package/src/watchdog/settings.d.ts +29 -0
  748. package/src/watchdog/settings.js +480 -0
  749. package/src/watchdog/tool-actions.d.ts +17 -0
  750. package/src/watchdog/tool-actions.js +150 -0
  751. package/src/watchdog/turn-delta.d.ts +15 -0
  752. package/src/watchdog/turn-delta.js +188 -0
  753. package/src/watchdog/types.d.ts +141 -0
  754. package/src/watchdog/types.js +27 -0
  755. package/src/watchdog/warning-format.d.ts +7 -0
  756. package/src/watchdog/warning-format.js +59 -0
  757. package/src/workflows/chat-progress.d.ts +37 -0
  758. package/src/workflows/chat-progress.js +129 -0
  759. package/src/workflows/host-command.d.ts +30 -0
  760. package/src/workflows/host-command.js +227 -0
  761. package/src/workflows/scripted-workflow.d.ts +204 -0
  762. package/src/workflows/scripted-workflow.js +1673 -0
  763. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  764. package/src/workflows/structured-workflow-scripts.js +179 -0
  765. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  766. package/src/workflows/workflow-auto-resume.js +102 -0
  767. package/src/workflows/workflow-checklist.d.ts +127 -0
  768. package/src/workflows/workflow-checklist.js +314 -0
  769. package/src/workflows/workflow-child-summary.d.ts +24 -0
  770. package/src/workflows/workflow-child-summary.js +195 -0
  771. package/src/workflows/workflow-launch-record.d.ts +27 -0
  772. package/src/workflows/workflow-launch-record.js +48 -0
  773. package/src/workflows/workflow-preflight.d.ts +58 -0
  774. package/src/workflows/workflow-preflight.js +288 -0
  775. package/src/workflows/workflow-receipt.d.ts +34 -0
  776. package/src/workflows/workflow-receipt.js +454 -0
  777. package/src/workflows/workflow-resources.d.ts +55 -0
  778. package/src/workflows/workflow-resources.js +271 -0
  779. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  780. package/src/workflows/workflow-resume-claim.js +210 -0
  781. package/src/workflows/workflow-resume.d.ts +56 -0
  782. package/src/workflows/workflow-resume.js +106 -0
  783. package/src/workflows/workflow-reuse.d.ts +61 -0
  784. package/src/workflows/workflow-reuse.js +186 -0
  785. package/src/workflows/workflow-revival.d.ts +33 -0
  786. package/src/workflows/workflow-revival.js +111 -0
  787. package/src/workflows/workflow-settlement.d.ts +84 -0
  788. package/src/workflows/workflow-settlement.js +203 -0
  789. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  790. package/src/workflows/workflow-stop-cause.js +8 -0
  791. package/workflow-script-worker.cjs +1342 -0
  792. package/index.ts +0 -18
  793. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  794. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  795. package/skills/pi-subagents/references/execution-controls.md +0 -561
  796. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  797. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  798. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  799. package/src/agents/advertised-agent-prompt.ts +0 -82
  800. package/src/agents/agent-eject.ts +0 -339
  801. package/src/agents/agent-management.ts +0 -1442
  802. package/src/agents/agent-memory.ts +0 -341
  803. package/src/agents/agent-refinements.ts +0 -624
  804. package/src/agents/agent-scope.ts +0 -10
  805. package/src/agents/agent-selection.ts +0 -25
  806. package/src/agents/agent-serializer.ts +0 -195
  807. package/src/agents/agents.ts +0 -3169
  808. package/src/agents/builtin-names.ts +0 -16
  809. package/src/agents/chain-serializer.ts +0 -285
  810. package/src/agents/frontmatter.ts +0 -153
  811. package/src/agents/global-npm-root.ts +0 -58
  812. package/src/agents/identity.ts +0 -30
  813. package/src/agents/proactive-skills.ts +0 -197
  814. package/src/agents/runtime-agent-events.ts +0 -70
  815. package/src/agents/runtime-agent-registry.ts +0 -457
  816. package/src/agents/runtime-discovery.ts +0 -39
  817. package/src/agents/skills.ts +0 -787
  818. package/src/api/agent-management.ts +0 -9
  819. package/src/api/agents.ts +0 -19
  820. package/src/api/background-work.ts +0 -206
  821. package/src/api/capability-ceiling.ts +0 -16
  822. package/src/api/child-tool-plan.ts +0 -5
  823. package/src/api/control-channel.ts +0 -4
  824. package/src/api/delegation.ts +0 -131
  825. package/src/api/external-job-provider.ts +0 -195
  826. package/src/api/external-runs.ts +0 -282
  827. package/src/api/inspectors.ts +0 -27
  828. package/src/api/intercom-bridge.ts +0 -3
  829. package/src/api/preflight.ts +0 -641
  830. package/src/api/project-panes.ts +0 -32
  831. package/src/api/required-child-extensions.ts +0 -6
  832. package/src/api/shared-types.ts +0 -29
  833. package/src/api/workflow-resources.ts +0 -6
  834. package/src/extension/config.ts +0 -262
  835. package/src/extension/context-injection.ts +0 -123
  836. package/src/extension/control-notices.ts +0 -53
  837. package/src/extension/declaration-pinning.ts +0 -164
  838. package/src/extension/doctor.ts +0 -284
  839. package/src/extension/fanout-child.ts +0 -282
  840. package/src/extension/herdr-pi-bridge.ts +0 -166
  841. package/src/extension/index.ts +0 -1185
  842. package/src/extension/public-execution.ts +0 -262
  843. package/src/extension/reply-workflow-script.ts +0 -67
  844. package/src/extension/rpc.ts +0 -881
  845. package/src/extension/schemas.ts +0 -337
  846. package/src/extension/steering-notices.ts +0 -35
  847. package/src/extension/subagent-guide.ts +0 -127
  848. package/src/extension/subagent-options.ts +0 -47
  849. package/src/extension/tool-activation.ts +0 -147
  850. package/src/extension/tool-description.ts +0 -193
  851. package/src/extension/tool-result.ts +0 -19
  852. package/src/extension/upgrade-notice.ts +0 -40
  853. package/src/inspectors/actions.ts +0 -174
  854. package/src/inspectors/ghostty/actions.ts +0 -74
  855. package/src/inspectors/ghostty/plugin.ts +0 -29
  856. package/src/inspectors/herdr/actions.ts +0 -155
  857. package/src/inspectors/herdr/client.ts +0 -130
  858. package/src/inspectors/herdr/focus.ts +0 -55
  859. package/src/inspectors/herdr/plugin.ts +0 -20
  860. package/src/inspectors/herdr/project-panes.ts +0 -733
  861. package/src/inspectors/inspector-runner.ts +0 -153
  862. package/src/inspectors/plugins.ts +0 -76
  863. package/src/inspectors/session-roots-codec.ts +0 -31
  864. package/src/inspectors/shell-command.ts +0 -16
  865. package/src/inspectors/tmux/actions.ts +0 -204
  866. package/src/inspectors/tmux/client.ts +0 -85
  867. package/src/inspectors/tmux/plugin.ts +0 -21
  868. package/src/inspectors/types.ts +0 -51
  869. package/src/integrations/herdr-status.ts +0 -385
  870. package/src/integrations/pi-web-session-liveness.ts +0 -73
  871. package/src/integrations/program-status.ts +0 -215
  872. package/src/intercom/intercom-bridge.ts +0 -235
  873. package/src/intercom/native-supervisor-channel.ts +0 -1000
  874. package/src/intercom/result-intercom.ts +0 -433
  875. package/src/intercom/supervisor-ui.ts +0 -72
  876. package/src/missions/actions.ts +0 -433
  877. package/src/missions/goal-driver.ts +0 -177
  878. package/src/missions/lifecycle.ts +0 -367
  879. package/src/missions/store.ts +0 -613
  880. package/src/missions/types.ts +0 -190
  881. package/src/missions/workflow-state.ts +0 -281
  882. package/src/policy/authority.ts +0 -50
  883. package/src/profiles/profiles.ts +0 -674
  884. package/src/runs/background/active-async-capacity.ts +0 -548
  885. package/src/runs/background/active-run-index.ts +0 -155
  886. package/src/runs/background/async-execution.ts +0 -2479
  887. package/src/runs/background/async-job-tracker.ts +0 -869
  888. package/src/runs/background/async-resume.ts +0 -686
  889. package/src/runs/background/async-retention.ts +0 -953
  890. package/src/runs/background/async-status-snapshot.ts +0 -46
  891. package/src/runs/background/async-status.ts +0 -787
  892. package/src/runs/background/auto-drain.ts +0 -92
  893. package/src/runs/background/await-async-run.ts +0 -83
  894. package/src/runs/background/binary-bootstrap.ts +0 -67
  895. package/src/runs/background/calendar-schedule.ts +0 -90
  896. package/src/runs/background/chain-append.ts +0 -321
  897. package/src/runs/background/chain-root-attachment.ts +0 -263
  898. package/src/runs/background/completion-batcher.ts +0 -168
  899. package/src/runs/background/completion-dedupe.ts +0 -58
  900. package/src/runs/background/completion-replay.ts +0 -287
  901. package/src/runs/background/control-channel.ts +0 -659
  902. package/src/runs/background/fleet-view.ts +0 -692
  903. package/src/runs/background/index-segment.ts +0 -59
  904. package/src/runs/background/inspect-rpc.ts +0 -443
  905. package/src/runs/background/notify.ts +0 -1083
  906. package/src/runs/background/owned-process-tree.ts +0 -131
  907. package/src/runs/background/parallel-groups.ts +0 -45
  908. package/src/runs/background/pid-namespace.ts +0 -18
  909. package/src/runs/background/process-terminal-candidate.ts +0 -98
  910. package/src/runs/background/process-terminal.ts +0 -231
  911. package/src/runs/background/result-delivery-ownership.ts +0 -45
  912. package/src/runs/background/result-files.ts +0 -634
  913. package/src/runs/background/result-watcher.ts +0 -842
  914. package/src/runs/background/resume-guidance.ts +0 -56
  915. package/src/runs/background/retained-children.ts +0 -136
  916. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  917. package/src/runs/background/run-child-session.ts +0 -725
  918. package/src/runs/background/run-id-query.ts +0 -7
  919. package/src/runs/background/run-id-resolver.ts +0 -183
  920. package/src/runs/background/run-status.ts +0 -803
  921. package/src/runs/background/runner-aliases.ts +0 -183
  922. package/src/runs/background/runner-child-launch.ts +0 -96
  923. package/src/runs/background/runner-child-sessions.ts +0 -32
  924. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  925. package/src/runs/background/runner-startup-failure.ts +0 -56
  926. package/src/runs/background/scheduled-runs.ts +0 -1222
  927. package/src/runs/background/stale-run-reconciler.ts +0 -463
  928. package/src/runs/background/steering.ts +0 -260
  929. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  930. package/src/runs/background/subagent-runner.ts +0 -5251
  931. package/src/runs/background/subagent-wait.ts +0 -895
  932. package/src/runs/background/terminal-run-index.ts +0 -183
  933. package/src/runs/background/top-level-async.ts +0 -14
  934. package/src/runs/background/wait-completions.ts +0 -262
  935. package/src/runs/background/wait-config.ts +0 -50
  936. package/src/runs/background/wait-subscriptions.ts +0 -354
  937. package/src/runs/background/wait-tool.ts +0 -57
  938. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  939. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  940. package/src/runs/foreground/async-steering-action.ts +0 -276
  941. package/src/runs/foreground/async-stop-action.ts +0 -216
  942. package/src/runs/foreground/command-action.ts +0 -41
  943. package/src/runs/foreground/execution.ts +0 -2315
  944. package/src/runs/foreground/foreground-control.ts +0 -157
  945. package/src/runs/foreground/foreground-history.ts +0 -164
  946. package/src/runs/foreground/prompt-audit.ts +0 -172
  947. package/src/runs/foreground/subagent-executor.ts +0 -8227
  948. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  949. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  950. package/src/runs/shared/abort-recovery.ts +0 -119
  951. package/src/runs/shared/acceptance.ts +0 -1664
  952. package/src/runs/shared/agent-contract.ts +0 -38
  953. package/src/runs/shared/async-status-projection.ts +0 -664
  954. package/src/runs/shared/background-process-options.ts +0 -9
  955. package/src/runs/shared/capability-ceiling.ts +0 -214
  956. package/src/runs/shared/chain-outputs.ts +0 -116
  957. package/src/runs/shared/child-commands.ts +0 -229
  958. package/src/runs/shared/child-hooks.ts +0 -175
  959. package/src/runs/shared/child-identity.ts +0 -62
  960. package/src/runs/shared/child-launch-plan.ts +0 -163
  961. package/src/runs/shared/child-launch.ts +0 -389
  962. package/src/runs/shared/child-lifecycle.ts +0 -28
  963. package/src/runs/shared/child-runtime-config.ts +0 -136
  964. package/src/runs/shared/child-session.ts +0 -699
  965. package/src/runs/shared/child-tool-plan.ts +0 -599
  966. package/src/runs/shared/claude-code-adapter.ts +0 -288
  967. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  968. package/src/runs/shared/context-mode.ts +0 -44
  969. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  970. package/src/runs/shared/dynamic-fanout.ts +0 -297
  971. package/src/runs/shared/effective-system-prompt.ts +0 -33
  972. package/src/runs/shared/extension-bindings.ts +0 -103
  973. package/src/runs/shared/external-cli-contract.ts +0 -177
  974. package/src/runs/shared/external-cli-preflight.ts +0 -190
  975. package/src/runs/shared/external-cli-runner.ts +0 -437
  976. package/src/runs/shared/external-job-bridge.ts +0 -514
  977. package/src/runs/shared/external-job-runner.ts +0 -389
  978. package/src/runs/shared/fast-mode-extension.ts +0 -10
  979. package/src/runs/shared/fork-command-result.ts +0 -10
  980. package/src/runs/shared/git-environment.ts +0 -29
  981. package/src/runs/shared/herdr-connection.ts +0 -134
  982. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  983. package/src/runs/shared/herdr-machine.ts +0 -279
  984. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  985. package/src/runs/shared/herdr-placed-run.ts +0 -264
  986. package/src/runs/shared/host-step-status.ts +0 -231
  987. package/src/runs/shared/lane-metadata.ts +0 -126
  988. package/src/runs/shared/launch-cwd.ts +0 -16
  989. package/src/runs/shared/long-running-guard.ts +0 -221
  990. package/src/runs/shared/mcp-config-sources.ts +0 -426
  991. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  992. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  993. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  994. package/src/runs/shared/model-resolution.ts +0 -503
  995. package/src/runs/shared/model-scope.ts +0 -224
  996. package/src/runs/shared/mutation-evidence.ts +0 -199
  997. package/src/runs/shared/nested-events.ts +0 -1125
  998. package/src/runs/shared/nested-path.ts +0 -38
  999. package/src/runs/shared/nested-render.ts +0 -127
  1000. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1001. package/src/runs/shared/parallel-handoff.ts +0 -789
  1002. package/src/runs/shared/parallel-utils.ts +0 -292
  1003. package/src/runs/shared/partial-output.ts +0 -48
  1004. package/src/runs/shared/permissions.ts +0 -86
  1005. package/src/runs/shared/pi-spawn.ts +0 -205
  1006. package/src/runs/shared/process-signal.ts +0 -35
  1007. package/src/runs/shared/profile-extensions.ts +0 -134
  1008. package/src/runs/shared/profile-launch-env.ts +0 -121
  1009. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1010. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1011. package/src/runs/shared/run-history.ts +0 -288
  1012. package/src/runs/shared/runner-launcher.ts +0 -25
  1013. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1014. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1015. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1016. package/src/runs/shared/session-lease.ts +0 -293
  1017. package/src/runs/shared/single-output.ts +0 -366
  1018. package/src/runs/shared/spawn-budget.ts +0 -128
  1019. package/src/runs/shared/structured-output.ts +0 -463
  1020. package/src/runs/shared/subagent-control.ts +0 -295
  1021. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1022. package/src/runs/shared/tool-availability.ts +0 -37
  1023. package/src/runs/shared/tool-budget.ts +0 -87
  1024. package/src/runs/shared/tool-timeout.ts +0 -93
  1025. package/src/runs/shared/usage-budget.ts +0 -65
  1026. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1027. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1028. package/src/runs/shared/workflow-graph.ts +0 -225
  1029. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1030. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1031. package/src/runs/shared/worktree-lock.ts +0 -29
  1032. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1033. package/src/runs/shared/worktree.ts +0 -1554
  1034. package/src/shared/accessible-dir.ts +0 -47
  1035. package/src/shared/agent-stream-options.ts +0 -5
  1036. package/src/shared/artifacts.ts +0 -281
  1037. package/src/shared/atomic-json.ts +0 -85
  1038. package/src/shared/capacity-resilient-json.ts +0 -102
  1039. package/src/shared/child-cache-retention.ts +0 -43
  1040. package/src/shared/child-session-name.ts +0 -48
  1041. package/src/shared/child-transcript.ts +0 -264
  1042. package/src/shared/completion-owner.ts +0 -14
  1043. package/src/shared/disabled-features.ts +0 -123
  1044. package/src/shared/display-text.ts +0 -150
  1045. package/src/shared/edit-distance.ts +0 -33
  1046. package/src/shared/extension-context.ts +0 -37
  1047. package/src/shared/file-coalescer.ts +0 -49
  1048. package/src/shared/file-lease.ts +0 -74
  1049. package/src/shared/file-system-retry.ts +0 -95
  1050. package/src/shared/fork-context.ts +0 -243
  1051. package/src/shared/fork-session-cwd.ts +0 -27
  1052. package/src/shared/formatters.ts +0 -142
  1053. package/src/shared/jsonl-writer.ts +0 -92
  1054. package/src/shared/launch-contract.ts +0 -206
  1055. package/src/shared/model-info.ts +0 -132
  1056. package/src/shared/model-response-aliases.ts +0 -13
  1057. package/src/shared/node-executable.ts +0 -21
  1058. package/src/shared/opencode-session-headers.ts +0 -30
  1059. package/src/shared/package-version.ts +0 -17
  1060. package/src/shared/parent-wake.ts +0 -79
  1061. package/src/shared/permission-profile.ts +0 -56
  1062. package/src/shared/prompt-resources.ts +0 -11
  1063. package/src/shared/pruned-fork.ts +0 -469
  1064. package/src/shared/required-child-extensions.ts +0 -115
  1065. package/src/shared/runtime-module-path.ts +0 -19
  1066. package/src/shared/sandbox-profile.ts +0 -37
  1067. package/src/shared/session-file-trust.ts +0 -19
  1068. package/src/shared/session-identity.ts +0 -10
  1069. package/src/shared/session-tokens.ts +0 -55
  1070. package/src/shared/settings-file-lease.ts +0 -36
  1071. package/src/shared/settings.ts +0 -412
  1072. package/src/shared/shortcuts.ts +0 -13
  1073. package/src/shared/status-format.ts +0 -55
  1074. package/src/shared/thinking-ceiling.ts +0 -46
  1075. package/src/shared/types.ts +0 -3105
  1076. package/src/shared/utf8.ts +0 -11
  1077. package/src/shared/utils.ts +0 -610
  1078. package/src/shared/watch-strategy.ts +0 -12
  1079. package/src/shared/workflow-child-permit.ts +0 -212
  1080. package/src/slash/delegation-adapters.ts +0 -452
  1081. package/src/slash/delegation-json.ts +0 -108
  1082. package/src/slash/delegation-request.ts +0 -176
  1083. package/src/slash/prompt-template-bridge.ts +0 -434
  1084. package/src/slash/prompt-workflows.ts +0 -298
  1085. package/src/slash/selector.ts +0 -147
  1086. package/src/slash/slash-bridge.ts +0 -192
  1087. package/src/slash/slash-commands.ts +0 -1096
  1088. package/src/slash/slash-live-state.ts +0 -310
  1089. package/src/slash/subagent-cost.ts +0 -317
  1090. package/src/slash/subagents-admin.ts +0 -489
  1091. package/src/tui/fleet-native-transcript.ts +0 -424
  1092. package/src/tui/fleet-status.ts +0 -1139
  1093. package/src/tui/fleet-transcript.ts +0 -591
  1094. package/src/tui/fleet.ts +0 -1618
  1095. package/src/tui/mouse-events.ts +0 -42
  1096. package/src/tui/render-helpers.ts +0 -111
  1097. package/src/tui/render.ts +0 -3824
  1098. package/src/tui/running-tone.ts +0 -28
  1099. package/src/tui/subagent-messages.ts +0 -305
  1100. package/src/ui-silent-marker.ts +0 -32
  1101. package/src/watchdog/change-signature.ts +0 -260
  1102. package/src/watchdog/child-status.ts +0 -225
  1103. package/src/watchdog/diff-tool.ts +0 -112
  1104. package/src/watchdog/emission-guard.ts +0 -125
  1105. package/src/watchdog/guidance.ts +0 -20
  1106. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1107. package/src/watchdog/model-selection.ts +0 -187
  1108. package/src/watchdog/permission-arbiter.ts +0 -154
  1109. package/src/watchdog/register-child.ts +0 -136
  1110. package/src/watchdog/register-main.ts +0 -425
  1111. package/src/watchdog/render.ts +0 -31
  1112. package/src/watchdog/review.ts +0 -362
  1113. package/src/watchdog/rules.ts +0 -70
  1114. package/src/watchdog/runtime.ts +0 -927
  1115. package/src/watchdog/scope.ts +0 -51
  1116. package/src/watchdog/settings.ts +0 -520
  1117. package/src/watchdog/tool-actions.ts +0 -156
  1118. package/src/watchdog/turn-delta.ts +0 -190
  1119. package/src/watchdog/types.ts +0 -186
  1120. package/src/watchdog/warning-format.ts +0 -72
  1121. package/src/workflows/chat-progress.ts +0 -152
  1122. package/src/workflows/host-command.ts +0 -235
  1123. package/src/workflows/scripted-workflow.ts +0 -2733
  1124. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1125. package/src/workflows/workflow-checklist.ts +0 -442
  1126. package/src/workflows/workflow-child-summary.ts +0 -172
  1127. package/src/workflows/workflow-preflight.ts +0 -297
  1128. package/src/workflows/workflow-receipt.ts +0 -390
  1129. package/src/workflows/workflow-resources.ts +0 -275
  1130. package/src/workflows/workflow-reuse.ts +0 -120
  1131. package/src/workflows/workflow-revival.ts +0 -123
  1132. package/src/workflows/workflow-settlement.ts +0 -252
@@ -1,953 +0,0 @@
1
- import { execFile } from "node:child_process";
2
- import * as fs from "node:fs";
3
- import * as os from "node:os";
4
- import * as path from "node:path";
5
- import { randomUUID } from "node:crypto";
6
- import { Worker } from "node:worker_threads";
7
- import { writeAtomicJson } from "../../shared/atomic-json.ts";
8
- import type { AsyncStatus } from "../../shared/types.ts";
9
- import { readMissionBinding, type MissionLaunchBinding } from "../../missions/lifecycle.ts";
10
- import { MissionNotFoundError, readMission } from "../../missions/store.ts";
11
- import type { MissionStatus } from "../../missions/types.ts";
12
- import { REVIVAL_ORIGIN_FILE } from "../../workflows/workflow-revival.ts";
13
- import { ACTIVE_RUN_INDEX_DIR } from "./active-run-index.ts";
14
- import { encodeIndexSegment } from "./index-segment.ts";
15
- import { reconcileAsyncRun } from "./stale-run-reconciler.ts";
16
-
17
- export const ASYNC_RETENTION_DAYS = 30;
18
- export const ASYNC_RETENTION_BATCH_SIZE = 100;
19
- export const ASYNC_RETENTION_DELAY_MS = 60_000;
20
- export const ASYNC_RETENTION_TOMBSTONE_GRACE_MS = 24 * 60 * 60 * 1000;
21
-
22
- const RETENTION_MS = ASYNC_RETENTION_DAYS * 24 * 60 * 60 * 1000;
23
- const LOCK_NAME = ".async-retention.lock";
24
- const CURSOR_NAME = ".async-retention-cursor.json";
25
- const LOG_NAME = "async-retention-maintenance.jsonl";
26
- const RUN_TOMBSTONE_PREFIX = ".deleting-run-";
27
- const RESULT_TOMBSTONE_PREFIX = ".deleting-result-";
28
- const RUN_TOMBSTONE_MARKERS_DIR = "async-retention-run-tombstones";
29
- const LOCK_STALE_MS = 24 * 60 * 60 * 1000;
30
- const RUN_MODES = new Set<AsyncStatus["mode"]>(["single", "parallel", "chain", "workflow"]);
31
- const TERMINAL_STATES = new Set<AsyncStatus["state"]>(["complete", "failed", "stopped", "rejected"]);
32
- // Mirrors TERMINAL_MISSION_STATUSES in src/missions/store.ts, which keeps it private.
33
- const TERMINAL_MISSION_STATUSES = new Set<MissionStatus>(["completed", "failed", "cancelled"]);
34
- const RESULT_TIMESTAMP_FIELDS = ["endedAt", "completedAt", "createdAt", "writtenAt", "expiresAt", "timestamp"] as const;
35
-
36
- interface RetentionCursor {
37
- version: 1;
38
- runAfter?: string;
39
- resultAfter?: string;
40
- resultPublicAfter?: string;
41
- resultPendingAfterBySession?: Record<string, string>;
42
- resultReplayAfter?: string;
43
- resultArchiveAfter?: string;
44
- pendingSessionAfter?: string;
45
- }
46
-
47
- type ResultCursorKey = keyof Pick<RetentionCursor, "resultPublicAfter" | "resultReplayAfter" | "resultArchiveAfter">;
48
- type ResultCursorTarget = { type: "result"; key: ResultCursorKey } | { type: "pending"; session: string };
49
-
50
- interface ResultCandidate {
51
- path: string;
52
- relative: string;
53
- kind: "public" | "pending" | "replay" | "archive" | "tombstone";
54
- cursor: ResultCursorTarget;
55
- }
56
-
57
- interface DiscoveredRunCandidate {
58
- name: string;
59
- relative: string;
60
- }
61
-
62
- type CursorOperation =
63
- | { type: "set"; key: Exclude<keyof RetentionCursor, "version" | "resultPendingAfterBySession">; value: string }
64
- | { type: "delete"; key: Exclude<keyof RetentionCursor, "version" | "resultPendingAfterBySession"> }
65
- | { type: "set-pending"; session: string; value: string }
66
- | { type: "delete-pending"; session: string };
67
-
68
- interface RetentionDiscovery {
69
- discoveryDurationMs: number;
70
- rawReads: number;
71
- sourceExhausted: Record<string, boolean>;
72
- runCandidates: DiscoveredRunCandidate[];
73
- resultCandidates: Array<Omit<ResultCandidate, "path">>;
74
- cursorOps: CursorOperation[];
75
- }
76
-
77
- interface RetentionLockOwner {
78
- version: 1;
79
- token: string;
80
- pid: number;
81
- hostname: string;
82
- startedAt: number;
83
- processStartIdentity?: string;
84
- }
85
-
86
- export interface AsyncRetentionOptions {
87
- asyncDirRoot: string;
88
- resultsDir: string;
89
- waitSubscriptionsDir?: string;
90
- protectedRunIds?: Iterable<string>;
91
- now?: () => number;
92
- retentionMs?: number;
93
- tombstoneGraceMs?: number;
94
- batchSize?: number;
95
- randomId?: () => string;
96
- maintenanceRoot?: string;
97
- pid?: number;
98
- hostname?: string;
99
- processStartIdentity?: string;
100
- isProcessAlive?: (pid: number) => boolean | undefined;
101
- getProcessStartIdentity?: (pid: number) => Promise<string | undefined>;
102
- lstatSync?: typeof fs.lstatSync;
103
- signal?: AbortSignal;
104
- discoveryWorkerUrl?: URL;
105
- reconcileKill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;
106
- }
107
-
108
- export interface AsyncRetentionResult {
109
- acquired: boolean;
110
- scanned: number;
111
- repairedRuns: number;
112
- deletedRuns: number;
113
- deletedResults: number;
114
- reapedTombstones: number;
115
- skipped: Record<string, number>;
116
- errors: string[];
117
- rawReads: number;
118
- sourceExhausted: Record<string, boolean>;
119
- discoveryDurationMs: number;
120
- commitDurationMs: number;
121
- cancelled: boolean;
122
- workerFailed: boolean;
123
- durationMs: number;
124
- }
125
-
126
- function isNotFound(error: unknown): boolean {
127
- return typeof error === "object" && error !== null && "code" in error && (error as NodeJS.ErrnoException).code === "ENOENT";
128
- }
129
-
130
- function compactError(error: unknown): string {
131
- const message = error instanceof Error ? error.message : String(error);
132
- return message.replace(/\s+/g, " ").slice(0, 240);
133
- }
134
-
135
- function listDir(dir: string): fs.Dirent[] {
136
- try {
137
- return fs.readdirSync(dir, { withFileTypes: true });
138
- } catch (error) {
139
- if (isNotFound(error)) return [];
140
- throw error;
141
- }
142
- }
143
-
144
- function readJson(filePath: string): Record<string, unknown> | undefined {
145
- try {
146
- const parsed = JSON.parse(fs.readFileSync(filePath).toString("utf8")) as unknown;
147
- return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed as Record<string, unknown> : undefined;
148
- } catch {
149
- return undefined;
150
- }
151
- }
152
-
153
- function readStatus(runDir: string): AsyncStatus | undefined {
154
- const value = readJson(path.join(runDir, "status.json"));
155
- if (!value
156
- || typeof value.runId !== "string"
157
- || typeof value.state !== "string"
158
- || typeof value.mode !== "string"
159
- || !RUN_MODES.has(value.mode as AsyncStatus["mode"])
160
- || typeof value.startedAt !== "number"
161
- || !Number.isFinite(value.startedAt)) return undefined;
162
- // SAFETY: readStatus validates every field of the raw JSON record above; the
163
- // cast only re-narrows the validated record to its domain type.
164
- return value as unknown as AsyncStatus;
165
- }
166
-
167
- function existingRegularFile(filePath: string | undefined): boolean {
168
- if (!filePath) return false;
169
- try {
170
- const stat = fs.lstatSync(filePath);
171
- return stat.isFile() && !stat.isSymbolicLink();
172
- } catch (error) {
173
- return !isNotFound(error);
174
- }
175
- }
176
-
177
- function validRunId(runId: string): boolean {
178
- return runId.length > 0 && runId !== "." && runId !== ".." && path.basename(runId) === runId;
179
- }
180
-
181
- function statusTimestamp(status: AsyncStatus, runDir: string): number | undefined {
182
- if (status.endedAt !== undefined && (typeof status.endedAt !== "number" || !Number.isFinite(status.endedAt))) return undefined;
183
- if (status.lastUpdate !== undefined && (typeof status.lastUpdate !== "number" || !Number.isFinite(status.lastUpdate))) return undefined;
184
- const logical = status.endedAt ?? status.lastUpdate;
185
- try {
186
- const physical = Math.max(fs.statSync(runDir).mtimeMs, fs.statSync(path.join(runDir, "status.json")).mtimeMs);
187
- const timestamp = logical === undefined ? physical : Math.max(logical, physical);
188
- return Number.isFinite(timestamp) ? timestamp : undefined;
189
- } catch {
190
- return undefined;
191
- }
192
- }
193
-
194
- function hasNestedReferences(status: AsyncStatus): boolean {
195
- return status.isNested === true || (status.steps ?? []).some((step) => (step.children?.length ?? 0) > 0);
196
- }
197
-
198
- function hasResumableContract(runDir: string, status: AsyncStatus): boolean {
199
- const statusSessionFiles = [status.sessionFile, ...(status.steps ?? []).map((step) => step.sessionFile)];
200
- if (statusSessionFiles.some(existingRegularFile)) return true;
201
- const descriptorPath = path.join(runDir, "recovery-descriptor.json");
202
- if (!fs.existsSync(descriptorPath)) return false;
203
- const descriptor = readJson(descriptorPath);
204
- if (!descriptor) return true;
205
- const sessionFiles = [
206
- typeof descriptor.sessionFile === "string" ? descriptor.sessionFile : undefined,
207
- ];
208
- if (descriptor.sourceRunId !== status.runId) return true;
209
- return sessionFiles.some(existingRegularFile);
210
- }
211
-
212
- function activeMarkerExists(asyncDirRoot: string, runId: string): boolean {
213
- return fs.existsSync(path.join(asyncDirRoot, ACTIVE_RUN_INDEX_DIR, runId));
214
- }
215
-
216
- function missionObserverIndexExists(resultsDir: string, runId: string): boolean {
217
- return fs.existsSync(path.join(resultsDir, "result-index", "observers", "mission", `${encodeIndexSegment(runId)}.json`));
218
- }
219
-
220
- // The retention window doubles as a terminal mission's grace period. Unreadable references and
221
- // pending syncs are kept because the watcher needs the run's binding to retry.
222
- function missionReferenceBlocksReclaim(runDir: string, resultsDir: string, runId: string): boolean {
223
- if (missionObserverIndexExists(resultsDir, runId)) return true;
224
- let binding: MissionLaunchBinding | undefined;
225
- try {
226
- binding = readMissionBinding(runDir);
227
- } catch {
228
- return true;
229
- }
230
- if (!binding) return false;
231
- try {
232
- const mission = readMission(binding.location, binding.missionId);
233
- return !TERMINAL_MISSION_STATUSES.has(mission.status);
234
- } catch (error) {
235
- return !(error instanceof MissionNotFoundError);
236
- }
237
- }
238
-
239
- function runTombstoneMarkerPath(maintenanceRoot: string, runId: string): string {
240
- return path.join(maintenanceRoot, RUN_TOMBSTONE_MARKERS_DIR, `${encodeIndexSegment(runId)}.json`);
241
- }
242
-
243
- function writeRunTombstoneMarker(maintenanceRoot: string, runId: string, tombstonePath: string, now: number): void {
244
- const markerPath = runTombstoneMarkerPath(maintenanceRoot, runId);
245
- fs.mkdirSync(path.dirname(markerPath), { recursive: true });
246
- writeAtomicJson(markerPath, { version: 1, runId, tombstonePath, createdAt: now });
247
- }
248
-
249
- function removeRunTombstoneMarker(maintenanceRoot: string, runId: string): void {
250
- fs.rmSync(runTombstoneMarkerPath(maintenanceRoot, runId), { force: true });
251
- }
252
-
253
- function readRunTombstoneMarker(maintenanceRoot: string, runId: string): { runId: string; tombstonePath: string } | undefined | "unreadable" {
254
- const markerPath = runTombstoneMarkerPath(maintenanceRoot, runId);
255
- try {
256
- const stat = fs.lstatSync(markerPath);
257
- if (!stat.isFile() || stat.isSymbolicLink()) return "unreadable";
258
- } catch (error) {
259
- return isNotFound(error) ? undefined : "unreadable";
260
- }
261
- const marker = readJson(markerPath);
262
- if (marker?.version !== 1 || marker.runId !== runId || typeof marker.tombstonePath !== "string" || !marker.tombstonePath) return "unreadable";
263
- return { runId, tombstonePath: marker.tombstonePath };
264
- }
265
-
266
- function runTombstoneMarkerMatches(maintenanceRoot: string, runId: string, tombstonePath: string): boolean {
267
- const marker = readRunTombstoneMarker(maintenanceRoot, runId);
268
- return marker !== undefined && marker !== "unreadable" && path.resolve(marker.tombstonePath) === path.resolve(tombstonePath);
269
- }
270
-
271
- function runTombstoneMarkerBlocks(maintenanceRoot: string, runId: string): boolean {
272
- const marker = readRunTombstoneMarker(maintenanceRoot, runId);
273
- if (marker === undefined) return false;
274
- if (marker === "unreadable") return true;
275
- try {
276
- if (fs.existsSync(marker.tombstonePath)) return true;
277
- removeRunTombstoneMarker(maintenanceRoot, runId);
278
- return false;
279
- } catch {
280
- return true;
281
- }
282
- }
283
-
284
- function unresolvedHandoff(manifestPath: string): boolean {
285
- const manifest = readJson(manifestPath);
286
- if (!manifest || manifest.version !== 1 || !Array.isArray(manifest.groups) || manifest.groups.length === 0) return true;
287
- return manifest.groups.some((value) => {
288
- if (!value || typeof value !== "object" || Array.isArray(value)) return true;
289
- const cleanup = (value as Record<string, unknown>).cleanup;
290
- return !cleanup || typeof cleanup !== "object" || Array.isArray(cleanup) || (cleanup as Record<string, unknown>).state !== "complete";
291
- });
292
- }
293
-
294
- function hasUnresolvedRunHandoff(runDir: string, status: AsyncStatus): boolean {
295
- const paths = new Set<string>();
296
- if (status.parallelHandoff) {
297
- if (typeof status.parallelHandoff.path !== "string" || !status.parallelHandoff.path) return true;
298
- paths.add(status.parallelHandoff.path);
299
- }
300
- const localPath = path.join(runDir, "handoff.json");
301
- if (fs.existsSync(localPath)) paths.add(localPath);
302
- return [...paths].some(unresolvedHandoff);
303
- }
304
-
305
- function runSkipReason(input: {
306
- runDir: string;
307
- status: AsyncStatus | undefined;
308
- asyncDirRoot: string;
309
- resultsDir: string;
310
- cutoff: number;
311
- protectedRunIds: ReadonlySet<string>;
312
- waitRunIds: ReadonlySet<string>;
313
- }): string | undefined {
314
- const { runDir, status } = input;
315
- if (!status) return "invalid-status";
316
- if (!validRunId(status.runId)) return "identity-mismatch";
317
- if (path.basename(runDir) !== status.runId && !path.basename(runDir).startsWith(RUN_TOMBSTONE_PREFIX)) return "identity-mismatch";
318
- if (input.protectedRunIds.has(status.runId)) return "runtime-reference";
319
- if (input.waitRunIds.has(status.runId)) return "wait-reference";
320
- if (activeMarkerExists(input.asyncDirRoot, status.runId)) return "active-index";
321
- if (!TERMINAL_STATES.has(status.state)) return "non-terminal";
322
- if (status.mode === "workflow" || status.parentWorkflowRunId || status.workflowKey) return "workflow-reference";
323
- // A revived workflow child is a link in its key's revival chain; deleting it would cut off later revivals.
324
- if (fs.existsSync(path.join(runDir, REVIVAL_ORIGIN_FILE))) return "workflow-reference";
325
- if (hasNestedReferences(status)) return "nested-reference";
326
- if (missionReferenceBlocksReclaim(runDir, input.resultsDir, status.runId)) return "mission-reference";
327
- if (hasUnresolvedRunHandoff(runDir, status)) return "handoff-reference";
328
- if (hasResumableContract(runDir, status)) return "resumable";
329
- const timestamp = statusTimestamp(status, runDir);
330
- if (timestamp === undefined) return "unknown-age";
331
- if (timestamp > input.cutoff) return "recent";
332
- return undefined;
333
- }
334
-
335
- function parseWaitRunIds(dir: string): { runIds: Set<string>; safe: boolean } {
336
- const runIds = new Set<string>();
337
- for (const entry of listDir(dir)) {
338
- if (!entry.isFile() || !entry.name.endsWith(".json")) continue;
339
- const record = readJson(path.join(dir, entry.name));
340
- if (!record || typeof record.runId !== "string" || typeof record.expiresAt !== "number") return { runIds, safe: false };
341
- runIds.add(record.runId);
342
- }
343
- return { runIds, safe: true };
344
- }
345
-
346
- function readCursor(root: string): RetentionCursor {
347
- const value = readJson(path.join(root, CURSOR_NAME));
348
- // SAFETY: readCursor checks version === 1 and the cursor shape is the only
349
- // v1 record this store writes; the cast re-narrows the validated payload.
350
- return value?.version === 1 ? value as unknown as RetentionCursor : { version: 1 };
351
- }
352
-
353
- let currentProcessStartIdentity: Promise<string | undefined> | undefined;
354
-
355
- function processStartIdentity(pid: number): Promise<string | undefined> {
356
- // Foreign PIDs can be reused while this process lives, so resolve them afresh.
357
- if (pid !== process.pid) return computeProcessStartIdentity(pid);
358
- currentProcessStartIdentity ??= computeProcessStartIdentity(pid);
359
- return currentProcessStartIdentity;
360
- }
361
-
362
- async function computeProcessStartIdentity(pid: number): Promise<string | undefined> {
363
- if (process.platform === "linux") {
364
- try {
365
- const stat = fs.readFileSync(`/proc/${pid}/stat`).toString("utf8");
366
- const commandEnd = stat.lastIndexOf(")");
367
- if (commandEnd === -1) return undefined;
368
- const fields = stat.slice(commandEnd + 1).trim().split(/\s+/);
369
- return fields[19] ? `linux:${fields[19]}` : undefined;
370
- } catch {
371
- return undefined;
372
- }
373
- }
374
- if (process.platform === "win32") {
375
- // PowerShell takes ~0.5 s to start; a synchronous spawn would freeze the TUI.
376
- const started = await new Promise<string>((resolve) => {
377
- execFile("powershell.exe", ["-NoProfile", "-Command", `(Get-CimInstance Win32_Process -Filter "ProcessId=${pid}").CreationDate`], { encoding: "utf-8", windowsHide: true, timeout: 5_000 }, (error, stdout) => {
378
- resolve(error ? "" : stdout.trim());
379
- });
380
- });
381
- return started ? `win:${started}` : undefined;
382
- }
383
- return undefined;
384
- }
385
-
386
- function processIsAlive(pid: number): boolean | undefined {
387
- try {
388
- process.kill(pid, 0);
389
- return true;
390
- } catch (error) {
391
- const code = (error as NodeJS.ErrnoException).code;
392
- if (code === "ESRCH") return false;
393
- if (code === "EPERM") return true;
394
- return undefined;
395
- }
396
- }
397
-
398
- function parseLockOwner(lockDir: string): RetentionLockOwner | undefined {
399
- const owner = readJson(path.join(lockDir, "owner.json"));
400
- if (owner?.version !== 1
401
- || typeof owner.token !== "string"
402
- || typeof owner.pid !== "number"
403
- || !Number.isInteger(owner.pid)
404
- || owner.pid <= 0
405
- || typeof owner.hostname !== "string"
406
- || typeof owner.startedAt !== "number"
407
- || !Number.isFinite(owner.startedAt)) return undefined;
408
- if (owner.processStartIdentity !== undefined && typeof owner.processStartIdentity !== "string") return undefined;
409
- // SAFETY: parseLockOwner validates every owner field above; the cast only
410
- // re-narrows the validated JSON record to RetentionLockOwner.
411
- return owner as unknown as RetentionLockOwner;
412
- }
413
-
414
- async function staleLock(lockDir: string, now: number, options: Required<Pick<AsyncRetentionOptions, "hostname" | "isProcessAlive" | "getProcessStartIdentity">>): Promise<{ stale: boolean; token?: string }> {
415
- const owner = parseLockOwner(lockDir);
416
- if (!owner) {
417
- try {
418
- return { stale: now - fs.statSync(lockDir).mtimeMs >= LOCK_STALE_MS };
419
- } catch {
420
- return { stale: false };
421
- }
422
- }
423
- if (owner.hostname !== options.hostname) return { stale: false };
424
- const alive = options.isProcessAlive(owner.pid);
425
- if (alive === false) return { stale: true, token: owner.token };
426
- if (alive === true && owner.processStartIdentity) {
427
- const currentIdentity = await options.getProcessStartIdentity(owner.pid);
428
- if (currentIdentity !== undefined && currentIdentity !== owner.processStartIdentity) return { stale: true, token: owner.token };
429
- }
430
- return { stale: now - owner.startedAt >= LOCK_STALE_MS, token: owner.token };
431
- }
432
-
433
- function createLockDirectory(lockDir: string, owner: RetentionLockOwner): boolean {
434
- try {
435
- fs.mkdirSync(lockDir, { mode: 0o700 });
436
- } catch (error) {
437
- if ((error as NodeJS.ErrnoException).code === "EEXIST") return false;
438
- throw error;
439
- }
440
- try {
441
- fs.writeFileSync(path.join(lockDir, "owner.json"), JSON.stringify(owner), { encoding: "utf-8", mode: 0o600 });
442
- return true;
443
- } catch (error) {
444
- fs.rmSync(lockDir, { recursive: true, force: true });
445
- throw error;
446
- }
447
- }
448
-
449
- async function acquireRetentionLock(lockDir: string, owner: RetentionLockOwner, options: Required<Pick<AsyncRetentionOptions, "hostname" | "isProcessAlive" | "getProcessStartIdentity">>): Promise<boolean> {
450
- for (let attempt = 0; attempt < 4; attempt += 1) {
451
- if (createLockDirectory(lockDir, owner)) return true;
452
- const stale = await staleLock(lockDir, owner.startedAt, options);
453
- if (!stale.stale) return false;
454
- const staleKey = (stale.token ?? owner.token).replace(/[^A-Za-z0-9._-]/g, "-");
455
- const tombstone = `${lockDir}.stale-${staleKey}`;
456
- try {
457
- fs.renameSync(lockDir, tombstone);
458
- } catch (error) {
459
- const code = (error as NodeJS.ErrnoException).code;
460
- if (code === "ENOENT" || fs.existsSync(tombstone)) continue;
461
- throw error;
462
- }
463
- }
464
- return false;
465
- }
466
-
467
- function releaseRetentionLock(lockDir: string, token: string): void {
468
- if (parseLockOwner(lockDir)?.token !== token) return;
469
- fs.rmSync(lockDir, { recursive: true, force: true });
470
- }
471
-
472
- function resultRunId(candidate: ResultCandidate, data: Record<string, unknown>): string | undefined {
473
- if (typeof data.runId === "string") return data.runId;
474
- if (typeof data.id === "string") return data.id;
475
- if ((candidate.kind === "public" || candidate.kind === "pending") && path.basename(candidate.path).endsWith(".json")) return path.basename(candidate.path, ".json");
476
- return undefined;
477
- }
478
-
479
- function resultTimestamp(data: Record<string, unknown>, filePath: string): number | undefined {
480
- for (const field of RESULT_TIMESTAMP_FIELDS) {
481
- const value = data[field];
482
- if (value !== undefined && (typeof value !== "number" || !Number.isFinite(value))) return undefined;
483
- }
484
- const logical = RESULT_TIMESTAMP_FIELDS.map((field) => data[field])
485
- .filter((value): value is number => typeof value === "number" && Number.isFinite(value));
486
- try {
487
- return Math.max(fs.statSync(filePath).mtimeMs, ...logical);
488
- } catch {
489
- return undefined;
490
- }
491
- }
492
-
493
- function terminalResult(data: Record<string, unknown>): boolean {
494
- return data.success === true || data.success === false || (typeof data.state === "string" && TERMINAL_STATES.has(data.state as AsyncStatus["state"]));
495
- }
496
-
497
- function resultHasResumableSession(data: Record<string, unknown>): boolean {
498
- if (existingRegularFile(typeof data.sessionFile === "string" ? data.sessionFile : undefined)) return true;
499
- return Array.isArray(data.results) && data.results.some((value) => {
500
- if (!value || typeof value !== "object" || Array.isArray(value)) return false;
501
- const sessionFile = (value as Record<string, unknown>).sessionFile;
502
- return existingRegularFile(typeof sessionFile === "string" ? sessionFile : undefined);
503
- });
504
- }
505
-
506
- function hasUnresolvedResultHandoff(data: Record<string, unknown>): boolean {
507
- if (data.parallelHandoff === undefined) return false;
508
- if (!data.parallelHandoff || typeof data.parallelHandoff !== "object" || Array.isArray(data.parallelHandoff)) return true;
509
- const manifestPath = (data.parallelHandoff as Record<string, unknown>).path;
510
- return typeof manifestPath !== "string" || !manifestPath || unresolvedHandoff(manifestPath);
511
- }
512
-
513
- // The completion mode is an opaque JSON leaf read from the result record; callers
514
- // narrow it with typeof before use.
515
- // pi-lens-ignore: no-unknown-returns
516
- function completionMode(data: Record<string, unknown>): unknown {
517
- return data.completion && typeof data.completion === "object" && !Array.isArray(data.completion)
518
- ? (data.completion as Record<string, unknown>).mode
519
- : undefined;
520
- }
521
-
522
- function resultSkipReason(input: {
523
- candidate: ResultCandidate;
524
- data: Record<string, unknown> | undefined;
525
- asyncDirRoot: string;
526
- resultsDir: string;
527
- maintenanceRoot: string;
528
- cutoff: number;
529
- protectedRunIds: ReadonlySet<string>;
530
- waitRunIds: ReadonlySet<string>;
531
- }): string | undefined {
532
- if (!input.data) return "invalid-result";
533
- const runId = resultRunId(input.candidate, input.data);
534
- if (!runId || !validRunId(runId)) return "invalid-result";
535
- if (runTombstoneMarkerBlocks(input.maintenanceRoot, runId)) return "run-tombstone-present";
536
- if (input.protectedRunIds.has(runId)) return "runtime-reference";
537
- if (input.waitRunIds.has(runId)) return "wait-reference";
538
- if (activeMarkerExists(input.asyncDirRoot, runId)) return "active-index";
539
- if (fs.existsSync(path.join(input.asyncDirRoot, runId))) return "run-present";
540
- if (missionObserverIndexExists(input.resultsDir, runId)) return "mission-reference";
541
- if (input.data.mode === "workflow" || completionMode(input.data) === "workflow" || typeof input.data.parentWorkflowRunId === "string" || typeof input.data.workflowKey === "string") return "workflow-reference";
542
- if (hasUnresolvedResultHandoff(input.data)) return "handoff-reference";
543
- if (resultHasResumableSession(input.data)) return "resumable";
544
- if (input.candidate.kind === "archive" && fs.existsSync(path.join(input.resultsDir, "completion-replay", `${encodeURIComponent(runId)}.json`))) return "replay-reference";
545
- if (!terminalResult(input.data) && input.candidate.kind !== "replay" && input.candidate.kind !== "archive" && input.candidate.kind !== "tombstone") return "non-terminal-result";
546
- const timestamp = resultTimestamp(input.data, input.candidate.path);
547
- if (timestamp === undefined) return "unknown-age";
548
- if (timestamp > input.cutoff) return "recent";
549
- return undefined;
550
- }
551
-
552
- function appendMaintenanceLog(root: string, result: AsyncRetentionResult, now: number, deletedIds: string[]): void {
553
- fs.mkdirSync(root, { recursive: true });
554
- fs.appendFileSync(path.join(root, LOG_NAME), `${JSON.stringify({
555
- at: new Date(now).toISOString(),
556
- acquired: result.acquired,
557
- scanned: result.scanned,
558
- repairedRuns: result.repairedRuns,
559
- deletedRuns: result.deletedRuns,
560
- deletedResults: result.deletedResults,
561
- reapedTombstones: result.reapedTombstones,
562
- skipped: result.skipped,
563
- deleted: deletedIds.slice(0, ASYNC_RETENTION_BATCH_SIZE),
564
- errors: result.errors.length,
565
- rawReads: result.rawReads,
566
- sourceExhausted: result.sourceExhausted,
567
- discoveryDurationMs: result.discoveryDurationMs,
568
- commitDurationMs: result.commitDurationMs,
569
- cancelled: result.cancelled,
570
- workerFailed: result.workerFailed,
571
- durationMs: result.durationMs,
572
- })}\n`, "utf-8");
573
- }
574
-
575
- function increment(record: Record<string, number>, key: string): void {
576
- record[key] = (record[key] ?? 0) + 1;
577
- }
578
-
579
-
580
- class RetentionCancelledError extends Error {}
581
-
582
- function isRecord(value: unknown): value is Record<string, unknown> {
583
- return value !== null && typeof value === "object" && !Array.isArray(value);
584
- }
585
-
586
- function safeRelative(relative: string): boolean {
587
- return relative.length > 0 && !path.isAbsolute(relative) && !relative.split(path.sep).includes("..");
588
- }
589
-
590
- function parseDiscoveryResult(message: unknown, passId: string, runBudget: number, resultBudget: number): RetentionDiscovery {
591
- if (!isRecord(message) || message.type !== "result" || message.passId !== passId) throw new Error("Retention discovery worker returned a stale or malformed pass id.");
592
- if (!Number.isFinite(message.discoveryDurationMs) || (message.discoveryDurationMs as number) < 0) throw new Error("Retention discovery worker returned an invalid duration.");
593
- if (!Number.isInteger(message.rawReads) || (message.rawReads as number) < 0) throw new Error("Retention discovery worker returned an invalid raw-read count.");
594
- if (!isRecord(message.sourceExhausted) || Object.values(message.sourceExhausted).some((value) => typeof value !== "boolean")) throw new Error("Retention discovery worker returned invalid source telemetry.");
595
- if (!Array.isArray(message.runCandidates) || message.runCandidates.length > runBudget) throw new Error("Retention discovery worker exceeded the run budget.");
596
- if (!Array.isArray(message.resultCandidates) || message.resultCandidates.length > resultBudget) throw new Error("Retention discovery worker exceeded the result budget.");
597
- if (!Array.isArray(message.cursorOps) || message.cursorOps.length > runBudget + resultBudget + 8) throw new Error("Retention discovery worker returned invalid cursor operations.");
598
- for (const candidate of message.runCandidates) {
599
- if (!isRecord(candidate) || typeof candidate.name !== "string" || typeof candidate.relative !== "string" || !validRunId(candidate.name) || candidate.relative !== candidate.name) throw new Error("Retention discovery worker returned an unsafe run candidate.");
600
- }
601
- const resultKinds = new Set(["public", "pending", "replay", "archive", "tombstone"]);
602
- const resultKeys = new Set(["resultPublicAfter", "resultReplayAfter", "resultArchiveAfter"]);
603
- for (const candidate of message.resultCandidates) {
604
- if (!isRecord(candidate) || typeof candidate.name !== "string" || typeof candidate.relative !== "string" || path.basename(candidate.name) !== candidate.name || !safeRelative(candidate.relative) || path.basename(candidate.relative) !== candidate.name || !resultKinds.has(candidate.kind as string) || !isRecord(candidate.cursor)) throw new Error("Retention discovery worker returned an unsafe result candidate.");
605
- const cursor = candidate.cursor;
606
- if (cursor.type === "pending") {
607
- if (typeof cursor.session !== "string" || !validRunId(cursor.session) || path.dirname(candidate.relative) !== path.join("result-pending", cursor.session)) throw new Error("Retention discovery worker returned an invalid pending candidate.");
608
- } else if (cursor.type === "result") {
609
- if (typeof cursor.key !== "string" || !resultKeys.has(cursor.key)) throw new Error("Retention discovery worker returned an invalid result cursor.");
610
- const expectedDir = cursor.key === "resultPublicAfter" ? "." : cursor.key === "resultReplayAfter" ? "completion-replay" : "output-archives";
611
- if (path.dirname(candidate.relative) !== expectedDir) throw new Error("Retention discovery worker returned a result from the wrong source.");
612
- } else throw new Error("Retention discovery worker returned an invalid result cursor target.");
613
- }
614
- const scalarKeys = new Set(["runAfter", "resultPublicAfter", "resultReplayAfter", "resultArchiveAfter", "pendingSessionAfter"]);
615
- for (const operation of message.cursorOps) {
616
- if (!isRecord(operation) || typeof operation.type !== "string") throw new Error("Retention discovery worker returned a malformed cursor operation.");
617
- if (operation.type === "set" || operation.type === "delete") {
618
- if (typeof operation.key !== "string" || !scalarKeys.has(operation.key) || (operation.type === "set" && (typeof operation.value !== "string" || !safeRelative(operation.value)))) throw new Error("Retention discovery worker returned an invalid scalar cursor operation.");
619
- } else if (operation.type === "set-pending" || operation.type === "delete-pending") {
620
- if (typeof operation.session !== "string" || !validRunId(operation.session) || (operation.type === "set-pending" && (typeof operation.value !== "string" || !safeRelative(operation.value)))) throw new Error("Retention discovery worker returned an invalid pending cursor operation.");
621
- } else throw new Error("Retention discovery worker returned an unknown cursor operation.");
622
- }
623
- // SAFETY: parseDiscoveryResult validates every candidate, cursor, and scalar
624
- // operation above; the cast re-narrows the worker message to its domain type.
625
- return message as unknown as RetentionDiscovery;
626
- }
627
-
628
- function runRetentionDiscovery(input: {
629
- passId: string;
630
- asyncDirRoot: string;
631
- resultsDir: string;
632
- cursor: RetentionCursor;
633
- runBudget: number;
634
- resultBudget: number;
635
- workerUrl: URL;
636
- signal?: AbortSignal;
637
- }): Promise<RetentionDiscovery> {
638
- return new Promise((resolve, reject) => {
639
- if (input.signal?.aborted) {
640
- reject(new RetentionCancelledError("Retention discovery was cancelled."));
641
- return;
642
- }
643
- const worker = new Worker(input.workerUrl);
644
- let settled = false;
645
- const cleanup = (): void => {
646
- input.signal?.removeEventListener("abort", onAbort);
647
- void worker.terminate();
648
- };
649
- const fail = (error: Error): void => {
650
- if (settled) return;
651
- settled = true;
652
- cleanup();
653
- reject(error);
654
- };
655
- const onAbort = (): void => fail(new RetentionCancelledError("Retention discovery was cancelled."));
656
- input.signal?.addEventListener("abort", onAbort, { once: true });
657
- worker.once("error", (error) => fail(error instanceof Error ? error : new Error(String(error))));
658
- worker.once("exit", (code) => {
659
- if (!settled) fail(new Error(`Retention discovery worker exited before replying (${code}).`));
660
- });
661
- worker.once("message", (message: unknown) => {
662
- if (settled) return;
663
- try {
664
- if (isRecord(message) && message.type === "error" && message.passId === input.passId) throw new Error(`Retention discovery failed: ${String(message.error)}`);
665
- const discovery = parseDiscoveryResult(message, input.passId, input.runBudget, input.resultBudget);
666
- settled = true;
667
- cleanup();
668
- resolve(discovery);
669
- } catch (error) {
670
- fail(error instanceof Error ? error : new Error(String(error)));
671
- }
672
- });
673
- worker.postMessage({ type: "discover", passId: input.passId, asyncDirRoot: input.asyncDirRoot, resultsDir: input.resultsDir, cursor: input.cursor, runBudget: input.runBudget, resultBudget: input.resultBudget });
674
- });
675
- }
676
-
677
- function applyCursorOperations(cursor: RetentionCursor, operations: CursorOperation[]): void {
678
- for (const operation of operations) {
679
- if (operation.type === "set") cursor[operation.key] = operation.value;
680
- else if (operation.type === "delete") delete cursor[operation.key];
681
- else if (operation.type === "set-pending") {
682
- cursor.resultPendingAfterBySession ??= {};
683
- cursor.resultPendingAfterBySession[operation.session] = operation.value;
684
- } else {
685
- delete cursor.resultPendingAfterBySession?.[operation.session];
686
- if (cursor.resultPendingAfterBySession && Object.keys(cursor.resultPendingAfterBySession).length === 0) delete cursor.resultPendingAfterBySession;
687
- }
688
- }
689
- }
690
-
691
- export async function cleanupAsyncRetention(options: AsyncRetentionOptions): Promise<AsyncRetentionResult> {
692
- const startedWall = Date.now();
693
- const now = options.now ?? Date.now;
694
- const currentTime = now();
695
- const retentionMs = options.retentionMs ?? RETENTION_MS;
696
- const tombstoneGraceMs = options.tombstoneGraceMs ?? ASYNC_RETENTION_TOMBSTONE_GRACE_MS;
697
- const batchSize = Math.min(ASYNC_RETENTION_BATCH_SIZE, Math.max(1, Math.trunc(options.batchSize ?? ASYNC_RETENTION_BATCH_SIZE)));
698
- const randomId = options.randomId ?? randomUUID;
699
- const maintenanceRoot = options.maintenanceRoot ?? path.dirname(options.asyncDirRoot);
700
- const lockDir = path.join(maintenanceRoot, LOCK_NAME);
701
- const lockToken = randomId();
702
- const pid = options.pid ?? process.pid;
703
- const hostname = options.hostname ?? os.hostname();
704
- const getProcessStartIdentity = options.getProcessStartIdentity ?? processStartIdentity;
705
- const currentProcessStartIdentity = options.processStartIdentity ?? await getProcessStartIdentity(pid) ?? (pid === process.pid ? `runtime:${Math.round(Date.now() - process.uptime() * 1000)}` : undefined);
706
- const lockOwner: RetentionLockOwner = { version: 1, token: lockToken, pid, hostname, startedAt: currentTime, ...(currentProcessStartIdentity ? { processStartIdentity: currentProcessStartIdentity } : {}) };
707
- const lockOptions = { hostname, isProcessAlive: options.isProcessAlive ?? processIsAlive, getProcessStartIdentity };
708
- const result: AsyncRetentionResult = {
709
- acquired: false,
710
- scanned: 0,
711
- repairedRuns: 0,
712
- deletedRuns: 0,
713
- deletedResults: 0,
714
- reapedTombstones: 0,
715
- skipped: {},
716
- errors: [],
717
- rawReads: 0,
718
- sourceExhausted: {},
719
- discoveryDurationMs: 0,
720
- commitDurationMs: 0,
721
- cancelled: false,
722
- workerFailed: false,
723
- durationMs: 0,
724
- };
725
- const deletedIds: string[] = [];
726
- const lstatSync = options.lstatSync ?? fs.lstatSync;
727
- let commitStartedAt: number | undefined;
728
- let cursorCommitUnsafe = false;
729
- const finish = (): AsyncRetentionResult => {
730
- if (commitStartedAt !== undefined) result.commitDurationMs = Math.max(0, Date.now() - commitStartedAt);
731
- result.durationMs = Math.max(0, Date.now() - startedWall);
732
- appendMaintenanceLog(maintenanceRoot, result, currentTime, deletedIds);
733
- return result;
734
- };
735
- const markCancelled = (): boolean => {
736
- if (!options.signal?.aborted) return false;
737
- result.cancelled = true;
738
- increment(result.skipped, "cancelled");
739
- return true;
740
- };
741
- fs.mkdirSync(maintenanceRoot, { recursive: true });
742
- if (!await acquireRetentionLock(lockDir, lockOwner, lockOptions)) {
743
- increment(result.skipped, "lock-busy");
744
- return finish();
745
- }
746
- result.acquired = true;
747
- try {
748
- if (markCancelled()) return finish();
749
- const protectedRunIds = new Set(options.protectedRunIds ?? []);
750
- const cutoff = currentTime - retentionMs;
751
- const cursor = readCursor(maintenanceRoot);
752
- const runBudget = Math.ceil(batchSize / 2);
753
- const resultBudget = batchSize - runBudget;
754
- const discoveryStartedAt = Date.now();
755
- let discovery: RetentionDiscovery;
756
- try {
757
- discovery = await runRetentionDiscovery({
758
- passId: randomUUID(),
759
- asyncDirRoot: options.asyncDirRoot,
760
- resultsDir: options.resultsDir,
761
- cursor,
762
- runBudget,
763
- resultBudget,
764
- workerUrl: options.discoveryWorkerUrl ?? new URL("../../../async-retention-discovery-worker.mjs", import.meta.url),
765
- signal: options.signal,
766
- });
767
- } catch (error) {
768
- result.discoveryDurationMs = Math.max(0, Date.now() - discoveryStartedAt);
769
- if (error instanceof RetentionCancelledError) {
770
- result.cancelled = true;
771
- increment(result.skipped, "cancelled");
772
- } else {
773
- result.workerFailed = true;
774
- increment(result.skipped, "worker-failure");
775
- result.errors.push(compactError(error));
776
- }
777
- return finish();
778
- }
779
- result.discoveryDurationMs = Math.max(0, Date.now() - discoveryStartedAt);
780
- result.rawReads = discovery.rawReads;
781
- result.sourceExhausted = discovery.sourceExhausted;
782
- commitStartedAt = Date.now();
783
- if (markCancelled()) return finish();
784
- if (parseLockOwner(lockDir)?.token !== lockToken) {
785
- increment(result.skipped, "lock-owner-changed");
786
- return finish();
787
- }
788
- const waitSubscriptionsDir = options.waitSubscriptionsDir ?? path.join(maintenanceRoot, "wait-subscriptions");
789
- // This safety scan stays on the commit thread. Wait records are the active,
790
- // swept subscription set. Each destructive action re-reads it to close the
791
- // race with a newly armed wait.
792
- const waitReferences = parseWaitRunIds(waitSubscriptionsDir);
793
- if (!waitReferences.safe) {
794
- increment(result.skipped, "wait-references-unknown");
795
- return finish();
796
- }
797
- for (const entry of discovery.runCandidates) {
798
- if (markCancelled()) return finish();
799
- result.scanned += 1;
800
- const runDir = path.join(options.asyncDirRoot, entry.name);
801
- let mutationStateChanged = false;
802
- try {
803
- const stat = lstatSync(runDir);
804
- if (!stat.isDirectory() || stat.isSymbolicLink()) {
805
- increment(result.skipped, "unsafe-run-path");
806
- continue;
807
- }
808
- let status = readStatus(runDir);
809
- if (status?.state === "running"
810
- && validRunId(status.runId)
811
- && path.basename(runDir) === status.runId
812
- && !protectedRunIds.has(status.runId)) {
813
- const reconciliation = reconcileAsyncRun(runDir, {
814
- resultsDir: options.resultsDir,
815
- kill: options.reconcileKill,
816
- now,
817
- });
818
- status = reconciliation.status ?? undefined;
819
- if (reconciliation.repaired) result.repairedRuns += 1;
820
- }
821
- const initialReason = runSkipReason({ runDir, status, asyncDirRoot: options.asyncDirRoot, resultsDir: options.resultsDir, cutoff, protectedRunIds, waitRunIds: waitReferences.runIds });
822
- if (initialReason) {
823
- increment(result.skipped, initialReason);
824
- continue;
825
- }
826
- if (entry.name.startsWith(RUN_TOMBSTONE_PREFIX)) {
827
- if (!runTombstoneMarkerMatches(maintenanceRoot, status!.runId, runDir)) {
828
- increment(result.skipped, "run-tombstone-marker");
829
- continue;
830
- }
831
- if (currentTime - stat.mtimeMs < tombstoneGraceMs) {
832
- increment(result.skipped, "tombstone-grace");
833
- continue;
834
- }
835
- const freshWaitReferences = parseWaitRunIds(waitSubscriptionsDir);
836
- const finalReason = freshWaitReferences.safe ? runSkipReason({ runDir, status, asyncDirRoot: options.asyncDirRoot, resultsDir: options.resultsDir, cutoff, protectedRunIds, waitRunIds: freshWaitReferences.runIds }) : "wait-references-unknown";
837
- if (finalReason) {
838
- increment(result.skipped, `recheck-${finalReason}`);
839
- continue;
840
- }
841
- mutationStateChanged = true;
842
- fs.rmSync(runDir, { recursive: true });
843
- removeRunTombstoneMarker(maintenanceRoot, status!.runId);
844
- result.reapedTombstones += 1;
845
- deletedIds.push(`run-tombstone:${status!.runId}`);
846
- continue;
847
- }
848
- const tombstone = path.join(options.asyncDirRoot, `${RUN_TOMBSTONE_PREFIX}${randomId()}`);
849
- writeRunTombstoneMarker(maintenanceRoot, status!.runId, tombstone, currentTime);
850
- mutationStateChanged = true;
851
- try {
852
- fs.renameSync(runDir, tombstone);
853
- } catch (error) {
854
- removeRunTombstoneMarker(maintenanceRoot, status!.runId);
855
- mutationStateChanged = false;
856
- throw error;
857
- }
858
- const recheckStatus = readStatus(tombstone);
859
- const freshWaitReferences = parseWaitRunIds(waitSubscriptionsDir);
860
- const recheckReason = freshWaitReferences.safe ? runSkipReason({ runDir: tombstone, status: recheckStatus, asyncDirRoot: options.asyncDirRoot, resultsDir: options.resultsDir, cutoff, protectedRunIds, waitRunIds: freshWaitReferences.runIds }) : "wait-references-unknown";
861
- if (recheckReason) {
862
- if (!fs.existsSync(runDir)) {
863
- fs.renameSync(tombstone, runDir);
864
- mutationStateChanged = false;
865
- }
866
- removeRunTombstoneMarker(maintenanceRoot, status!.runId);
867
- if (mutationStateChanged) cursorCommitUnsafe = true;
868
- increment(result.skipped, `recheck-${recheckReason}`);
869
- continue;
870
- }
871
- fs.rmSync(tombstone, { recursive: true });
872
- removeRunTombstoneMarker(maintenanceRoot, status!.runId);
873
- result.deletedRuns += 1;
874
- deletedIds.push(`run:${status!.runId}`);
875
- } catch (error) {
876
- if (mutationStateChanged) cursorCommitUnsafe = true;
877
- if (!isNotFound(error)) result.errors.push(compactError(error));
878
- }
879
- }
880
- for (const discoveredCandidate of discovery.resultCandidates) {
881
- if (markCancelled()) return finish();
882
- result.scanned += 1;
883
- const candidate: ResultCandidate = { ...discoveredCandidate, path: path.join(options.resultsDir, discoveredCandidate.relative) };
884
- let mutationStateChanged = false;
885
- try {
886
- const stat = lstatSync(candidate.path);
887
- if (!stat.isFile() || stat.isSymbolicLink()) {
888
- increment(result.skipped, "unsafe-result-path");
889
- continue;
890
- }
891
- const data = readJson(candidate.path);
892
- const reason = resultSkipReason({ candidate, data, asyncDirRoot: options.asyncDirRoot, resultsDir: options.resultsDir, maintenanceRoot, cutoff, protectedRunIds, waitRunIds: waitReferences.runIds });
893
- if (reason) {
894
- increment(result.skipped, reason);
895
- continue;
896
- }
897
- if (candidate.kind === "tombstone") {
898
- if (currentTime - stat.mtimeMs < tombstoneGraceMs) {
899
- increment(result.skipped, "tombstone-grace");
900
- continue;
901
- }
902
- const freshWaitReferences = parseWaitRunIds(waitSubscriptionsDir);
903
- const finalReason = freshWaitReferences.safe ? resultSkipReason({ candidate, data, asyncDirRoot: options.asyncDirRoot, resultsDir: options.resultsDir, maintenanceRoot, cutoff, protectedRunIds, waitRunIds: freshWaitReferences.runIds }) : "wait-references-unknown";
904
- if (finalReason) {
905
- increment(result.skipped, `recheck-${finalReason}`);
906
- continue;
907
- }
908
- fs.rmSync(candidate.path);
909
- mutationStateChanged = true;
910
- result.reapedTombstones += 1;
911
- deletedIds.push(`result-tombstone:${resultRunId(candidate, data!)}`);
912
- continue;
913
- }
914
- const tombstone = path.join(path.dirname(candidate.path), `${RESULT_TOMBSTONE_PREFIX}${candidate.kind}-${randomId()}`);
915
- fs.renameSync(candidate.path, tombstone);
916
- mutationStateChanged = true;
917
- const tombstoneCandidate = { ...candidate, path: tombstone, kind: "tombstone" as const };
918
- const recheckData = readJson(tombstone);
919
- const freshWaitReferences = parseWaitRunIds(waitSubscriptionsDir);
920
- const recheckReason = freshWaitReferences.safe ? resultSkipReason({ candidate: tombstoneCandidate, data: recheckData, asyncDirRoot: options.asyncDirRoot, resultsDir: options.resultsDir, maintenanceRoot, cutoff, protectedRunIds, waitRunIds: freshWaitReferences.runIds }) : "wait-references-unknown";
921
- if (recheckReason) {
922
- if (!fs.existsSync(candidate.path)) {
923
- fs.renameSync(tombstone, candidate.path);
924
- mutationStateChanged = false;
925
- }
926
- if (mutationStateChanged) cursorCommitUnsafe = true;
927
- increment(result.skipped, `recheck-${recheckReason}`);
928
- continue;
929
- }
930
- fs.rmSync(tombstone);
931
- result.deletedResults += 1;
932
- deletedIds.push(`result:${resultRunId(candidate, data!)}`);
933
- } catch (error) {
934
- if (mutationStateChanged) cursorCommitUnsafe = true;
935
- if (!isNotFound(error)) result.errors.push(compactError(error));
936
- }
937
- }
938
- if (cursorCommitUnsafe) {
939
- increment(result.skipped, "commit-failure");
940
- return finish();
941
- }
942
- if (markCancelled()) return finish();
943
- if (parseLockOwner(lockDir)?.token !== lockToken) {
944
- increment(result.skipped, "lock-owner-changed");
945
- return finish();
946
- }
947
- applyCursorOperations(cursor, discovery.cursorOps);
948
- writeAtomicJson(path.join(maintenanceRoot, CURSOR_NAME), cursor);
949
- return finish();
950
- } finally {
951
- try { releaseRetentionLock(lockDir, lockToken); } catch { /* a stale lock blocks the next pass safely */ }
952
- }
953
- }