@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,2733 +0,0 @@
1
- import { accessSync, constants, readFileSync, realpathSync, statSync } from "node:fs";
2
- import { createRequire } from "node:module";
3
- import { dirname, resolve as resolvePath } from "node:path";
4
- import { Worker } from "node:worker_threads";
5
- import { DEFAULT_GLOBAL_CONCURRENCY_LIMIT, Semaphore } from "../runs/shared/parallel-utils.ts";
6
- import { HOST_STEP_MAX_COUNT } from "../runs/shared/host-step-status.ts";
7
- import { describeGateAcceptanceConflict, parseGateInput } from "../runs/shared/acceptance.ts";
8
- import type { AcceptanceRecoveryMetadata, HostStepNode, SingleResult, WorkflowScriptFailureKind } from "../shared/types.ts";
9
- import { normalizeWorkflowHostCommandParams, type WorkflowHostCommandParams, type WorkflowHostCommandResult } from "./host-command.ts";
10
-
11
- const KEY_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
12
- const BASE_REF_VALIDATION_ERROR = "baseRef must be a valid Git ref: use HEAD or a supported named ref (for example, refs/heads/main). Full 40/64-character commit IDs and revision expressions are unsupported.";
13
- function validGitRef(ref: unknown): ref is string {
14
- if (typeof ref !== "string" || !ref || ref === "@" || Buffer.byteLength(ref, "utf-8") > 1024 || ref.startsWith("/") || ref.endsWith("/") || ref.includes("//") || ref.includes("..") || ref.includes("@{")) return false;
15
- if (/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/iu.test(ref)) return false;
16
- if (/[[\]\\~^:?*\u0000-\u0020\u007f]/u.test(ref) || ref.endsWith(".") || ref.endsWith(".lock")) return false;
17
- return ref.split("/").every((component) => component.length > 0 && component !== "." && component !== ".." && !component.startsWith(".") && !component.endsWith(".") && !component.endsWith(".lock"));
18
- }
19
- const requireFromPackage = createRequire(import.meta.url);
20
- const WORKFLOW_ASSEMBLY_FLUSH_TIMEOUT_MS = 5_000;
21
-
22
- export interface WorkflowScriptValidationError {
23
- message: string;
24
- line?: number;
25
- column?: number;
26
- kind?: "spawn-budget" | "agent";
27
- }
28
-
29
- export interface WorkflowScriptValidationWarning {
30
- message: string;
31
- kind: "dynamic-spawn-count";
32
- }
33
-
34
- export interface WorkflowScriptValidationResult {
35
- ok: boolean;
36
- errors: WorkflowScriptValidationError[];
37
- warnings?: WorkflowScriptValidationWarning[];
38
- }
39
-
40
- export interface WorkflowScriptValidationOptions {
41
- maxSubagentSpawnsPerRun?: number;
42
- /** Returns why launch-time resolution would reject this literal child agent name. */
43
- agentNameError?: (name: string) => string | undefined;
44
- }
45
-
46
- const WORKER_SOURCE = String.raw`
47
- const { parentPort, workerData } = require("node:worker_threads");
48
- const vm = require("node:vm");
49
- const { inspect } = require("node:util");
50
- const { parse } = require(workerData.acornPath);
51
-
52
- let promiseHooks;
53
- try {
54
- ({ promiseHooks } = require("node:v8"));
55
- } catch {}
56
-
57
- function createWorkflowPromiseHook(callbacks) {
58
- if (!promiseHooks || typeof promiseHooks.createHook !== "function") return () => {};
59
- try {
60
- return promiseHooks.createHook(callbacks);
61
- } catch (error) {
62
- if (error?.name !== "NotImplementedError") throw error;
63
- return () => {};
64
- }
65
- }
66
-
67
- let nextCallId = 0;
68
- let topLevelWorkflowPromise;
69
- let suppressNativePromiseConsumption = 0;
70
- const activeNativePromises = [];
71
- const pending = new Map();
72
- const workflowErrorKinds = new WeakMap();
73
- const runKeyPattern = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
74
- function validGitRef(ref) {
75
- if (typeof ref !== "string" || !ref || ref === "@" || new TextEncoder().encode(ref).length > 1024 || ref.startsWith("/") || ref.endsWith("/") || ref.includes("//") || ref.includes("..") || ref.includes("@{")) return false;
76
- if (/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/iu.test(ref)) return false;
77
- if (/[[\]\\~^:?*\u0000-\u0020\u007f]/u.test(ref) || ref.endsWith(".") || ref.endsWith(".lock")) return false;
78
- return ref.split("/").every((component) => component.length > 0 && component !== "." && component !== ".." && !component.startsWith(".") && !component.endsWith(".") && !component.endsWith(".lock"));
79
- }
80
- const trackedPromiseTrackers = new WeakMap();
81
- const trackedPromiseTargets = new WeakMap();
82
- let nativePromiseTrackers = new WeakMap();
83
- let nativePromiseParents = new WeakMap();
84
- const observedCallIds = new Set();
85
-
86
- function stableRunJson(value) {
87
- if (Array.isArray(value)) return "[" + value.map(stableRunJson).join(",") + "]";
88
- if (value && typeof value === "object") return "{" + Object.keys(value).sort().map((key) => JSON.stringify(key) + ":" + stableRunJson(value[key])).join(",") + "}";
89
- return JSON.stringify(value) ?? "undefined";
90
- }
91
-
92
- function canonicalRunParams(params) {
93
- if (params.gate === undefined || params.acceptance !== false) return params;
94
- const { acceptance: _acceptance, ...withoutAcceptance } = params;
95
- return withoutAcceptance;
96
- }
97
-
98
- function isDirectWorkflowScriptPromiseHandlerCall() {
99
- const stack = new Error().stack;
100
- if (typeof stack !== "string") return false;
101
- return stack.split("\n").some((line) => line.includes("workflow-script.js") && !line.includes("at async "));
102
- }
103
-
104
- function nativePromiseTracker(promise) {
105
- if (!promise || (typeof promise !== "object" && typeof promise !== "function")) return undefined;
106
- let tracker = nativePromiseTrackers.get(promise);
107
- if (!tracker) {
108
- tracker = { observations: [], consumed: false, dependencies: [] };
109
- nativePromiseTrackers.set(promise, tracker);
110
- }
111
- return tracker;
112
- }
113
-
114
- function promiseObservationTracker(value) {
115
- if (!value || (typeof value !== "object" && typeof value !== "function")) return undefined;
116
- return trackedPromiseTrackers.get(value) ?? nativePromiseTrackers.get(value);
117
- }
118
-
119
- function addTrackerDependency(tracker, dependency) {
120
- if (!dependency) return;
121
- tracker.dependencies ??= [];
122
- if (!tracker.dependencies.includes(dependency)) tracker.dependencies.push(dependency);
123
- if (tracker.consumed) markTrackedObservationsConsumed(dependency);
124
- }
125
-
126
- function descendsFromTopLevelWorkflow(promise) {
127
- const seen = new Set();
128
- for (let current = promise; current && !seen.has(current); current = nativePromiseParents.get(current)) {
129
- if (current === topLevelWorkflowPromise) return true;
130
- seen.add(current);
131
- }
132
- return false;
133
- }
134
-
135
- function withSuppressedNativePromiseConsumption(callback) {
136
- suppressNativePromiseConsumption++;
137
- try {
138
- return callback();
139
- } finally {
140
- suppressNativePromiseConsumption--;
141
- }
142
- }
143
-
144
- function mergeObservations(...groups) {
145
- const seen = new Set();
146
- const merged = [];
147
- for (const group of groups) {
148
- for (const observation of group) {
149
- if (!observation || typeof observation.callId !== "number" || typeof observation.key !== "string" || typeof observation.operation !== "string" || seen.has(observation.callId)) continue;
150
- seen.add(observation.callId);
151
- merged.push(observation);
152
- }
153
- }
154
- return merged;
155
- }
156
-
157
- function trackedObservationTracker(value) {
158
- return value && (typeof value === "object" || typeof value === "function") ? trackedPromiseTrackers.get(value) : undefined;
159
- }
160
-
161
- function trackedPromiseTarget(value) {
162
- return value && (typeof value === "object" || typeof value === "function") ? trackedPromiseTargets.get(value) ?? value : value;
163
- }
164
-
165
- function addTrackedObservations(tracker, observations) {
166
- tracker.observations = mergeObservations(tracker.observations, observations);
167
- if (!tracker.consumed) return;
168
- for (const observation of tracker.observations) {
169
- if (observedCallIds.has(observation.callId)) continue;
170
- observedCallIds.add(observation.callId);
171
- parentPort.postMessage({ type: "callObserved", callId: observation.callId, key: observation.key, operation: observation.operation });
172
- }
173
- }
174
-
175
- function markTrackedObservationsConsumed(tracker, seen = new Set()) {
176
- if (seen.has(tracker)) return;
177
- seen.add(tracker);
178
- tracker.consumed = true;
179
- addTrackedObservations(tracker, []);
180
- for (const dependency of tracker.dependencies ?? []) markTrackedObservationsConsumed(dependency, seen);
181
- }
182
-
183
- function consumeTrackedObservations(tracker) {
184
- if (isDirectWorkflowScriptPromiseHandlerCall()) return;
185
- const activePromise = activeNativePromises.at(-1);
186
- if (activePromise === topLevelWorkflowPromise || descendsFromTopLevelWorkflow(activePromise)) {
187
- markTrackedObservationsConsumed(tracker);
188
- } else if (activePromise) {
189
- addTrackerDependency(nativePromiseTracker(activePromise), tracker);
190
- } else {
191
- markTrackedObservationsConsumed(tracker);
192
- }
193
- }
194
-
195
- function trackObservationTracker(tracker, promise, allowFutureObservations = false) {
196
- const target = trackedPromiseTarget(promise);
197
- if ((!allowFutureObservations && tracker.observations.length === 0) || !target || typeof target.then !== "function") return promise;
198
-
199
- const tracked = new Proxy(target, {
200
- get(promiseTarget, prop) {
201
- if (prop === "then") return function promiseThen(onFulfilled, onRejected) {
202
- consumeTrackedObservations(tracker);
203
- const chainTracker = { observations: tracker.observations, consumed: false, dependencies: [tracker] };
204
- const wrapHandler = (handler) => typeof handler === "function"
205
- ? function trackedThenHandler(...args) {
206
- const value = handler.apply(this, args);
207
- addTrackerDependency(chainTracker, promiseObservationTracker(value));
208
- return trackedPromiseTarget(value);
209
- }
210
- : handler;
211
- return trackObservationTracker(chainTracker, promiseTarget.then(wrapHandler(onFulfilled), wrapHandler(onRejected)), true);
212
- };
213
- if (prop === "catch") return function promiseCatch(onRejected) {
214
- consumeTrackedObservations(tracker);
215
- return trackObservationTracker({ observations: tracker.observations, consumed: false, dependencies: [tracker] }, promiseTarget.catch(onRejected), true);
216
- };
217
- if (prop === "finally") return function promiseFinally(onFinally) {
218
- consumeTrackedObservations(tracker);
219
- return trackObservationTracker({ observations: tracker.observations, consumed: false, dependencies: [tracker] }, promiseTarget.finally(onFinally), true);
220
- };
221
- return Reflect.get(promiseTarget, prop, promiseTarget);
222
- },
223
- });
224
- trackedPromiseTrackers.set(tracked, tracker);
225
- trackedPromiseTargets.set(tracked, target);
226
- return tracked;
227
- }
228
-
229
- function trackRunObservation(observations, promise) {
230
- const tracker = trackedObservationTracker(promise) ?? { observations: [], consumed: false };
231
- addTrackedObservations(tracker, observations);
232
- return trackObservationTracker(tracker, promise);
233
- }
234
-
235
- function trackPromiseCombinator(items, createPromise) {
236
- const values = Array.from(items);
237
- const dependencies = [...new Set(values.map(promiseObservationTracker).filter(Boolean))];
238
- const promise = withSuppressedNativePromiseConsumption(() => createPromise(values.map(trackedPromiseTarget)));
239
- if (dependencies.length === 0) return promise;
240
- return trackObservationTracker({ observations: [], consumed: false, dependencies }, promise, true);
241
- }
242
-
243
- const workflowPromise = new Proxy(Promise, {
244
- construct(target, [executor]) {
245
- if (typeof executor !== "function") return new target(executor);
246
- const tracker = { observations: [], consumed: false };
247
- const promise = new target((resolve, reject) => {
248
- let settled = false;
249
- try {
250
- executor((value) => {
251
- if (settled) return;
252
- settled = true;
253
- addTrackerDependency(tracker, promiseObservationTracker(value));
254
- resolve(trackedPromiseTarget(value));
255
- }, (reason) => {
256
- if (settled) return;
257
- settled = true;
258
- reject(reason);
259
- });
260
- } catch (error) {
261
- settled = true;
262
- throw error;
263
- }
264
- });
265
- return trackObservationTracker(tracker, promise, true);
266
- },
267
- get(target, prop) {
268
- if (prop === "all") return (items) => trackPromiseCombinator(items, (values) => target.all(values));
269
- if (prop === "allSettled") return (items) => trackPromiseCombinator(items, (values) => target.allSettled(values));
270
- if (prop === "race") return (items) => trackPromiseCombinator(items, (values) => target.race(values));
271
- if (prop === "any") return (items) => trackPromiseCombinator(items, (values) => target.any(values));
272
- if (prop === "resolve") return (value) => {
273
- const dependency = promiseObservationTracker(value);
274
- const promise = withSuppressedNativePromiseConsumption(() => target.resolve(trackedPromiseTarget(value)));
275
- if (!dependency) return promise;
276
- return trackObservationTracker({ observations: [], consumed: false, dependencies: [dependency] }, promise, true);
277
- };
278
- const value = target[prop];
279
- return typeof value === "function" ? value.bind(target) : value;
280
- },
281
- });
282
-
283
- function hostCall(method, args, observation) {
284
- const callId = ++nextCallId;
285
- const promise = new Promise((resolve, reject) => {
286
- pending.set(callId, { resolve, reject });
287
- parentPort.postMessage({ type: "call", callId, method, args });
288
- });
289
- return observation && typeof observation.key === "string" && typeof observation.operation === "string"
290
- ? trackRunObservation([{ key: observation.key, operation: observation.operation, callId }], promise)
291
- : promise;
292
- }
293
-
294
- function runHostCall(key, params, collectFailure, batch, generatedLaneKey) {
295
- const callId = ++nextCallId;
296
- const promise = new Promise((resolve, reject) => {
297
- pending.set(callId, { resolve, reject });
298
- parentPort.postMessage({ type: "call", callId, method: "run", args: { key, params, ...(collectFailure ? { collectFailure: true } : {}), ...(batch ? { batch } : {}), ...(generatedLaneKey ? { generatedLaneKey } : {}) } });
299
- });
300
- return { key, callId, promise };
301
- }
302
-
303
- function isArrayIndexProperty(prop) {
304
- if (!/^(0|[1-9]\d*)$/.test(prop)) return false;
305
- const index = Number(prop);
306
- return Number.isSafeInteger(index) && index >= 0 && index < 4294967295;
307
- }
308
-
309
- const runsAllResultTargets = new WeakMap();
310
-
311
- const MAX_LANES = 32;
312
- const MAX_LANE_STAGES = 16;
313
- const MAX_LANE_STAGE_COUNT = 64;
314
- const MAX_LANE_SPEC_BYTES = 64 * 1024;
315
- const MAX_LANE_TASK_BYTES = 1024 * 1024;
316
- const MAX_LANE_PATH_BYTES = 32 * 1024;
317
- const MAX_LANE_BOARD_TEXT_BYTES = 256;
318
- const LANE_PATH_FIELDS = new Set(["cwd", "output", "sessionDir"]);
319
-
320
- function runsAllKeyAccessError(prop) {
321
- return new Error("Cannot read runs.all result property '" + prop + "'. runs.all resolves to an ordered array, not a key map. Use results[0], array destructuring, or results.map((result) => result.output), not results." + prop + ".");
322
- }
323
-
324
- function wrapRunsAllResults(results, keys) {
325
- const keySet = new Set(keys);
326
- const proxy = new Proxy(results, {
327
- get(target, prop, receiver) {
328
- if (typeof prop !== "string") return Reflect.get(target, prop, receiver);
329
- if (prop === "then" || prop === "toJSON") return undefined;
330
- if (prop in target || isArrayIndexProperty(prop)) return Reflect.get(target, prop, receiver);
331
- if (keySet.has(prop)) throw runsAllKeyAccessError(prop);
332
- throw runsAllKeyAccessError(prop);
333
- },
334
- });
335
- runsAllResultTargets.set(proxy, results);
336
- return proxy;
337
- }
338
-
339
- function laneByteLength(value) {
340
- return new TextEncoder().encode(value).byteLength;
341
- }
342
-
343
- function laneBoardText(value) {
344
- if (typeof value !== "string" || !value) return undefined;
345
- if (laneByteLength(value) <= MAX_LANE_BOARD_TEXT_BYTES) return value;
346
- const bytes = new TextEncoder().encode(value).subarray(0, MAX_LANE_BOARD_TEXT_BYTES - 3);
347
- return new TextDecoder().decode(bytes) + "...";
348
- }
349
-
350
- function laneBoardPath(value) {
351
- if (typeof value !== "string" || !value || laneByteLength(value) > MAX_LANE_BOARD_TEXT_BYTES) return undefined;
352
- return value;
353
- }
354
-
355
- function validateLaneStageBounds(params, label) {
356
- if (typeof params.task === "string" && laneByteLength(params.task) > MAX_LANE_TASK_BYTES) throw new Error(label + " task exceeds 1 MiB when UTF-8 encoded.");
357
- for (const field of LANE_PATH_FIELDS) if (typeof params[field] === "string" && laneByteLength(params[field]) > MAX_LANE_PATH_BYTES) throw new Error(label + " " + field + " exceeds 32 KiB when UTF-8 encoded.");
358
- }
359
-
360
- function validateLaneKey(value, owner) {
361
- if (typeof value !== "string" || !runKeyPattern.test(value)) throw new Error(owner + " key must be 1-128 characters using letters, numbers, '.', '_' or '-', and start with a letter or number.");
362
- return value;
363
- }
364
-
365
- function laneStageParams(stage, previous) {
366
- const resume = stage.resume;
367
- const params = { ...stage.params };
368
- if (resume !== "previous") return params;
369
- if (!previous || typeof previous.runId !== "string" || !previous.runId.trim()) return undefined;
370
- return { ...params, resume: previous.runId.trim() };
371
- }
372
-
373
- function laneStageVerdict(result) {
374
- const structured = result && typeof result === "object" && !Array.isArray(result) ? result.structuredOutput : undefined;
375
- const verdict = structured && typeof structured === "object" && !Array.isArray(structured) ? structured.verdict : undefined;
376
- return typeof verdict === "string" && verdict.trim() ? laneBoardText(verdict.trim()) : undefined;
377
- }
378
-
379
- function laneStageIsBlocked(result) {
380
- const structured = result && typeof result === "object" && !Array.isArray(result) ? result.structuredOutput : undefined;
381
- return structured && typeof structured === "object" && !Array.isArray(structured) && structured.verdict === "blocked";
382
- }
383
-
384
- function laneStageRecord(stageKey, child, forcedState) {
385
- const result = child && typeof child === "object" && !Array.isArray(child) ? child : undefined;
386
- const ok = result?.ok === true;
387
- const verdict = laneStageVerdict(result);
388
- const blocked = laneStageIsBlocked(result);
389
- const state = forcedState ?? (result?.state === "running" ? "running" : result?.stopped ? "stopped" : result?.detached ? "detached" : ok ? blocked ? "blocked" : "completed" : "failed");
390
- const error = state !== "completed" && state !== "running"
391
- ? state === "blocked" && blocked
392
- ? "Stage returned a blocked verdict."
393
- : typeof result?.error === "string"
394
- ? result.error
395
- : typeof result?.output === "string"
396
- ? result.output
397
- : "Stage did not complete successfully."
398
- : undefined;
399
- return {
400
- key: stageKey,
401
- ...(typeof result?.runId === "string" && result.runId.trim() ? { runId: laneBoardText(result.runId.trim()) } : {}),
402
- ...(result ? { ok } : {}),
403
- state,
404
- ...(typeof result?.outputReference === "string" ? (laneBoardPath(result.outputReference) ? { outputReference: laneBoardPath(result.outputReference) } : {}) : {}),
405
- ...(verdict ? { verdict } : {}),
406
- ...(error ? { error: laneBoardText(error) } : {}),
407
- };
408
- }
409
-
410
- function laneFailure(stageKey, error) {
411
- const text = error instanceof Error ? error.message : String(error);
412
- return { key: stageKey, ok: false, output: text, error: text, artifactPaths: [] };
413
- }
414
-
415
- function runCollected(key, params, observe, generatedLaneKey) {
416
- validateRunCall(key, params, "runs.lanes stage", runFingerprints);
417
- const launched = runHostCall(key, params, true, undefined, generatedLaneKey);
418
- observe([{ key, operation: "run", callId: launched.callId }]);
419
- return launched.promise.then(decorateWorkflowChildResult);
420
- }
421
-
422
- function validateLaneSpecs(laneSpecs) {
423
- if (!Array.isArray(laneSpecs)) throw new Error("runs.lanes(lanes) requires an array.");
424
- if (laneSpecs.length === 0) throw new Error("runs.lanes(lanes) requires at least one lane.");
425
- if (laneSpecs.length > MAX_LANES) throw new Error("runs.lanes supports at most " + MAX_LANES + " lanes.");
426
- assertJsonValue(laneSpecs, "runs.lanes lanes");
427
- if (laneByteLength(stableRunJson(laneSpecs)) > MAX_LANE_SPEC_BYTES) throw new Error("runs.lanes canonical JSON exceeds 64 KiB.");
428
- const generatedKeys = new Set();
429
- const validationFingerprints = new Map();
430
- let stageCount = 0;
431
- const normalized = [];
432
- for (let laneIndex = 0; laneIndex < laneSpecs.length; laneIndex++) {
433
- const lane = laneSpecs[laneIndex];
434
- const laneLabel = "runs.lanes lane " + laneIndex;
435
- if (!lane || typeof lane !== "object" || Array.isArray(lane)) throw new Error(laneLabel + " must be an object.");
436
- const laneFields = Object.keys(lane);
437
- if (laneFields.some((field) => field !== "key" && field !== "stages")) throw new Error(laneLabel + " contains unsupported fields.");
438
- const laneKey = validateLaneKey(lane.key, laneLabel);
439
- if (!Array.isArray(lane.stages) || lane.stages.length === 0) throw new Error(laneLabel + " stages must contain at least one stage.");
440
- if (lane.stages.length > MAX_LANE_STAGES) throw new Error(laneLabel + " supports at most " + MAX_LANE_STAGES + " stages.");
441
- const stageKeys = new Set();
442
- const stages = [];
443
- for (let stageIndex = 0; stageIndex < lane.stages.length; stageIndex++) {
444
- stageCount++;
445
- if (stageCount > MAX_LANE_STAGE_COUNT) throw new Error("runs.lanes supports at most " + MAX_LANE_STAGE_COUNT + " total stages.");
446
- const stage = lane.stages[stageIndex];
447
- const stageLabel = laneLabel + " stage " + stageIndex;
448
- if (!stage || typeof stage !== "object" || Array.isArray(stage)) throw new Error(stageLabel + " must be an object.");
449
- const stageKey = validateLaneKey(stage.key, stageLabel);
450
- if (stageKeys.has(stageKey)) throw new Error(laneLabel + " contains duplicate stage key '" + stageKey + "'.");
451
- stageKeys.add(stageKey);
452
- const generatedKey = laneKey + "." + stageKey;
453
- validateLaneKey(generatedKey, stageLabel + " generated");
454
- if (generatedKeys.has(generatedKey)) throw new Error("runs.lanes generated child key '" + generatedKey + "' is duplicated.");
455
- generatedKeys.add(generatedKey);
456
- const resume = stage.resume;
457
- if (resume !== undefined && resume !== "previous") {
458
- if (stageIndex === 0 && typeof resume === "string") {
459
- throw new Error(stageLabel + " cannot resume a retained run id in runs.lanes; use runs.run(key, { resume: id }) outside lanes, or start the lane with an agent stage and use resume: \"previous\" later.");
460
- }
461
- throw new Error(stageLabel + " resume must be 'previous'.");
462
- }
463
- if (stageIndex === 0 && resume === "previous") throw new Error(stageLabel + " cannot resume previous without a predecessor stage.");
464
- const { key: _stageKey, resume: _resume, ...params } = stage;
465
- const validationParams = resume === "previous" ? { ...params, resume: "retained-run-placeholder" } : params;
466
- validateLaneStageBounds(validationParams, stageLabel);
467
- validateRunCall(generatedKey, validationParams, stageLabel, validationFingerprints);
468
- const existingFingerprint = runFingerprints.get(generatedKey);
469
- if (existingFingerprint !== undefined && (resume === "previous" || existingFingerprint !== stableRunJson(canonicalRunParams(params)))) {
470
- throw new Error("runs.lanes generated child key '" + generatedKey + "' is already used with incompatible launch params.");
471
- }
472
- stages.push({ key: stageKey, generatedKey, resume, params });
473
- }
474
- normalized.push({ key: laneKey, stages });
475
- }
476
- return normalized;
477
- }
478
-
479
- function runLane(lane, firstResult, observe) {
480
- const records = [];
481
- const appendSkipped = (start) => {
482
- for (let index = start; index < lane.stages.length; index++) records.push({ key: lane.stages[index].key, state: "skipped" });
483
- };
484
- const finish = (state, failedStage) => ({ key: lane.key, state, ...(failedStage ? { failedStage } : {}), stages: records });
485
- const visit = (index, previous) => {
486
- if (index >= lane.stages.length) return Promise.resolve(finish("complete"));
487
- const stage = lane.stages[index];
488
- if (index === 0) {
489
- const record = laneStageRecord(stage.key, previous);
490
- records.push(record);
491
- if (record.state !== "completed") {
492
- appendSkipped(index + 1);
493
- return Promise.resolve(finish("blocked", stage.key));
494
- }
495
- return visit(index + 1, previous);
496
- }
497
- if (stage.resume === "previous" && (!previous || typeof previous.runId !== "string" || !previous.runId.trim())) {
498
- records.push({ key: stage.key, state: "blocked", error: "Previous stage did not return a retained run id." });
499
- appendSkipped(index + 1);
500
- return Promise.resolve(finish("blocked", stage.key));
501
- }
502
- if (!previous || previous.ok !== true || laneStageIsBlocked(previous)) {
503
- records.push({ key: stage.key, state: "blocked", error: "Previous stage did not complete successfully." });
504
- appendSkipped(index + 1);
505
- return Promise.resolve(finish("blocked", stage.key));
506
- }
507
- const params = laneStageParams(stage, previous);
508
- if (!params) {
509
- records.push({ key: stage.key, state: "blocked", error: "Previous stage did not return a retained run id." });
510
- appendSkipped(index + 1);
511
- return Promise.resolve(finish("blocked", stage.key));
512
- }
513
- let launched;
514
- try {
515
- launched = runCollected(stage.generatedKey, params, observe, lane.key);
516
- } catch (error) {
517
- const failed = laneFailure(stage.generatedKey, error);
518
- records.push(laneStageRecord(stage.key, failed));
519
- appendSkipped(index + 1);
520
- return Promise.resolve(finish("blocked", stage.key));
521
- }
522
- return launched.then((result) => {
523
- const record = laneStageRecord(stage.key, result);
524
- records.push(record);
525
- if (record.state === "completed") return visit(index + 1, result);
526
- appendSkipped(index + 1);
527
- return finish("blocked", stage.key);
528
- }, (error) => {
529
- const failed = laneFailure(stage.generatedKey, error);
530
- records.push(laneStageRecord(stage.key, failed));
531
- appendSkipped(index + 1);
532
- return finish("blocked", stage.key);
533
- });
534
- };
535
- return visit(0, firstResult);
536
- }
537
-
538
- function workflowPlanStringMetadata(params) {
539
- return {
540
- ...(typeof params.phase === "string" && params.phase.trim() ? { phase: params.phase.trim() } : {}),
541
- ...(typeof params.label === "string" && params.label.trim() ? { label: params.label.trim() } : {}),
542
- ...(typeof params.agent === "string" && params.agent.trim() ? { agent: params.agent.trim() } : {}),
543
- };
544
- }
545
-
546
- function runLanes(laneSpecs) {
547
- const lanes = validateLaneSpecs(laneSpecs);
548
- parentPort.postMessage({ type: "lanePlan", lanes: lanes.map((lane) => ({
549
- key: lane.key,
550
- stages: lane.stages.map((stage) => ({
551
- key: stage.key,
552
- generatedKey: stage.generatedKey,
553
- ...workflowPlanStringMetadata(stage.params),
554
- ...(typeof stage.params.as === "string" && stage.params.as.trim() ? { outputName: stage.params.as.trim() } : {}),
555
- ...(stage.params.outputSchema ? { structured: true } : {}),
556
- })),
557
- })) });
558
- const firstItems = lanes.map((lane) => {
559
- const first = lane.stages[0];
560
- return { key: first.generatedKey, ...first.params };
561
- });
562
- // Share the runs.all batch launcher while allowing each lane to advance independently.
563
- const firstBatch = launchRunsAll(firstItems, lanes.map((lane) => lane.key));
564
- const firstResults = firstBatch.launched.map(({ promise }) => promise.then(decorateWorkflowChildResult));
565
- let trackedAggregate;
566
- const observe = (observations) => trackRunObservation(observations, trackedAggregate);
567
- const laneAggregate = Promise.all(lanes.map((lane, index) => firstResults[index].then(
568
- (result) => runLane(lane, result, observe),
569
- (error) => runLane(lane, laneFailure(lane.stages[0].generatedKey, error), observe),
570
- )));
571
- trackedAggregate = trackRunObservation(firstBatch.launched.map(({ key, callId }) => ({ key, operation: "run", callId })), laneAggregate);
572
- return trackedAggregate;
573
- }
574
-
575
- function formatRef(result) {
576
- if (!result || typeof result !== "object") throw new Error("runs.ref(result) requires a run result object.");
577
- const parts = ["run " + (result.key || "unknown")];
578
- if (result.runId) parts.push("id=" + String(result.runId).slice(0, 8));
579
- return "[" + parts.join("; ") + "]";
580
- }
581
-
582
- function formatChildResultString(result) {
583
- const output = typeof result?.output === "string" ? result.output.trim() : "";
584
- return output || formatRef(result);
585
- }
586
-
587
- function decorateWorkflowChildResult(result) {
588
- if (!result || typeof result !== "object" || Array.isArray(result)) return result;
589
- Object.defineProperties(result, {
590
- toString: { value() { return formatChildResultString(this); }, enumerable: false, configurable: true },
591
- });
592
- return result;
593
- }
594
-
595
- let runFingerprints = new Map();
596
-
597
- function validateExtensionBindings(value, label) {
598
- if (value === undefined) return;
599
- if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(label + " extensionBindings must be a plain JSON object.");
600
- const keys = Object.keys(value);
601
- if (keys.length > 16) throw new Error(label + " extensionBindings supports at most 16 namespaces.");
602
- for (const key of keys) if (!/^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,62})\/[1-9][0-9]{0,8}$/.test(key)) throw new Error(label + " extensionBindings namespace '" + key + "' must use a package-like name followed by '/<positive-version>'.");
603
- assertJsonValue(value, label + " extensionBindings");
604
- let propertyCount = 0;
605
- function visit(entry, depth) {
606
- if (!entry || typeof entry !== "object") return;
607
- if (depth > 16) throw new Error(label + " extensionBindings exceeds the maximum nesting depth of 16.");
608
- if (Array.isArray(entry)) { for (const item of entry) visit(item, depth + 1); return; }
609
- for (const child of Object.values(entry)) {
610
- propertyCount++;
611
- if (propertyCount > 256) throw new Error(label + " extensionBindings exceeds 256 total properties.");
612
- visit(child, depth + 1);
613
- }
614
- }
615
- visit(value, 0);
616
- if (new TextEncoder().encode(stableRunJson(value)).byteLength > 16384) throw new Error(label + " extensionBindings canonical JSON exceeds 16384 bytes.");
617
- }
618
-
619
- function validateLaneMetadata(value, label, workflowKey) {
620
- if (value === undefined) return;
621
- if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(label + " must be a plain JSON object.");
622
- const fields = Object.keys(value);
623
- const allowed = ["version", "key", "mode", "sourceRef", "claims", "outputPaths"];
624
- const unknown = fields.filter((field) => !allowed.includes(field));
625
- if (unknown.length > 0) throw new Error(label + " has unsupported fields: " + unknown.join(", ") + ".");
626
- if (value.version !== 1) throw new Error(label + ".version must be 1.");
627
- if (typeof value.key !== "string" || !value.key.trim() || !runKeyPattern.test(value.key.trim())) throw new Error(label + ".key is invalid.");
628
- if (workflowKey !== undefined && value.key.trim() !== workflowKey) throw new Error(label + ".key must match workflow key '" + workflowKey + "'.");
629
- if (value.mode !== undefined && !["mutation", "review", "scout", "gate"].includes(value.mode)) throw new Error(label + ".mode is invalid.");
630
- const bounded = (entry, maxBytes) => typeof entry === "string" && entry.trim() && new TextEncoder().encode(entry.trim()).byteLength <= maxBytes && !/[\r\n\u0000]/.test(entry);
631
- if (value.sourceRef !== undefined && !bounded(value.sourceRef, 128)) throw new Error(label + ".sourceRef is invalid.");
632
- for (const [name, maxItems, maxLength] of [["claims", 20, 160], ["outputPaths", 10, 256]]) {
633
- if (value[name] === undefined) continue;
634
- if (!Array.isArray(value[name]) || value[name].length > maxItems || value[name].some((entry) => !bounded(entry, maxLength))) throw new Error(label + "." + name + " is invalid.");
635
- }
636
- }
637
-
638
- // Mirrors parseGateInput in src/runs/shared/acceptance.ts; the sandbox cannot import it.
639
- function describeGateShapeError(gate) {
640
- const shape = "gate must be a non-empty command string or { command, output?: \"json\", schema?, timeoutMs? }.";
641
- if (typeof gate === "string") return gate.trim() ? undefined : shape;
642
- if (!gate || typeof gate !== "object" || Array.isArray(gate)) return shape;
643
- for (const key of Object.keys(gate)) {
644
- if (!["command", "output", "schema", "timeoutMs"].includes(key)) return "gate." + key + " is not supported.";
645
- }
646
- if (typeof gate.command !== "string" || !gate.command.trim()) return shape;
647
- if (gate.output !== undefined && gate.output !== "json") return "gate.output must be \"json\" when present.";
648
- if (gate.schema !== undefined) {
649
- if (gate.output !== "json") return "gate.schema requires gate.output: \"json\".";
650
- if (!gate.schema || typeof gate.schema !== "object" || Array.isArray(gate.schema)) return "gate.schema must be a JSON Schema object.";
651
- }
652
- if (gate.timeoutMs !== undefined && (!Number.isInteger(gate.timeoutMs) || gate.timeoutMs < 1)) return "gate.timeoutMs must be an integer >= 1.";
653
- return undefined;
654
- }
655
-
656
- function describeGateAcceptanceConflict(gate, acceptance) {
657
- const render = (value) => {
658
- let encoded;
659
- try {
660
- encoded = JSON.stringify(value) ?? String(value);
661
- } catch {
662
- encoded = String(value);
663
- }
664
- return encoded.length > 120 ? encoded.slice(0, 120) + "..." : encoded;
665
- };
666
- return " Both fields were present: gate=" + render(gate) + " acceptance=" + render(acceptance) + ".";
667
- }
668
-
669
- function validateRunCall(key, params, label, fingerprints) {
670
- if (typeof key !== "string" || !runKeyPattern.test(key)) throw new Error(label + " has an invalid key.");
671
- if (hostKeys.has(key)) throw new Error("Workflow key '" + key + "' is already used by runs.host.");
672
- if (!params || typeof params !== "object" || Array.isArray(params)) throw new Error(label + " requires a params object.");
673
- if (Object.prototype.hasOwnProperty.call(params, "action") || Object.prototype.hasOwnProperty.call(params, "workflowScript") || Object.prototype.hasOwnProperty.call(params, "globalConcurrencyLimit") || Object.prototype.hasOwnProperty.call(params, "maxSubagentSpawnsPerRun") || Object.prototype.hasOwnProperty.call(params, "tasks") || Object.prototype.hasOwnProperty.call(params, "chain") || Object.prototype.hasOwnProperty.call(params, "parallel") || Object.prototype.hasOwnProperty.call(params, "concurrency") || Object.prototype.hasOwnProperty.call(params, "chainDir")) {
674
- const hint = label === "runs.run" ? "; use runs.all(...) and JavaScript control flow for orchestration." : ".";
675
- throw new Error(label + " accepts one child via { agent, task } and execution controls only" + hint);
676
- }
677
- if (Object.prototype.hasOwnProperty.call(params, "clarify")) throw new Error(label + " does not support clarify UI.");
678
- if (params.worktree !== undefined && typeof params.worktree !== "boolean") throw new Error(label + " worktree must be true or false.");
679
- if (params.baseRef !== undefined && (typeof params.baseRef !== "string" || !validGitRef(params.baseRef))) throw new Error(label + " baseRef must be a valid Git ref: use HEAD or a supported named ref (for example, refs/heads/main). Full 40/64-character commit IDs and revision expressions are unsupported.");
680
- validateLaneMetadata(params.lane, label + " lane", key);
681
- if (params.gate !== undefined) {
682
- const gateError = describeGateShapeError(params.gate);
683
- if (gateError) throw new Error(label + " " + gateError);
684
- }
685
- if (params.gate !== undefined && params.acceptance !== undefined && params.acceptance !== false) throw new Error(label + " gate cannot be combined with acceptance; use one gate command or acceptance.verify." + describeGateAcceptanceConflict(params.gate, params.acceptance));
686
- if (params.gate !== undefined && params.resume !== undefined) throw new Error(label + " gate is not supported with retained resume.");
687
- if (params.extensionBindings !== undefined && params.resume !== undefined) throw new Error(label + " extensionBindings is not supported with retained resume; resume uses the original retained child binding.");
688
- if (params.resume !== undefined && typeof params.resume !== "string") {
689
- const reference = params.resume;
690
- if (!reference || typeof reference !== "object" || Array.isArray(reference)) throw new Error(label + " resume must be a retained run id or keyed workflow receipt reference.");
691
- const fields = Object.keys(reference);
692
- if (fields.some((field) => field !== "workflowRunId" && field !== "key" && field !== "latest")) throw new Error(label + " keyed resume contains unsupported fields.");
693
- if (typeof reference.workflowRunId !== "string" || !reference.workflowRunId.trim()) throw new Error(label + " keyed resume workflowRunId must be non-empty.");
694
- if (typeof reference.key !== "string" || !runKeyPattern.test(reference.key)) throw new Error(label + " keyed resume key is invalid.");
695
- if (reference.latest !== true) throw new Error(label + " keyed resume requires latest: true.");
696
- }
697
- if (typeof params.resume === "string" && !params.resume.trim()) throw new Error(label + " resume must be a non-empty retained run id.");
698
- if (params.resume !== undefined && params.agent !== undefined) throw new Error(label + " resume and agent are mutually exclusive.");
699
- if (params.resume !== undefined && (typeof params.task !== "string" || !params.task.trim())) throw new Error(label + " resume requires a non-empty task follow-up.");
700
- validateExtensionBindings(params.extensionBindings, label);
701
- assertJsonValue(params, label + " params");
702
- const fingerprint = stableRunJson(canonicalRunParams(params));
703
- const existing = fingerprints.get(key);
704
- if (existing !== undefined && existing !== fingerprint) throw new Error("Duplicate workflow key '" + key + "' used with incompatible launch params.");
705
- fingerprints.set(key, fingerprint);
706
- }
707
-
708
- const hostKeys = new Set();
709
-
710
- function validateHostCommand(key, params) {
711
- validateLaneKey(key, "runs.host");
712
- if (!params || typeof params !== "object" || Array.isArray(params)) throw new Error("runs.host('" + key + "') params must be an object.");
713
- const allowed = new Set(["kind", "command", "timeoutMs", "output", "role", "provider"]);
714
- const unknown = Object.keys(params).filter((field) => !allowed.has(field));
715
- if (unknown.length) {
716
- const cwdHint = unknown.includes("cwd")
717
- ? " The host step does not accept per-step cwd; commands and relative output paths use the workflow cwd. Set cwd on the outer subagent request, or put a trusted directory change in command (for example, 'cd /path/to/worktree && npm test')."
718
- : "";
719
- throw new Error("runs.host('" + key + "') params have unsupported fields: " + unknown.join(", ") + "." + cwdHint);
720
- }
721
- if (params.kind !== "command") throw new Error("runs.host('" + key + "') kind must be 'command'.");
722
- if (typeof params.command !== "string" || !params.command.trim() || params.command.includes("\u0000") || new TextEncoder().encode(params.command.trim()).byteLength > 16384) throw new Error("runs.host('" + key + "') command must be a non-empty string of at most 16384 bytes without NUL.");
723
- if (!Number.isInteger(params.timeoutMs) || params.timeoutMs < 1 || params.timeoutMs > 86400000) throw new Error("runs.host('" + key + "') timeoutMs must be an integer from 1 to 86400000.");
724
- if (params.output !== undefined && (typeof params.output !== "string" || !params.output.trim() || /^[/\\]|(?:^|[/\\])\.\.(?:[/\\]|$)/.test(params.output) || /[\u0000-\u001f\u007f]/.test(params.output) || new TextEncoder().encode(params.output.trim()).byteLength > 240)) throw new Error("runs.host('" + key + "') output must be a bounded relative path without traversal or control characters.");
725
- if (params.role !== undefined && params.role !== "ci" && params.role !== "gate") throw new Error("runs.host('" + key + "') role must be 'ci' or 'gate'.");
726
- if (params.provider !== undefined && (typeof params.provider !== "string" || !params.provider.trim() || /[\r\n\u0000]/.test(params.provider) || new TextEncoder().encode(params.provider.trim()).byteLength > 64)) throw new Error("runs.host('" + key + "') provider must be a non-empty single-line string of at most 64 bytes.");
727
- assertJsonValue(params, "runs.host('" + key + "') params");
728
- if (hostKeys.has(key) || runFingerprints.has(key)) throw new Error("Workflow key '" + key + "' is already in use.");
729
- if (hostKeys.size >= 32) throw new Error("workflowScript supports at most 32 runs.host calls.");
730
- hostKeys.add(key);
731
- }
732
-
733
- const RUNS_ALL_PERMISSIVE_WARNING = "runs.all received runs.run(...) launch promise(s) or thenable(s). Those children were already launched individually, so runs.all cannot apply batch fingerprint validation, batch grouping in the fleet view, or collectFailure semantics; a failed child will throw at the runs.all boundary instead of returning as { ok: false }. To get full runs.all semantics, pass config objects: runs.all(items.map((item) => ({ key: item.key, agent: item.agent, task: item.task }))).";
734
-
735
- function runsAllItemThenableInfo(item, index) {
736
- if (!item || typeof item !== "object" || Array.isArray(item)) return null;
737
- if (typeof item.then !== "function") return null;
738
- const tracker = promiseObservationTracker(item);
739
- const observation = tracker && Array.isArray(tracker.observations) ? tracker.observations.find((entry) => entry && entry.operation === "run") : undefined;
740
- return {
741
- key: observation && typeof observation.key === "string" ? observation.key : ("runs.all[" + index + "]"),
742
- callId: observation && typeof observation.callId === "number" ? observation.callId : null,
743
- promise: item,
744
- };
745
- }
746
-
747
- let warnedPermissiveRunsAll = false;
748
-
749
- function launchRunsAll(items, generatedLaneKeys) {
750
- if (!Array.isArray(items)) throw new Error("runs.all(items) requires an array.");
751
- const anyThenable = items.some((item, index) => runsAllItemThenableInfo(item, index) !== null);
752
- if (anyThenable) return launchRunsAllPermissive(items);
753
- const fingerprints = new Map(runFingerprints);
754
- const calls = [];
755
- for (let index = 0; index < items.length; index++) {
756
- if (!Object.prototype.hasOwnProperty.call(items, index)) throw new Error("runs.all items must not contain sparse entries.");
757
- const item = items[index];
758
- if (!item || typeof item !== "object" || Array.isArray(item)) throw new Error("runs.all item " + index + " must be an object.");
759
- const { key, ...params } = item;
760
- validateRunCall(key, params, "runs.all item " + index, fingerprints);
761
- calls.push({ key, params });
762
- }
763
- runFingerprints = fingerprints;
764
- const batch = { id: "batch-" + (++nextCallId), calls };
765
- const launched = calls.map(({ key, params }, index) => runHostCall(key, params, true, batch, generatedLaneKeys?.[index]));
766
- return { calls, launched };
767
- }
768
-
769
- function launchRunsAllPermissive(items) {
770
- if (!warnedPermissiveRunsAll) {
771
- warnedPermissiveRunsAll = true;
772
- try { capturedConsole.warn(RUNS_ALL_PERMISSIVE_WARNING); } catch { /* console emission is best-effort */ }
773
- }
774
- const fingerprints = new Map(runFingerprints);
775
- const calls = [];
776
- const launched = [];
777
- for (let index = 0; index < items.length; index++) {
778
- if (!Object.prototype.hasOwnProperty.call(items, index)) throw new Error("runs.all items must not contain sparse entries.");
779
- const item = items[index];
780
- if (!item || typeof item !== "object" || Array.isArray(item)) throw new Error("runs.all item " + index + " must be an object or a runs.run(...) launch promise.");
781
- const thenable = runsAllItemThenableInfo(item, index);
782
- if (thenable) {
783
- calls.push({ key: thenable.key, params: {} });
784
- launched.push(thenable);
785
- continue;
786
- }
787
- const { key, ...params } = item;
788
- validateRunCall(key, params, "runs.all item " + index, fingerprints);
789
- calls.push({ key, params });
790
- launched.push(null);
791
- }
792
- runFingerprints = fingerprints;
793
- return { calls, launched: launched.map((entry, index) => entry ?? runHostCall(calls[index].key, calls[index].params, false, undefined)) };
794
- }
795
-
796
- const runs = Object.freeze({
797
- run(key, params) {
798
- validateRunCall(key, params, "runs.run", runFingerprints);
799
- const launched = runHostCall(key, params, false);
800
- return trackRunObservation([{ key, operation: "run", callId: launched.callId }], launched.promise.then(decorateWorkflowChildResult));
801
- },
802
- all(items) {
803
- const { calls, launched } = launchRunsAll(items);
804
- return trackRunObservation(launched.map(({ key, callId }) => ({ key, operation: "run", callId })), trackPromiseCombinator(launched.map(({ promise }) => promise), (values) => Promise.all(values).then((results) => wrapRunsAllResults(results.map(decorateWorkflowChildResult), calls.map(({ key }) => key)))));
805
- },
806
- lanes(laneSpecs) {
807
- return runLanes(laneSpecs);
808
- },
809
- host(key, params) {
810
- validateHostCommand(key, params);
811
- return hostCall("host", { key, params }, { key, operation: "host" });
812
- },
813
- steer(key, message, options = {}) {
814
- if (typeof key !== "string" || !runKeyPattern.test(key)) throw new Error("runs.steer has an invalid key.");
815
- if (typeof message !== "string" || !message.trim()) throw new Error("runs.steer message must be a non-empty string.");
816
- if (!options || typeof options !== "object" || Array.isArray(options)) throw new Error("runs.steer options must be an object.");
817
- const allowed = new Set(["mode", "index", "ackTimeoutMs"]);
818
- for (const option of Object.keys(options)) if (!allowed.has(option)) throw new Error("runs.steer options contain unsupported field '" + option + "'.");
819
- if (options.mode !== undefined && options.mode !== "steer" && options.mode !== "follow_up" && options.mode !== "auto") throw new Error("runs.steer mode must be 'steer', 'follow_up', or 'auto'.");
820
- if (options.index !== undefined && (!Number.isInteger(options.index) || options.index < 0 || options.index > 1000000)) throw new Error("runs.steer index must be an integer between 0 and 1000000.");
821
- if (options.ackTimeoutMs !== undefined && (!Number.isInteger(options.ackTimeoutMs) || options.ackTimeoutMs < 1)) throw new Error("runs.steer ackTimeoutMs must be a positive integer.");
822
- return hostCall("steer", { key, message: message.trim(), options }, { key, operation: "steer" });
823
- },
824
- status(keyOrRunId) { return hostCall("status", { keyOrRunId }); },
825
- ref: formatRef,
826
- refs(results) {
827
- if (!Array.isArray(results)) throw new Error("runs.refs(results) requires an array.");
828
- return results.map(formatRef).join("\n");
829
- },
830
- });
831
-
832
- function validateStateKey(key) {
833
- if (typeof key !== "string" || !runKeyPattern.test(key)) throw new Error("state key must be 1-128 characters using letters, numbers, '.', '_' or '-', and start with a letter or number.");
834
- return key;
835
- }
836
-
837
- const state = Object.freeze({
838
- get(key) { return hostCall("state.get", { key: validateStateKey(key) }); },
839
- set(key, value) {
840
- const validKey = validateStateKey(key);
841
- assertJsonValue(value, "state.set('" + validKey + "') value");
842
- return hostCall("state.set", { key: validKey, value });
843
- },
844
- });
845
-
846
- let contextObjectPrototype;
847
-
848
- const capturedConsole = Object.freeze(Object.fromEntries(
849
- ["log", "info", "warn", "error"].map((level) => [level, (...args) => {
850
- parentPort.postMessage({ type: "console", level, text: args.map((value) => typeof value === "string" ? value : inspect(value, { depth: 4, breakLength: 120 })).join(" ") });
851
- }]),
852
- ));
853
-
854
- function formatWorkflowScriptSyntaxError(error) {
855
- const details = formatWorkflowScriptError(error);
856
- return [
857
- "workflowScript must be valid JavaScript.",
858
- "If task text contains Markdown fences or backticks, use an array joined with \"\\n\" or escaped strings instead of a raw backtick template literal.",
859
- "",
860
- "Original SyntaxError:",
861
- details,
862
- ].join("\n");
863
- }
864
-
865
- function formatWorkflowScriptError(error) {
866
- const message = error && typeof error.message === "string" ? error.message : String(error);
867
- const stack = error && typeof error.stack === "string" ? error.stack : "";
868
- if (!stack) return message;
869
- return stack.includes(message) ? stack : message + "\n" + stack;
870
- }
871
-
872
- function isSyntaxError(error) {
873
- return error instanceof SyntaxError || error?.name === "SyntaxError";
874
- }
875
-
876
- function postWorkflowError(error) {
877
- // Pre-run syntax and portability errors are tagged "validation" where the script is compiled;
878
- // anything reaching here was thrown while the script ran, including a runtime SyntaxError.
879
- const taggedKind = error && (typeof error === "object" || typeof error === "function") ? workflowErrorKinds.get(error) : undefined;
880
- parentPort.postMessage({ type: "error", error: isSyntaxError(error) ? formatWorkflowScriptSyntaxError(error) : formatWorkflowScriptError(error), errorKind: taggedKind ?? "script" });
881
- }
882
-
883
- process.on("unhandledRejection", postWorkflowError);
884
-
885
- const NESTED_ASYNC_WORKFLOW_ERROR = "workflowScript validation failed before child launch; no children launched. workflowScript does not support nested async functions. Use top-level await, plain helper functions that return runs.run(...), or explicit Promise chains so workflows stay portable across Node and Bun. Parallel plus sequential rewrite: const a = runs.run(\"a\", { agent: \"worker\", task: \"A\" }); const writer = await runs.run(\"writer\", { agent: \"worker\", task: \"Write\" }); const review = await runs.run(\"review\", { agent: \"reviewer\", task: writer.output }); const [aResult] = await Promise.all([a]); return { a: aResult.output, issue: { writerRunId: writer.runId, reviewRunId: review.runId } };";
886
- const AST_SCALAR_KEYS = new Set(["type", "start", "end"]);
887
-
888
- function assertPortableWorkflowScript(source) {
889
- const wrapped = "(async () => {\n" + source + "\n})()";
890
- let ast;
891
- try {
892
- ast = parse(wrapped, { ecmaVersion: "latest", sourceType: "script" });
893
- } catch (error) {
894
- // The wrapper adds one line before the script; report the script's own line.
895
- if (isSyntaxError(error) && typeof error.message === "string") {
896
- const message = error.message.replace(/\((\d+):(\d+)\)$/, (_match, line, column) => "(" + Math.max(1, Number(line) - 1) + ":" + column + ")");
897
- if (typeof error.stack === "string") error.stack = error.stack.replace(error.message, message);
898
- error.message = message;
899
- }
900
- throw error;
901
- }
902
- const wrapper = workflowWrapperFunction(ast);
903
- walkWorkflowAst(wrapper.body, wrapper);
904
- }
905
-
906
- function workflowWrapperFunction(ast) {
907
- const wrapper = ast.body?.[0]?.expression?.callee;
908
- if (!wrapper || wrapper.type !== "ArrowFunctionExpression") throw new Error("workflowScript wrapper parse invariant failed.");
909
- return wrapper;
910
- }
911
-
912
- function isAsyncFunctionNode(node) {
913
- return node.async === true && (node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression");
914
- }
915
-
916
- function walkWorkflowAst(node, allowedAsyncFunction) {
917
- if (!node || typeof node !== "object") return;
918
- if (Array.isArray(node)) {
919
- for (const item of node) walkWorkflowAst(item, allowedAsyncFunction);
920
- return;
921
- }
922
- if (node !== allowedAsyncFunction && isAsyncFunctionNode(node)) {
923
- throw new Error(NESTED_ASYNC_WORKFLOW_ERROR);
924
- }
925
- for (const [key, child] of Object.entries(node)) {
926
- if (AST_SCALAR_KEYS.has(key)) continue;
927
- walkWorkflowAst(child, allowedAsyncFunction);
928
- }
929
- }
930
-
931
- function assertJsonValue(value, path = "emit", seen = new Set()) {
932
- if (value === null || typeof value === "string" || typeof value === "boolean") return;
933
- if (typeof value === "number") {
934
- if (!Number.isFinite(value)) throw new Error(path + " must contain only finite JSON numbers.");
935
- return;
936
- }
937
- if (typeof value !== "object") throw new Error(path + " must be a JSON value; received " + typeof value + ".");
938
- if (seen.has(value)) throw new Error(path + " must not contain cycles.");
939
- seen.add(value);
940
- if (Array.isArray(value)) {
941
- for (let index = 0; index < value.length; index++) {
942
- if (!Object.prototype.hasOwnProperty.call(value, index)) throw new Error(path + " must not contain sparse array entries.");
943
- assertJsonValue(value[index], path + "[" + index + "]", seen);
944
- }
945
- } else {
946
- const prototype = Object.getPrototypeOf(value);
947
- if (prototype !== null && prototype !== Object.prototype && prototype !== contextObjectPrototype) throw new Error(path + " must contain only plain JSON objects.");
948
- if (Object.getOwnPropertySymbols(value).length > 0) throw new Error(path + " must not contain symbol keys.");
949
- for (const [key, entry] of Object.entries(value)) assertJsonValue(entry, path + "." + key, seen);
950
- }
951
- seen.delete(value);
952
- }
953
-
954
- function isPlainWorkflowObject(value) {
955
- if (!value || typeof value !== "object" || Array.isArray(value)) return false;
956
- const prototype = Object.getPrototypeOf(value);
957
- return prototype === null || prototype === Object.prototype || prototype === contextObjectPrototype;
958
- }
959
-
960
- function unwrapRunsAllResults(value, seen = new Map()) {
961
- if (value === null || typeof value !== "object") return value;
962
- const runsAllTarget = runsAllResultTargets.get(value);
963
- const target = runsAllTarget || value;
964
- if (seen.has(target)) return seen.get(target);
965
- if (Array.isArray(target)) {
966
- const copy = [];
967
- seen.set(target, copy);
968
- let changed = !!runsAllTarget;
969
- for (let index = 0; index < target.length; index++) {
970
- copy[index] = unwrapRunsAllResults(target[index], seen);
971
- changed ||= copy[index] !== target[index];
972
- }
973
- return changed ? copy : target;
974
- }
975
- if (!isPlainWorkflowObject(target) || Object.getOwnPropertySymbols(target).length > 0) return target;
976
- let changed = false;
977
- const entries = Object.entries(target).map(([key, entry]) => {
978
- const unwrapped = unwrapRunsAllResults(entry, seen);
979
- changed ||= unwrapped !== entry;
980
- return [key, unwrapped];
981
- });
982
- return changed ? Object.fromEntries(entries) : target;
983
- }
984
-
985
- function omitUndefinedWorkflowValues(value, seen = new Set()) {
986
- if (value === null || typeof value !== "object") return value;
987
- if (seen.has(value)) return value;
988
- seen.add(value);
989
- const normalized = Array.isArray(value)
990
- ? value.map((entry) => entry === undefined ? null : omitUndefinedWorkflowValues(entry, seen))
991
- : isPlainWorkflowObject(value) && Object.getOwnPropertySymbols(value).length === 0
992
- ? Object.fromEntries(Object.entries(value).flatMap(([key, entry]) => entry === undefined ? [] : [[key, omitUndefinedWorkflowValues(entry, seen)]]))
993
- : value;
994
- seen.delete(value);
995
- return normalized;
996
- }
997
-
998
- function deepFreezeWorkflowArgs(value) {
999
- if (value === null || typeof value !== "object" || Object.isFrozen(value)) return value;
1000
- for (const entry of Object.values(value)) deepFreezeWorkflowArgs(entry);
1001
- return Object.freeze(value);
1002
- }
1003
-
1004
- parentPort.on("message", async (message) => {
1005
- if (message.type === "response") {
1006
- const entry = pending.get(message.callId);
1007
- if (!entry) return;
1008
- pending.delete(message.callId);
1009
- if (message.ok) entry.resolve(message.value);
1010
- else {
1011
- const error = new Error(message.error);
1012
- if (message.errorKind === "child" || message.errorKind === "detached-child") workflowErrorKinds.set(error, message.errorKind);
1013
- entry.reject(error);
1014
- }
1015
- return;
1016
- }
1017
- if (message.type !== "start") return;
1018
- try {
1019
- const sandbox = { runs, Promise: workflowPromise, emit(value) { const unwrapped = unwrapRunsAllResults(value); const emittedValue = unwrapped === undefined ? null : omitUndefinedWorkflowValues(unwrapped); assertJsonValue(emittedValue); parentPort.postMessage({ type: "emit", value: emittedValue }); }, console: capturedConsole };
1020
- if (message.stateEnabled) sandbox.state = state;
1021
- const context = vm.createContext(sandbox, { codeGeneration: { strings: false, wasm: false } });
1022
- contextObjectPrototype = vm.runInContext("Object.prototype", context);
1023
- // Rebuild args inside the VM realm: a worker-realm object would expose the worker's unrestricted
1024
- // Function through args.constructor.constructor, bypassing codeGeneration.strings: false.
1025
- sandbox.args = deepFreezeWorkflowArgs(vm.runInContext("JSON.parse", context)(JSON.stringify(message.args ?? {})));
1026
- let compiled;
1027
- try {
1028
- assertPortableWorkflowScript(message.script);
1029
- compiled = new vm.Script("(async () => {\n" + message.script + "\n})()", { filename: "workflow-script.js", lineOffset: -1 });
1030
- } catch (error) {
1031
- parentPort.postMessage({ type: "error", errorKind: "validation", error: isSyntaxError(error) ? formatWorkflowScriptSyntaxError(error) : formatWorkflowScriptError(error) });
1032
- return;
1033
- }
1034
- const nativePromisePrototype = vm.runInContext("(async () => {})().constructor.prototype", context);
1035
- const nativeThenDescriptor = Object.getOwnPropertyDescriptor(nativePromisePrototype, "then");
1036
- if (!nativeThenDescriptor || typeof nativeThenDescriptor.value !== "function") throw new Error("workflowScript could not inspect the VM Promise.prototype.then method.");
1037
- const nativeThen = nativeThenDescriptor.value;
1038
- let stopWorkflowPromiseHook;
1039
- let value;
1040
- try {
1041
- // Some hosts freeze built-ins in every realm, which makes then read-only. The promise hooks
1042
- // below still track observation, so skip the wrapper rather than fail every workflow.
1043
- if (nativeThenDescriptor.configurable) Object.defineProperty(nativePromisePrototype, "then", {
1044
- ...nativeThenDescriptor,
1045
- value: function workflowPromiseThen(...args) {
1046
- if (isDirectWorkflowScriptPromiseHandlerCall() || suppressNativePromiseConsumption > 0) {
1047
- return withSuppressedNativePromiseConsumption(() => Reflect.apply(nativeThen, this, args));
1048
- }
1049
- return Reflect.apply(nativeThen, this, args);
1050
- },
1051
- });
1052
- stopWorkflowPromiseHook = createWorkflowPromiseHook({
1053
- before(promise) {
1054
- activeNativePromises.push(promise);
1055
- },
1056
- after(promise) {
1057
- const index = activeNativePromises.lastIndexOf(promise);
1058
- if (index !== -1) activeNativePromises.splice(index, 1);
1059
- },
1060
- init(promise, parent) {
1061
- const childTracker = nativePromiseTracker(promise);
1062
- if (!parent) return;
1063
- nativePromiseParents.set(promise, parent);
1064
- const parentTracker = nativePromiseTracker(parent);
1065
- addTrackerDependency(childTracker, parentTracker);
1066
- const activePromise = activeNativePromises.at(-1);
1067
- if (activePromise && activePromise !== parent) {
1068
- addTrackerDependency(nativePromiseTracker(activePromise), parentTracker);
1069
- } else if (!activePromise && suppressNativePromiseConsumption === 0) {
1070
- markTrackedObservationsConsumed(parentTracker);
1071
- }
1072
- },
1073
- });
1074
- const workflowResultPromise = compiled.runInContext(context);
1075
- topLevelWorkflowPromise = workflowResultPromise;
1076
- markTrackedObservationsConsumed(nativePromiseTracker(workflowResultPromise));
1077
- value = await workflowResultPromise;
1078
- } finally {
1079
- try {
1080
- stopWorkflowPromiseHook?.();
1081
- } finally {
1082
- try {
1083
- if (nativeThenDescriptor.configurable) Object.defineProperty(nativePromisePrototype, "then", nativeThenDescriptor);
1084
- } finally {
1085
- topLevelWorkflowPromise = undefined;
1086
- activeNativePromises.length = 0;
1087
- suppressNativePromiseConsumption = 0;
1088
- nativePromiseTrackers = new WeakMap();
1089
- nativePromiseParents = new WeakMap();
1090
- }
1091
- }
1092
- }
1093
- const persistedValue = value === undefined ? null : omitUndefinedWorkflowValues(value);
1094
- try {
1095
- assertJsonValue(persistedValue, "return");
1096
- } catch (error) {
1097
- parentPort.postMessage({ type: "error", errorKind: "return-serialization", errorPhase: "return-serialization", error: formatWorkflowScriptError(error) });
1098
- return;
1099
- }
1100
- parentPort.postMessage({ type: "complete", value: persistedValue });
1101
- } catch (error) {
1102
- postWorkflowError(error);
1103
- }
1104
- });
1105
- `;
1106
-
1107
- export interface WorkflowScriptChildResult {
1108
- key: string;
1109
- /** True only for successfully completed child work, never for a launch receipt. */
1110
- ok: boolean;
1111
- /** An explicit async launch returned before a final child result was available. */
1112
- state?: "running";
1113
- asyncDir?: string;
1114
- lane?: import("../shared/types.ts").WorkflowLaneMetadata;
1115
- terminalOutcome?: import("../shared/types.ts").WorkflowTerminalOutcome;
1116
- stopped?: boolean;
1117
- /** Canonical child agent name when launch resolution produced one. */
1118
- agent?: string;
1119
- runId?: string;
1120
- output: string;
1121
- error?: string;
1122
- detached?: boolean;
1123
- interrupted?: boolean;
1124
- structuredOutput?: unknown;
1125
- requestedContext?: "fresh" | "fork";
1126
- resolvedContext?: "fresh" | "fork" | "mixed";
1127
- outputReference?: string;
1128
- /** A file produced by the child runtime (output or worktree handoff), not its job directory. */
1129
- outputArtifactPath?: string;
1130
- recovery?: AcceptanceRecoveryMetadata;
1131
- outputPathMapping?: { requestedPath: string; savedPath: string };
1132
- externalAdapter?: import("../shared/types.ts").ExternalCliReceiptMetadata;
1133
- resumability?: { state: "resumable" } | { state: "not-resumable"; reason: string };
1134
- continuation?: { runIds: string[] };
1135
- artifactPaths: string[];
1136
- results?: SingleResult[];
1137
- /** Came from a runtime-replaced run of the same script and args (its saved result, or its still-running child re-attached); this run launched nothing. */
1138
- reused?: boolean;
1139
- }
1140
-
1141
- export interface WorkflowScriptTraceEntry {
1142
- operation: "run" | "status" | "steer" | "host";
1143
- key: string;
1144
- state: "started" | "completed" | "failed" | "detached" | "stopped" | "reused" | "queued" | "delivered" | "missed";
1145
- /** Canonical child agent name when resolved launch or result data is available. */
1146
- agent?: string;
1147
- runId?: string;
1148
- durationMs?: number;
1149
- phase?: string;
1150
- label?: string;
1151
- error?: string;
1152
- /** Internal provenance for a generated runs.lanes child key. */
1153
- generatedLaneKey?: string;
1154
- lane?: import("../shared/types.ts").WorkflowLaneMetadata;
1155
- warning?: string;
1156
- /** The settled result came from a previous run of the same script and args; no child was launched. */
1157
- reused?: boolean;
1158
- }
1159
-
1160
- /** Bounded plan metadata emitted when a workflow materializes a runs.lanes graph. */
1161
- export interface WorkflowLanePlanStage {
1162
- key: string;
1163
- generatedKey: string;
1164
- agent?: string;
1165
- phase?: string;
1166
- label?: string;
1167
- outputName?: string;
1168
- structured?: boolean;
1169
- }
1170
-
1171
- export interface WorkflowLanePlan {
1172
- key: string;
1173
- stages: WorkflowLanePlanStage[];
1174
- }
1175
-
1176
- export interface WorkflowSteerOptions {
1177
- mode?: "steer" | "follow_up" | "auto";
1178
- index?: number;
1179
- ackTimeoutMs?: number;
1180
- }
1181
-
1182
- export interface WorkflowSteerResult {
1183
- key: string;
1184
- state: "queued" | "delivered" | "missed" | "failed";
1185
- requestId?: string;
1186
- deliveryStatus?: "queued" | "delivered";
1187
- targets?: Array<{ index: number; state: string; reason?: string }>;
1188
- error?: string;
1189
- }
1190
-
1191
- export interface WorkflowReceiptResumeReference {
1192
- workflowRunId: string;
1193
- key: string;
1194
- latest: true;
1195
- }
1196
-
1197
- export interface WorkflowResolvedResumeReference {
1198
- runId: string;
1199
- runIds?: string[];
1200
- }
1201
-
1202
- export interface WorkflowScriptResult {
1203
- value: unknown;
1204
- emits: unknown[];
1205
- console: Array<{ level: "log" | "info" | "warn" | "error"; text: string }>;
1206
- trace: WorkflowScriptTraceEntry[];
1207
- children: WorkflowScriptChildResult[];
1208
- }
1209
-
1210
- function isWorkflowScriptFailureKind(value: unknown): value is WorkflowScriptFailureKind {
1211
- return value === "validation" || value === "script" || value === "child" || value === "return-serialization" || value === "timeout" || value === "detached-child" || value === "runtime";
1212
- }
1213
-
1214
- function taggedWorkflowError(message: string, kind: WorkflowScriptFailureKind): Error & { workflowErrorKind: WorkflowScriptFailureKind } {
1215
- return Object.assign(new Error(message), { workflowErrorKind: kind });
1216
- }
1217
-
1218
- export class WorkflowScriptError extends Error {
1219
- readonly partial: Omit<WorkflowScriptResult, "value">;
1220
- readonly errorKind?: WorkflowScriptFailureKind;
1221
-
1222
- constructor(message: string, partial: Omit<WorkflowScriptResult, "value">, errorKind?: WorkflowScriptFailureKind, options?: ErrorOptions) {
1223
- super(message, options);
1224
- this.name = "WorkflowScriptError";
1225
- this.partial = partial;
1226
- this.errorKind = errorKind;
1227
- }
1228
- }
1229
-
1230
- export type WorkflowChildSettledOutcome = "completed" | "failed" | "paused" | "stopped";
1231
-
1232
- export interface WorkflowChildSettledNotification {
1233
- workflowRunId: string;
1234
- childKey: string;
1235
- childRunId?: string;
1236
- outcome: WorkflowChildSettledOutcome;
1237
- outputReference?: string;
1238
- error?: string;
1239
- workflowRunning: boolean;
1240
- /** The script-visible result, exactly as returned to the script. */
1241
- result: WorkflowScriptChildResult;
1242
- }
1243
-
1244
- export interface RunWorkflowScriptOptions {
1245
- script: string;
1246
- /** Normalized raw-script input exposed as the deeply frozen sandbox global `args`. */
1247
- args?: Readonly<Record<string, unknown>>;
1248
- /** Parent-session cwd used to recover a stale process cwd. */
1249
- processCwd?: string;
1250
- /** Workflow run ID for notifications. Required when onChildSettled is provided. */
1251
- workflowRunId?: string;
1252
- /** Host-only first-slice admission context. It is never sent to the workflow worker. */
1253
- oneUsePermit?: { claim: (key: string) => string | undefined };
1254
- timeoutMs?: number;
1255
- signal?: AbortSignal;
1256
- /** Let an async workflow flush pure result assembly after reload once every child is terminal. */
1257
- continueAfterAbortWhenChildrenSettled?: (abortError: Error) => boolean;
1258
- /** Maximum children executing concurrently within this workflow. Defaults to 20. */
1259
- globalConcurrencyLimit?: number;
1260
- admit?: (calls: Array<{ key: string; params: Record<string, unknown> }>, signal: AbortSignal) => void | Promise<void>;
1261
- launch: (key: string, params: Record<string, unknown>, signal: AbortSignal, admission: { admitted: boolean; batch: boolean }) => Promise<WorkflowScriptChildResult>;
1262
- resolveResume?: (reference: WorkflowReceiptResumeReference | string, signal: AbortSignal, index?: number) => string | WorkflowResolvedResumeReference | Promise<string | WorkflowResolvedResumeReference>;
1263
- status: (keyOrRunId: string, signal: AbortSignal) => Promise<WorkflowScriptChildResult>;
1264
- steer?: (key: string, message: string, options: WorkflowSteerOptions, signal: AbortSignal) => Promise<WorkflowSteerResult>;
1265
- host?: (key: string, params: WorkflowHostCommandParams, signal: AbortSignal) => Promise<WorkflowHostCommandResult>;
1266
- onHostStep?: (hostStep: HostStepNode) => void;
1267
- state?: {
1268
- get: (key: string) => unknown | Promise<unknown>;
1269
- set: (key: string, value: unknown) => void | Promise<void>;
1270
- };
1271
- registerStopChild?: (stop: ((key: string, message?: string) => boolean) | undefined) => void;
1272
- onTrace?: (trace: WorkflowScriptTraceEntry[]) => void;
1273
- onLanePlan?: (lanes: WorkflowLanePlan[]) => void;
1274
- onEmit?: (emits: unknown[]) => void;
1275
- onChildSettled?: (notification: WorkflowChildSettledNotification) => void;
1276
- }
1277
-
1278
- function combinedAbortSignal(signals: AbortSignal[]): AbortSignal {
1279
- const controller = new AbortController();
1280
- const abort = (signal: AbortSignal): void => {
1281
- if (controller.signal.aborted) return;
1282
- controller.abort(signal.reason);
1283
- };
1284
- for (const signal of signals) {
1285
- if (signal.aborted) {
1286
- abort(signal);
1287
- break;
1288
- }
1289
- signal.addEventListener("abort", () => abort(signal), { once: true });
1290
- }
1291
- return controller.signal;
1292
- }
1293
-
1294
- function isRecord(value: unknown): value is Record<string, unknown> {
1295
- return !!value && typeof value === "object" && !Array.isArray(value);
1296
- }
1297
-
1298
- function isAcceptanceMetadataRecovery(result: WorkflowScriptChildResult): boolean {
1299
- return !result.ok
1300
- && result.recovery?.status === "available-for-review"
1301
- && result.recovery.reason === "acceptance-metadata-rejected";
1302
- }
1303
-
1304
- const RECOVERY_REVIEW_MUTATION_VERB_PATTERN = /\b(?:add(?:ing)?|append(?:ing)?|apply(?:ing)?|cherry[ -]pick(?:ing)?|change|changing|clean(?:ing)?|commit(?:ting)?|cop(?:y|ying)|create|creating|delete|deleting|edit(?:ing)?|fix(?:ing)?|implement(?:ing)?|insert(?:ing)?|make|making|merge|merging|mov(?:e|ing)|modify(?:ing)?|mutate|mutating|open(?:ing)?|patch(?:ing)?|prepend(?:ing)?|push(?:ing)?|rebase|rebasing|refactor(?:ing)?|remove|removing|rename|renaming|replace|replacing|revert(?:ing)?|revise|revising|rewrite|rewriting|sav(?:e|ing)|stag(?:e|ing)|stash(?:ing)?|tag(?:ging)?|touch(?:ing)?|update|updating|write|writing)\b/i;
1305
- const RECOVERY_REVIEW_READ_ONLY_PATTERN = /\b(?:read[- ]only|review only|only return findings|return findings only|suggest fixes only|without\s+(?:editing|modifying|changing|writing|touching)|do not\s+(?:edit|modify|change|write|touch)|don't\s+(?:edit|modify|change|write|touch)|must not\s+(?:edit|modify|change|write|touch))\b/i;
1306
- const RECOVERY_REVIEW_NO_MUTATION_CLAUSE_PATTERN = /\b(?:do not|don't|must not)\s+(?:edit|modify|change|write|touch)(?:\s+files?)?(?:\s*,\s*(?:commit|push|comment|merge|launch(?:\s+subagents?)?)(?=\s*(?:,|\bor\b|[.;!?\n)]|$)))*(?:\s*,?\s*or\s+(?:commit|push|comment|merge|launch(?:\s+subagents?)?)(?=\s*(?:[.;!?\n)]|$)))?/gi;
1307
- const RECOVERY_REVIEW_DELIVERABLE_PATTERN = /\b(?:compose|create|draft|prepare|produce|write)\s+(?:(?:a|an|the|your)\s+)?(?:findings?|review|report|summary|analysis|recommendations?)(?:\s+(?:to|at|in)\s+\S+)?/gi;
1308
- const RECOVERY_REVIEW_CONTEXT_OBJECT_PATTERN = /\breview\s+(?:(?:the|this|that|saved)\s+)?(?:patch|diff|changes?|implementation|report)\b/gi;
1309
- const RECOVERY_REVIEW_MUTATION_NOUN_CONTEXT_PATTERN = /\b(?:later\s+real\s+)?update\s+imperatives?\b/gi;
1310
- const RECOVERY_REVIEW_PRIOR_FIX_CONTEXT_PATTERN = /\bthe\s+prior\s+fix\s+keeps\b/gi;
1311
- const RECOVERY_REVIEW_DETECTION_CONTEXT_PATTERN = /\b(?:mutation\s+detection\s+now\s+includes\s+move\/rename\/copy\s+file\s+mutation\s+imperatives|delegation\s+detection\s+now\s+blocks\s+get\/let\/have\/tell\/ask\s+follow-up\s+forms)(?=[,.;!?\n]|\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b|$)/gi;
1312
- const RECOVERY_REVIEW_PATTERN_CHANGE_CONTEXT_PATTERN = /\bRECOVERY_REVIEW_MUTATION_VERB_PATTERN\s+now\s+includes\s+append,\s+prepend,\s+and\s+sav(?:e|ing)\b(?=\s*(?:[,.;!?\n)]|$))/gi;
1313
- const RECOVERY_REVIEW_GIT_PATTERN_CHANGE_CONTEXT_PATTERN = /\bfixed\s+mutating\s+git\s+follow-up\s+bypasses\b|\b(?:added|adding)\s+[a-z][a-z-]*(?:\/[a-z][a-z-]*)*(?:(?:\s*,\s*(?:and\s+)?|\s+and\s+)[a-z][a-z-]*(?:\/[a-z][a-z-]*)*)*\s+to\s+the\s+(?:mutation\s+imperative|mutating\s+git\s+command)\s+pattern\b|\band\s+[a-z][a-z-]*(?:\/[a-z][a-z-]*)*(?:(?:\s*,\s*(?:and\s+)?|\s+and\s+)[a-z][a-z-]*(?:\/[a-z][a-z-]*)*)*\s+to\s+the\s+mutating\s+git\s+command\s+pattern\b/gi;
1314
- const RECOVERY_REVIEW_VALIDATION_EVIDENCE_PATTERN = /\bvalidation(?:\s+after\s+fix)?\s*:/gi;
1315
- const RECOVERY_REVIEW_CONTRACT_PROHIBITION_PATTERN = /\b(?:do not|don't|must not)\s+(?:mutate\s+durable\s+state|launch\s+(?:mutating|destructive|mutating\/destructive)\s+work)(?:\s+or\s+(?:mutate\s+durable\s+state|launch\s+(?:mutating|destructive|mutating\/destructive)\s+work))*/gi;
1316
- const RECOVERY_REVIEW_ONLY_REVIEW_CONTRACT_PATTERN = /\bmay\s+only\s+launch\s+explicit\s+read-only\s+review\s+children\s+with\s+acceptance:false\b/gi;
1317
- const RECOVERY_REVIEW_BLOCKED_CONTEXT_FRAGMENT_PATTERN = /\bstate\.set, runs\.host, runs\.steer, ordinary\/mutating children, and destructive command wording are blocked(?=[,.;!?\n)\]}]|$)/gi;
1318
- const RECOVERY_REVIEW_REGRESSION_EVIDENCE_PATTERN = /\b(?:existing regressions cover plain rm and git clean\/reset\/restore|prior regressions covering rm\/git clean as evidence only)(?=[,.;!?\n)\]}]|$)/gi;
1319
- const RECOVERY_REVIEW_BLOCKED_QUOTED_EXAMPLE_PATTERN = /(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+")(?:(?:\s*,\s*(?:and\s+)?|\s+and\s+)(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+"))*\s+(?:is|are|remains?)\s+(?:blocked|(?:an?\s+)?blocked\s+examples?)(?=[,.;!?\n)\]}]|$)/gi;
1320
- const RECOVERY_REVIEW_CONTEXT_QUOTED_EXAMPLE_PATTERN = /\b(?:examples?|phrasing|forms|variants):\s*(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+")(?:(?:\s*,\s*(?:and\s+)?|\s+and\s+)(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+"))*/gi;
1321
- const RECOVERY_REVIEW_LISTED_BLOCKED_EXAMPLE_PATTERN = /(?:^|[.;!?\n]\s*)blocked\s+examples:\s*(?:\r?\n[ \t]*(?:[-*]|\d+[.)])\s+[^\r\n]+)+/gim;
1322
- const RECOVERY_REVIEW_BLOCKS_QUOTED_EXAMPLE_PATTERN = /\b(?:this\s+)?blocks?\s+examples?\s+like\s+(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+")(?:(?:\s*,\s*(?:and\s+)?|\s+and\s+)(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+"))*/gi;
1323
- const RECOVERY_REVIEW_EXAMPLES_LIKE_BLOCKED_PATTERN = /\bexamples?\s+like\s+(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+")(?:(?:\s*,\s*(?:and\s+)?|\s+and\s+)(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+"))*\s+(?:is|are|remains?)\s+blocked\b/gi;
1324
- const RECOVERY_REVIEW_QUOTED_VISIBLE_BLOCKED_PATTERN = /(?:\b(?:(?:the\s+)?examples?|commands?\s+hidden\s+in)\s+|(?:^|[\s([{]))(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+")(?:(?:\s*,\s*(?:and\s+|or\s+)?|\s+(?:and|or)\s+)(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+"))*\s+(?:(?:is|are|remains?)\s+)?visible\s+and\s+blocked\b/gi;
1325
- const RECOVERY_REVIEW_PROMPTS_LIKE_BLOCKED_PATTERN = /\bdescribed\s+prompts?\s+like\s+Run\s+git\s+rebase\s+main,\s+git\s+rebase\s+main,\s+Run\s+git\s+cherry-pick\s+abc123,\s+cherry-pick\s+abc123,\s+and\s+Stage\s+the\s+changed\s+files\s+as\s+blocked\b/gi;
1326
- const RECOVERY_REVIEW_GIT_MUTATIONS_BROADER_CONTEXT_PATTERN = /\bpositive\s+git\s+mutations\s+are\s+broader:\s*git\s+branch\s+-D\s+old,\s+git\s+tag\s+-d\s+v1\.0,\s+git\s+stash,\s+git\s+revert\s+abc123,\s+and\s+natural\s+cherry\s+pick\s+abc123\s+now\s+trips?\s+the\s+recovery\s+barrier\b/gi;
1327
- const RECOVERY_REVIEW_GIT_COVERAGE_CONTEXT_PATTERN = /\bbroadened\s+positive\s+git\s+mutation\s+coverage\s+for\s+natural\s+`cherry\s+pick`,\s+`revert`,\s+`stash`,\s+`tag`,\s+plus\s+git\s+`branch\|revert\|stash\|tag`/gi;
1328
- const RECOVERY_REVIEW_REGRESSION_QUOTED_EXAMPLE_PATTERN = /\b(?:added\s+)?exact\s+regressions?\s+for\s+(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+")(?:(?:\s*,\s*(?:and\s+)?|\s+and\s+)(?:`[^`\n]+`|'[^'\n]+'|"[^"\n]+"))*/gi;
1329
- const RECOVERY_REVIEW_REGRESSION_ANAPHORIC_EXAMPLE_PATTERN = /\b(?:added\s+)?exact\s+regressions?\s+for\s+(?:do|run|execute|perform|apply)\s+(?:it|that|this|(?:the\s+)?(?:(?:previous(?:ly)?|prior|above|quoted|blocked)\s+){0,4}(?:command|example|operation|action|phrase|instruction|request))(?:[\s,]+(?:now|still|again|really|actually|immediately)){0,3}[\s,]+anyway(?:(?:\s*,\s*(?:and\s+)?|\s+and\s+)(?:do|run|execute|perform|apply)\s+(?:it|that|this|(?:the\s+)?(?:(?:previous(?:ly)?|prior|above|quoted|blocked)\s+){0,4}(?:command|example|operation|action|phrase|instruction|request))(?:[\s,]+(?:now|still|again|really|actually|immediately)){0,3}[\s,]+anyway)*/gi;
1330
- const RECOVERY_REVIEW_REGRESSION_FOLLOWED_BY_ANAPHORIC_PATTERN = /\badded\s+(?:exact\s+)?regressions?\s+for\s+quoted\s+rm\s+remaining\s+blocked\s+followed\s+by\s+execute\s+the\s+previous\s+command\b(?=\s*(?:[,.;!?\n)]|\bwhile\b|$))/gi;
1331
- const RECOVERY_REVIEW_REGRESSION_FOLLOWED_BY_NAMED_RM_PATTERN = /\b(?:added\s+)?(?:exact\s+)?regressions?\s+for\s+quoted\s+rm\s+remaining\s+blocked\s+followed\s+by\s+(?:do|run|execute|perform|apply)\s+(?:it|that|this|(?:the\s+)?(?:(?:previous(?:ly)?|prior|above|quoted|blocked)\s+){0,4}(?:command|example|operation|action|phrase|instruction|request))(?:[\s,]+(?:now|still|again|really|actually|immediately)){0,3}(?:[\s,]+anyway)?(?=\s*(?:[,.;!?\n)]|\bwhile\b|$))/gi;
1332
- const RECOVERY_REVIEW_BLOCKED_LIVE_VARIANT_CONTEXT_PATTERN = /\b(?:while\s+)?keeping\s+live-command\s+variants\s+such\s+as\s+followed\s+by\s+execute\s+the\s+previous\s+command\s+then\s+update\s+tests\s+blocked\b(?=\s*(?:[,.;!?\n)]|$))/gi;
1333
- const RECOVERY_REVIEW_ANAPHORIC_REFERENCES_CONTEXT_PATTERN = /\bdirect\s+anaphoric\s+references\s+now\s+include\s+numeric\s+and\s+word\s+ordinals\s+through\s+tenth\s+plus\s+one,\s+so\s+(?:do|run|execute|perform|apply)\s+(?:it|that|this|(?:the\s+)?(?:(?:\d+(?:st|nd|rd|th)|first|second|third|fourth|fifth|sixth|seventh|eighth|ninth|tenth|last|next|previous(?:ly)?|prior|above|quoted|blocked)\s+){0,4}(?:command|example|operation|action|phrase|instruction|request|one))(?:[\s,]+(?:right|now|still|again|really|actually|immediately)){0,4}[\s,]+anyway(?:(?:\s*,\s*(?:and\s+)?|\s+and\s+)(?:do|run|execute|perform|apply)\s+(?:it|that|this|(?:the\s+)?(?:(?:\d+(?:st|nd|rd|th)|first|second|third|fourth|fifth|sixth|seventh|eighth|ninth|tenth|last|next|previous(?:ly)?|prior|above|quoted|blocked)\s+){0,4}(?:command|example|operation|action|phrase|instruction|request|one))(?:[\s,]+(?:right|now|still|again|really|actually|immediately)){0,4}[\s,]+anyway)*\s+(?:is|are|remains?)\s+blocked\b(?:\s+after\s+quoted\s+destructive\s+examples\s+are\s+scrubbed)?/gi;
1334
- const RECOVERY_REVIEW_NO_ANAPHORIC_MUTATION_CLAUSE_PATTERN = /\b(?:do not|don't|must not)\s+(?:do|run|execute|perform|apply)\s+(?:it|that|this|(?:the\s+)?(?:(?:\d+(?:st|nd|rd|th)|first|second|third|fourth|fifth|sixth|seventh|eighth|ninth|tenth|last|next|previous(?:ly)?|prior|above|quoted|blocked)\s+){0,4}(?:command|example|operation|action|phrase|instruction|request|one))(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n—–-]){0,80}/gi;
1335
- const RECOVERY_REVIEW_NO_DELEGATION_CLAUSE_PATTERN = /\b(?:do not|don't|must not)\s+(?:(?:launch|start|spawn|run)\b(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n])*(?:workers?|reviewers?|agents?|subagents?|children|child|runs?)|(?:get|let|request|hand\s+off|assign|use|have|tell)\b(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n])*(?:workers?|reviewers?|agents?|subagents?|children|child)|(?:get|let|have|tell|request)\b(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n])*(?:review|implementation|fix(?:es)?|changes?|follow-up)\b(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n])*\b(?:from|with|via|by)\b(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n])*(?:workers?|reviewers?|agents?|subagents?|children|child)|ask\b(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n])*(?:(?:workers?|reviewers?|agents?|subagents?|children|child)\b(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n])*\b(?:continue|implement|review|fix|edit|write|modify|change|patch|update|delete|remove|create|follow-up)|(?:review|implementation|fix(?:es)?|changes?|follow-up)\b(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n])*\b(?:from|via)\b(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n])*(?:workers?|reviewers?|agents?|subagents?|children|child)))\b/gi;
1336
- const RECOVERY_REVIEW_DELEGATION_PATTERN = /\b(?:launch|start|spawn|run)\b[^,.;!?\n]*(?:workers?|reviewers?|agents?|subagents?|children|child|runs?)\b|\b(?:delegate|hand\s+off|assign)\s+(?:remediation|implementation(?:\s+follow-up)?|changes?|fix(?:es)?|follow-up)\s+to\s+(?:(?:a|an|the)\s+)?(?:workers?|reviewers?|agents?|subagents?|children|child)\b|\b(?:get|let|have|tell|request)\b[^,.;!?\n]*(?:workers?|reviewers?|agents?|subagents?|children|child)\b[^,.;!?\n]*\b(?:continue|implement|review|fix|edit|write|modify|change|patch|update|delete|remove|create|follow-up)\b|\b(?:get|let|have|tell|request)\b[^,.;!?\n]*(?:review|implementation|fix(?:es)?|changes?|follow-up)\b[^,.;!?\n]*\b(?:from|with|via|by)\b[^,.;!?\n]*(?:workers?|reviewers?|agents?|subagents?|children|child)\b|\bask\b[^,.;!?\n]*(?:(?:workers?|reviewers?|agents?|subagents?|children|child)\b[^,.;!?\n]*\b(?:continue|implement|review|fix|edit|write|modify|change|patch|update|delete|remove|create|follow-up)|(?:review|implementation|fix(?:es)?|changes?|follow-up)\b[^,.;!?\n]*\b(?:from|via)\b[^,.;!?\n]*(?:workers?|reviewers?|agents?|subagents?|children|child))\b|\buse\b[^,.;!?\n]*(?:workers?|reviewers?|agents?|subagents?|children|child|runs?)\s+(?:for|to)\s+(?:implementation|follow-up|remediation|fix|edit|write|modify|change|patch|update|delete|remove|create)\b/i;
1337
- const RECOVERY_REVIEW_ANAPHORIC_MUTATION_PATTERN = /\b(?:do|run|execute|perform|apply)\s+(?:it|that|this|(?:the\s+)?(?:(?:\d+(?:st|nd|rd|th)|first|second|third|fourth|fifth|sixth|seventh|eighth|ninth|tenth|last|next|previous(?:ly)?|prior|above|quoted|blocked)\s+){0,4}(?:command|example|operation|action|phrase|instruction|request|one))(?!(?:\s+(?:(?:now|still|also|already)\s+)*(?:is|are|remains?)\s+blocked\b))(?:(?:[\s,]+\w+){0,4}[\s,]+anyway|(?:(?!\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b)[^,.;!?\n]){0,80})(?=\s*(?:[,.;!?\n)]|\b(?:and|but|then|however|nevertheless|nonetheless|yet)\b|$))/i;
1338
- const RECOVERY_REVIEW_DESTRUCTIVE_COMMAND_PATTERN = /(?:^|[\s;,.`'"([{])(?:\S*\/)?(?:rm|rmdir|unlink|truncate|mv|cp|chmod|chown)\b|\bgit\b(?:\s+(?:-[A-Za-z](?:\s+(?:"[^"\n]*"|'[^'\n]*'|\S+))?|--(?:git-dir|work-tree|namespace|exec-path|config-env)(?:=(?:"[^"\n]*"|'[^'\n]*'|\S+)|\s+(?:"[^"\n]*"|'[^'\n]*'|\S+))|--[A-Za-z0-9-]+(?:=(?:"[^"\n]*"|'[^'\n]*'|\S+))?))*\s+(?:add|branch|cherry-pick|clean|commit|merge|rebase|reset|restore|revert|stash|tag|checkout|switch)\b/i;
1339
- const RECOVERY_REVIEW_DASH_LIVE_ACTION_PATTERN = /(?:[—–]|--|\s-\s|:|\s\/\s)\s*(?:then\s+)?(?:(?:add|append|apply|change|cherry[ -]pick|clean|commit|copy|create|delete|edit|fix|implement|insert|make|merge|move|modify|mutate|open|patch|prepend|push|rebase|refactor|remove|rename|replace|revert|revise|rewrite|save|stage|stash|tag|touch|update|write)\b|(?:launch|start|spawn|run)\b[^,.;!?\n]*(?:workers?|reviewers?|agents?|subagents?|children|child|runs?)\b|(?:\S*\/)?(?:rm|rmdir|unlink|truncate|mv|cp|chmod|chown)\b|git\b[^,.;!?\n]*\b(?:add|branch|cherry-pick|clean|commit|merge|rebase|reset|restore|revert|stash|tag|checkout|switch)\b)/i;
1340
-
1341
- function isExplicitReadOnlyRecoveryReview(params: Record<string, unknown>): boolean {
1342
- const agent = typeof params.agent === "string" ? params.agent.trim() : "";
1343
- const task = typeof params.task === "string" ? params.task.trim() : "";
1344
- const taskDestructiveCommandText = task
1345
- .replace(RECOVERY_REVIEW_BLOCKED_CONTEXT_FRAGMENT_PATTERN, " ")
1346
- .replace(RECOVERY_REVIEW_REGRESSION_EVIDENCE_PATTERN, " ")
1347
- .replace(RECOVERY_REVIEW_BLOCKED_QUOTED_EXAMPLE_PATTERN, " ")
1348
- .replace(RECOVERY_REVIEW_CONTEXT_QUOTED_EXAMPLE_PATTERN, " ")
1349
- .replace(RECOVERY_REVIEW_LISTED_BLOCKED_EXAMPLE_PATTERN, " ")
1350
- .replace(RECOVERY_REVIEW_BLOCKS_QUOTED_EXAMPLE_PATTERN, " ")
1351
- .replace(RECOVERY_REVIEW_EXAMPLES_LIKE_BLOCKED_PATTERN, " ")
1352
- .replace(RECOVERY_REVIEW_QUOTED_VISIBLE_BLOCKED_PATTERN, " ")
1353
- .replace(RECOVERY_REVIEW_PROMPTS_LIKE_BLOCKED_PATTERN, " ")
1354
- .replace(RECOVERY_REVIEW_GIT_MUTATIONS_BROADER_CONTEXT_PATTERN, " ")
1355
- .replace(RECOVERY_REVIEW_GIT_COVERAGE_CONTEXT_PATTERN, " ")
1356
- .replace(RECOVERY_REVIEW_REGRESSION_FOLLOWED_BY_NAMED_RM_PATTERN, " ");
1357
- const taskDashLiveActionText = task
1358
- .replace(RECOVERY_REVIEW_DELIVERABLE_PATTERN, " ")
1359
- .replace(RECOVERY_REVIEW_CONTEXT_OBJECT_PATTERN, " ")
1360
- .replace(RECOVERY_REVIEW_MUTATION_NOUN_CONTEXT_PATTERN, " ")
1361
- .replace(RECOVERY_REVIEW_PRIOR_FIX_CONTEXT_PATTERN, " ")
1362
- .replace(RECOVERY_REVIEW_DETECTION_CONTEXT_PATTERN, " ")
1363
- .replace(RECOVERY_REVIEW_PATTERN_CHANGE_CONTEXT_PATTERN, " ")
1364
- .replace(RECOVERY_REVIEW_GIT_PATTERN_CHANGE_CONTEXT_PATTERN, " ")
1365
- .replace(RECOVERY_REVIEW_VALIDATION_EVIDENCE_PATTERN, " ")
1366
- .replace(RECOVERY_REVIEW_CONTRACT_PROHIBITION_PATTERN, " ")
1367
- .replace(RECOVERY_REVIEW_ONLY_REVIEW_CONTRACT_PATTERN, " ")
1368
- .replace(RECOVERY_REVIEW_BLOCKED_QUOTED_EXAMPLE_PATTERN, " ")
1369
- .replace(RECOVERY_REVIEW_CONTEXT_QUOTED_EXAMPLE_PATTERN, " ")
1370
- .replace(RECOVERY_REVIEW_LISTED_BLOCKED_EXAMPLE_PATTERN, " ")
1371
- .replace(RECOVERY_REVIEW_BLOCKS_QUOTED_EXAMPLE_PATTERN, " ")
1372
- .replace(RECOVERY_REVIEW_EXAMPLES_LIKE_BLOCKED_PATTERN, " ")
1373
- .replace(RECOVERY_REVIEW_QUOTED_VISIBLE_BLOCKED_PATTERN, " ")
1374
- .replace(RECOVERY_REVIEW_PROMPTS_LIKE_BLOCKED_PATTERN, " ")
1375
- .replace(RECOVERY_REVIEW_GIT_MUTATIONS_BROADER_CONTEXT_PATTERN, " ")
1376
- .replace(RECOVERY_REVIEW_GIT_COVERAGE_CONTEXT_PATTERN, " ")
1377
- .replace(RECOVERY_REVIEW_REGRESSION_QUOTED_EXAMPLE_PATTERN, " ")
1378
- .replace(RECOVERY_REVIEW_REGRESSION_ANAPHORIC_EXAMPLE_PATTERN, " ")
1379
- .replace(RECOVERY_REVIEW_REGRESSION_FOLLOWED_BY_ANAPHORIC_PATTERN, " ")
1380
- .replace(RECOVERY_REVIEW_BLOCKED_LIVE_VARIANT_CONTEXT_PATTERN, " ")
1381
- .replace(RECOVERY_REVIEW_ANAPHORIC_REFERENCES_CONTEXT_PATTERN, " ");
1382
- const taskMutationText = task
1383
- .replace(RECOVERY_REVIEW_DELIVERABLE_PATTERN, " ")
1384
- .replace(RECOVERY_REVIEW_CONTEXT_OBJECT_PATTERN, " ")
1385
- .replace(RECOVERY_REVIEW_MUTATION_NOUN_CONTEXT_PATTERN, " ")
1386
- .replace(RECOVERY_REVIEW_PRIOR_FIX_CONTEXT_PATTERN, " ")
1387
- .replace(RECOVERY_REVIEW_DETECTION_CONTEXT_PATTERN, " ")
1388
- .replace(RECOVERY_REVIEW_PATTERN_CHANGE_CONTEXT_PATTERN, " ")
1389
- .replace(RECOVERY_REVIEW_GIT_PATTERN_CHANGE_CONTEXT_PATTERN, " ")
1390
- .replace(RECOVERY_REVIEW_VALIDATION_EVIDENCE_PATTERN, " ")
1391
- .replace(RECOVERY_REVIEW_CONTRACT_PROHIBITION_PATTERN, " ")
1392
- .replace(RECOVERY_REVIEW_ONLY_REVIEW_CONTRACT_PATTERN, " ")
1393
- .replace(RECOVERY_REVIEW_BLOCKED_CONTEXT_FRAGMENT_PATTERN, " ")
1394
- .replace(RECOVERY_REVIEW_REGRESSION_EVIDENCE_PATTERN, " ")
1395
- .replace(RECOVERY_REVIEW_BLOCKED_QUOTED_EXAMPLE_PATTERN, " ")
1396
- .replace(RECOVERY_REVIEW_CONTEXT_QUOTED_EXAMPLE_PATTERN, " ")
1397
- .replace(RECOVERY_REVIEW_LISTED_BLOCKED_EXAMPLE_PATTERN, " ")
1398
- .replace(RECOVERY_REVIEW_BLOCKS_QUOTED_EXAMPLE_PATTERN, " ")
1399
- .replace(RECOVERY_REVIEW_EXAMPLES_LIKE_BLOCKED_PATTERN, " ")
1400
- .replace(RECOVERY_REVIEW_QUOTED_VISIBLE_BLOCKED_PATTERN, " ")
1401
- .replace(RECOVERY_REVIEW_PROMPTS_LIKE_BLOCKED_PATTERN, " ")
1402
- .replace(RECOVERY_REVIEW_GIT_MUTATIONS_BROADER_CONTEXT_PATTERN, " ")
1403
- .replace(RECOVERY_REVIEW_GIT_COVERAGE_CONTEXT_PATTERN, " ")
1404
- .replace(RECOVERY_REVIEW_REGRESSION_QUOTED_EXAMPLE_PATTERN, " ")
1405
- .replace(RECOVERY_REVIEW_REGRESSION_ANAPHORIC_EXAMPLE_PATTERN, " ")
1406
- .replace(RECOVERY_REVIEW_REGRESSION_FOLLOWED_BY_ANAPHORIC_PATTERN, " ")
1407
- .replace(RECOVERY_REVIEW_BLOCKED_LIVE_VARIANT_CONTEXT_PATTERN, " ")
1408
- .replace(RECOVERY_REVIEW_ANAPHORIC_REFERENCES_CONTEXT_PATTERN, " ")
1409
- .replace(RECOVERY_REVIEW_NO_ANAPHORIC_MUTATION_CLAUSE_PATTERN, " ")
1410
- .replace(RECOVERY_REVIEW_NO_DELEGATION_CLAUSE_PATTERN, " ")
1411
- .replace(RECOVERY_REVIEW_NO_MUTATION_CLAUSE_PATTERN, " ")
1412
- .replace(new RegExp(RECOVERY_REVIEW_READ_ONLY_PATTERN.source, "gi"), " ");
1413
- return params.acceptance === false
1414
- && agent !== ""
1415
- && /\b(?:advisor|oracle|review|reviewer)\b/i.test(agent)
1416
- && RECOVERY_REVIEW_READ_ONLY_PATTERN.test(task)
1417
- && !RECOVERY_REVIEW_DESTRUCTIVE_COMMAND_PATTERN.test(taskDestructiveCommandText)
1418
- && !RECOVERY_REVIEW_MUTATION_VERB_PATTERN.test(taskMutationText)
1419
- && !RECOVERY_REVIEW_DELEGATION_PATTERN.test(taskMutationText)
1420
- && !RECOVERY_REVIEW_ANAPHORIC_MUTATION_PATTERN.test(taskMutationText)
1421
- && !RECOVERY_REVIEW_DESTRUCTIVE_COMMAND_PATTERN.test(taskMutationText)
1422
- && !RECOVERY_REVIEW_DASH_LIVE_ACTION_PATTERN.test(taskDashLiveActionText);
1423
- }
1424
-
1425
- function recoveryBarrierMessage(sourceKey: string, target: string): string {
1426
- return `Run '${target}' cannot launch after run '${sourceKey}' returned rejected acceptance recovery; only explicit read-only review children with acceptance:false may follow.`;
1427
- }
1428
-
1429
- function isPlainJsonObject(value: unknown): value is Record<string, unknown> {
1430
- if (!isRecord(value)) return false;
1431
- const prototype = Object.getPrototypeOf(value);
1432
- return prototype === null || prototype === Object.prototype;
1433
- }
1434
-
1435
- function parseWorkflowResumeReference(value: unknown): WorkflowReceiptResumeReference | undefined {
1436
- if (!isRecord(value)) return undefined;
1437
- const fields = Object.keys(value);
1438
- if (fields.some((field) => field !== "workflowRunId" && field !== "key" && field !== "latest")) throw new Error("keyed resume contains unsupported fields.");
1439
- if (typeof value.workflowRunId !== "string" || !value.workflowRunId.trim()) throw new Error("keyed resume workflowRunId must be non-empty.");
1440
- const key = validateKey(value.key, "keyed resume");
1441
- if (value.latest !== true) throw new Error("keyed resume requires latest: true.");
1442
- return { workflowRunId: value.workflowRunId.trim(), key, latest: true };
1443
- }
1444
-
1445
- function omitUndefinedWorkflowValues(value: unknown, seen = new Set<object>()): unknown {
1446
- if (value === null || typeof value !== "object") return value;
1447
- if (seen.has(value)) return value;
1448
- seen.add(value);
1449
- const normalized = Array.isArray(value)
1450
- ? value.map((entry) => entry === undefined ? null : omitUndefinedWorkflowValues(entry, seen))
1451
- : isPlainJsonObject(value)
1452
- ? Object.fromEntries(Object.entries(value).flatMap(([key, entry]) => entry === undefined ? [] : [[key, omitUndefinedWorkflowValues(entry, seen)]]))
1453
- : value;
1454
- seen.delete(value);
1455
- return normalized;
1456
- }
1457
-
1458
- function omitNonJsonWorkflowResultMetadata(value: unknown): unknown {
1459
- const normalized = omitUndefinedWorkflowValues(value);
1460
- if (!isPlainJsonObject(normalized) || !Object.hasOwn(normalized, "results")) return normalized;
1461
- try {
1462
- assertWorkflowJsonValue(normalized.results, "runs.run result.results");
1463
- return normalized;
1464
- } catch {
1465
- const { results: _results, ...safeResult } = normalized;
1466
- return safeResult;
1467
- }
1468
- }
1469
-
1470
- export function assertWorkflowJsonValue(value: unknown, path = "value", seen = new Set<object>()): void {
1471
- if (value === null || typeof value === "string" || typeof value === "boolean") return;
1472
- if (typeof value === "number") {
1473
- if (!Number.isFinite(value)) throw new Error(`${path} must contain only finite JSON numbers.`);
1474
- return;
1475
- }
1476
- if (typeof value !== "object") throw new Error(`${path} must be a JSON value; received ${typeof value}.`);
1477
- if (seen.has(value)) throw new Error(`${path} must not contain cycles.`);
1478
- seen.add(value);
1479
- if (Array.isArray(value)) {
1480
- for (let index = 0; index < value.length; index++) {
1481
- if (!Object.hasOwn(value, index)) throw new Error(`${path} must not contain sparse array entries.`);
1482
- assertWorkflowJsonValue(value[index], `${path}[${index}]`, seen);
1483
- }
1484
- } else {
1485
- const prototype = Object.getPrototypeOf(value);
1486
- if (prototype !== null && prototype !== Object.prototype) throw new Error(`${path} must contain only plain JSON objects.`);
1487
- if (Object.getOwnPropertySymbols(value).length > 0) throw new Error(`${path} must not contain symbol keys.`);
1488
- for (const [key, entry] of Object.entries(value)) assertWorkflowJsonValue(entry, `${path}.${key}`, seen);
1489
- }
1490
- seen.delete(value);
1491
- }
1492
-
1493
- export function formatWorkflowJsonPreview(value: unknown, maxLength: number): string | undefined {
1494
- try {
1495
- assertWorkflowJsonValue(value);
1496
- const serialized = JSON.stringify(value);
1497
- if (typeof serialized !== "string") return undefined;
1498
- // Serialized JSON never ends in "…", so the suffix always means the preview was cut.
1499
- return serialized.length > maxLength ? `${serialized.slice(0, maxLength)}…` : serialized;
1500
- } catch {
1501
- return undefined;
1502
- }
1503
- }
1504
-
1505
- function workflowReturnRecoveryHint(children: WorkflowScriptChildResult[]): string {
1506
- if (children.length === 0) return " Return only plain JSON data. For a child result, select fields such as { runId: child.runId, ok: child.ok, outputReference: child.outputReference }.";
1507
- const references = children.slice(0, 10).map((child) => {
1508
- const fields = [child.runId ? `runId=${child.runId.slice(0, 500)}` : undefined, child.outputReference ? `outputReference=${child.outputReference.slice(0, 500)}` : undefined, child.artifactPaths[0] ? `artifact=${child.artifactPaths[0].slice(0, 500)}` : undefined].filter((field): field is string => field !== undefined);
1509
- return `'${child.key}'${fields.length > 0 ? ` (${fields.join(", ")})` : ""}`;
1510
- });
1511
- return ` ${children.some((child) => child.state === "running") ? "Child calls returned before return serialization failed; launch receipts do not prove completion." : "Child work completed before return serialization failed."} Recover outputs from: ${references.join(", ")}${children.length > references.length ? `, and ${children.length - references.length} more` : ""}. Return a plain projection such as { runId: child.runId, ok: child.ok, outputReference: child.outputReference }.`;
1512
- }
1513
-
1514
- export interface SimpleWorkflowRunPreview {
1515
- agent?: string;
1516
- task?: string;
1517
- }
1518
-
1519
- /** Display-only preview for the exact simple `return runs.run(key, {...})` form. */
1520
- export function previewSimpleWorkflowRun(script: string | undefined): SimpleWorkflowRunPreview | undefined {
1521
- const body = script?.match(/^\s*return\s+(?:await\s+)?runs\.run\s*\(\s*(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|`[^`$\\]*`)\s*,\s*\{([\s\S]*)\}\s*\)\s*;?\s*$/)?.[1];
1522
- if (body === undefined) return undefined;
1523
- const readProperty = (name: "agent" | "task"): string | undefined => {
1524
- const match = body.match(new RegExp(`(?:^|,)\\s*(?:${name}|["']${name}["'])\\s*:\\s*("(?:\\\\.|[^"\\\\])*"|'(?:\\\\.|[^'\\\\])*'|\u0060[^\u0060$\\\\]*\u0060)`));
1525
- if (!match?.[1]) return undefined;
1526
- const literal = match[1];
1527
- if (literal.startsWith('"')) {
1528
- try { return JSON.parse(literal) as string; } catch { return undefined; }
1529
- }
1530
- if (literal.slice(1, -1).includes("\\")) return undefined;
1531
- return literal.slice(1, -1);
1532
- };
1533
- const agent = readProperty("agent");
1534
- const task = readProperty("task");
1535
- return { ...(agent !== undefined ? { agent } : {}), ...(task !== undefined ? { task } : {}) };
1536
- }
1537
-
1538
- function stableJson(value: unknown): string {
1539
- if (Array.isArray(value)) return `[${value.map(stableJson).join(",")}]`;
1540
- if (isRecord(value)) return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableJson(value[key])}`).join(",")}}`;
1541
- return JSON.stringify(value) ?? "undefined";
1542
- }
1543
-
1544
- function canonicalRunParams(params: Record<string, unknown>): Record<string, unknown> {
1545
- if (params.gate === undefined || params.acceptance !== false) return params;
1546
- const { acceptance: _acceptance, ...withoutAcceptance } = params;
1547
- return withoutAcceptance;
1548
- }
1549
-
1550
- /** Canonical launch-params identity; matches the worker's stableRunJson(canonicalRunParams(params)). */
1551
- export function workflowRunParamsFingerprint(params: Record<string, unknown>): string {
1552
- return stableJson(canonicalRunParams(params));
1553
- }
1554
-
1555
- function validateKey(value: unknown, owner = "runs.run"): string {
1556
- if (typeof value !== "string" || !KEY_PATTERN.test(value)) {
1557
- throw new Error(`${owner} key must be 1-128 characters using letters, numbers, '.', '_' or '-', and start with a letter or number.`);
1558
- }
1559
- return value;
1560
- }
1561
-
1562
- type AstNode = {
1563
- type: string;
1564
- loc?: { start: { line: number; column: number } };
1565
- [key: string]: unknown;
1566
- };
1567
-
1568
- const AST_LOCATION_KEYS = new Set(["type", "start", "end", "loc", "range"]);
1569
-
1570
- function astNode(value: unknown): value is AstNode {
1571
- return Boolean(value) && typeof value === "object" && typeof (value as { type?: unknown }).type === "string";
1572
- }
1573
-
1574
- function literalString(node: unknown): string | undefined {
1575
- if (!astNode(node)) return undefined;
1576
- if (node.type === "Literal" && typeof node.value === "string") return node.value;
1577
- if (node.type === "TemplateLiteral" && Array.isArray(node.expressions) && node.expressions.length === 0 && Array.isArray(node.quasis)) {
1578
- const first = node.quasis[0] as { value?: { cooked?: unknown } } | undefined;
1579
- if (typeof first?.value?.cooked === "string") return first.value.cooked;
1580
- }
1581
- return undefined;
1582
- }
1583
-
1584
- function directRunsCall(node: unknown, method: "run" | "all" | "host" | "lanes"): boolean {
1585
- if (!astNode(node) || node.type !== "CallExpression" || !astNode(node.callee) || node.callee.type !== "MemberExpression") return false;
1586
- const property = node.callee.computed === true ? literalString(node.callee.property) : astNode(node.callee.property) && node.callee.property.type === "Identifier" ? node.callee.property.name : undefined;
1587
- return property === method && astNode(node.callee.object) && node.callee.object.type === "Identifier" && node.callee.object.name === "runs";
1588
- }
1589
-
1590
- function validateStaticHostCall(call: AstNode): WorkflowScriptValidationError[] {
1591
- const args = Array.isArray(call.arguments) ? call.arguments : [];
1592
- const keyNode = astNode(args[0]) ? args[0] : undefined;
1593
- const params = astNode(args[1]) ? args[1] : undefined;
1594
- const errors: WorkflowScriptValidationError[] = [];
1595
- const key = literalString(keyNode);
1596
- if (keyNode && key !== undefined && !KEY_PATTERN.test(key)) errors.push({ message: "runs.host key must be 1-128 characters using letters, numbers, '.', '_' or '-', and start with a letter or number.", ...nodeLocation(keyNode) });
1597
- if (!params || params.type !== "ObjectExpression" || !Array.isArray(params.properties) || params.properties.some((property) => !astNode(property) || property.type !== "Property")) return errors;
1598
- const allowed = new Set(["kind", "command", "timeoutMs", "output", "role", "provider"]);
1599
- for (const property of params.properties) {
1600
- if (!astNode(property)) continue;
1601
- const name = staticPropertyKey(property);
1602
- if (name !== undefined && !allowed.has(name)) errors.push({ message: name === "cwd" ? "runs.host params contain unsupported field 'cwd'. The host step does not accept per-step cwd; commands and relative output paths use the workflow cwd. Set cwd on the outer subagent request, or put a trusted directory change in command (for example, 'cd /path/to/worktree && npm test')." : `runs.host params contain unsupported field '${name}'.`, ...nodeLocation(property) });
1603
- }
1604
- const kindNode = directObjectPropertyValue(params, "kind");
1605
- const commandNode = directObjectPropertyValue(params, "command");
1606
- const timeoutNode = directObjectPropertyValue(params, "timeoutMs");
1607
- const kind = literalString(kindNode);
1608
- const command = literalString(commandNode);
1609
- const timeout = astNode(timeoutNode) && timeoutNode.type === "Literal" ? timeoutNode.value : undefined;
1610
- if (!kindNode) errors.push({ message: "runs.host params require kind: 'command'.", ...nodeLocation(params) });
1611
- else if (kind !== undefined && kind !== "command") errors.push({ message: "runs.host params kind must be 'command'.", ...nodeLocation(kindNode) });
1612
- if (!commandNode) errors.push({ message: "runs.host params require command.", ...nodeLocation(params) });
1613
- else if (command !== undefined && !command.trim()) errors.push({ message: "runs.host params command must be non-empty.", ...nodeLocation(commandNode) });
1614
- if (!timeoutNode) errors.push({ message: "runs.host params require timeoutMs.", ...nodeLocation(params) });
1615
- else if (typeof timeout === "number" && (!Number.isInteger(timeout) || timeout < 1)) errors.push({ message: "runs.host params timeoutMs must be a positive integer.", ...nodeLocation(timeoutNode) });
1616
- const outputNode = directObjectPropertyValue(params, "output");
1617
- const output = literalString(outputNode);
1618
- if (outputNode && output !== undefined && (!output.trim() || /^[/\\]|(?:^|[/\\])\.\.(?:[/\\]|$)/.test(output))) errors.push({ message: "runs.host params output must be a non-empty relative path without traversal.", ...nodeLocation(outputNode) });
1619
- const roleNode = directObjectPropertyValue(params, "role");
1620
- const role = literalString(roleNode);
1621
- if (roleNode && role !== undefined && role !== "ci" && role !== "gate") errors.push({ message: "runs.host params role must be 'ci' or 'gate'.", ...nodeLocation(roleNode) });
1622
- return errors;
1623
- }
1624
-
1625
- function nodeLocation(node: AstNode): Pick<WorkflowScriptValidationError, "line" | "column"> {
1626
- return node.loc ? { line: Math.max(1, node.loc.start.line - 1), column: node.loc.start.column + 1 } : {};
1627
- }
1628
-
1629
- function walkAst(node: unknown, visit: (node: AstNode) => void, includeNestedFunctions = true): void {
1630
- if (Array.isArray(node)) {
1631
- for (const item of node) walkAst(item, visit, includeNestedFunctions);
1632
- return;
1633
- }
1634
- if (!astNode(node)) return;
1635
- visit(node);
1636
- if (!includeNestedFunctions && (node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression")) return;
1637
- for (const [key, child] of Object.entries(node)) {
1638
- if (!AST_LOCATION_KEYS.has(key)) walkAst(child, visit, includeNestedFunctions);
1639
- }
1640
- }
1641
-
1642
- function bindingPatternContainsName(node: unknown, name: string): boolean {
1643
- if (!astNode(node)) return false;
1644
- if (node.type === "Identifier") return node.name === name;
1645
- if (node.type === "RestElement") return bindingPatternContainsName(node.argument, name);
1646
- if (node.type === "AssignmentPattern") return bindingPatternContainsName(node.left, name);
1647
- if (node.type === "ArrayPattern" && Array.isArray(node.elements)) return node.elements.some((element) => bindingPatternContainsName(element, name));
1648
- if (node.type === "ObjectPattern" && Array.isArray(node.properties)) return node.properties.some((property) => {
1649
- if (!astNode(property)) return false;
1650
- return property.type === "RestElement"
1651
- ? bindingPatternContainsName(property.argument, name)
1652
- : property.type === "Property" && bindingPatternContainsName(property.value, name);
1653
- });
1654
- return false;
1655
- }
1656
-
1657
- function definitelyReassignsBinding(node: unknown, name: string): boolean {
1658
- let assignment = node;
1659
- while (astNode(assignment) && assignment.type === "AssignmentExpression" && assignment.operator !== "&&=" && assignment.operator !== "||=" && assignment.operator !== "??=") {
1660
- if (bindingPatternContainsName(assignment.left, name)) return true;
1661
- assignment = assignment.right;
1662
- }
1663
- return false;
1664
- }
1665
-
1666
- function lexicalDeclarationContainsName(node: unknown, name: string): boolean {
1667
- if (!astNode(node)) return false;
1668
- if (node.type === "VariableDeclaration" && node.kind !== "var" && Array.isArray(node.declarations)) {
1669
- return node.declarations.some((declaration) => astNode(declaration) && bindingPatternContainsName(declaration.id, name));
1670
- }
1671
- return (node.type === "FunctionDeclaration" || node.type === "ClassDeclaration") && bindingPatternContainsName(node.id, name);
1672
- }
1673
-
1674
- function scopeShadowsIdentifier(node: AstNode, name: string): boolean {
1675
- if (node.type === "BlockStatement" && Array.isArray(node.body)) return node.body.some((statement) => lexicalDeclarationContainsName(statement, name));
1676
- if (node.type === "CatchClause") return bindingPatternContainsName(node.param, name);
1677
- if (node.type === "ForStatement") return lexicalDeclarationContainsName(node.init, name);
1678
- if (node.type === "ForInStatement" || node.type === "ForOfStatement") return lexicalDeclarationContainsName(node.left, name);
1679
- if (node.type === "SwitchStatement" && Array.isArray(node.cases)) {
1680
- return node.cases.some((entry) => astNode(entry) && Array.isArray(entry.consequent) && entry.consequent.some((statement) => lexicalDeclarationContainsName(statement, name)));
1681
- }
1682
- return false;
1683
- }
1684
-
1685
- function walkAstWithoutShadowedIdentifier(node: unknown, name: string, visit: (node: AstNode) => void): void {
1686
- if (Array.isArray(node)) {
1687
- for (const item of node) walkAstWithoutShadowedIdentifier(item, name, visit);
1688
- return;
1689
- }
1690
- if (!astNode(node) || scopeShadowsIdentifier(node, name)) return;
1691
- visit(node);
1692
- if (node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression") return;
1693
- for (const [key, child] of Object.entries(node)) {
1694
- if (!AST_LOCATION_KEYS.has(key)) walkAstWithoutShadowedIdentifier(child, name, visit);
1695
- }
1696
- }
1697
-
1698
- function definitelyNonJson(node: AstNode, normalizeUndefined = false): string | undefined {
1699
- if (node.type === "Literal") {
1700
- if (typeof node.bigint === "string") return "BigInt values are not JSON-representable";
1701
- if (node.regex !== undefined) return "regular expressions are not JSON-representable";
1702
- return undefined;
1703
- }
1704
- if (node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression") return "functions are not JSON-representable";
1705
- if (node.type === "Identifier" && node.name === "undefined") return normalizeUndefined ? undefined : "undefined is not JSON-representable";
1706
- if (node.type === "UnaryExpression" && node.operator === "void") return normalizeUndefined ? undefined : "undefined is not JSON-representable";
1707
- if (node.type === "ArrayExpression" && Array.isArray(node.elements)) {
1708
- if (node.elements.some((entry) => entry === null)) return "sparse arrays are not JSON-representable";
1709
- for (const entry of node.elements) if (astNode(entry)) {
1710
- const error = definitelyNonJson(entry, normalizeUndefined);
1711
- if (error) return error;
1712
- }
1713
- }
1714
- if (node.type === "ObjectExpression" && Array.isArray(node.properties)) {
1715
- const values = new Map<string, AstNode>();
1716
- for (const property of node.properties) {
1717
- if (!astNode(property) || property.type !== "Property" || !astNode(property.value) || property.kind !== "init") return undefined;
1718
- const key = staticPropertyKey(property);
1719
- if (key === undefined) return undefined;
1720
- values.set(key, property.value);
1721
- }
1722
- for (const value of values.values()) {
1723
- const error = definitelyNonJson(value, normalizeUndefined);
1724
- if (error) return error;
1725
- }
1726
- }
1727
- return undefined;
1728
- }
1729
-
1730
- function staticPropertyKey(property: AstNode): string | undefined {
1731
- return property.computed === true
1732
- ? literalString(property.key)
1733
- : literalString(property.key) ?? (astNode(property.key) && property.key.type === "Identifier" ? property.key.name as string : undefined);
1734
- }
1735
-
1736
- function directObjectPropertyValue(node: AstNode, name: string): AstNode | undefined {
1737
- if (node.type !== "ObjectExpression" || !Array.isArray(node.properties)) return undefined;
1738
- let value: AstNode | undefined;
1739
- for (const property of node.properties) {
1740
- if (!astNode(property) || property.type !== "Property" || !astNode(property.value)) continue;
1741
- if (staticPropertyKey(property) === name) value = property.value;
1742
- }
1743
- return value;
1744
- }
1745
-
1746
- function validateStaticBaseRef(params: AstNode, owner: string): WorkflowScriptValidationError[] {
1747
- if (params.type !== "ObjectExpression" || !Array.isArray(params.properties)) return [];
1748
- // Inspect the final definition only. A later spread or unknown key may overwrite it.
1749
- for (let index = params.properties.length - 1; index >= 0; index--) {
1750
- const property = params.properties[index];
1751
- if (!astNode(property) || property.type !== "Property") return [];
1752
- const key = staticPropertyKey(property);
1753
- if (key === undefined) return [];
1754
- if (key !== "baseRef") continue;
1755
- if (property.kind !== "init" || !astNode(property.value)) return [];
1756
- const valueNode = property.value;
1757
- const value = literalString(valueNode);
1758
- if ((value !== undefined || valueNode.type === "Literal") && !validGitRef(value)) {
1759
- return [{ message: `${owner} ${BASE_REF_VALIDATION_ERROR}`, ...nodeLocation(valueNode) }];
1760
- }
1761
- return [];
1762
- }
1763
- return [];
1764
- }
1765
-
1766
- // Children with their own cwd, agentScope, or resume resolve agents elsewhere, and a
1767
- // spread or computed key can replace `agent`; leave those to launch-time resolution.
1768
- function staticChildAgentNode(params: unknown): AstNode | undefined {
1769
- if (!astNode(params) || params.type !== "ObjectExpression" || !Array.isArray(params.properties)) return undefined;
1770
- let agent: AstNode | undefined;
1771
- for (const property of params.properties) {
1772
- if (!astNode(property) || property.type !== "Property") return undefined;
1773
- const key = staticPropertyKey(property);
1774
- if (key === undefined || key === "cwd" || key === "agentScope" || key === "resume") return undefined;
1775
- if (key === "agent") agent = property.kind === "init" && astNode(property.value) ? property.value : undefined;
1776
- }
1777
- return literalString(agent) === undefined ? undefined : agent;
1778
- }
1779
-
1780
- function validateStaticChildAgents(call: AstNode, agentNameError: (name: string) => string | undefined): WorkflowScriptValidationError[] {
1781
- const args = Array.isArray(call.arguments) ? call.arguments : [];
1782
- const elements = (node: unknown): unknown[] => astNode(node) && node.type === "ArrayExpression" && Array.isArray(node.elements) ? node.elements : [];
1783
- // A spread or unknown computed key on the lane can replace `stages`.
1784
- const staticLane = (lane: unknown): lane is AstNode => astNode(lane) && lane.type === "ObjectExpression" && Array.isArray(lane.properties)
1785
- && lane.properties.every((property) => astNode(property) && property.type === "Property" && staticPropertyKey(property) !== undefined);
1786
- const children: Array<{ owner: string; params: unknown }> = directRunsCall(call, "run")
1787
- ? [{ owner: "runs.run", params: args[1] }]
1788
- : directRunsCall(call, "all")
1789
- ? elements(args[0]).map((params) => ({ owner: "runs.all item", params }))
1790
- : directRunsCall(call, "lanes")
1791
- ? elements(args[0]).flatMap((lane) => staticLane(lane) ? elements(directObjectPropertyValue(lane, "stages")).map((params) => ({ owner: "runs.lanes stage", params })) : [])
1792
- : [];
1793
- const errors: WorkflowScriptValidationError[] = [];
1794
- for (const child of children) {
1795
- const agentNode = staticChildAgentNode(child.params);
1796
- const agentName = literalString(agentNode);
1797
- const error = agentName === undefined ? undefined : agentNameError(agentName);
1798
- if (agentNode && error) errors.push({ kind: "agent", message: `${child.owner}: ${error}`, ...nodeLocation(agentNode) });
1799
- }
1800
- return errors;
1801
- }
1802
-
1803
- function directRunsAllKeys(call: AstNode): Array<{ key: string; node: AstNode }> {
1804
- const args = Array.isArray(call.arguments) ? call.arguments : [];
1805
- const items = astNode(args[0]) && args[0].type === "ArrayExpression" && Array.isArray(args[0].elements) ? args[0].elements : [];
1806
- return items.flatMap((item) => {
1807
- if (!astNode(item)) return [];
1808
- const keyNode = directObjectPropertyValue(item, "key");
1809
- const key = literalString(keyNode);
1810
- return keyNode && key !== undefined ? [{ key, node: keyNode }] : [];
1811
- });
1812
- }
1813
-
1814
- function containsWorkflowLaunch(node: unknown): boolean {
1815
- let found = false;
1816
- walkAst(node, (candidate) => {
1817
- if (directRunsCall(candidate, "run") || directRunsCall(candidate, "all") || directRunsCall(candidate, "lanes")) found = true;
1818
- });
1819
- return found;
1820
- }
1821
-
1822
- function containsRunsIdentifier(node: unknown): boolean {
1823
- let found = false;
1824
- walkAst(node, (candidate) => {
1825
- if (candidate.type === "Identifier" && candidate.name === "runs") found = true;
1826
- });
1827
- return found;
1828
- }
1829
-
1830
- function invalidatesRunsBinding(workflowBody: AstNode): boolean {
1831
- let invalidated = false;
1832
- walkAst(workflowBody, (node) => {
1833
- if ((node.type === "VariableDeclarator" || node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ClassDeclaration" || node.type === "ClassExpression")
1834
- && containsRunsIdentifier(node.id)) invalidated = true;
1835
- if ((node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression") && Array.isArray(node.params)
1836
- && node.params.some(containsRunsIdentifier)) invalidated = true;
1837
- if (node.type === "CatchClause" && containsRunsIdentifier(node.param)) invalidated = true;
1838
- if ((node.type === "AssignmentExpression" || node.type === "UpdateExpression") && containsRunsIdentifier(node.left ?? node.argument)) invalidated = true;
1839
- });
1840
- return invalidated;
1841
- }
1842
-
1843
- function containsAbruptControl(node: AstNode): boolean {
1844
- let found = false;
1845
- walkAst(node, (candidate) => {
1846
- if (candidate !== node && (candidate.type === "ReturnStatement" || candidate.type === "ThrowStatement" || candidate.type === "BreakStatement" || candidate.type === "ContinueStatement")) found = true;
1847
- }, false);
1848
- return found;
1849
- }
1850
-
1851
- function directLaunchCall(expression: unknown): AstNode | undefined {
1852
- if (!astNode(expression)) return undefined;
1853
- const candidate = expression.type === "AwaitExpression" && astNode(expression.argument) ? expression.argument : expression;
1854
- return directRunsCall(candidate, "run") || directRunsCall(candidate, "all") ? candidate : undefined;
1855
- }
1856
-
1857
- function staticWorkflowLaunchPlan(workflowBody: AstNode): { keys: string[]; dynamic: boolean } {
1858
- if (workflowBody.type !== "BlockStatement" || !Array.isArray(workflowBody.body) || invalidatesRunsBinding(workflowBody)) {
1859
- return { keys: [], dynamic: containsWorkflowLaunch(workflowBody) };
1860
- }
1861
- const keys = new Set<string>();
1862
- let dynamic = false;
1863
- let remainderUncertain = false;
1864
- const addCall = (call: AstNode): void => {
1865
- const args = Array.isArray(call.arguments) ? call.arguments : [];
1866
- let nestedLaunch = false;
1867
- for (const argument of args) walkAst(argument, (node) => {
1868
- if (node !== call && (directRunsCall(node, "run") || directRunsCall(node, "all") || directRunsCall(node, "lanes"))) nestedLaunch = true;
1869
- });
1870
- if (nestedLaunch) {
1871
- dynamic = true;
1872
- return;
1873
- }
1874
- if (directRunsCall(call, "run")) {
1875
- const key = literalString(args[0]);
1876
- if (key === undefined) dynamic = true;
1877
- else keys.add(key);
1878
- return;
1879
- }
1880
- const array = astNode(args[0]) && args[0].type === "ArrayExpression" && Array.isArray(args[0].elements) ? args[0] : undefined;
1881
- if (!array) {
1882
- dynamic = true;
1883
- return;
1884
- }
1885
- const batchKeys: string[] = [];
1886
- for (const item of array.elements as unknown[]) {
1887
- if (!astNode(item) || item.type !== "ObjectExpression" || !Array.isArray(item.properties)
1888
- || item.properties.some((property) => !astNode(property) || property.type !== "Property" || staticPropertyKey(property) === undefined)) {
1889
- dynamic = true;
1890
- return;
1891
- }
1892
- const key = literalString(directObjectPropertyValue(item, "key"));
1893
- if (key === undefined) {
1894
- dynamic = true;
1895
- return;
1896
- }
1897
- batchKeys.push(key);
1898
- }
1899
- for (const key of batchKeys) keys.add(key);
1900
- };
1901
- for (const statement of workflowBody.body) {
1902
- if (!astNode(statement)) continue;
1903
- if (remainderUncertain) {
1904
- if (containsWorkflowLaunch(statement)) dynamic = true;
1905
- continue;
1906
- }
1907
- const expressions: unknown[] = [];
1908
- if (statement.type === "VariableDeclaration" && Array.isArray(statement.declarations)) {
1909
- for (const declaration of statement.declarations) if (astNode(declaration)) expressions.push(declaration.init);
1910
- } else if (statement.type === "ExpressionStatement") expressions.push(statement.expression);
1911
- else if (statement.type === "ReturnStatement" || statement.type === "ThrowStatement") expressions.push(statement.argument);
1912
- let handledLaunch = false;
1913
- for (const expression of expressions) {
1914
- const call = directLaunchCall(expression);
1915
- if (call) {
1916
- addCall(call);
1917
- handledLaunch = true;
1918
- } else if (containsWorkflowLaunch(expression)) dynamic = true;
1919
- }
1920
- if (!handledLaunch && expressions.length === 0 && containsWorkflowLaunch(statement)) dynamic = true;
1921
- if (statement.type === "ReturnStatement" || statement.type === "ThrowStatement") remainderUncertain = true;
1922
- else if (containsAbruptControl(statement)) remainderUncertain = true;
1923
- }
1924
- return { keys: [...keys], dynamic };
1925
- }
1926
-
1927
- /** Parse a workflowScript and apply only rules that are decidable from its local syntax. */
1928
- export function validateWorkflowScript(script: string, options: WorkflowScriptValidationOptions = {}): WorkflowScriptValidationResult {
1929
- const errors: WorkflowScriptValidationError[] = [];
1930
- if (!script.trim()) return { ok: false, errors: [{ message: "workflowScript must not be empty." }] };
1931
- let root: AstNode;
1932
- try {
1933
- const parser = requireFromPackage(resolveWorkflowParserEntry()) as { parse(source: string, options: Record<string, unknown>): unknown };
1934
- root = parser.parse(`(async () => {\n${script}\n})()`, { ecmaVersion: "latest", sourceType: "script", locations: true }) as AstNode;
1935
- } catch (error) {
1936
- const location = error && typeof error === "object" && "loc" in error && error.loc && typeof error.loc === "object"
1937
- ? error.loc as { line?: unknown; column?: unknown }
1938
- : undefined;
1939
- const message = (error instanceof Error ? error.message : String(error)).replace(/\s+\(\d+:\d+\)$/, "");
1940
- return { ok: false, errors: [{ message, ...(typeof location?.line === "number" ? { line: Math.max(1, location.line - 1) } : {}), ...(typeof location?.column === "number" ? { column: location.column + 1 } : {}) }] };
1941
- }
1942
-
1943
- const wrapper = astNode(root.body) ? undefined : Array.isArray(root.body) && astNode(root.body[0]) && astNode(root.body[0].expression) && astNode(root.body[0].expression.callee)
1944
- ? root.body[0].expression.callee
1945
- : undefined;
1946
- const workflowBody = wrapper && astNode(wrapper.body) ? wrapper.body : root;
1947
- // A rebound `runs` may not be the workflow API, so its calls prove nothing about child launches.
1948
- const agentNameError = options.agentNameError && !invalidatesRunsBinding(workflowBody) ? options.agentNameError : undefined;
1949
- walkAst(workflowBody, (node) => {
1950
- if (node !== wrapper && node.async === true && (node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression")) {
1951
- errors.push({ message: "workflowScript does not support nested async functions. Use top-level await, plain helper functions that return runs.run(...), or explicit Promise chains.", ...nodeLocation(node) });
1952
- }
1953
- if (directRunsCall(node, "run")) {
1954
- const args = Array.isArray(node.arguments) ? node.arguments : [];
1955
- const keyNode = astNode(args[0]) ? args[0] : undefined;
1956
- const key = literalString(keyNode);
1957
- if (keyNode && key !== undefined && !KEY_PATTERN.test(key)) errors.push({ message: "runs.run key must be 1-128 characters using letters, numbers, '.', '_' or '-', and start with a letter or number.", ...nodeLocation(keyNode) });
1958
- if (astNode(args[1])) {
1959
- errors.push(...validateStaticBaseRef(args[1], "runs.run"));
1960
- const message = definitelyNonJson(args[1]);
1961
- if (message) errors.push({ message: `runs.run params are invalid: ${message}.`, ...nodeLocation(args[1]) });
1962
- }
1963
- }
1964
- if (directRunsCall(node, "all")) {
1965
- for (const entry of directRunsAllKeys(node)) if (!KEY_PATTERN.test(entry.key)) errors.push({ message: "runs.all item key must be 1-128 characters using letters, numbers, '.', '_' or '-', and start with a letter or number.", ...nodeLocation(entry.node) });
1966
- const args = Array.isArray(node.arguments) ? node.arguments : [];
1967
- if (astNode(args[0]) && args[0].type === "ArrayExpression" && Array.isArray(args[0].elements)) {
1968
- for (const item of args[0].elements) if (astNode(item)) {
1969
- errors.push(...validateStaticBaseRef(item, "runs.all item"));
1970
- const message = definitelyNonJson(item);
1971
- if (message) errors.push({ message: `runs.all item params are invalid: ${message}.`, ...nodeLocation(item) });
1972
- }
1973
- }
1974
- }
1975
- if (directRunsCall(node, "host")) errors.push(...validateStaticHostCall(node));
1976
- if (agentNameError) errors.push(...validateStaticChildAgents(node, agentNameError));
1977
- const boundaryValue = node.type === "CallExpression" && astNode(node.callee) && node.callee.type === "Identifier" && node.callee.name === "emit" && Array.isArray(node.arguments) && astNode(node.arguments[0])
1978
- ? node.arguments[0]
1979
- : node.type === "CallExpression" && astNode(node.callee) && node.callee.type === "MemberExpression" && astNode(node.callee.object) && node.callee.object.type === "Identifier" && node.callee.object.name === "state" && astNode(node.callee.property) && node.callee.property.type === "Identifier" && node.callee.property.name === "set" && Array.isArray(node.arguments) && astNode(node.arguments[1])
1980
- ? node.arguments[1]
1981
- : undefined;
1982
- if (boundaryValue) {
1983
- // emit normalizes undefined like return; state.set values must already be JSON.
1984
- const message = definitelyNonJson(boundaryValue, Array.isArray(node.arguments) && boundaryValue === node.arguments[0]);
1985
- if (message) errors.push({ message: `workflowScript boundary value is invalid: ${message}.`, ...nodeLocation(boundaryValue) });
1986
- }
1987
- });
1988
- walkAst(workflowBody, (node) => {
1989
- if (node.type !== "ReturnStatement" || !astNode(node.argument)) return;
1990
- const message = definitelyNonJson(node.argument, true);
1991
- if (message) errors.push({ message: `workflowScript boundary value is invalid: ${message}.`, ...nodeLocation(node.argument) });
1992
- }, false);
1993
-
1994
- if (workflowBody.type === "BlockStatement" && Array.isArray(workflowBody.body)) {
1995
- for (let statementIndex = 0; statementIndex < workflowBody.body.length; statementIndex++) {
1996
- const statement = workflowBody.body[statementIndex];
1997
- if (!astNode(statement) || statement.type !== "VariableDeclaration" || !Array.isArray(statement.declarations)) continue;
1998
- for (const declaration of statement.declarations) {
1999
- if (!astNode(declaration) || !astNode(declaration.id) || declaration.id.type !== "Identifier" || !astNode(declaration.init) || declaration.init.type !== "AwaitExpression" || !astNode(declaration.init.argument) || !directRunsCall(declaration.init.argument, "all")) continue;
2000
- const name = declaration.id.name as string;
2001
- const laterStatements = workflowBody.body.slice(statementIndex + 1);
2002
- const keys = new Set(directRunsAllKeys(declaration.init.argument).map((entry) => entry.key));
2003
- if (keys.size === 0) continue;
2004
- const args = Array.isArray(declaration.init.argument.arguments) ? declaration.init.argument.arguments : [];
2005
- const itemCount = astNode(args[0]) && args[0].type === "ArrayExpression" && Array.isArray(args[0].elements) ? args[0].elements.length : 0;
2006
- const arrayResultShape = Array.from({ length: itemCount });
2007
- for (const later of laterStatements) {
2008
- walkAstWithoutShadowedIdentifier(later, name, (node) => {
2009
- if (node.type !== "MemberExpression" || !astNode(node.object) || node.object.type !== "Identifier" || node.object.name !== name) return;
2010
- const property = node.computed === true ? literalString(node.property) : astNode(node.property) && node.property.type === "Identifier" ? node.property.name as string : undefined;
2011
- if (property && keys.has(property) && !(property in arrayResultShape)) errors.push({ message: `runs.all returns an ordered array; '${name}.${property}' is keyed access. Use an index, destructuring, or map(...).`, ...nodeLocation(node) });
2012
- });
2013
- if (statement.kind !== "const" && astNode(later) && later.type === "ExpressionStatement" && definitelyReassignsBinding(later.expression, name)) break;
2014
- }
2015
- }
2016
- }
2017
- }
2018
-
2019
- const warnings: WorkflowScriptValidationWarning[] = [];
2020
- if (options.maxSubagentSpawnsPerRun !== undefined) {
2021
- const plan = staticWorkflowLaunchPlan(workflowBody);
2022
- if (plan.keys.length > options.maxSubagentSpawnsPerRun) {
2023
- errors.push({
2024
- kind: "spawn-budget",
2025
- message: `workflowScript statically requires child launches ${plan.keys.map((key) => `'${key}'`).join(", ")}; minimum required: ${plan.keys.length}; configured: ${options.maxSubagentSpawnsPerRun}.`,
2026
- });
2027
- }
2028
- if (plan.dynamic) {
2029
- warnings.push({
2030
- kind: "dynamic-spawn-count",
2031
- message: `workflowScript contains dynamic child launches; static validation proved ${plan.keys.length} launch(es), so runtime fan-out enforcement remains authoritative for the configured budget of ${options.maxSubagentSpawnsPerRun}.`,
2032
- });
2033
- }
2034
- }
2035
- const unique = errors.filter((error, index) => errors.findIndex((candidate) => candidate.message === error.message && candidate.line === error.line && candidate.column === error.column) === index);
2036
- return { ok: unique.length === 0, errors: unique, ...(warnings.length > 0 ? { warnings } : {}) };
2037
- }
2038
- function workflowStringMetadata(params: Record<string, unknown>): Pick<WorkflowScriptTraceEntry, "phase" | "label" | "agent"> {
2039
- return {
2040
- ...(typeof params.phase === "string" && params.phase.trim() ? { phase: params.phase.trim() } : {}),
2041
- ...(typeof params.label === "string" && params.label.trim() ? { label: params.label.trim() } : {}),
2042
- // Requested agent name, so a child is identifiable while it runs. Launch
2043
- // resolution overwrites this with the canonical name on the terminal entry.
2044
- ...(typeof params.agent === "string" && params.agent.trim() ? { agent: params.agent.trim() } : {}),
2045
- };
2046
- }
2047
-
2048
- function resolveWorkflowParserEntry(): string {
2049
- try {
2050
- return requireFromPackage.resolve("acorn");
2051
- } catch (primaryError) {
2052
- // Some runtimes (e.g. Bun-compiled single-file binaries) fail bare
2053
- // package-specifier resolution through createRequire while subpath
2054
- // resolution still works. Resolve the manifest and derive the
2055
- // CommonJS entry from its "main" field instead.
2056
- try {
2057
- const manifestPath = requireFromPackage.resolve("acorn/package.json");
2058
- const manifest = JSON.parse(readFileSync(manifestPath, "utf8")) as { main?: unknown };
2059
- const entry = typeof manifest.main === "string" && manifest.main ? manifest.main : "./dist/acorn.js";
2060
- return resolvePath(dirname(manifestPath), entry);
2061
- } catch {
2062
- throw primaryError;
2063
- }
2064
- }
2065
- }
2066
-
2067
- const AUTO_RESUME_PARAM_KEYS = ["acceptance", "agentContract", "baseRef", "index", "intercomBridge", "label", "lane", "maxRuntimeMs", "output", "outputMode", "outputSchema", "phase", "skill", "skills", "task", "timeoutMs", "toolBudget", "worktree"] as const;
2068
-
2069
- function isZeroUsage(usage: unknown): boolean {
2070
- if (!isRecord(usage)) return false;
2071
- const cost = usage.cost;
2072
- return (usage.input ?? 0) === 0
2073
- && (usage.output ?? 0) === 0
2074
- && (usage.cacheRead ?? 0) === 0
2075
- && (usage.cacheWrite ?? 0) === 0
2076
- && (!isRecord(cost) || (cost.total ?? 0) === 0);
2077
- }
2078
-
2079
- function setupAbortResumeParams(params: Record<string, unknown>, result: WorkflowScriptChildResult, signal: AbortSignal): Record<string, unknown> | undefined {
2080
- if (signal.aborted || result.state === "running" || result.ok || result.stopped || result.interrupted || !result.runId) return undefined;
2081
- const childResult = Array.isArray(result.results) && result.results.length === 1 && isRecord(result.results[0]) ? result.results[0] : undefined;
2082
- const error = typeof childResult?.error === "string" ? childResult.error : result.error;
2083
- if (error !== "This operation was aborted" || !isZeroUsage(childResult?.usage)) return undefined;
2084
- const messages: unknown[] = Array.isArray(childResult?.messages) ? childResult.messages : [];
2085
- const message = messages.findLast((entry) => isRecord(entry) && entry.role === "assistant");
2086
- if (message !== undefined) {
2087
- if (!isRecord(message)) return undefined;
2088
- if (message.stopReason !== "error" || message.errorMessage !== error) return undefined;
2089
- if (!Array.isArray(message.content) || message.content.length > 0 || !isZeroUsage(message.usage)) return undefined;
2090
- if (Object.hasOwn(message, "diagnostics") || Object.hasOwn(message, "responseId")) return undefined;
2091
- }
2092
- const task = typeof params.task === "string" && params.task.trim() ? params.task.trim() : "Continue after the setup abort.";
2093
- const resumeParams: Record<string, unknown> = { resume: result.runId, task };
2094
- for (const key of AUTO_RESUME_PARAM_KEYS) {
2095
- if (Object.hasOwn(params, key)) resumeParams[key] = params[key];
2096
- }
2097
- resumeParams.resume = result.runId;
2098
- resumeParams.task = task;
2099
- return resumeParams;
2100
- }
2101
-
2102
- export async function runWorkflowScript(options: RunWorkflowScriptOptions): Promise<WorkflowScriptResult> {
2103
- const emptyPartial = (): Omit<WorkflowScriptResult, "value"> => ({ emits: [], console: [], trace: [], children: [] });
2104
- if (!options.script.trim()) throw new WorkflowScriptError("workflowScript must not be empty.", emptyPartial(), "validation");
2105
- if (options.timeoutMs !== undefined && (!Number.isInteger(options.timeoutMs) || options.timeoutMs < 1)) throw new WorkflowScriptError("workflow script timeout must be a positive integer.", emptyPartial(), "runtime");
2106
- if (options.globalConcurrencyLimit !== undefined && (!Number.isSafeInteger(options.globalConcurrencyLimit) || options.globalConcurrencyLimit < 1)) {
2107
- throw new WorkflowScriptError("workflow script global concurrency limit must be a positive integer.", emptyPartial(), "runtime");
2108
- }
2109
- const launchSemaphore = new Semaphore(options.globalConcurrencyLimit ?? DEFAULT_GLOBAL_CONCURRENCY_LIMIT);
2110
-
2111
- if (options.processCwd !== undefined) {
2112
- let staleCwd = false;
2113
- try {
2114
- realpathSync(process.cwd());
2115
- } catch (error) {
2116
- const code = typeof error === "object" && error !== null && "code" in error ? (error as NodeJS.ErrnoException).code : undefined;
2117
- if (code !== "ENOENT") throw new WorkflowScriptError("Workflow current cwd could not be validated.", emptyPartial(), "runtime", { cause: error });
2118
- staleCwd = true;
2119
- }
2120
- try {
2121
- if (staleCwd) process.chdir(options.processCwd);
2122
- else {
2123
- const target = realpathSync(options.processCwd);
2124
- if (!statSync(target).isDirectory()) {
2125
- const error = new Error(`ENOTDIR: not a directory, access '${target}'`) as NodeJS.ErrnoException;
2126
- error.code = "ENOTDIR";
2127
- throw error;
2128
- }
2129
- accessSync(target, constants.X_OK);
2130
- }
2131
- } catch (error) {
2132
- const detail = error instanceof Error ? error.message : String(error);
2133
- throw new WorkflowScriptError(`Workflow process cwd is unavailable: ${options.processCwd}: ${detail}`, emptyPartial(), "runtime", { cause: error });
2134
- }
2135
- }
2136
-
2137
- let acornPath: string;
2138
- try {
2139
- acornPath = resolveWorkflowParserEntry();
2140
- } catch (error) {
2141
- throw new WorkflowScriptError("Workflow parser dependency 'acorn' is unavailable from pi-subagents. Reinstall pi-subagents dependencies before launching workflowScript.", emptyPartial(), "runtime", { cause: error });
2142
- }
2143
- let worker: Worker;
2144
- try {
2145
- worker = new Worker(WORKER_SOURCE, { eval: true, workerData: { acornPath } });
2146
- } catch (error) {
2147
- throw new WorkflowScriptError(`Workflow worker could not start: ${error instanceof Error ? error.message : String(error)}`, emptyPartial(), "runtime", { cause: error });
2148
- }
2149
- const emits: unknown[] = [];
2150
- const consoleEntries: WorkflowScriptResult["console"] = [];
2151
- const trace: WorkflowScriptTraceEntry[] = [];
2152
- const children = new Map<string, WorkflowScriptChildResult>();
2153
- const childOrder: string[] = [];
2154
- const launches = new Map<string, { fingerprint: string; promise: Promise<WorkflowScriptChildResult>; observed: boolean; generatedLaneKey?: string }>();
2155
- const steers = new Map<number, { key: string; promise: Promise<WorkflowSteerResult>; observed: boolean }>();
2156
- const hostCalls = new Map<number, { key: string; promise: Promise<WorkflowHostCommandResult>; observed: boolean }>();
2157
- const stoppedLaunches = new Set<string>();
2158
- const childStopControllers = new Map<string, AbortController>();
2159
- const batchAdmissions = new Map<string, Promise<void>>();
2160
- const observedRunCalls = new Set<number>();
2161
- const observedSteerCalls = new Set<number>();
2162
- const observedHostCalls = new Set<number>();
2163
- const childController = new AbortController();
2164
- let acceptanceRecoveryBarrier: { key: string } | undefined;
2165
- let settled = false;
2166
- let finishing = false;
2167
- let assemblyAbortRequested = false;
2168
- let assemblyFlushTimer: ReturnType<typeof setTimeout> | undefined;
2169
- let abortError: Error | undefined;
2170
-
2171
- const partial = (): Omit<WorkflowScriptResult, "value"> => ({ emits, console: consoleEntries, trace, children: childOrder.flatMap((key) => {
2172
- const child = children.get(key);
2173
- return child ? [child] : [];
2174
- }) });
2175
- // Hosts use onTrace to persist a progress journal, and it is invoked from inside
2176
- // the run-promise handlers below. A throw here would reject the child promise the
2177
- // script is awaiting, so a single failed status write could mark a completed child
2178
- // failed and abort its siblings through Promise.all. Telemetry must not decide
2179
- // workflow outcomes, so a failing callback is reported and the run continues.
2180
- const traceChanged = () => {
2181
- try {
2182
- options.onTrace?.([...trace]);
2183
- } catch (error) {
2184
- console.error("Workflow onTrace callback failed:", error);
2185
- }
2186
- };
2187
- const lanePlanChanged = (lanes: WorkflowLanePlan[]) => {
2188
- try {
2189
- options.onLanePlan?.(lanes);
2190
- } catch (error) {
2191
- console.error("Workflow onLanePlan callback failed:", error);
2192
- }
2193
- };
2194
- const hostStepChanged = (hostStep: HostStepNode) => {
2195
- try {
2196
- options.onHostStep?.(hostStep);
2197
- } catch (error) {
2198
- console.error("Workflow onHostStep callback failed:", error);
2199
- }
2200
- };
2201
- const stoppedChildResult = (key: string, message: string): WorkflowScriptChildResult => ({ key, ok: false, stopped: true, output: message, error: message, artifactPaths: [] });
2202
- const responseBoundaryFailure = (key: string, error: unknown): WorkflowScriptChildResult => {
2203
- const text = error instanceof Error ? error.message : String(error);
2204
- return { key, ok: false, output: text, error: text, artifactPaths: [] };
2205
- };
2206
- const assertRecoveryBarrierAllowsRun = (key: string, params: Record<string, unknown>): void => {
2207
- if (!acceptanceRecoveryBarrier || isExplicitReadOnlyRecoveryReview(params)) return;
2208
- throw new Error(recoveryBarrierMessage(acceptanceRecoveryBarrier.key, key));
2209
- };
2210
- const recordAcceptanceRecoveryBarrier = (key: string, result: WorkflowScriptChildResult): void => {
2211
- if (isAcceptanceMetadataRecovery(result)) acceptanceRecoveryBarrier = { key };
2212
- };
2213
- const stopChild = (key: string, message = `Workflow child '${key}' stopped by user.`): boolean => {
2214
- if (!launches.has(key) || children.has(key)) return false;
2215
- stoppedLaunches.add(key);
2216
- children.set(key, stoppedChildResult(key, message));
2217
- childStopControllers.get(key)?.abort(new Error(message));
2218
- const started = trace.findLast((entry) => entry.operation === "run" && entry.key === key && entry.state === "started");
2219
- trace.push({
2220
- operation: "run",
2221
- key,
2222
- state: "stopped",
2223
- ...(started?.agent ? { agent: started.agent } : {}),
2224
- ...(started?.phase ? { phase: started.phase } : {}),
2225
- ...(started?.label ? { label: started.label } : {}),
2226
- ...(started?.generatedLaneKey ? { generatedLaneKey: started.generatedLaneKey } : {}),
2227
- error: message,
2228
- });
2229
- traceChanged();
2230
- return true;
2231
- };
2232
- const notifyChildSettled = (key: string, result: WorkflowScriptChildResult): void => {
2233
- if (result.state === "running" || !options.onChildSettled || !options.workflowRunId) return;
2234
- const outcome: WorkflowChildSettledOutcome = result.ok
2235
- ? "completed"
2236
- : result.stopped
2237
- ? "stopped"
2238
- : result.detached
2239
- ? "paused"
2240
- : "failed";
2241
- const outputReference = result.outputReference ?? result.outputArtifactPath;
2242
- try {
2243
- options.onChildSettled({
2244
- workflowRunId: options.workflowRunId,
2245
- childKey: key,
2246
- ...(result.runId ? { childRunId: result.runId } : {}),
2247
- outcome,
2248
- ...(outputReference ? { outputReference } : {}),
2249
- ...(!result.ok && result.error ? { error: result.error } : {}),
2250
- workflowRunning: !settled && !finishing,
2251
- result,
2252
- });
2253
- } catch (error) {
2254
- console.error("Workflow onChildSettled callback failed:", error);
2255
- }
2256
- };
2257
- options.registerStopChild?.(stopChild);
2258
-
2259
- return await new Promise<WorkflowScriptResult>((resolve, reject) => {
2260
- const finish = (outcome: { value: unknown } | { error: Error & { workflowErrorKind?: unknown } }) => {
2261
- if (settled || finishing) return;
2262
- finishing = true;
2263
- if (assemblyFlushTimer !== undefined) {
2264
- clearTimeout(assemblyFlushTimer);
2265
- assemblyFlushTimer = undefined;
2266
- }
2267
- childController.abort("error" in outcome ? outcome.error : new Error("Workflow script completed."));
2268
- void Promise.allSettled([...steers.values(), ...hostCalls.values()].map(({ promise }) => promise)).then(() => {
2269
- if (settled) return;
2270
- settled = true;
2271
- options.registerStopChild?.(undefined);
2272
- if (timer) clearTimeout(timer);
2273
- options.signal?.removeEventListener("abort", onAbort);
2274
- void worker.terminate();
2275
- const unobservedKeys = "value" in outcome ? [...launches].filter(([, launch]) => !launch.observed).map(([key]) => key) : [];
2276
- const completionError = unobservedKeys.length > 0
2277
- ? new Error(`workflowScript completed with unawaited runs.run launch(es): ${unobservedKeys.map((key) => `'${key}'`).join(", ")}. For ordinary parallel fanout use await runs.all([{key, agent, task}, ...]); do not read .output from unawaited launches.`)
2278
- : "value" in outcome
2279
- ? (() => {
2280
- const unobservedSteers = [...steers.values()].filter((steer) => !steer.observed).map((steer) => steer.key);
2281
- if (unobservedSteers.length > 0) return new Error(`workflowScript completed with unawaited runs.steer call(s): ${unobservedSteers.map((key) => `'${key}'`).join(", ")}. Await or return each call.`);
2282
- const unobservedHosts = [...hostCalls.values()].filter((host) => !host.observed).map((host) => host.key);
2283
- return unobservedHosts.length > 0 ? new Error(`workflowScript completed with unawaited runs.host call(s): ${unobservedHosts.map((key) => `'${key}'`).join(", ")}. Await or return each call.`) : undefined;
2284
- })()
2285
- : undefined;
2286
- // Stops and reloads end through the abort paths untagged: they are not failures.
2287
- if ("error" in outcome) reject(new WorkflowScriptError(outcome.error.message, partial(), isWorkflowScriptFailureKind(outcome.error.workflowErrorKind) ? outcome.error.workflowErrorKind : undefined));
2288
- else if (completionError) reject(new WorkflowScriptError(completionError.message, partial(), "validation"));
2289
- else resolve({ value: outcome.value, ...partial() });
2290
- });
2291
- };
2292
- const onAbort = () => {
2293
- const signalReason = options.signal?.reason;
2294
- const error = signalReason instanceof Error
2295
- ? signalReason
2296
- : typeof signalReason === "string"
2297
- ? new Error(signalReason)
2298
- : new Error("Workflow script aborted.");
2299
- if (finishing) return;
2300
- abortError = error;
2301
- const allChildrenSettled = launches.size > 0
2302
- && [...launches.keys()].every((key) => children.has(key));
2303
- let mayFlushAssembly = false;
2304
- try {
2305
- mayFlushAssembly = options.continueAfterAbortWhenChildrenSettled?.(error) === true;
2306
- } catch (callbackError) {
2307
- const callbackMessage = callbackError instanceof Error ? callbackError.message : String(callbackError);
2308
- return finish({ error: taggedWorkflowError(`Workflow assembly flush eligibility failed: ${callbackMessage}`, "runtime") });
2309
- }
2310
- if (mayFlushAssembly && allChildrenSettled) {
2311
- // A reloaded async workflow may already be past its last child launch.
2312
- // Keep the worker alive for pure result assembly, but abort the child
2313
- // signal so any later launch or side effect cannot use stale context.
2314
- assemblyAbortRequested = true;
2315
- childController.abort(error);
2316
- assemblyFlushTimer = setTimeout(() => finish({ error }), WORKFLOW_ASSEMBLY_FLUSH_TIMEOUT_MS);
2317
- return;
2318
- }
2319
- for (const key of launches.keys()) {
2320
- if (children.has(key)) continue;
2321
- stoppedLaunches.add(key);
2322
- const started = trace.findLast((entry) => entry.operation === "run" && entry.key === key && entry.state === "started");
2323
- trace.push({
2324
- operation: "run",
2325
- key,
2326
- state: "stopped",
2327
- ...(started?.agent ? { agent: started.agent } : {}),
2328
- ...(started?.phase ? { phase: started.phase } : {}),
2329
- ...(started?.label ? { label: started.label } : {}),
2330
- ...(started?.generatedLaneKey ? { generatedLaneKey: started.generatedLaneKey } : {}),
2331
- error: error.message,
2332
- });
2333
- }
2334
- traceChanged();
2335
- finish({ error });
2336
- };
2337
- const timer = options.timeoutMs === undefined
2338
- ? undefined
2339
- : setTimeout(() => {
2340
- finish({ error: taggedWorkflowError(`Workflow script timed out after ${options.timeoutMs}ms.`, "timeout") });
2341
- }, options.timeoutMs);
2342
- options.signal?.addEventListener("abort", onAbort, { once: true });
2343
- if (options.signal?.aborted) return onAbort();
2344
-
2345
- worker.on("error", (error) => finish({ error: taggedWorkflowError(`Workflow worker failed: ${error instanceof Error ? error.message : String(error)}`, "runtime") }));
2346
- worker.on("exit", (code) => {
2347
- if (!settled && code !== 0) finish({ error: taggedWorkflowError(`Workflow worker exited with code ${code}.`, "runtime") });
2348
- });
2349
- worker.on("message", (message: Record<string, unknown>) => {
2350
- if (settled) return;
2351
- if (message.type === "lanePlan" && Array.isArray(message.lanes)) {
2352
- lanePlanChanged(message.lanes as WorkflowLanePlan[]);
2353
- return;
2354
- }
2355
- if (message.type === "emit") {
2356
- try {
2357
- assertWorkflowJsonValue(message.value, "emit");
2358
- } catch (error) {
2359
- finish({ error: taggedWorkflowError(`Workflow emit could not be persisted: ${error instanceof Error ? error.message : String(error)}`, "runtime") });
2360
- return;
2361
- }
2362
- emits.push(message.value);
2363
- try {
2364
- options.onEmit?.([...emits]);
2365
- } catch (error) {
2366
- emits.pop();
2367
- finish({ error: taggedWorkflowError(`Workflow emit could not be persisted: ${error instanceof Error ? error.message : String(error)}`, "runtime") });
2368
- }
2369
- return;
2370
- }
2371
- if (message.type === "console") {
2372
- const level = message.level;
2373
- if ((level === "log" || level === "info" || level === "warn" || level === "error") && typeof message.text === "string") consoleEntries.push({ level, text: message.text });
2374
- return;
2375
- }
2376
- if (message.type === "complete") {
2377
- try {
2378
- assertWorkflowJsonValue(message.value, "return");
2379
- } catch (error) {
2380
- return finish({ error: taggedWorkflowError(`Workflow return could not be persisted: ${error instanceof Error ? error.message : String(error)}`, "return-serialization") });
2381
- }
2382
- return finish({ value: message.value });
2383
- }
2384
- if (message.type === "error") {
2385
- const rawError = typeof message.error === "string" ? message.error : "Workflow script failed.";
2386
- const text = message.errorPhase === "return-serialization" ? `${rawError}${workflowReturnRecoveryHint(partial().children)}` : rawError;
2387
- return finish({ error: isWorkflowScriptFailureKind(message.errorKind) ? taggedWorkflowError(text, message.errorKind) : new Error(text) });
2388
- }
2389
- if (message.type === "callObserved" && typeof message.callId === "number") {
2390
- const key = typeof message.key === "string" ? message.key : undefined;
2391
- if (message.operation === "run") {
2392
- const launch = key ? launches.get(key) : undefined;
2393
- if (launch) launch.observed = true;
2394
- else observedRunCalls.add(message.callId);
2395
- } else if (message.operation === "steer") {
2396
- const steer = steers.get(message.callId);
2397
- if (steer) steer.observed = true;
2398
- else observedSteerCalls.add(message.callId);
2399
- } else if (message.operation === "host") {
2400
- const host = hostCalls.get(message.callId);
2401
- if (host) host.observed = true;
2402
- else observedHostCalls.add(message.callId);
2403
- }
2404
- return;
2405
- }
2406
- if (message.type !== "call" || typeof message.callId !== "number" || typeof message.method !== "string" || !isRecord(message.args)) return;
2407
- if (assemblyAbortRequested) return finish({ error: abortError ?? new Error("Workflow context was replaced or reloaded.") });
2408
-
2409
- const respond = (promise: Promise<unknown>, responsePath?: string, onBoundaryError?: (error: unknown) => void) => {
2410
- void promise.then(
2411
- (value) => {
2412
- if (settled) return;
2413
- const normalized = responsePath ? omitNonJsonWorkflowResultMetadata(value) : omitUndefinedWorkflowValues(value);
2414
- if (!responsePath) {
2415
- worker.postMessage({ type: "response", callId: message.callId, ok: true, value: normalized });
2416
- return;
2417
- }
2418
- try {
2419
- assertWorkflowJsonValue(normalized, responsePath);
2420
- worker.postMessage({ type: "response", callId: message.callId, ok: true, value: normalized });
2421
- } catch (error) {
2422
- onBoundaryError?.(error);
2423
- worker.postMessage({ type: "response", callId: message.callId, ok: false, error: `${responsePath} must contain only JSON data before it can be returned from workflowScript. Return a plain projection such as { runId, ok, output }. ${error instanceof Error ? error.message : String(error)}` });
2424
- }
2425
- },
2426
- (error: unknown) => {
2427
- if (!settled) {
2428
- const errorKind = error instanceof Error ? (error as { workflowErrorKind?: unknown }).workflowErrorKind : undefined;
2429
- worker.postMessage({ type: "response", callId: message.callId, ok: false, error: error instanceof Error ? error.message : String(error), ...(isWorkflowScriptFailureKind(errorKind) ? { errorKind } : {}) });
2430
- }
2431
- },
2432
- );
2433
- };
2434
- if (message.method === "state.get" || message.method === "state.set") {
2435
- if (!options.state) return respond(Promise.reject(new Error("Workflow state is unavailable without a mission.")));
2436
- let key: string;
2437
- try {
2438
- key = validateKey(message.args.key, "state");
2439
- } catch (error) {
2440
- return respond(Promise.reject(error));
2441
- }
2442
- if (message.method === "state.get") return respond(Promise.resolve().then(() => options.state!.get(key)));
2443
- if (acceptanceRecoveryBarrier) return respond(Promise.reject(new Error(recoveryBarrierMessage(acceptanceRecoveryBarrier.key, `state.set('${key}')`))));
2444
- const value = message.args.value;
2445
- try {
2446
- assertWorkflowJsonValue(value, `state.set('${key}') value`);
2447
- } catch (error) {
2448
- return respond(Promise.reject(error));
2449
- }
2450
- return respond(Promise.resolve().then(() => options.state!.set(key, value)));
2451
- }
2452
-
2453
- if (message.method === "status") {
2454
- const keyOrRunId = message.args.keyOrRunId;
2455
- if (typeof keyOrRunId !== "string" || !keyOrRunId.trim()) return respond(Promise.reject(new Error("runs.status(keyOrRunId) requires a non-empty string.")));
2456
- const known = children.get(keyOrRunId);
2457
- const target = known?.runId ?? keyOrRunId;
2458
- trace.push({ operation: "status", key: keyOrRunId, state: "started", ...(known?.runId ? { runId: known.runId } : {}) });
2459
- traceChanged();
2460
- if (settled || finishing) return;
2461
- respond(options.status(target, childController.signal).then((result) => {
2462
- if (settled || finishing) return result;
2463
- trace.push({ operation: "status", key: keyOrRunId, state: result.ok ? "completed" : "failed", ...(result.runId ? { runId: result.runId } : {}), ...(!result.ok ? { error: result.output } : {}) });
2464
- traceChanged();
2465
- if (!result.ok) throw new Error(`Status '${keyOrRunId}' failed: ${result.output}`);
2466
- return result;
2467
- }));
2468
- return;
2469
- }
2470
- if (message.method === "steer") {
2471
- let key: string;
2472
- try {
2473
- key = validateKey(message.args.key, "runs.steer");
2474
- } catch (error) {
2475
- return respond(Promise.reject(error));
2476
- }
2477
- const steerMessage = message.args.message;
2478
- if (typeof steerMessage !== "string" || !steerMessage.trim()) return respond(Promise.reject(new Error(`runs.steer('${key}') requires a non-empty message.`)));
2479
- const steerOptions = isRecord(message.args.options) ? message.args.options as WorkflowSteerOptions : {};
2480
- if (acceptanceRecoveryBarrier) return respond(Promise.reject(new Error(recoveryBarrierMessage(acceptanceRecoveryBarrier.key, `runs.steer('${key}')`))));
2481
- const startedAt = Date.now();
2482
- trace.push({ operation: "steer", key, state: "started" });
2483
- traceChanged();
2484
- const promise = Promise.resolve().then(() => {
2485
- if (!launches.has(key)) throw new Error(`runs.steer('${key}') requires a prior runs.run/runs.all launch with that key.`);
2486
- if (!options.steer) throw new Error("Workflow steering is unavailable in this host.");
2487
- return options.steer(key, steerMessage.trim(), steerOptions, childController.signal);
2488
- }).then((receipt) => {
2489
- trace.push({ operation: "steer", key, state: receipt.state, durationMs: Date.now() - startedAt, ...(receipt.error ? { error: receipt.error } : {}) });
2490
- traceChanged();
2491
- return receipt;
2492
- }, (error: unknown) => {
2493
- const text = error instanceof Error ? error.message : String(error);
2494
- trace.push({ operation: "steer", key, state: "failed", durationMs: Date.now() - startedAt, error: text });
2495
- traceChanged();
2496
- throw error;
2497
- });
2498
- steers.set(message.callId, { key, promise, observed: observedSteerCalls.delete(message.callId) });
2499
- respond(promise);
2500
- return;
2501
- }
2502
- if (message.method === "host") {
2503
- let key: string;
2504
- let params: WorkflowHostCommandParams;
2505
- try {
2506
- key = validateKey(message.args.key, "runs.host");
2507
- params = normalizeWorkflowHostCommandParams(message.args.params, `runs.host('${key}') params`);
2508
- } catch (error) {
2509
- return respond(Promise.reject(error));
2510
- }
2511
- if (acceptanceRecoveryBarrier) return respond(Promise.reject(new Error(recoveryBarrierMessage(acceptanceRecoveryBarrier.key, `runs.host('${key}')`))));
2512
- if (!options.host) return respond(Promise.reject(new Error("runs.host is unavailable in this host context.")));
2513
- if (hostCalls.size >= HOST_STEP_MAX_COUNT) return respond(Promise.reject(new Error(`workflowScript supports at most ${HOST_STEP_MAX_COUNT} runs.host calls.`)));
2514
- const startedAt = Date.now();
2515
- const startedStep: HostStepNode = {
2516
- version: 1,
2517
- kind: "host-step",
2518
- monitorKind: "command",
2519
- id: key,
2520
- label: key,
2521
- ...(params.role ? { role: params.role } : {}),
2522
- ...(params.provider ? { provider: params.provider } : {}),
2523
- state: "running",
2524
- updatedAt: startedAt,
2525
- deadlineAt: startedAt + params.timeoutMs,
2526
- };
2527
- hostStepChanged(startedStep);
2528
- trace.push({ operation: "host", key, state: "started" });
2529
- traceChanged();
2530
- const promise = Promise.resolve().then(() => options.host!(key, params, childController.signal)).then((result) => {
2531
- const state = result.state === "stopped" ? "cancelled" : result.ok ? "done" : "error";
2532
- const detail = [result.error, result.stderr.trim() || result.stdout.trim()].filter(Boolean).join(" ").replace(/\s+/g, " ").trim().slice(0, 200);
2533
- hostStepChanged({ ...startedStep, state, ...(state === "done" ? { verdict: "pass" as const } : {}), ...(!result.ok ? { reasonCode: result.state === "timed-out" ? "timed_out" : result.state === "stopped" ? "aborted" : "command_failed" } : {}), ...(detail ? { detail } : {}), reportPath: params.output ?? result.outputPath.split(/[\\/]/).at(-1), exitCode: result.exitCode, updatedAt: Date.now() });
2534
- trace.push({ operation: "host", key, state: result.ok ? "completed" : result.state === "stopped" ? "stopped" : "failed", durationMs: result.durationMs, ...(!result.ok ? { error: result.error ?? "Host command failed." } : {}) });
2535
- traceChanged();
2536
- if (!result.ok) throw new Error(`Host command '${key}' failed: ${detail || result.error || `exit code ${result.exitCode ?? "unknown"}`}`);
2537
- return result;
2538
- }, (error: unknown) => {
2539
- const text = error instanceof Error ? error.message : String(error);
2540
- hostStepChanged({ ...startedStep, state: "error", reasonCode: "execution_failed", detail: text.replace(/\s+/g, " ").slice(0, 200), updatedAt: Date.now() });
2541
- trace.push({ operation: "host", key, state: "failed", durationMs: Date.now() - startedAt, error: text });
2542
- traceChanged();
2543
- throw error;
2544
- });
2545
- hostCalls.set(message.callId, { key, promise, observed: observedHostCalls.delete(message.callId) });
2546
- respond(promise, `runs.host('${key}') result`);
2547
- return;
2548
- }
2549
- if (message.method !== "run") return respond(Promise.reject(new Error(`Unknown runs API method '${message.method}'.`)));
2550
-
2551
- let key: string;
2552
- try {
2553
- key = validateKey(message.args.key);
2554
- } catch (error) {
2555
- return respond(Promise.reject(error));
2556
- }
2557
- const params = message.args.params;
2558
- if (!isRecord(params)) return respond(Promise.reject(new Error(`runs.run('${key}', params) requires a params object.`)));
2559
- const generatedLaneKey = typeof message.args.generatedLaneKey === "string" && KEY_PATTERN.test(message.args.generatedLaneKey) && key.startsWith(`${message.args.generatedLaneKey}.`)
2560
- ? message.args.generatedLaneKey
2561
- : undefined;
2562
- const collectFailure = message.args.collectFailure === true;
2563
- const callObserved = observedRunCalls.delete(message.callId);
2564
- const deliver = (promise: Promise<WorkflowScriptChildResult>) => collectFailure
2565
- ? promise
2566
- : promise.then((result) => {
2567
- const recoverableAcceptanceMetadata = result.recovery?.status === "available-for-review"
2568
- && result.recovery.reason === "acceptance-metadata-rejected";
2569
- if (!result.ok && result.state !== "running" && !result.stopped && !recoverableAcceptanceMetadata) {
2570
- throw taggedWorkflowError(`Run '${key}' ${result.detached ? "detached" : "failed"}: ${result.error ?? result.output}`, result.detached ? "detached-child" : "child");
2571
- }
2572
- return result;
2573
- });
2574
- const fingerprint = workflowRunParamsFingerprint(params);
2575
- const existing = launches.get(key);
2576
- if (existing) {
2577
- if (existing.fingerprint !== fingerprint) return respond(Promise.reject(new Error(`Duplicate workflow key '${key}' used with incompatible launch params.`)));
2578
- if (callObserved) existing.observed = true;
2579
- trace.push({ operation: "run", key, state: "reused", ...workflowStringMetadata(params), ...(existing.generatedLaneKey ? { generatedLaneKey: existing.generatedLaneKey } : {}) });
2580
- traceChanged();
2581
- return respond(deliver(existing.promise), `runs.run('${key}') result`, (error) => children.set(key, responseBoundaryFailure(key, error)));
2582
- }
2583
- const permitError = options.oneUsePermit?.claim(key);
2584
- if (permitError) return respond(Promise.reject(new Error(permitError)));
2585
- if (options.oneUsePermit && message.args.batch !== undefined) return respond(Promise.reject(new Error("Workflow child permit does not support runs.all.")));
2586
- if (options.oneUsePermit && params.resume !== undefined) return respond(Promise.reject(new Error("Workflow child permit does not support retained resume.")));
2587
- if (params.action !== undefined) return respond(Promise.reject(new Error(`runs.run('${key}') accepts execution params only; management action is not allowed.`)));
2588
- if (params.workflowScript !== undefined) return respond(Promise.reject(new Error(`runs.run('${key}') cannot start a nested workflow script.`)));
2589
- if (params.tasks !== undefined || params.chain !== undefined || params.parallel !== undefined || params.concurrency !== undefined || params.chainDir !== undefined) {
2590
- return respond(Promise.reject(new Error(`runs.run('${key}') accepts one child via { agent, task }; use runs.all(...) and JavaScript control flow for orchestration.`)));
2591
- }
2592
- if (params.worktree !== undefined && typeof params.worktree !== "boolean") {
2593
- return respond(Promise.reject(new Error(`runs.run('${key}') worktree must be true or false.`)));
2594
- }
2595
- if (params.baseRef !== undefined && (typeof params.baseRef !== "string" || !validGitRef(params.baseRef))) {
2596
- return respond(Promise.reject(new Error(`runs.run('${key}') ${BASE_REF_VALIDATION_ERROR}`)));
2597
- }
2598
- if (params.gate !== undefined) {
2599
- const parsedGate = parseGateInput(params.gate);
2600
- if (!parsedGate.ok) return respond(Promise.reject(new Error(`runs.run('${key}') ${parsedGate.error}`)));
2601
- }
2602
- if (params.gate !== undefined && params.acceptance !== undefined && params.acceptance !== false) {
2603
- return respond(Promise.reject(new Error(`runs.run('${key}') gate cannot be combined with acceptance; use one gate command or acceptance.verify.` + describeGateAcceptanceConflict(params.gate, params.acceptance))));
2604
- }
2605
- if (params.gate !== undefined && params.resume !== undefined) {
2606
- return respond(Promise.reject(new Error(`runs.run('${key}') gate is not supported with retained resume.`)));
2607
- }
2608
- let resumeReference: WorkflowReceiptResumeReference | undefined;
2609
- try {
2610
- if (params.resume !== undefined && typeof params.resume !== "string") resumeReference = parseWorkflowResumeReference(params.resume);
2611
- } catch (error) {
2612
- return respond(Promise.reject(new Error(`runs.run('${key}') ${error instanceof Error ? error.message : String(error)}`)));
2613
- }
2614
- if (typeof params.resume === "string" && !params.resume.trim()) return respond(Promise.reject(new Error(`runs.run('${key}') resume must be a non-empty retained run id.`)));
2615
- if (params.resume !== undefined && params.agent !== undefined) {
2616
- return respond(Promise.reject(new Error(`runs.run('${key}') resume and agent are mutually exclusive.`)));
2617
- }
2618
- if (params.resume !== undefined && (typeof params.task !== "string" || !params.task.trim())) {
2619
- return respond(Promise.reject(new Error(`runs.run('${key}') resume requires a non-empty task follow-up.`)));
2620
- }
2621
- const startedAt = Date.now();
2622
- const batch = isRecord(message.args.batch) && typeof message.args.batch.id === "string" && Array.isArray(message.args.batch.calls)
2623
- ? { id: message.args.batch.id, calls: message.args.batch.calls.filter((call): call is { key: string; params: Record<string, unknown> } => isRecord(call) && typeof call.key === "string" && isRecord(call.params)) }
2624
- : undefined;
2625
- let admission = batch ? batchAdmissions.get(batch.id) : undefined;
2626
- if (!admission) {
2627
- const seenKeys = new Set<string>();
2628
- const calls = (batch?.calls ?? [{ key, params }]).filter((call) => {
2629
- if (seenKeys.has(call.key) || launches.has(call.key)) return false;
2630
- seenKeys.add(call.key);
2631
- return true;
2632
- });
2633
- admission = Promise.resolve().then(() => {
2634
- if (settled || finishing) return;
2635
- for (const call of calls) assertRecoveryBarrierAllowsRun(call.key, call.params);
2636
- return options.admit?.(calls, childController.signal);
2637
- });
2638
- if (batch) batchAdmissions.set(batch.id, admission);
2639
- }
2640
- let resolvedResumeLineage: string[] | undefined;
2641
- const promise = admission.then(async () => {
2642
- if (settled || finishing || stoppedLaunches.has(key)) {
2643
- const reason = childController.signal.reason;
2644
- const text = children.get(key)?.error ?? (reason instanceof Error ? reason.message : typeof reason === "string" ? reason : "Workflow script aborted.");
2645
- return stoppedChildResult(key, text);
2646
- }
2647
- const childStopController = new AbortController();
2648
- childStopControllers.set(key, childStopController);
2649
- const childSignal = combinedAbortSignal([childController.signal, childStopController.signal]);
2650
- const resumeInput = resumeReference ?? (typeof params.resume === "string" && options.resolveResume ? params.resume : undefined);
2651
- const resolvedResumeValue = resumeInput
2652
- ? await Promise.resolve().then(() => {
2653
- if (!options.resolveResume) throw new Error("Keyed workflow receipt resume is unavailable in this host.");
2654
- return options.resolveResume(resumeInput, childSignal, typeof params.index === "number" ? params.index : undefined);
2655
- })
2656
- : undefined;
2657
- const resolvedResume = typeof resolvedResumeValue === "string"
2658
- ? resolvedResumeValue
2659
- : isRecord(resolvedResumeValue) && typeof resolvedResumeValue.runId === "string"
2660
- ? resolvedResumeValue.runId
2661
- : undefined;
2662
- if (resumeReference && (typeof resolvedResume !== "string" || !resolvedResume.trim())) throw new Error("Keyed workflow receipt resume resolved without a retained run id.");
2663
- const resolvedResumeId = resolvedResume?.trim();
2664
- if (isRecord(resolvedResumeValue)) {
2665
- const lineage = Array.isArray(resolvedResumeValue.runIds)
2666
- ? resolvedResumeValue.runIds.filter((runId): runId is string => typeof runId === "string" && Boolean(runId.trim())).map((runId) => runId.trim())
2667
- : [];
2668
- resolvedResumeLineage = [...new Set(lineage.length ? lineage : [resolvedResumeId!])];
2669
- if (resolvedResumeLineage.at(-1) !== resolvedResumeId) resolvedResumeLineage.push(resolvedResumeId!);
2670
- if (typeof resumeInput === "string") {
2671
- const predecessor = [...children.values()].find((child) => child.runId === resolvedResumeId);
2672
- if (predecessor?.continuation && predecessor.continuation.runIds.at(-1) === resolvedResumeId) resolvedResumeLineage = predecessor.continuation.runIds;
2673
- }
2674
- }
2675
- const launchParams = resolvedResumeId ? { ...params, resume: resolvedResumeId } : params;
2676
- await launchSemaphore.acquire();
2677
- try {
2678
- if (settled || finishing || stoppedLaunches.has(key) || childSignal.aborted) {
2679
- const reason = childSignal.reason;
2680
- const text = children.get(key)?.error ?? (reason instanceof Error ? reason.message : typeof reason === "string" ? reason : "Workflow script aborted.");
2681
- return stoppedChildResult(key, text);
2682
- }
2683
- const result = await options.launch(key, launchParams, childSignal, { admitted: true, batch: batch !== undefined });
2684
- const autoResumeParams = setupAbortResumeParams(params, result, childSignal);
2685
- if (!autoResumeParams) return result;
2686
- resolvedResumeLineage = [...new Set([...(resolvedResumeLineage ?? []), result.runId!])];
2687
- trace.push({ operation: "run", key, state: "started", ...workflowStringMetadata(autoResumeParams), ...(generatedLaneKey ? { generatedLaneKey } : {}), phase: "auto-resume", runId: result.runId });
2688
- traceChanged();
2689
- return options.launch(key, autoResumeParams, childSignal, { admitted: true, batch: batch !== undefined });
2690
- } finally {
2691
- launchSemaphore.release();
2692
- }
2693
- }, (error: unknown) => {
2694
- if (!childController.signal.aborted) throw error;
2695
- const reason = childController.signal.reason;
2696
- return stoppedChildResult(key, reason instanceof Error ? reason.message : typeof reason === "string" ? reason : "Workflow script aborted.");
2697
- }).then((result) => {
2698
- let normalized = !result.ok && result.state !== "running" && !result.error ? { ...result, error: result.output } : result;
2699
- if (resolvedResumeLineage?.length && normalized.runId) {
2700
- normalized = { ...normalized, continuation: { runIds: [...new Set([...resolvedResumeLineage, normalized.runId])] } };
2701
- }
2702
- childStopControllers.delete(key);
2703
- if (stoppedLaunches.has(key)) return children.get(key) ?? normalized;
2704
- children.set(key, normalized);
2705
- recordAcceptanceRecoveryBarrier(key, normalized);
2706
- const state = normalized.state === "running" ? "started" : normalized.ok ? "completed" : normalized.stopped ? "stopped" : normalized.detached ? "detached" : "failed";
2707
- const settledEntry: WorkflowScriptTraceEntry = { operation: "run", key, state, durationMs: Date.now() - startedAt, ...workflowStringMetadata(params), ...(generatedLaneKey ? { generatedLaneKey } : {}), ...(normalized.agent ? { agent: normalized.agent } : {}), ...(normalized.runId ? { runId: normalized.runId } : {}), ...(!normalized.ok && normalized.state !== "running" ? { error: normalized.error ?? normalized.output } : {}) };
2708
- if (normalized.reused) settledEntry.reused = true;
2709
- trace.push(settledEntry);
2710
- traceChanged();
2711
- notifyChildSettled(key, normalized);
2712
- return normalized;
2713
- }, (error: unknown) => {
2714
- const text = error instanceof Error ? error.message : String(error);
2715
- const failure: WorkflowScriptChildResult = { key, ok: false, output: text, error: text, artifactPaths: [] };
2716
- childStopControllers.delete(key);
2717
- if (stoppedLaunches.has(key)) return children.get(key) ?? { ...failure, stopped: true };
2718
- children.set(key, failure);
2719
- trace.push({ operation: "run", key, state: "failed", durationMs: Date.now() - startedAt, ...workflowStringMetadata(params), ...(generatedLaneKey ? { generatedLaneKey } : {}), error: text });
2720
- traceChanged();
2721
- notifyChildSettled(key, failure);
2722
- return failure;
2723
- });
2724
- launches.set(key, { fingerprint, promise, observed: callObserved, ...(generatedLaneKey ? { generatedLaneKey } : {}) });
2725
- childOrder.push(key);
2726
- trace.push({ operation: "run", key, state: "started", ...workflowStringMetadata(params), ...(generatedLaneKey ? { generatedLaneKey } : {}) });
2727
- traceChanged();
2728
- respond(deliver(promise), `runs.run('${key}') result`, (error) => children.set(key, responseBoundaryFailure(key, error)));
2729
- });
2730
-
2731
- worker.postMessage({ type: "start", script: options.script, ...(options.args ? { args: options.args } : {}), stateEnabled: options.state !== undefined });
2732
- });
2733
- }