@xzzpig/pi-subagents 0.21.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1132) hide show
  1. package/CHANGELOG.md +356 -0
  2. package/README.md +2 -2
  3. package/agents/evidence-auditor.md +1 -0
  4. package/agents/oracle.md +1 -0
  5. package/agents/reviewer.md +1 -0
  6. package/bundle/agent-management.js +16 -0
  7. package/bundle/agents.js +41 -0
  8. package/bundle/background-work.js +16 -0
  9. package/bundle/capability-ceiling.js +22 -0
  10. package/bundle/child-tool-plan.js +11 -0
  11. package/bundle/chunk-355ECEP2.js +1321 -0
  12. package/bundle/chunk-35GII5EF.js +637 -0
  13. package/bundle/chunk-3G4JXNZ4.js +4130 -0
  14. package/bundle/chunk-3U633XDZ.js +749 -0
  15. package/bundle/chunk-4QFZZV3O.js +57 -0
  16. package/bundle/chunk-62OCY2S4.js +14 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-7K3Z6DM7.js +276 -0
  19. package/bundle/chunk-BGIYHF2W.js +138 -0
  20. package/bundle/chunk-CTPAE36Y.js +94 -0
  21. package/bundle/chunk-D4EHT5SJ.js +14 -0
  22. package/bundle/chunk-ED55MIC2.js +1681 -0
  23. package/bundle/chunk-F3NSN7UH.js +7331 -0
  24. package/bundle/chunk-FJWI64H7.js +490 -0
  25. package/bundle/chunk-H36HBZB2.js +753 -0
  26. package/bundle/chunk-ICNYIALB.js +7347 -0
  27. package/bundle/chunk-KD2IMFN4.js +1310 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LPVUHUZ7.js +5503 -0
  30. package/bundle/chunk-MYCL5QEJ.js +1372 -0
  31. package/bundle/chunk-NCWCVJLT.js +1768 -0
  32. package/bundle/chunk-NIXWDZZV.js +9 -0
  33. package/bundle/chunk-NTRJDXBC.js +4175 -0
  34. package/bundle/chunk-OFGSZBHP.js +16924 -0
  35. package/bundle/chunk-OTLRAB22.js +143 -0
  36. package/bundle/chunk-QXASAHIA.js +173 -0
  37. package/bundle/chunk-RB4GELQA.js +458 -0
  38. package/bundle/chunk-RK2HDPLK.js +1234 -0
  39. package/bundle/chunk-SW2VMNIU.js +526 -0
  40. package/bundle/chunk-T65XRVVM.js +940 -0
  41. package/bundle/chunk-U4ODUYAG.js +235 -0
  42. package/bundle/chunk-UFNSLL5D.js +9796 -0
  43. package/bundle/chunk-UKG4V45O.js +228 -0
  44. package/bundle/chunk-UQDHXMUG.js +264 -0
  45. package/bundle/chunk-V2KFIGFH.js +8774 -0
  46. package/bundle/chunk-VO3G7HI3.js +85 -0
  47. package/bundle/chunk-WPW4V6HM.js +227 -0
  48. package/bundle/chunk-WW76JRIX.js +175 -0
  49. package/bundle/chunk-XA3DY6UG.js +161 -0
  50. package/bundle/chunk-YFCK7H2S.js +129 -0
  51. package/bundle/chunk-YYREO77V.js +137 -0
  52. package/bundle/chunk-Z6TFJ6BR.js +400 -0
  53. package/bundle/control-channel.js +11 -0
  54. package/bundle/delegation.js +14 -0
  55. package/bundle/external-job-provider.js +20 -0
  56. package/bundle/external-runs.js +21 -0
  57. package/bundle/index.js +30 -0
  58. package/bundle/inspectors.js +8 -0
  59. package/bundle/intercom-bridge.js +11 -0
  60. package/bundle/preflight.js +468 -0
  61. package/bundle/project-panes.js +28 -0
  62. package/bundle/required-child-extensions.js +6 -0
  63. package/bundle/shared-types.js +8 -0
  64. package/bundle/supervisor-routing.js +12 -0
  65. package/bundle/workflow-resources.js +7 -0
  66. package/docs/agents.md +42 -10
  67. package/docs/configuration.md +59 -14
  68. package/docs/extension-api.md +61 -9
  69. package/docs/fork-supervisor-routing.md +77 -0
  70. package/docs/missions.md +2 -0
  71. package/docs/observability.md +20 -5
  72. package/docs/standalone-background.md +8 -6
  73. package/docs/tool-reference.md +18 -5
  74. package/docs/workflows.md +25 -7
  75. package/index.d.ts +3 -0
  76. package/index.js +14 -0
  77. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  78. package/package.json +107 -86
  79. package/skills/council-mode/SKILL.md +1 -4
  80. package/skills/pi-subagents/SKILL.md +130 -106
  81. package/skills/pi-subagents/references/orchestration.md +124 -0
  82. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  83. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  84. package/src/agents/advertised-agent-prompt.js +68 -0
  85. package/src/agents/agent-eject.d.ts +39 -0
  86. package/src/agents/agent-eject.js +263 -0
  87. package/src/agents/agent-management.d.ts +33 -0
  88. package/src/agents/agent-management.js +1541 -0
  89. package/src/agents/agent-memory.d.ts +48 -0
  90. package/src/agents/agent-memory.js +350 -0
  91. package/src/agents/agent-refinements.d.ts +99 -0
  92. package/src/agents/agent-refinements.js +568 -0
  93. package/src/agents/agent-scope.d.ts +3 -0
  94. package/src/agents/agent-scope.js +8 -0
  95. package/src/agents/agent-selection.d.ts +2 -0
  96. package/src/agents/agent-selection.js +22 -0
  97. package/src/agents/agent-serializer.d.ts +7 -0
  98. package/src/agents/agent-serializer.js +213 -0
  99. package/src/agents/agents.d.ts +352 -0
  100. package/src/agents/agents.js +2817 -0
  101. package/src/agents/builtin-names.d.ts +1 -0
  102. package/src/agents/builtin-names.js +16 -0
  103. package/src/agents/chain-serializer.d.ts +6 -0
  104. package/src/agents/chain-serializer.js +318 -0
  105. package/src/agents/frontmatter.d.ts +19 -0
  106. package/src/agents/frontmatter.js +166 -0
  107. package/src/agents/global-npm-root.d.ts +6 -0
  108. package/src/agents/global-npm-root.js +57 -0
  109. package/src/agents/identity.d.ts +7 -0
  110. package/src/agents/identity.js +29 -0
  111. package/src/agents/proactive-skills.d.ts +35 -0
  112. package/src/agents/proactive-skills.js +155 -0
  113. package/src/agents/runtime-agent-events.d.ts +26 -0
  114. package/src/agents/runtime-agent-events.js +52 -0
  115. package/src/agents/runtime-agent-registry.d.ts +66 -0
  116. package/src/agents/runtime-agent-registry.js +415 -0
  117. package/src/agents/runtime-discovery.d.ts +13 -0
  118. package/src/agents/runtime-discovery.js +27 -0
  119. package/src/agents/skills.d.ts +34 -0
  120. package/src/agents/skills.js +718 -0
  121. package/src/api/agent-management.d.ts +2 -0
  122. package/src/api/agent-management.js +2 -0
  123. package/src/api/agents.d.ts +6 -0
  124. package/src/api/agents.js +3 -0
  125. package/src/api/background-work.d.ts +41 -0
  126. package/src/api/background-work.js +171 -0
  127. package/src/api/capability-ceiling.d.ts +1 -0
  128. package/src/api/capability-ceiling.js +1 -0
  129. package/src/api/child-tool-plan.d.ts +1 -0
  130. package/src/api/child-tool-plan.js +1 -0
  131. package/src/api/control-channel.d.ts +1 -0
  132. package/src/api/control-channel.js +1 -0
  133. package/src/api/delegation.d.ts +132 -0
  134. package/src/api/delegation.js +8 -0
  135. package/src/api/external-job-provider.d.ts +57 -0
  136. package/src/api/external-job-provider.js +139 -0
  137. package/src/api/external-runs.d.ts +47 -0
  138. package/src/api/external-runs.js +245 -0
  139. package/src/api/inspectors.d.ts +20 -0
  140. package/src/api/inspectors.js +11 -0
  141. package/src/api/intercom-bridge.d.ts +1 -0
  142. package/src/api/intercom-bridge.js +1 -0
  143. package/src/api/preflight.d.ts +183 -0
  144. package/src/api/preflight.js +455 -0
  145. package/src/api/project-panes.d.ts +7 -0
  146. package/src/api/project-panes.js +7 -0
  147. package/src/api/required-child-extensions.d.ts +1 -0
  148. package/src/api/required-child-extensions.js +1 -0
  149. package/src/api/shared-types.d.ts +1 -0
  150. package/src/api/shared-types.js +1 -0
  151. package/src/api/supervisor-routing.d.ts +110 -0
  152. package/src/api/supervisor-routing.js +95 -0
  153. package/src/api/workflow-resources.d.ts +2 -0
  154. package/src/api/workflow-resources.js +1 -0
  155. package/src/extension/active-runs-prompt.d.ts +7 -0
  156. package/src/extension/active-runs-prompt.js +29 -0
  157. package/src/extension/config.d.ts +7 -0
  158. package/src/extension/config.js +290 -0
  159. package/src/extension/context-injection.d.ts +52 -0
  160. package/src/extension/context-injection.js +102 -0
  161. package/src/extension/control-notices.d.ts +18 -0
  162. package/src/extension/control-notices.js +29 -0
  163. package/src/extension/declaration-pinning.d.ts +18 -0
  164. package/src/extension/declaration-pinning.js +167 -0
  165. package/src/extension/doctor.d.ts +34 -0
  166. package/src/extension/doctor.js +236 -0
  167. package/src/extension/fanout-child.d.ts +6 -0
  168. package/src/extension/fanout-child.js +278 -0
  169. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  170. package/src/extension/herdr-pi-bridge.js +261 -0
  171. package/src/extension/index.d.ts +18 -0
  172. package/src/extension/index.js +1288 -0
  173. package/src/extension/public-execution.d.ts +71 -0
  174. package/src/extension/public-execution.js +214 -0
  175. package/src/extension/reply-workflow-script.d.ts +11 -0
  176. package/src/extension/reply-workflow-script.js +71 -0
  177. package/src/extension/rpc.d.ts +84 -0
  178. package/src/extension/rpc.js +729 -0
  179. package/src/extension/schemas.d.ts +276 -0
  180. package/src/extension/schemas.js +311 -0
  181. package/src/extension/steering-notices.d.ts +14 -0
  182. package/src/extension/steering-notices.js +22 -0
  183. package/src/extension/subagent-guide.d.ts +4 -0
  184. package/src/extension/subagent-guide.js +114 -0
  185. package/src/extension/subagent-options.d.ts +7 -0
  186. package/src/extension/subagent-options.js +64 -0
  187. package/src/extension/tool-activation.d.ts +7 -0
  188. package/src/extension/tool-activation.js +185 -0
  189. package/src/extension/tool-description.d.ts +19 -0
  190. package/src/extension/tool-description.js +169 -0
  191. package/src/extension/tool-result.d.ts +9 -0
  192. package/src/extension/tool-result.js +16 -0
  193. package/src/extension/upgrade-notice.d.ts +6 -0
  194. package/src/extension/upgrade-notice.js +42 -0
  195. package/src/inspectors/actions.d.ts +24 -0
  196. package/src/inspectors/actions.js +182 -0
  197. package/src/inspectors/ghostty/actions.d.ts +11 -0
  198. package/src/inspectors/ghostty/actions.js +62 -0
  199. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  200. package/src/inspectors/ghostty/plugin.js +23 -0
  201. package/src/inspectors/herdr/actions.d.ts +25 -0
  202. package/src/inspectors/herdr/actions.js +133 -0
  203. package/src/inspectors/herdr/client.d.ts +41 -0
  204. package/src/inspectors/herdr/client.js +129 -0
  205. package/src/inspectors/herdr/focus.d.ts +24 -0
  206. package/src/inspectors/herdr/focus.js +49 -0
  207. package/src/inspectors/herdr/plugin.d.ts +6 -0
  208. package/src/inspectors/herdr/plugin.js +14 -0
  209. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  210. package/src/inspectors/herdr/project-panes.js +610 -0
  211. package/src/inspectors/inspector-runner.d.ts +23 -0
  212. package/src/inspectors/inspector-runner.js +161 -0
  213. package/src/inspectors/plugins.d.ts +8 -0
  214. package/src/inspectors/plugins.js +82 -0
  215. package/src/inspectors/session-roots-codec.d.ts +15 -0
  216. package/src/inspectors/session-roots-codec.js +32 -0
  217. package/src/inspectors/shell-command.d.ts +1 -0
  218. package/src/inspectors/shell-command.js +16 -0
  219. package/src/inspectors/tmux/actions.d.ts +25 -0
  220. package/src/inspectors/tmux/actions.js +181 -0
  221. package/src/inspectors/tmux/client.d.ts +27 -0
  222. package/src/inspectors/tmux/client.js +64 -0
  223. package/src/inspectors/tmux/plugin.d.ts +7 -0
  224. package/src/inspectors/tmux/plugin.js +14 -0
  225. package/src/inspectors/types.d.ts +48 -0
  226. package/src/inspectors/types.js +1 -0
  227. package/src/integrations/herdr-status.d.ts +47 -0
  228. package/src/integrations/herdr-status.js +350 -0
  229. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  230. package/src/integrations/pi-web-session-liveness.js +53 -0
  231. package/src/integrations/program-status.d.ts +30 -0
  232. package/src/integrations/program-status.js +188 -0
  233. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  234. package/src/intercom/fork-supervisor-routing.js +392 -0
  235. package/src/intercom/intercom-bridge.d.ts +58 -0
  236. package/src/intercom/intercom-bridge.js +193 -0
  237. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  238. package/src/intercom/native-supervisor-channel.js +1184 -0
  239. package/src/intercom/result-intercom.d.ts +35 -0
  240. package/src/intercom/result-intercom.js +376 -0
  241. package/src/intercom/supervisor-ui.d.ts +29 -0
  242. package/src/intercom/supervisor-ui.js +49 -0
  243. package/src/missions/actions.d.ts +54 -0
  244. package/src/missions/actions.js +400 -0
  245. package/src/missions/goal-driver.d.ts +16 -0
  246. package/src/missions/goal-driver.js +171 -0
  247. package/src/missions/lifecycle.d.ts +50 -0
  248. package/src/missions/lifecycle.js +388 -0
  249. package/src/missions/store.d.ts +21 -0
  250. package/src/missions/store.js +605 -0
  251. package/src/missions/types.d.ts +169 -0
  252. package/src/missions/types.js +9 -0
  253. package/src/missions/workflow-state.d.ts +14 -0
  254. package/src/missions/workflow-state.js +273 -0
  255. package/src/policy/authority.d.ts +9 -0
  256. package/src/policy/authority.js +41 -0
  257. package/src/profiles/profiles.d.ts +134 -0
  258. package/src/profiles/profiles.js +526 -0
  259. package/src/runs/background/active-async-capacity.d.ts +115 -0
  260. package/src/runs/background/active-async-capacity.js +517 -0
  261. package/src/runs/background/active-run-index.d.ts +12 -0
  262. package/src/runs/background/active-run-index.js +157 -0
  263. package/src/runs/background/async-execution.d.ts +304 -0
  264. package/src/runs/background/async-execution.js +2206 -0
  265. package/src/runs/background/async-job-tracker.d.ts +37 -0
  266. package/src/runs/background/async-job-tracker.js +921 -0
  267. package/src/runs/background/async-resume.d.ts +60 -0
  268. package/src/runs/background/async-resume.js +707 -0
  269. package/src/runs/background/async-retention.d.ts +45 -0
  270. package/src/runs/background/async-retention.js +932 -0
  271. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  272. package/src/runs/background/async-status-snapshot.js +26 -0
  273. package/src/runs/background/async-status.d.ts +177 -0
  274. package/src/runs/background/async-status.js +710 -0
  275. package/src/runs/background/auto-drain.d.ts +16 -0
  276. package/src/runs/background/auto-drain.js +71 -0
  277. package/src/runs/background/await-async-run.d.ts +26 -0
  278. package/src/runs/background/await-async-run.js +83 -0
  279. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  280. package/src/runs/background/binary-bootstrap.js +69 -0
  281. package/src/runs/background/boot-id.d.ts +12 -0
  282. package/src/runs/background/boot-id.js +47 -0
  283. package/src/runs/background/calendar-schedule.d.ts +26 -0
  284. package/src/runs/background/calendar-schedule.js +93 -0
  285. package/src/runs/background/chain-append.d.ts +34 -0
  286. package/src/runs/background/chain-append.js +299 -0
  287. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  288. package/src/runs/background/chain-root-attachment.js +186 -0
  289. package/src/runs/background/completion-batcher.d.ts +51 -0
  290. package/src/runs/background/completion-batcher.js +119 -0
  291. package/src/runs/background/completion-dedupe.d.ts +13 -0
  292. package/src/runs/background/completion-dedupe.js +48 -0
  293. package/src/runs/background/completion-replay.d.ts +47 -0
  294. package/src/runs/background/completion-replay.js +266 -0
  295. package/src/runs/background/control-channel.d.ts +170 -0
  296. package/src/runs/background/control-channel.js +610 -0
  297. package/src/runs/background/fleet-view.d.ts +63 -0
  298. package/src/runs/background/fleet-view.js +666 -0
  299. package/src/runs/background/index-segment.d.ts +16 -0
  300. package/src/runs/background/index-segment.js +58 -0
  301. package/src/runs/background/inspect-rpc.d.ts +64 -0
  302. package/src/runs/background/inspect-rpc.js +422 -0
  303. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  304. package/src/runs/background/interrupted-elsewhere.js +68 -0
  305. package/src/runs/background/notify.d.ts +214 -0
  306. package/src/runs/background/notify.js +1001 -0
  307. package/src/runs/background/owned-process-tree.d.ts +10 -0
  308. package/src/runs/background/owned-process-tree.js +116 -0
  309. package/src/runs/background/parallel-groups.d.ts +3 -0
  310. package/src/runs/background/parallel-groups.js +46 -0
  311. package/src/runs/background/pid-namespace.d.ts +2 -0
  312. package/src/runs/background/pid-namespace.js +19 -0
  313. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  314. package/src/runs/background/process-terminal-candidate.js +96 -0
  315. package/src/runs/background/process-terminal.d.ts +21 -0
  316. package/src/runs/background/process-terminal.js +227 -0
  317. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  318. package/src/runs/background/result-delivery-ownership.js +38 -0
  319. package/src/runs/background/result-files.d.ts +63 -0
  320. package/src/runs/background/result-files.js +629 -0
  321. package/src/runs/background/result-watcher.d.ts +92 -0
  322. package/src/runs/background/result-watcher.js +819 -0
  323. package/src/runs/background/resume-guidance.d.ts +4 -0
  324. package/src/runs/background/resume-guidance.js +57 -0
  325. package/src/runs/background/retained-children.d.ts +24 -0
  326. package/src/runs/background/retained-children.js +128 -0
  327. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  328. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  329. package/src/runs/background/run-child-session.d.ts +123 -0
  330. package/src/runs/background/run-child-session.js +670 -0
  331. package/src/runs/background/run-id-query.d.ts +3 -0
  332. package/src/runs/background/run-id-query.js +6 -0
  333. package/src/runs/background/run-id-resolver.d.ts +22 -0
  334. package/src/runs/background/run-id-resolver.js +172 -0
  335. package/src/runs/background/run-status.d.ts +25 -0
  336. package/src/runs/background/run-status.js +850 -0
  337. package/src/runs/background/runner-aliases.d.ts +17 -0
  338. package/src/runs/background/runner-aliases.js +191 -0
  339. package/src/runs/background/runner-child-launch.d.ts +24 -0
  340. package/src/runs/background/runner-child-launch.js +72 -0
  341. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  342. package/src/runs/background/runner-child-sessions.js +34 -0
  343. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  344. package/src/runs/background/runner-http-dispatcher.js +115 -0
  345. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  346. package/src/runs/background/runner-startup-failure.js +46 -0
  347. package/src/runs/background/scheduled-runs.d.ts +127 -0
  348. package/src/runs/background/scheduled-runs.js +1265 -0
  349. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  350. package/src/runs/background/stale-run-reconciler.js +509 -0
  351. package/src/runs/background/steering.d.ts +51 -0
  352. package/src/runs/background/steering.js +246 -0
  353. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  354. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  355. package/src/runs/background/subagent-runner.d.ts +210 -0
  356. package/src/runs/background/subagent-runner.js +4963 -0
  357. package/src/runs/background/subagent-wait.d.ts +124 -0
  358. package/src/runs/background/subagent-wait.js +756 -0
  359. package/src/runs/background/terminal-run-index.d.ts +10 -0
  360. package/src/runs/background/terminal-run-index.js +209 -0
  361. package/src/runs/background/top-level-async.d.ts +7 -0
  362. package/src/runs/background/top-level-async.js +5 -0
  363. package/src/runs/background/wait-completions.d.ts +28 -0
  364. package/src/runs/background/wait-completions.js +264 -0
  365. package/src/runs/background/wait-config.d.ts +8 -0
  366. package/src/runs/background/wait-config.js +46 -0
  367. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  368. package/src/runs/background/wait-subscriptions.js +339 -0
  369. package/src/runs/background/wait-tool.d.ts +6 -0
  370. package/src/runs/background/wait-tool.js +48 -0
  371. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  372. package/src/runs/background/workflow-terminal-proof.js +116 -0
  373. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  374. package/src/runs/foreground/async-dismiss-action.js +82 -0
  375. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  376. package/src/runs/foreground/async-steering-action.js +294 -0
  377. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  378. package/src/runs/foreground/async-stop-action.js +213 -0
  379. package/src/runs/foreground/command-action.d.ts +12 -0
  380. package/src/runs/foreground/command-action.js +38 -0
  381. package/src/runs/foreground/execution.d.ts +10 -0
  382. package/src/runs/foreground/execution.js +2322 -0
  383. package/src/runs/foreground/foreground-control.d.ts +24 -0
  384. package/src/runs/foreground/foreground-control.js +138 -0
  385. package/src/runs/foreground/foreground-history.d.ts +25 -0
  386. package/src/runs/foreground/foreground-history.js +267 -0
  387. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  388. package/src/runs/foreground/prompt-audit.js +138 -0
  389. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  390. package/src/runs/foreground/subagent-executor.js +7986 -0
  391. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  392. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  393. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  394. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  395. package/src/runs/shared/abort-recovery.d.ts +26 -0
  396. package/src/runs/shared/abort-recovery.js +108 -0
  397. package/src/runs/shared/acceptance.d.ts +144 -0
  398. package/src/runs/shared/acceptance.js +1616 -0
  399. package/src/runs/shared/agent-contract.d.ts +5 -0
  400. package/src/runs/shared/agent-contract.js +35 -0
  401. package/src/runs/shared/async-status-projection.d.ts +100 -0
  402. package/src/runs/shared/async-status-projection.js +566 -0
  403. package/src/runs/shared/background-process-options.d.ts +4 -0
  404. package/src/runs/shared/background-process-options.js +6 -0
  405. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  406. package/src/runs/shared/capability-ceiling.js +179 -0
  407. package/src/runs/shared/chain-outputs.d.ts +18 -0
  408. package/src/runs/shared/chain-outputs.js +104 -0
  409. package/src/runs/shared/child-commands.d.ts +29 -0
  410. package/src/runs/shared/child-commands.js +254 -0
  411. package/src/runs/shared/child-hooks.d.ts +31 -0
  412. package/src/runs/shared/child-hooks.js +173 -0
  413. package/src/runs/shared/child-identity.d.ts +23 -0
  414. package/src/runs/shared/child-identity.js +40 -0
  415. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  416. package/src/runs/shared/child-launch-plan.js +88 -0
  417. package/src/runs/shared/child-launch.d.ts +128 -0
  418. package/src/runs/shared/child-launch.js +262 -0
  419. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  420. package/src/runs/shared/child-lifecycle.js +22 -0
  421. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  422. package/src/runs/shared/child-runtime-config.js +44 -0
  423. package/src/runs/shared/child-session.d.ts +178 -0
  424. package/src/runs/shared/child-session.js +726 -0
  425. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  426. package/src/runs/shared/child-tool-plan.js +430 -0
  427. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  428. package/src/runs/shared/claude-code-adapter.js +255 -0
  429. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  430. package/src/runs/shared/codex-exec-adapter.js +127 -0
  431. package/src/runs/shared/context-mode.d.ts +12 -0
  432. package/src/runs/shared/context-mode.js +38 -0
  433. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  434. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  435. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  436. package/src/runs/shared/dynamic-fanout.js +273 -0
  437. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  438. package/src/runs/shared/effective-system-prompt.js +23 -0
  439. package/src/runs/shared/extension-bindings.d.ts +25 -0
  440. package/src/runs/shared/extension-bindings.js +96 -0
  441. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  442. package/src/runs/shared/external-cli-contract.js +145 -0
  443. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  444. package/src/runs/shared/external-cli-preflight.js +159 -0
  445. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  446. package/src/runs/shared/external-cli-runner.js +425 -0
  447. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  448. package/src/runs/shared/external-job-bridge.js +486 -0
  449. package/src/runs/shared/external-job-runner.d.ts +44 -0
  450. package/src/runs/shared/external-job-runner.js +352 -0
  451. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  452. package/src/runs/shared/fast-mode-extension.js +8 -0
  453. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  454. package/src/runs/shared/fork-placed-env.js +13 -0
  455. package/src/runs/shared/git-environment.d.ts +2 -0
  456. package/src/runs/shared/git-environment.js +27 -0
  457. package/src/runs/shared/herdr-connection.d.ts +79 -0
  458. package/src/runs/shared/herdr-connection.js +269 -0
  459. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  460. package/src/runs/shared/herdr-external-adapters.js +404 -0
  461. package/src/runs/shared/herdr-machine.d.ts +59 -0
  462. package/src/runs/shared/herdr-machine.js +294 -0
  463. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  464. package/src/runs/shared/herdr-pane-host.js +155 -0
  465. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  466. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  467. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  468. package/src/runs/shared/herdr-placed-run.js +380 -0
  469. package/src/runs/shared/host-step-status.d.ts +33 -0
  470. package/src/runs/shared/host-step-status.js +244 -0
  471. package/src/runs/shared/lane-metadata.d.ts +23 -0
  472. package/src/runs/shared/lane-metadata.js +126 -0
  473. package/src/runs/shared/launch-cwd.d.ts +1 -0
  474. package/src/runs/shared/launch-cwd.js +16 -0
  475. package/src/runs/shared/local-machine-access.d.ts +5 -0
  476. package/src/runs/shared/local-machine-access.js +28 -0
  477. package/src/runs/shared/long-running-guard.d.ts +34 -0
  478. package/src/runs/shared/long-running-guard.js +256 -0
  479. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  480. package/src/runs/shared/mcp-config-sources.js +418 -0
  481. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  482. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  483. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  484. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  485. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  486. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  487. package/src/runs/shared/model-resolution.d.ts +109 -0
  488. package/src/runs/shared/model-resolution.js +411 -0
  489. package/src/runs/shared/model-scope.d.ts +68 -0
  490. package/src/runs/shared/model-scope.js +171 -0
  491. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  492. package/src/runs/shared/mutation-evidence.js +198 -0
  493. package/src/runs/shared/nested-events.d.ts +135 -0
  494. package/src/runs/shared/nested-events.js +1090 -0
  495. package/src/runs/shared/nested-path.d.ts +8 -0
  496. package/src/runs/shared/nested-path.js +34 -0
  497. package/src/runs/shared/nested-render.d.ts +20 -0
  498. package/src/runs/shared/nested-render.js +115 -0
  499. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  500. package/src/runs/shared/orca-progress-tabs.js +503 -0
  501. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  502. package/src/runs/shared/parallel-handoff.js +783 -0
  503. package/src/runs/shared/parallel-utils.d.ts +177 -0
  504. package/src/runs/shared/parallel-utils.js +125 -0
  505. package/src/runs/shared/partial-output.d.ts +24 -0
  506. package/src/runs/shared/partial-output.js +35 -0
  507. package/src/runs/shared/permissions.d.ts +12 -0
  508. package/src/runs/shared/permissions.js +92 -0
  509. package/src/runs/shared/pi-spawn.d.ts +31 -0
  510. package/src/runs/shared/pi-spawn.js +211 -0
  511. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  512. package/src/runs/shared/placed-run-owner.js +93 -0
  513. package/src/runs/shared/placement-host.d.ts +99 -0
  514. package/src/runs/shared/placement-host.js +157 -0
  515. package/src/runs/shared/process-signal.d.ts +15 -0
  516. package/src/runs/shared/process-signal.js +21 -0
  517. package/src/runs/shared/profile-extensions.d.ts +21 -0
  518. package/src/runs/shared/profile-extensions.js +122 -0
  519. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  520. package/src/runs/shared/profile-launch-env.js +90 -0
  521. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  522. package/src/runs/shared/readonly-drain-observation.js +50 -0
  523. package/src/runs/shared/rex-machine.d.ts +25 -0
  524. package/src/runs/shared/rex-machine.js +83 -0
  525. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  526. package/src/runs/shared/rex-pane-host.js +327 -0
  527. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  528. package/src/runs/shared/run-fanout-budget.js +258 -0
  529. package/src/runs/shared/run-ownership.d.ts +3 -0
  530. package/src/runs/shared/run-ownership.js +8 -0
  531. package/src/runs/shared/runner-launcher.d.ts +11 -0
  532. package/src/runs/shared/runner-launcher.js +24 -0
  533. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  534. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  535. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  536. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  537. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  538. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  539. package/src/runs/shared/session-lease.d.ts +69 -0
  540. package/src/runs/shared/session-lease.js +250 -0
  541. package/src/runs/shared/single-output.d.ts +90 -0
  542. package/src/runs/shared/single-output.js +349 -0
  543. package/src/runs/shared/spawn-budget.d.ts +20 -0
  544. package/src/runs/shared/spawn-budget.js +93 -0
  545. package/src/runs/shared/structured-output.d.ts +66 -0
  546. package/src/runs/shared/structured-output.js +483 -0
  547. package/src/runs/shared/subagent-control.d.ts +50 -0
  548. package/src/runs/shared/subagent-control.js +247 -0
  549. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  550. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  551. package/src/runs/shared/tool-availability.d.ts +16 -0
  552. package/src/runs/shared/tool-availability.js +29 -0
  553. package/src/runs/shared/tool-budget.d.ts +21 -0
  554. package/src/runs/shared/tool-budget.js +78 -0
  555. package/src/runs/shared/tool-timeout.d.ts +31 -0
  556. package/src/runs/shared/tool-timeout.js +73 -0
  557. package/src/runs/shared/usage-budget.d.ts +7 -0
  558. package/src/runs/shared/usage-budget.js +74 -0
  559. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  560. package/src/runs/shared/usage-reconciliation.js +71 -0
  561. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  562. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  563. package/src/runs/shared/workflow-graph.d.ts +31 -0
  564. package/src/runs/shared/workflow-graph.js +221 -0
  565. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  566. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  567. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  568. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  569. package/src/runs/shared/worktree-lock.d.ts +5 -0
  570. package/src/runs/shared/worktree-lock.js +40 -0
  571. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  572. package/src/runs/shared/worktree-setup-command.js +200 -0
  573. package/src/runs/shared/worktree.d.ts +181 -0
  574. package/src/runs/shared/worktree.js +1346 -0
  575. package/src/shared/accessible-dir.d.ts +11 -0
  576. package/src/shared/accessible-dir.js +39 -0
  577. package/src/shared/agent-stream-options.d.ts +5 -0
  578. package/src/shared/agent-stream-options.js +3 -0
  579. package/src/shared/artifacts.d.ts +22 -0
  580. package/src/shared/artifacts.js +272 -0
  581. package/src/shared/atomic-json.d.ts +19 -0
  582. package/src/shared/atomic-json.js +61 -0
  583. package/src/shared/capacity-resilient-json.d.ts +26 -0
  584. package/src/shared/capacity-resilient-json.js +86 -0
  585. package/src/shared/child-cache-retention.d.ts +29 -0
  586. package/src/shared/child-cache-retention.js +40 -0
  587. package/src/shared/child-session-name.d.ts +8 -0
  588. package/src/shared/child-session-name.js +40 -0
  589. package/src/shared/child-transcript.d.ts +37 -0
  590. package/src/shared/child-transcript.js +225 -0
  591. package/src/shared/completion-owner.d.ts +7 -0
  592. package/src/shared/completion-owner.js +13 -0
  593. package/src/shared/disabled-features.d.ts +93 -0
  594. package/src/shared/disabled-features.js +120 -0
  595. package/src/shared/display-text.d.ts +5 -0
  596. package/src/shared/display-text.js +154 -0
  597. package/src/shared/edit-distance.d.ts +4 -0
  598. package/src/shared/edit-distance.js +32 -0
  599. package/src/shared/extension-context.d.ts +21 -0
  600. package/src/shared/extension-context.js +39 -0
  601. package/src/shared/file-coalescer.d.ts +11 -0
  602. package/src/shared/file-coalescer.js +34 -0
  603. package/src/shared/file-lease.d.ts +10 -0
  604. package/src/shared/file-lease.js +106 -0
  605. package/src/shared/file-system-retry.d.ts +31 -0
  606. package/src/shared/file-system-retry.js +84 -0
  607. package/src/shared/fork-context.d.ts +64 -0
  608. package/src/shared/fork-context.js +185 -0
  609. package/src/shared/fork-session-cwd.d.ts +2 -0
  610. package/src/shared/fork-session-cwd.js +23 -0
  611. package/src/shared/formatters.d.ts +35 -0
  612. package/src/shared/formatters.js +137 -0
  613. package/src/shared/jsonl-writer.d.ts +20 -0
  614. package/src/shared/jsonl-writer.js +67 -0
  615. package/src/shared/launch-contract.d.ts +65 -0
  616. package/src/shared/launch-contract.js +145 -0
  617. package/src/shared/model-info.d.ts +55 -0
  618. package/src/shared/model-info.js +103 -0
  619. package/src/shared/model-response-aliases.d.ts +1 -0
  620. package/src/shared/model-response-aliases.js +15 -0
  621. package/src/shared/node-executable.d.ts +1 -0
  622. package/src/shared/node-executable.js +20 -0
  623. package/src/shared/opencode-session-headers.d.ts +12 -0
  624. package/src/shared/opencode-session-headers.js +26 -0
  625. package/src/shared/package-version.d.ts +2 -0
  626. package/src/shared/package-version.js +14 -0
  627. package/src/shared/parent-wake.d.ts +26 -0
  628. package/src/shared/parent-wake.js +68 -0
  629. package/src/shared/permission-profile.d.ts +26 -0
  630. package/src/shared/permission-profile.js +49 -0
  631. package/src/shared/prompt-resources.d.ts +5 -0
  632. package/src/shared/prompt-resources.js +10 -0
  633. package/src/shared/provider-diagnostics.d.ts +9 -0
  634. package/src/shared/provider-diagnostics.js +75 -0
  635. package/src/shared/pruned-fork.d.ts +34 -0
  636. package/src/shared/pruned-fork.js +434 -0
  637. package/src/shared/required-child-extensions.d.ts +34 -0
  638. package/src/shared/required-child-extensions.js +105 -0
  639. package/src/shared/runtime-module-path.d.ts +10 -0
  640. package/src/shared/runtime-module-path.js +16 -0
  641. package/src/shared/sandbox-profile.d.ts +12 -0
  642. package/src/shared/sandbox-profile.js +35 -0
  643. package/src/shared/session-file-trust.d.ts +1 -0
  644. package/src/shared/session-file-trust.js +20 -0
  645. package/src/shared/session-identity.d.ts +8 -0
  646. package/src/shared/session-identity.js +32 -0
  647. package/src/shared/session-succession.d.ts +4 -0
  648. package/src/shared/session-succession.js +24 -0
  649. package/src/shared/session-tokens.d.ts +2 -0
  650. package/src/shared/session-tokens.js +58 -0
  651. package/src/shared/settings-file-lease.d.ts +4 -0
  652. package/src/shared/settings-file-lease.js +38 -0
  653. package/src/shared/settings.d.ts +146 -0
  654. package/src/shared/settings.js +247 -0
  655. package/src/shared/shortcuts.d.ts +1 -0
  656. package/src/shared/shortcuts.js +17 -0
  657. package/src/shared/status-format.d.ts +9 -0
  658. package/src/shared/status-format.js +60 -0
  659. package/src/shared/thinking-ceiling.d.ts +13 -0
  660. package/src/shared/thinking-ceiling.js +37 -0
  661. package/src/shared/types.d.ts +2840 -0
  662. package/src/shared/types.js +276 -0
  663. package/src/shared/utf8.d.ts +5 -0
  664. package/src/shared/utf8.js +12 -0
  665. package/src/shared/utils.d.ts +83 -0
  666. package/src/shared/utils.js +612 -0
  667. package/src/shared/watch-strategy.d.ts +2 -0
  668. package/src/shared/watch-strategy.js +5 -0
  669. package/src/shared/workflow-child-permit.d.ts +58 -0
  670. package/src/shared/workflow-child-permit.js +159 -0
  671. package/src/slash/delegation-adapters.d.ts +154 -0
  672. package/src/slash/delegation-adapters.js +316 -0
  673. package/src/slash/delegation-json.d.ts +10 -0
  674. package/src/slash/delegation-json.js +117 -0
  675. package/src/slash/delegation-request.d.ts +12 -0
  676. package/src/slash/delegation-request.js +174 -0
  677. package/src/slash/prompt-template-bridge.d.ts +29 -0
  678. package/src/slash/prompt-template-bridge.js +399 -0
  679. package/src/slash/prompt-workflows.d.ts +21 -0
  680. package/src/slash/prompt-workflows.js +274 -0
  681. package/src/slash/selector.d.ts +47 -0
  682. package/src/slash/selector.js +117 -0
  683. package/src/slash/slash-bridge.d.ts +30 -0
  684. package/src/slash/slash-bridge.js +132 -0
  685. package/src/slash/slash-commands.d.ts +10 -0
  686. package/src/slash/slash-commands.js +1059 -0
  687. package/src/slash/slash-live-state.d.ts +21 -0
  688. package/src/slash/slash-live-state.js +263 -0
  689. package/src/slash/subagent-cost.d.ts +29 -0
  690. package/src/slash/subagent-cost.js +310 -0
  691. package/src/slash/subagents-admin.d.ts +3 -0
  692. package/src/slash/subagents-admin.js +481 -0
  693. package/src/tui/fleet-layout.d.ts +20 -0
  694. package/src/tui/fleet-layout.js +17 -0
  695. package/src/tui/fleet-native-transcript.d.ts +53 -0
  696. package/src/tui/fleet-native-transcript.js +339 -0
  697. package/src/tui/fleet-status.d.ts +92 -0
  698. package/src/tui/fleet-status.js +1132 -0
  699. package/src/tui/fleet-transcript.d.ts +64 -0
  700. package/src/tui/fleet-transcript.js +544 -0
  701. package/src/tui/fleet-viewport.d.ts +12 -0
  702. package/src/tui/fleet-viewport.js +35 -0
  703. package/src/tui/fleet.d.ts +196 -0
  704. package/src/tui/fleet.js +1588 -0
  705. package/src/tui/mouse-events.d.ts +21 -0
  706. package/src/tui/mouse-events.js +26 -0
  707. package/src/tui/render-helpers.d.ts +23 -0
  708. package/src/tui/render-helpers.js +100 -0
  709. package/src/tui/render.d.ts +66 -0
  710. package/src/tui/render.js +3707 -0
  711. package/src/tui/running-tone.d.ts +10 -0
  712. package/src/tui/running-tone.js +22 -0
  713. package/src/tui/subagent-messages.d.ts +22 -0
  714. package/src/tui/subagent-messages.js +270 -0
  715. package/src/ui-silent-marker.d.ts +20 -0
  716. package/src/ui-silent-marker.js +25 -0
  717. package/src/watchdog/change-signature.d.ts +7 -0
  718. package/src/watchdog/change-signature.js +243 -0
  719. package/src/watchdog/child-status.d.ts +53 -0
  720. package/src/watchdog/child-status.js +187 -0
  721. package/src/watchdog/diff-tool.d.ts +25 -0
  722. package/src/watchdog/diff-tool.js +104 -0
  723. package/src/watchdog/emission-guard.d.ts +36 -0
  724. package/src/watchdog/emission-guard.js +97 -0
  725. package/src/watchdog/guidance.d.ts +3 -0
  726. package/src/watchdog/guidance.js +19 -0
  727. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  728. package/src/watchdog/lsp-diagnostics.js +489 -0
  729. package/src/watchdog/model-selection.d.ts +24 -0
  730. package/src/watchdog/model-selection.js +167 -0
  731. package/src/watchdog/permission-arbiter.d.ts +20 -0
  732. package/src/watchdog/permission-arbiter.js +135 -0
  733. package/src/watchdog/register-child.d.ts +13 -0
  734. package/src/watchdog/register-child.js +128 -0
  735. package/src/watchdog/register-main.d.ts +11 -0
  736. package/src/watchdog/register-main.js +400 -0
  737. package/src/watchdog/render.d.ts +3 -0
  738. package/src/watchdog/render.js +33 -0
  739. package/src/watchdog/review.d.ts +36 -0
  740. package/src/watchdog/review.js +319 -0
  741. package/src/watchdog/rules.d.ts +21 -0
  742. package/src/watchdog/rules.js +58 -0
  743. package/src/watchdog/runtime.d.ts +195 -0
  744. package/src/watchdog/runtime.js +864 -0
  745. package/src/watchdog/scope.d.ts +14 -0
  746. package/src/watchdog/scope.js +44 -0
  747. package/src/watchdog/settings.d.ts +29 -0
  748. package/src/watchdog/settings.js +480 -0
  749. package/src/watchdog/tool-actions.d.ts +17 -0
  750. package/src/watchdog/tool-actions.js +150 -0
  751. package/src/watchdog/turn-delta.d.ts +15 -0
  752. package/src/watchdog/turn-delta.js +188 -0
  753. package/src/watchdog/types.d.ts +141 -0
  754. package/src/watchdog/types.js +27 -0
  755. package/src/watchdog/warning-format.d.ts +7 -0
  756. package/src/watchdog/warning-format.js +59 -0
  757. package/src/workflows/chat-progress.d.ts +37 -0
  758. package/src/workflows/chat-progress.js +129 -0
  759. package/src/workflows/host-command.d.ts +30 -0
  760. package/src/workflows/host-command.js +227 -0
  761. package/src/workflows/scripted-workflow.d.ts +204 -0
  762. package/src/workflows/scripted-workflow.js +1673 -0
  763. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  764. package/src/workflows/structured-workflow-scripts.js +179 -0
  765. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  766. package/src/workflows/workflow-auto-resume.js +102 -0
  767. package/src/workflows/workflow-checklist.d.ts +127 -0
  768. package/src/workflows/workflow-checklist.js +314 -0
  769. package/src/workflows/workflow-child-summary.d.ts +24 -0
  770. package/src/workflows/workflow-child-summary.js +195 -0
  771. package/src/workflows/workflow-launch-record.d.ts +27 -0
  772. package/src/workflows/workflow-launch-record.js +48 -0
  773. package/src/workflows/workflow-preflight.d.ts +58 -0
  774. package/src/workflows/workflow-preflight.js +288 -0
  775. package/src/workflows/workflow-receipt.d.ts +34 -0
  776. package/src/workflows/workflow-receipt.js +454 -0
  777. package/src/workflows/workflow-resources.d.ts +55 -0
  778. package/src/workflows/workflow-resources.js +271 -0
  779. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  780. package/src/workflows/workflow-resume-claim.js +210 -0
  781. package/src/workflows/workflow-resume.d.ts +56 -0
  782. package/src/workflows/workflow-resume.js +106 -0
  783. package/src/workflows/workflow-reuse.d.ts +61 -0
  784. package/src/workflows/workflow-reuse.js +186 -0
  785. package/src/workflows/workflow-revival.d.ts +33 -0
  786. package/src/workflows/workflow-revival.js +111 -0
  787. package/src/workflows/workflow-settlement.d.ts +84 -0
  788. package/src/workflows/workflow-settlement.js +203 -0
  789. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  790. package/src/workflows/workflow-stop-cause.js +8 -0
  791. package/workflow-script-worker.cjs +1342 -0
  792. package/index.ts +0 -18
  793. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  794. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  795. package/skills/pi-subagents/references/execution-controls.md +0 -561
  796. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  797. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  798. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  799. package/src/agents/advertised-agent-prompt.ts +0 -82
  800. package/src/agents/agent-eject.ts +0 -339
  801. package/src/agents/agent-management.ts +0 -1442
  802. package/src/agents/agent-memory.ts +0 -341
  803. package/src/agents/agent-refinements.ts +0 -624
  804. package/src/agents/agent-scope.ts +0 -10
  805. package/src/agents/agent-selection.ts +0 -25
  806. package/src/agents/agent-serializer.ts +0 -195
  807. package/src/agents/agents.ts +0 -3169
  808. package/src/agents/builtin-names.ts +0 -16
  809. package/src/agents/chain-serializer.ts +0 -285
  810. package/src/agents/frontmatter.ts +0 -153
  811. package/src/agents/global-npm-root.ts +0 -58
  812. package/src/agents/identity.ts +0 -30
  813. package/src/agents/proactive-skills.ts +0 -197
  814. package/src/agents/runtime-agent-events.ts +0 -70
  815. package/src/agents/runtime-agent-registry.ts +0 -457
  816. package/src/agents/runtime-discovery.ts +0 -39
  817. package/src/agents/skills.ts +0 -787
  818. package/src/api/agent-management.ts +0 -9
  819. package/src/api/agents.ts +0 -19
  820. package/src/api/background-work.ts +0 -206
  821. package/src/api/capability-ceiling.ts +0 -16
  822. package/src/api/child-tool-plan.ts +0 -5
  823. package/src/api/control-channel.ts +0 -4
  824. package/src/api/delegation.ts +0 -131
  825. package/src/api/external-job-provider.ts +0 -195
  826. package/src/api/external-runs.ts +0 -282
  827. package/src/api/inspectors.ts +0 -27
  828. package/src/api/intercom-bridge.ts +0 -3
  829. package/src/api/preflight.ts +0 -641
  830. package/src/api/project-panes.ts +0 -32
  831. package/src/api/required-child-extensions.ts +0 -6
  832. package/src/api/shared-types.ts +0 -29
  833. package/src/api/workflow-resources.ts +0 -6
  834. package/src/extension/config.ts +0 -262
  835. package/src/extension/context-injection.ts +0 -123
  836. package/src/extension/control-notices.ts +0 -53
  837. package/src/extension/declaration-pinning.ts +0 -164
  838. package/src/extension/doctor.ts +0 -284
  839. package/src/extension/fanout-child.ts +0 -282
  840. package/src/extension/herdr-pi-bridge.ts +0 -166
  841. package/src/extension/index.ts +0 -1185
  842. package/src/extension/public-execution.ts +0 -262
  843. package/src/extension/reply-workflow-script.ts +0 -67
  844. package/src/extension/rpc.ts +0 -881
  845. package/src/extension/schemas.ts +0 -337
  846. package/src/extension/steering-notices.ts +0 -35
  847. package/src/extension/subagent-guide.ts +0 -127
  848. package/src/extension/subagent-options.ts +0 -47
  849. package/src/extension/tool-activation.ts +0 -147
  850. package/src/extension/tool-description.ts +0 -193
  851. package/src/extension/tool-result.ts +0 -19
  852. package/src/extension/upgrade-notice.ts +0 -40
  853. package/src/inspectors/actions.ts +0 -174
  854. package/src/inspectors/ghostty/actions.ts +0 -74
  855. package/src/inspectors/ghostty/plugin.ts +0 -29
  856. package/src/inspectors/herdr/actions.ts +0 -155
  857. package/src/inspectors/herdr/client.ts +0 -130
  858. package/src/inspectors/herdr/focus.ts +0 -55
  859. package/src/inspectors/herdr/plugin.ts +0 -20
  860. package/src/inspectors/herdr/project-panes.ts +0 -733
  861. package/src/inspectors/inspector-runner.ts +0 -153
  862. package/src/inspectors/plugins.ts +0 -76
  863. package/src/inspectors/session-roots-codec.ts +0 -31
  864. package/src/inspectors/shell-command.ts +0 -16
  865. package/src/inspectors/tmux/actions.ts +0 -204
  866. package/src/inspectors/tmux/client.ts +0 -85
  867. package/src/inspectors/tmux/plugin.ts +0 -21
  868. package/src/inspectors/types.ts +0 -51
  869. package/src/integrations/herdr-status.ts +0 -385
  870. package/src/integrations/pi-web-session-liveness.ts +0 -73
  871. package/src/integrations/program-status.ts +0 -215
  872. package/src/intercom/intercom-bridge.ts +0 -235
  873. package/src/intercom/native-supervisor-channel.ts +0 -1000
  874. package/src/intercom/result-intercom.ts +0 -433
  875. package/src/intercom/supervisor-ui.ts +0 -72
  876. package/src/missions/actions.ts +0 -433
  877. package/src/missions/goal-driver.ts +0 -177
  878. package/src/missions/lifecycle.ts +0 -367
  879. package/src/missions/store.ts +0 -613
  880. package/src/missions/types.ts +0 -190
  881. package/src/missions/workflow-state.ts +0 -281
  882. package/src/policy/authority.ts +0 -50
  883. package/src/profiles/profiles.ts +0 -674
  884. package/src/runs/background/active-async-capacity.ts +0 -548
  885. package/src/runs/background/active-run-index.ts +0 -155
  886. package/src/runs/background/async-execution.ts +0 -2479
  887. package/src/runs/background/async-job-tracker.ts +0 -869
  888. package/src/runs/background/async-resume.ts +0 -686
  889. package/src/runs/background/async-retention.ts +0 -953
  890. package/src/runs/background/async-status-snapshot.ts +0 -46
  891. package/src/runs/background/async-status.ts +0 -787
  892. package/src/runs/background/auto-drain.ts +0 -92
  893. package/src/runs/background/await-async-run.ts +0 -83
  894. package/src/runs/background/binary-bootstrap.ts +0 -67
  895. package/src/runs/background/calendar-schedule.ts +0 -90
  896. package/src/runs/background/chain-append.ts +0 -321
  897. package/src/runs/background/chain-root-attachment.ts +0 -263
  898. package/src/runs/background/completion-batcher.ts +0 -168
  899. package/src/runs/background/completion-dedupe.ts +0 -58
  900. package/src/runs/background/completion-replay.ts +0 -287
  901. package/src/runs/background/control-channel.ts +0 -659
  902. package/src/runs/background/fleet-view.ts +0 -692
  903. package/src/runs/background/index-segment.ts +0 -59
  904. package/src/runs/background/inspect-rpc.ts +0 -443
  905. package/src/runs/background/notify.ts +0 -1083
  906. package/src/runs/background/owned-process-tree.ts +0 -131
  907. package/src/runs/background/parallel-groups.ts +0 -45
  908. package/src/runs/background/pid-namespace.ts +0 -18
  909. package/src/runs/background/process-terminal-candidate.ts +0 -98
  910. package/src/runs/background/process-terminal.ts +0 -231
  911. package/src/runs/background/result-delivery-ownership.ts +0 -45
  912. package/src/runs/background/result-files.ts +0 -634
  913. package/src/runs/background/result-watcher.ts +0 -842
  914. package/src/runs/background/resume-guidance.ts +0 -56
  915. package/src/runs/background/retained-children.ts +0 -136
  916. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  917. package/src/runs/background/run-child-session.ts +0 -725
  918. package/src/runs/background/run-id-query.ts +0 -7
  919. package/src/runs/background/run-id-resolver.ts +0 -183
  920. package/src/runs/background/run-status.ts +0 -803
  921. package/src/runs/background/runner-aliases.ts +0 -183
  922. package/src/runs/background/runner-child-launch.ts +0 -96
  923. package/src/runs/background/runner-child-sessions.ts +0 -32
  924. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  925. package/src/runs/background/runner-startup-failure.ts +0 -56
  926. package/src/runs/background/scheduled-runs.ts +0 -1222
  927. package/src/runs/background/stale-run-reconciler.ts +0 -463
  928. package/src/runs/background/steering.ts +0 -260
  929. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  930. package/src/runs/background/subagent-runner.ts +0 -5251
  931. package/src/runs/background/subagent-wait.ts +0 -895
  932. package/src/runs/background/terminal-run-index.ts +0 -183
  933. package/src/runs/background/top-level-async.ts +0 -14
  934. package/src/runs/background/wait-completions.ts +0 -262
  935. package/src/runs/background/wait-config.ts +0 -50
  936. package/src/runs/background/wait-subscriptions.ts +0 -354
  937. package/src/runs/background/wait-tool.ts +0 -57
  938. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  939. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  940. package/src/runs/foreground/async-steering-action.ts +0 -276
  941. package/src/runs/foreground/async-stop-action.ts +0 -216
  942. package/src/runs/foreground/command-action.ts +0 -41
  943. package/src/runs/foreground/execution.ts +0 -2315
  944. package/src/runs/foreground/foreground-control.ts +0 -157
  945. package/src/runs/foreground/foreground-history.ts +0 -164
  946. package/src/runs/foreground/prompt-audit.ts +0 -172
  947. package/src/runs/foreground/subagent-executor.ts +0 -8227
  948. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  949. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  950. package/src/runs/shared/abort-recovery.ts +0 -119
  951. package/src/runs/shared/acceptance.ts +0 -1664
  952. package/src/runs/shared/agent-contract.ts +0 -38
  953. package/src/runs/shared/async-status-projection.ts +0 -664
  954. package/src/runs/shared/background-process-options.ts +0 -9
  955. package/src/runs/shared/capability-ceiling.ts +0 -214
  956. package/src/runs/shared/chain-outputs.ts +0 -116
  957. package/src/runs/shared/child-commands.ts +0 -229
  958. package/src/runs/shared/child-hooks.ts +0 -175
  959. package/src/runs/shared/child-identity.ts +0 -62
  960. package/src/runs/shared/child-launch-plan.ts +0 -163
  961. package/src/runs/shared/child-launch.ts +0 -389
  962. package/src/runs/shared/child-lifecycle.ts +0 -28
  963. package/src/runs/shared/child-runtime-config.ts +0 -136
  964. package/src/runs/shared/child-session.ts +0 -699
  965. package/src/runs/shared/child-tool-plan.ts +0 -599
  966. package/src/runs/shared/claude-code-adapter.ts +0 -288
  967. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  968. package/src/runs/shared/context-mode.ts +0 -44
  969. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  970. package/src/runs/shared/dynamic-fanout.ts +0 -297
  971. package/src/runs/shared/effective-system-prompt.ts +0 -33
  972. package/src/runs/shared/extension-bindings.ts +0 -103
  973. package/src/runs/shared/external-cli-contract.ts +0 -177
  974. package/src/runs/shared/external-cli-preflight.ts +0 -190
  975. package/src/runs/shared/external-cli-runner.ts +0 -437
  976. package/src/runs/shared/external-job-bridge.ts +0 -514
  977. package/src/runs/shared/external-job-runner.ts +0 -389
  978. package/src/runs/shared/fast-mode-extension.ts +0 -10
  979. package/src/runs/shared/fork-command-result.ts +0 -10
  980. package/src/runs/shared/git-environment.ts +0 -29
  981. package/src/runs/shared/herdr-connection.ts +0 -134
  982. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  983. package/src/runs/shared/herdr-machine.ts +0 -279
  984. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  985. package/src/runs/shared/herdr-placed-run.ts +0 -264
  986. package/src/runs/shared/host-step-status.ts +0 -231
  987. package/src/runs/shared/lane-metadata.ts +0 -126
  988. package/src/runs/shared/launch-cwd.ts +0 -16
  989. package/src/runs/shared/long-running-guard.ts +0 -221
  990. package/src/runs/shared/mcp-config-sources.ts +0 -426
  991. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  992. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  993. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  994. package/src/runs/shared/model-resolution.ts +0 -503
  995. package/src/runs/shared/model-scope.ts +0 -224
  996. package/src/runs/shared/mutation-evidence.ts +0 -199
  997. package/src/runs/shared/nested-events.ts +0 -1125
  998. package/src/runs/shared/nested-path.ts +0 -38
  999. package/src/runs/shared/nested-render.ts +0 -127
  1000. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1001. package/src/runs/shared/parallel-handoff.ts +0 -789
  1002. package/src/runs/shared/parallel-utils.ts +0 -292
  1003. package/src/runs/shared/partial-output.ts +0 -48
  1004. package/src/runs/shared/permissions.ts +0 -86
  1005. package/src/runs/shared/pi-spawn.ts +0 -205
  1006. package/src/runs/shared/process-signal.ts +0 -35
  1007. package/src/runs/shared/profile-extensions.ts +0 -134
  1008. package/src/runs/shared/profile-launch-env.ts +0 -121
  1009. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1010. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1011. package/src/runs/shared/run-history.ts +0 -288
  1012. package/src/runs/shared/runner-launcher.ts +0 -25
  1013. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1014. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1015. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1016. package/src/runs/shared/session-lease.ts +0 -293
  1017. package/src/runs/shared/single-output.ts +0 -366
  1018. package/src/runs/shared/spawn-budget.ts +0 -128
  1019. package/src/runs/shared/structured-output.ts +0 -463
  1020. package/src/runs/shared/subagent-control.ts +0 -295
  1021. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1022. package/src/runs/shared/tool-availability.ts +0 -37
  1023. package/src/runs/shared/tool-budget.ts +0 -87
  1024. package/src/runs/shared/tool-timeout.ts +0 -93
  1025. package/src/runs/shared/usage-budget.ts +0 -65
  1026. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1027. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1028. package/src/runs/shared/workflow-graph.ts +0 -225
  1029. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1030. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1031. package/src/runs/shared/worktree-lock.ts +0 -29
  1032. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1033. package/src/runs/shared/worktree.ts +0 -1554
  1034. package/src/shared/accessible-dir.ts +0 -47
  1035. package/src/shared/agent-stream-options.ts +0 -5
  1036. package/src/shared/artifacts.ts +0 -281
  1037. package/src/shared/atomic-json.ts +0 -85
  1038. package/src/shared/capacity-resilient-json.ts +0 -102
  1039. package/src/shared/child-cache-retention.ts +0 -43
  1040. package/src/shared/child-session-name.ts +0 -48
  1041. package/src/shared/child-transcript.ts +0 -264
  1042. package/src/shared/completion-owner.ts +0 -14
  1043. package/src/shared/disabled-features.ts +0 -123
  1044. package/src/shared/display-text.ts +0 -150
  1045. package/src/shared/edit-distance.ts +0 -33
  1046. package/src/shared/extension-context.ts +0 -37
  1047. package/src/shared/file-coalescer.ts +0 -49
  1048. package/src/shared/file-lease.ts +0 -74
  1049. package/src/shared/file-system-retry.ts +0 -95
  1050. package/src/shared/fork-context.ts +0 -243
  1051. package/src/shared/fork-session-cwd.ts +0 -27
  1052. package/src/shared/formatters.ts +0 -142
  1053. package/src/shared/jsonl-writer.ts +0 -92
  1054. package/src/shared/launch-contract.ts +0 -206
  1055. package/src/shared/model-info.ts +0 -132
  1056. package/src/shared/model-response-aliases.ts +0 -13
  1057. package/src/shared/node-executable.ts +0 -21
  1058. package/src/shared/opencode-session-headers.ts +0 -30
  1059. package/src/shared/package-version.ts +0 -17
  1060. package/src/shared/parent-wake.ts +0 -79
  1061. package/src/shared/permission-profile.ts +0 -56
  1062. package/src/shared/prompt-resources.ts +0 -11
  1063. package/src/shared/pruned-fork.ts +0 -469
  1064. package/src/shared/required-child-extensions.ts +0 -115
  1065. package/src/shared/runtime-module-path.ts +0 -19
  1066. package/src/shared/sandbox-profile.ts +0 -37
  1067. package/src/shared/session-file-trust.ts +0 -19
  1068. package/src/shared/session-identity.ts +0 -10
  1069. package/src/shared/session-tokens.ts +0 -55
  1070. package/src/shared/settings-file-lease.ts +0 -36
  1071. package/src/shared/settings.ts +0 -412
  1072. package/src/shared/shortcuts.ts +0 -13
  1073. package/src/shared/status-format.ts +0 -55
  1074. package/src/shared/thinking-ceiling.ts +0 -46
  1075. package/src/shared/types.ts +0 -3105
  1076. package/src/shared/utf8.ts +0 -11
  1077. package/src/shared/utils.ts +0 -610
  1078. package/src/shared/watch-strategy.ts +0 -12
  1079. package/src/shared/workflow-child-permit.ts +0 -212
  1080. package/src/slash/delegation-adapters.ts +0 -452
  1081. package/src/slash/delegation-json.ts +0 -108
  1082. package/src/slash/delegation-request.ts +0 -176
  1083. package/src/slash/prompt-template-bridge.ts +0 -434
  1084. package/src/slash/prompt-workflows.ts +0 -298
  1085. package/src/slash/selector.ts +0 -147
  1086. package/src/slash/slash-bridge.ts +0 -192
  1087. package/src/slash/slash-commands.ts +0 -1096
  1088. package/src/slash/slash-live-state.ts +0 -310
  1089. package/src/slash/subagent-cost.ts +0 -317
  1090. package/src/slash/subagents-admin.ts +0 -489
  1091. package/src/tui/fleet-native-transcript.ts +0 -424
  1092. package/src/tui/fleet-status.ts +0 -1139
  1093. package/src/tui/fleet-transcript.ts +0 -591
  1094. package/src/tui/fleet.ts +0 -1618
  1095. package/src/tui/mouse-events.ts +0 -42
  1096. package/src/tui/render-helpers.ts +0 -111
  1097. package/src/tui/render.ts +0 -3824
  1098. package/src/tui/running-tone.ts +0 -28
  1099. package/src/tui/subagent-messages.ts +0 -305
  1100. package/src/ui-silent-marker.ts +0 -32
  1101. package/src/watchdog/change-signature.ts +0 -260
  1102. package/src/watchdog/child-status.ts +0 -225
  1103. package/src/watchdog/diff-tool.ts +0 -112
  1104. package/src/watchdog/emission-guard.ts +0 -125
  1105. package/src/watchdog/guidance.ts +0 -20
  1106. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1107. package/src/watchdog/model-selection.ts +0 -187
  1108. package/src/watchdog/permission-arbiter.ts +0 -154
  1109. package/src/watchdog/register-child.ts +0 -136
  1110. package/src/watchdog/register-main.ts +0 -425
  1111. package/src/watchdog/render.ts +0 -31
  1112. package/src/watchdog/review.ts +0 -362
  1113. package/src/watchdog/rules.ts +0 -70
  1114. package/src/watchdog/runtime.ts +0 -927
  1115. package/src/watchdog/scope.ts +0 -51
  1116. package/src/watchdog/settings.ts +0 -520
  1117. package/src/watchdog/tool-actions.ts +0 -156
  1118. package/src/watchdog/turn-delta.ts +0 -190
  1119. package/src/watchdog/types.ts +0 -186
  1120. package/src/watchdog/warning-format.ts +0 -72
  1121. package/src/workflows/chat-progress.ts +0 -152
  1122. package/src/workflows/host-command.ts +0 -235
  1123. package/src/workflows/scripted-workflow.ts +0 -2733
  1124. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1125. package/src/workflows/workflow-checklist.ts +0 -442
  1126. package/src/workflows/workflow-child-summary.ts +0 -172
  1127. package/src/workflows/workflow-preflight.ts +0 -297
  1128. package/src/workflows/workflow-receipt.ts +0 -390
  1129. package/src/workflows/workflow-resources.ts +0 -275
  1130. package/src/workflows/workflow-reuse.ts +0 -120
  1131. package/src/workflows/workflow-revival.ts +0 -123
  1132. package/src/workflows/workflow-settlement.ts +0 -252
@@ -0,0 +1,1342 @@
1
+ "use strict";
2
+
3
+ const { parentPort, workerData } = require("node:worker_threads");
4
+ const vm = require("node:vm");
5
+ const { inspect } = require("node:util");
6
+ const { parse } = require(workerData.acornPath);
7
+
8
+ let promiseHooks;
9
+ try {
10
+ ({ promiseHooks } = require("node:v8"));
11
+ } catch {}
12
+
13
+ function createWorkflowPromiseHook(callbacks) {
14
+ if (!promiseHooks || typeof promiseHooks.createHook !== "function") return () => {};
15
+ try {
16
+ return promiseHooks.createHook(callbacks);
17
+ } catch (error) {
18
+ if (error?.name !== "NotImplementedError") throw error;
19
+ return () => {};
20
+ }
21
+ }
22
+
23
+ // Workflow scripts run in their own vm context (the script realm). The API a script can reach (runs,
24
+ // state, emit, console, Promise, results, errors) is built by workflowRuntime inside a second vm
25
+ // context (the runtime realm), compiled from this function's source. Neither realm can compile code
26
+ // from strings, and no worker-realm object may ever become reachable from either: one would hand the
27
+ // script the worker's Function, and with it process. The runtime talks to the worker only through
28
+ // `bridge`, which it keeps in this closure, passes only strings and numbers, and calls in try/catch.
29
+ // Engine paths can still throw a worker-realm error into script code (a stack overflow inside Node's
30
+ // stack formatter, for one), so lockWorkerRealm also makes every worker value useless before a script runs.
31
+ function workflowRuntime(bridge, scriptRealm, stateEnabled) {
32
+ "use strict";
33
+
34
+ // Promise hooks report every promise in the isolate, the worker's own included. Captured before any
35
+ // script runs, so a script that replaces Object.getPrototypeOf cannot receive a worker promise.
36
+ const getPrototypeOf = Object.getPrototypeOf;
37
+ const runtimePromisePrototype = Promise.prototype;
38
+ const nativePromisePrototype = scriptRealm.promisePrototype;
39
+
40
+ function isWorkflowRealmPromise(value) {
41
+ if (!value || typeof value !== "object") return false;
42
+ let prototype = getPrototypeOf(value);
43
+ for (let depth = 0; prototype && depth < 16; depth++) {
44
+ if (prototype === nativePromisePrototype || prototype === runtimePromisePrototype) return true;
45
+ prototype = getPrototypeOf(prototype);
46
+ }
47
+ return false;
48
+ }
49
+
50
+ function post(message) {
51
+ const json = JSON.stringify(message);
52
+ let posted = false;
53
+ try {
54
+ posted = bridge.post(json);
55
+ } catch {}
56
+ if (posted !== true) throw new Error("Workflow runtime could not send a message to the host.");
57
+ }
58
+
59
+ function inspectValue(value) {
60
+ let encoded;
61
+ try {
62
+ encoded = bridge.inspect(value);
63
+ } catch {}
64
+ if (typeof encoded !== "string") throw new Error("console could not format a value.");
65
+ const decoded = JSON.parse(encoded);
66
+ if (decoded[0] !== true) throw new Error(String(decoded[1]));
67
+ return decoded[1];
68
+ }
69
+
70
+ function utf8ByteLength(value) {
71
+ if (typeof value !== "string") throw new TypeError("Expected a string to measure.");
72
+ let length;
73
+ try {
74
+ length = bridge.utf8Length(value);
75
+ } catch {}
76
+ if (typeof length !== "number" || length < 0) throw new Error("Workflow runtime could not measure a string.");
77
+ return length;
78
+ }
79
+
80
+ function utf8Prefix(value, maxBytes) {
81
+ let prefix;
82
+ try {
83
+ prefix = bridge.utf8Prefix(value, maxBytes);
84
+ } catch {}
85
+ if (typeof prefix !== "string") throw new Error("Workflow runtime could not truncate a string.");
86
+ return prefix;
87
+ }
88
+
89
+ let nextCallId = 0;
90
+ let topLevelWorkflowPromise;
91
+ let suppressNativePromiseConsumption = 0;
92
+ const activeNativePromises = [];
93
+ const pending = new Map();
94
+ const workflowErrorKinds = new WeakMap();
95
+ const runKeyPattern = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
96
+ function validGitRef(ref) {
97
+ if (typeof ref !== "string" || !ref || ref === "@" || utf8ByteLength(ref) > 1024 || ref.startsWith("/") || ref.endsWith("/") || ref.includes("//") || ref.includes("..") || ref.includes("@{")) return false;
98
+ if (/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/iu.test(ref)) return false;
99
+ if (/[[\]\\~^:?*\u0000-\u0020\u007f]/u.test(ref) || ref.endsWith(".") || ref.endsWith(".lock")) return false;
100
+ return ref.split("/").every((component) => component.length > 0 && component !== "." && component !== ".." && !component.startsWith(".") && !component.endsWith(".") && !component.endsWith(".lock"));
101
+ }
102
+ const trackedPromiseTrackers = new WeakMap();
103
+ const trackedPromiseTargets = new WeakMap();
104
+ let nativePromiseTrackers = new WeakMap();
105
+ let nativePromiseParents = new WeakMap();
106
+ const observedCallIds = new Set();
107
+
108
+ function stableRunJson(value) {
109
+ if (Array.isArray(value)) return "[" + value.map(stableRunJson).join(",") + "]";
110
+ if (value && typeof value === "object") return "{" + Object.keys(value).sort().map((key) => JSON.stringify(key) + ":" + stableRunJson(value[key])).join(",") + "}";
111
+ return JSON.stringify(value) ?? "undefined";
112
+ }
113
+
114
+ function canonicalRunParams(params) {
115
+ if (params.gate === undefined || params.acceptance !== false) return params;
116
+ const { acceptance: _acceptance, ...withoutAcceptance } = params;
117
+ return withoutAcceptance;
118
+ }
119
+
120
+ function isDirectWorkflowScriptPromiseHandlerCall() {
121
+ let stack;
122
+ try {
123
+ stack = new Error().stack;
124
+ } catch {
125
+ // Near the stack limit the host's formatter overflows and throws its own realm's RangeError.
126
+ return false;
127
+ }
128
+ if (typeof stack !== "string") return false;
129
+ return stack.split("\n").some((line) => line.includes("workflow-script.js") && !line.includes("at async "));
130
+ }
131
+
132
+ function nativePromiseTracker(promise) {
133
+ if (!promise || (typeof promise !== "object" && typeof promise !== "function")) return undefined;
134
+ let tracker = nativePromiseTrackers.get(promise);
135
+ if (!tracker) {
136
+ tracker = { observations: [], consumed: false, dependencies: [] };
137
+ nativePromiseTrackers.set(promise, tracker);
138
+ }
139
+ return tracker;
140
+ }
141
+
142
+ function promiseObservationTracker(value) {
143
+ if (!value || (typeof value !== "object" && typeof value !== "function")) return undefined;
144
+ return trackedPromiseTrackers.get(value) ?? nativePromiseTrackers.get(value);
145
+ }
146
+
147
+ function addTrackerDependency(tracker, dependency) {
148
+ if (!dependency) return;
149
+ tracker.dependencies ??= [];
150
+ if (!tracker.dependencies.includes(dependency)) tracker.dependencies.push(dependency);
151
+ if (tracker.consumed) markTrackedObservationsConsumed(dependency);
152
+ }
153
+
154
+ function descendsFromTopLevelWorkflow(promise) {
155
+ const seen = new Set();
156
+ for (let current = promise; current && !seen.has(current); current = nativePromiseParents.get(current)) {
157
+ if (current === topLevelWorkflowPromise) return true;
158
+ seen.add(current);
159
+ }
160
+ return false;
161
+ }
162
+
163
+ function withSuppressedNativePromiseConsumption(callback) {
164
+ suppressNativePromiseConsumption++;
165
+ try {
166
+ return callback();
167
+ } finally {
168
+ suppressNativePromiseConsumption--;
169
+ }
170
+ }
171
+
172
+ function mergeObservations(...groups) {
173
+ const seen = new Set();
174
+ const merged = [];
175
+ for (const group of groups) {
176
+ for (const observation of group) {
177
+ if (!observation || typeof observation.callId !== "number" || typeof observation.key !== "string" || typeof observation.operation !== "string" || seen.has(observation.callId)) continue;
178
+ seen.add(observation.callId);
179
+ merged.push(observation);
180
+ }
181
+ }
182
+ return merged;
183
+ }
184
+
185
+ function trackedObservationTracker(value) {
186
+ return value && (typeof value === "object" || typeof value === "function") ? trackedPromiseTrackers.get(value) : undefined;
187
+ }
188
+
189
+ function trackedPromiseTarget(value) {
190
+ return value && (typeof value === "object" || typeof value === "function") ? trackedPromiseTargets.get(value) ?? value : value;
191
+ }
192
+
193
+ function addTrackedObservations(tracker, observations) {
194
+ tracker.observations = mergeObservations(tracker.observations, observations);
195
+ if (!tracker.consumed) return;
196
+ for (const observation of tracker.observations) {
197
+ if (observedCallIds.has(observation.callId)) continue;
198
+ observedCallIds.add(observation.callId);
199
+ post({ type: "callObserved", callId: observation.callId, key: observation.key, operation: observation.operation });
200
+ }
201
+ }
202
+
203
+ function markTrackedObservationsConsumed(tracker, seen = new Set()) {
204
+ if (seen.has(tracker)) return;
205
+ seen.add(tracker);
206
+ tracker.consumed = true;
207
+ addTrackedObservations(tracker, []);
208
+ for (const dependency of tracker.dependencies ?? []) markTrackedObservationsConsumed(dependency, seen);
209
+ }
210
+
211
+ function consumeTrackedObservations(tracker) {
212
+ if (isDirectWorkflowScriptPromiseHandlerCall()) return;
213
+ const activePromise = activeNativePromises.at(-1);
214
+ if (activePromise === topLevelWorkflowPromise || descendsFromTopLevelWorkflow(activePromise)) {
215
+ markTrackedObservationsConsumed(tracker);
216
+ } else if (activePromise) {
217
+ addTrackerDependency(nativePromiseTracker(activePromise), tracker);
218
+ } else {
219
+ markTrackedObservationsConsumed(tracker);
220
+ }
221
+ }
222
+
223
+ function trackObservationTracker(tracker, promise, allowFutureObservations = false) {
224
+ const target = trackedPromiseTarget(promise);
225
+ if ((!allowFutureObservations && tracker.observations.length === 0) || !target || typeof target.then !== "function") return promise;
226
+
227
+ const tracked = new Proxy(target, {
228
+ get(promiseTarget, prop) {
229
+ if (prop === "then") return function promiseThen(onFulfilled, onRejected) {
230
+ consumeTrackedObservations(tracker);
231
+ const chainTracker = { observations: tracker.observations, consumed: false, dependencies: [tracker] };
232
+ const wrapHandler = (handler) => typeof handler === "function"
233
+ ? function trackedThenHandler(...args) {
234
+ const value = handler.apply(this, args);
235
+ addTrackerDependency(chainTracker, promiseObservationTracker(value));
236
+ return trackedPromiseTarget(value);
237
+ }
238
+ : handler;
239
+ return trackObservationTracker(chainTracker, promiseTarget.then(wrapHandler(onFulfilled), wrapHandler(onRejected)), true);
240
+ };
241
+ if (prop === "catch") return function promiseCatch(onRejected) {
242
+ consumeTrackedObservations(tracker);
243
+ return trackObservationTracker({ observations: tracker.observations, consumed: false, dependencies: [tracker] }, promiseTarget.catch(onRejected), true);
244
+ };
245
+ if (prop === "finally") return function promiseFinally(onFinally) {
246
+ consumeTrackedObservations(tracker);
247
+ return trackObservationTracker({ observations: tracker.observations, consumed: false, dependencies: [tracker] }, promiseTarget.finally(onFinally), true);
248
+ };
249
+ return Reflect.get(promiseTarget, prop, promiseTarget);
250
+ },
251
+ });
252
+ trackedPromiseTrackers.set(tracked, tracker);
253
+ trackedPromiseTargets.set(tracked, target);
254
+ return tracked;
255
+ }
256
+
257
+ function trackRunObservation(observations, promise) {
258
+ const tracker = trackedObservationTracker(promise) ?? { observations: [], consumed: false };
259
+ addTrackedObservations(tracker, observations);
260
+ return trackObservationTracker(tracker, promise);
261
+ }
262
+
263
+ function trackPromiseCombinator(items, createPromise) {
264
+ const values = Array.from(items);
265
+ const dependencies = [...new Set(values.map(promiseObservationTracker).filter(Boolean))];
266
+ const promise = withSuppressedNativePromiseConsumption(() => createPromise(values.map(trackedPromiseTarget)));
267
+ if (dependencies.length === 0) return promise;
268
+ return trackObservationTracker({ observations: [], consumed: false, dependencies }, promise, true);
269
+ }
270
+
271
+ // Hosts that freeze built-ins make Promise.all and friends non-writable and non-configurable, and a
272
+ // Proxy over Promise itself may not return wrappers for those. Proxy a plain constructor instead.
273
+ const workflowPromiseTarget = function Promise() {};
274
+ workflowPromiseTarget.prototype = Promise.prototype;
275
+ const workflowPromise = new Proxy(workflowPromiseTarget, {
276
+ apply() {
277
+ throw new TypeError("Promise constructor cannot be invoked without 'new'");
278
+ },
279
+ construct(_proxyTarget, [executor]) {
280
+ const target = Promise;
281
+ if (typeof executor !== "function") return new target(executor);
282
+ const tracker = { observations: [], consumed: false };
283
+ const promise = new target((resolve, reject) => {
284
+ let settled = false;
285
+ try {
286
+ executor((value) => {
287
+ if (settled) return;
288
+ settled = true;
289
+ addTrackerDependency(tracker, promiseObservationTracker(value));
290
+ resolve(trackedPromiseTarget(value));
291
+ }, (reason) => {
292
+ if (settled) return;
293
+ settled = true;
294
+ reject(reason);
295
+ });
296
+ } catch (error) {
297
+ settled = true;
298
+ throw error;
299
+ }
300
+ });
301
+ return trackObservationTracker(tracker, promise, true);
302
+ },
303
+ get(_proxyTarget, prop) {
304
+ const target = Promise;
305
+ if (prop === "all") return (items) => trackPromiseCombinator(items, (values) => target.all(values));
306
+ if (prop === "allSettled") return (items) => trackPromiseCombinator(items, (values) => target.allSettled(values));
307
+ if (prop === "race") return (items) => trackPromiseCombinator(items, (values) => target.race(values));
308
+ if (prop === "any") return (items) => trackPromiseCombinator(items, (values) => target.any(values));
309
+ if (prop === "resolve") return (value) => {
310
+ const dependency = promiseObservationTracker(value);
311
+ const promise = withSuppressedNativePromiseConsumption(() => target.resolve(trackedPromiseTarget(value)));
312
+ if (!dependency) return promise;
313
+ return trackObservationTracker({ observations: [], consumed: false, dependencies: [dependency] }, promise, true);
314
+ };
315
+ const value = target[prop];
316
+ return typeof value === "function" ? value.bind(target) : value;
317
+ },
318
+ });
319
+
320
+ function hostCall(method, args, observation) {
321
+ const callId = ++nextCallId;
322
+ const promise = new Promise((resolve, reject) => {
323
+ pending.set(callId, { resolve, reject });
324
+ post({ type: "call", callId, method, args });
325
+ });
326
+ return observation && typeof observation.key === "string" && typeof observation.operation === "string"
327
+ ? trackRunObservation([{ key: observation.key, operation: observation.operation, callId }], promise)
328
+ : promise;
329
+ }
330
+
331
+ function runHostCall(key, params, collectFailure, batch, generatedLaneKey) {
332
+ const callId = ++nextCallId;
333
+ const promise = new Promise((resolve, reject) => {
334
+ pending.set(callId, { resolve, reject });
335
+ post({ type: "call", callId, method: "run", args: { key, params, ...(collectFailure ? { collectFailure: true } : {}), ...(batch ? { batch } : {}), ...(generatedLaneKey ? { generatedLaneKey } : {}) } });
336
+ });
337
+ return { key, callId, promise };
338
+ }
339
+
340
+ function isArrayIndexProperty(prop) {
341
+ if (!/^(0|[1-9]\d*)$/.test(prop)) return false;
342
+ const index = Number(prop);
343
+ return Number.isSafeInteger(index) && index >= 0 && index < 4294967295;
344
+ }
345
+
346
+ const runsAllResultTargets = new WeakMap();
347
+
348
+ const MAX_LANES = 32;
349
+ const MAX_LANE_STAGES = 16;
350
+ const MAX_LANE_STAGE_COUNT = 64;
351
+ const MAX_LANE_SPEC_BYTES = 64 * 1024;
352
+ const MAX_LANE_TASK_BYTES = 1024 * 1024;
353
+ const MAX_LANE_PATH_BYTES = 32 * 1024;
354
+ const MAX_LANE_BOARD_TEXT_BYTES = 256;
355
+ const LANE_PATH_FIELDS = new Set(["cwd", "output", "sessionDir"]);
356
+
357
+ function runsAllKeyAccessError(prop) {
358
+ 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 + ".");
359
+ }
360
+
361
+ function wrapRunsAllResults(results, keys) {
362
+ const keySet = new Set(keys);
363
+ const proxy = new Proxy(results, {
364
+ get(target, prop, receiver) {
365
+ if (typeof prop !== "string") return Reflect.get(target, prop, receiver);
366
+ if (prop === "then" || prop === "toJSON") return undefined;
367
+ if (prop in target || isArrayIndexProperty(prop)) return Reflect.get(target, prop, receiver);
368
+ if (keySet.has(prop)) throw runsAllKeyAccessError(prop);
369
+ throw runsAllKeyAccessError(prop);
370
+ },
371
+ });
372
+ runsAllResultTargets.set(proxy, results);
373
+ return proxy;
374
+ }
375
+
376
+ function laneByteLength(value) {
377
+ return utf8ByteLength(value);
378
+ }
379
+
380
+ function laneBoardText(value) {
381
+ if (typeof value !== "string" || !value) return undefined;
382
+ if (laneByteLength(value) <= MAX_LANE_BOARD_TEXT_BYTES) return value;
383
+ return utf8Prefix(value, MAX_LANE_BOARD_TEXT_BYTES - 3) + "...";
384
+ }
385
+
386
+ function laneBoardPath(value) {
387
+ if (typeof value !== "string" || !value || laneByteLength(value) > MAX_LANE_BOARD_TEXT_BYTES) return undefined;
388
+ return value;
389
+ }
390
+
391
+ function validateLaneStageBounds(params, label) {
392
+ if (typeof params.task === "string" && laneByteLength(params.task) > MAX_LANE_TASK_BYTES) throw new Error(label + " task exceeds 1 MiB when UTF-8 encoded.");
393
+ 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.");
394
+ }
395
+
396
+ function validateLaneKey(value, owner) {
397
+ 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.");
398
+ return value;
399
+ }
400
+
401
+ function laneStageParams(stage, previous) {
402
+ const resume = stage.resume;
403
+ const params = { ...stage.params };
404
+ if (resume !== "previous") return params;
405
+ if (!previous || typeof previous.runId !== "string" || !previous.runId.trim()) return undefined;
406
+ return { ...params, resume: previous.runId.trim() };
407
+ }
408
+
409
+ function laneStageVerdict(result) {
410
+ const structured = result && typeof result === "object" && !Array.isArray(result) ? result.structuredOutput : undefined;
411
+ const verdict = structured && typeof structured === "object" && !Array.isArray(structured) ? structured.verdict : undefined;
412
+ return typeof verdict === "string" && verdict.trim() ? laneBoardText(verdict.trim()) : undefined;
413
+ }
414
+
415
+ function laneStageIsBlocked(result) {
416
+ const structured = result && typeof result === "object" && !Array.isArray(result) ? result.structuredOutput : undefined;
417
+ return structured && typeof structured === "object" && !Array.isArray(structured) && structured.verdict === "blocked";
418
+ }
419
+
420
+ function laneStageRecord(stageKey, child, forcedState) {
421
+ const result = child && typeof child === "object" && !Array.isArray(child) ? child : undefined;
422
+ const ok = result?.ok === true;
423
+ const verdict = laneStageVerdict(result);
424
+ const blocked = laneStageIsBlocked(result);
425
+ const state = forcedState ?? (result?.state === "running" ? "running" : result?.stopped ? "stopped" : result?.detached ? "detached" : ok ? blocked ? "blocked" : "completed" : "failed");
426
+ const error = state !== "completed" && state !== "running"
427
+ ? state === "blocked" && blocked
428
+ ? "Stage returned a blocked verdict."
429
+ : typeof result?.error === "string"
430
+ ? result.error
431
+ : typeof result?.output === "string"
432
+ ? result.output
433
+ : "Stage did not complete successfully."
434
+ : undefined;
435
+ return {
436
+ key: stageKey,
437
+ ...(typeof result?.runId === "string" && result.runId.trim() ? { runId: laneBoardText(result.runId.trim()) } : {}),
438
+ ...(result ? { ok } : {}),
439
+ state,
440
+ ...(typeof result?.outputReference === "string" ? (laneBoardPath(result.outputReference) ? { outputReference: laneBoardPath(result.outputReference) } : {}) : {}),
441
+ ...(verdict ? { verdict } : {}),
442
+ ...(error ? { error: laneBoardText(error) } : {}),
443
+ };
444
+ }
445
+
446
+ function laneFailure(stageKey, error) {
447
+ const text = error instanceof Error ? error.message : String(error);
448
+ return { key: stageKey, ok: false, output: text, error: text, artifactPaths: [] };
449
+ }
450
+
451
+ function runCollected(key, params, observe, generatedLaneKey) {
452
+ validateRunCall(key, params, "runs.lanes stage", runFingerprints);
453
+ const launched = runHostCall(key, params, true, undefined, generatedLaneKey);
454
+ observe([{ key, operation: "run", callId: launched.callId }]);
455
+ return launched.promise.then(decorateWorkflowChildResult);
456
+ }
457
+
458
+ function validateLaneSpecs(laneSpecs) {
459
+ if (!Array.isArray(laneSpecs)) throw new Error("runs.lanes(lanes) requires an array.");
460
+ if (laneSpecs.length === 0) throw new Error("runs.lanes(lanes) requires at least one lane.");
461
+ if (laneSpecs.length > MAX_LANES) throw new Error("runs.lanes supports at most " + MAX_LANES + " lanes.");
462
+ assertJsonValue(laneSpecs, "runs.lanes lanes");
463
+ if (laneByteLength(stableRunJson(laneSpecs)) > MAX_LANE_SPEC_BYTES) throw new Error("runs.lanes canonical JSON exceeds 64 KiB.");
464
+ const generatedKeys = new Set();
465
+ const validationFingerprints = new Map();
466
+ let stageCount = 0;
467
+ const normalized = [];
468
+ for (let laneIndex = 0; laneIndex < laneSpecs.length; laneIndex++) {
469
+ const lane = laneSpecs[laneIndex];
470
+ const laneLabel = "runs.lanes lane " + laneIndex;
471
+ if (!lane || typeof lane !== "object" || Array.isArray(lane)) throw new Error(laneLabel + " must be an object.");
472
+ const laneFields = Object.keys(lane);
473
+ if (laneFields.some((field) => field !== "key" && field !== "stages")) throw new Error(laneLabel + " contains unsupported fields.");
474
+ const laneKey = validateLaneKey(lane.key, laneLabel);
475
+ if (!Array.isArray(lane.stages) || lane.stages.length === 0) throw new Error(laneLabel + " stages must contain at least one stage.");
476
+ if (lane.stages.length > MAX_LANE_STAGES) throw new Error(laneLabel + " supports at most " + MAX_LANE_STAGES + " stages.");
477
+ const stageKeys = new Set();
478
+ const stages = [];
479
+ for (let stageIndex = 0; stageIndex < lane.stages.length; stageIndex++) {
480
+ stageCount++;
481
+ if (stageCount > MAX_LANE_STAGE_COUNT) throw new Error("runs.lanes supports at most " + MAX_LANE_STAGE_COUNT + " total stages.");
482
+ const stage = lane.stages[stageIndex];
483
+ const stageLabel = laneLabel + " stage " + stageIndex;
484
+ if (!stage || typeof stage !== "object" || Array.isArray(stage)) throw new Error(stageLabel + " must be an object.");
485
+ const stageKey = validateLaneKey(stage.key, stageLabel);
486
+ if (stageKeys.has(stageKey)) throw new Error(laneLabel + " contains duplicate stage key '" + stageKey + "'.");
487
+ stageKeys.add(stageKey);
488
+ const generatedKey = laneKey + "." + stageKey;
489
+ validateLaneKey(generatedKey, stageLabel + " generated");
490
+ if (generatedKeys.has(generatedKey)) throw new Error("runs.lanes generated child key '" + generatedKey + "' is duplicated.");
491
+ generatedKeys.add(generatedKey);
492
+ const resume = stage.resume;
493
+ if (resume !== undefined && resume !== "previous") {
494
+ if (stageIndex === 0 && typeof resume === "string") {
495
+ 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.");
496
+ }
497
+ throw new Error(stageLabel + " resume must be 'previous'.");
498
+ }
499
+ if (stageIndex === 0 && resume === "previous") throw new Error(stageLabel + " cannot resume previous without a predecessor stage.");
500
+ const { key: _stageKey, resume: _resume, ...params } = stage;
501
+ const validationParams = resume === "previous" ? { ...params, resume: "retained-run-placeholder" } : params;
502
+ validateLaneStageBounds(validationParams, stageLabel);
503
+ validateRunCall(generatedKey, validationParams, stageLabel, validationFingerprints);
504
+ const existingFingerprint = runFingerprints.get(generatedKey);
505
+ if (existingFingerprint !== undefined && (resume === "previous" || existingFingerprint !== stableRunJson(canonicalRunParams(params)))) {
506
+ throw new Error("runs.lanes generated child key '" + generatedKey + "' is already used with incompatible launch params.");
507
+ }
508
+ stages.push({ key: stageKey, generatedKey, resume, params });
509
+ }
510
+ normalized.push({ key: laneKey, stages });
511
+ }
512
+ return normalized;
513
+ }
514
+
515
+ function runLane(lane, firstResult, observe) {
516
+ const records = [];
517
+ const appendSkipped = (start) => {
518
+ for (let index = start; index < lane.stages.length; index++) records.push({ key: lane.stages[index].key, state: "skipped" });
519
+ };
520
+ const finish = (state, failedStage) => ({ key: lane.key, state, ...(failedStage ? { failedStage } : {}), stages: records });
521
+ const visit = (index, previous) => {
522
+ if (index >= lane.stages.length) return Promise.resolve(finish("complete"));
523
+ const stage = lane.stages[index];
524
+ if (index === 0) {
525
+ const record = laneStageRecord(stage.key, previous);
526
+ records.push(record);
527
+ if (record.state !== "completed") {
528
+ appendSkipped(index + 1);
529
+ return Promise.resolve(finish("blocked", stage.key));
530
+ }
531
+ return visit(index + 1, previous);
532
+ }
533
+ if (stage.resume === "previous" && (!previous || typeof previous.runId !== "string" || !previous.runId.trim())) {
534
+ records.push({ key: stage.key, state: "blocked", error: "Previous stage did not return a retained run id." });
535
+ appendSkipped(index + 1);
536
+ return Promise.resolve(finish("blocked", stage.key));
537
+ }
538
+ if (!previous || previous.ok !== true || laneStageIsBlocked(previous)) {
539
+ records.push({ key: stage.key, state: "blocked", error: "Previous stage did not complete successfully." });
540
+ appendSkipped(index + 1);
541
+ return Promise.resolve(finish("blocked", stage.key));
542
+ }
543
+ const params = laneStageParams(stage, previous);
544
+ if (!params) {
545
+ records.push({ key: stage.key, state: "blocked", error: "Previous stage did not return a retained run id." });
546
+ appendSkipped(index + 1);
547
+ return Promise.resolve(finish("blocked", stage.key));
548
+ }
549
+ let launched;
550
+ try {
551
+ launched = runCollected(stage.generatedKey, params, observe, lane.key);
552
+ } catch (error) {
553
+ const failed = laneFailure(stage.generatedKey, error);
554
+ records.push(laneStageRecord(stage.key, failed));
555
+ appendSkipped(index + 1);
556
+ return Promise.resolve(finish("blocked", stage.key));
557
+ }
558
+ return launched.then((result) => {
559
+ const record = laneStageRecord(stage.key, result);
560
+ records.push(record);
561
+ if (record.state === "completed") return visit(index + 1, result);
562
+ appendSkipped(index + 1);
563
+ return finish("blocked", stage.key);
564
+ }, (error) => {
565
+ const failed = laneFailure(stage.generatedKey, error);
566
+ records.push(laneStageRecord(stage.key, failed));
567
+ appendSkipped(index + 1);
568
+ return finish("blocked", stage.key);
569
+ });
570
+ };
571
+ return visit(0, firstResult);
572
+ }
573
+
574
+ function workflowPlanStringMetadata(params) {
575
+ return {
576
+ ...(typeof params.phase === "string" && params.phase.trim() ? { phase: params.phase.trim() } : {}),
577
+ ...(typeof params.label === "string" && params.label.trim() ? { label: params.label.trim() } : {}),
578
+ ...(typeof params.agent === "string" && params.agent.trim() ? { agent: params.agent.trim() } : {}),
579
+ };
580
+ }
581
+
582
+ function runLanes(laneSpecs) {
583
+ const lanes = validateLaneSpecs(laneSpecs);
584
+ post({ type: "lanePlan", lanes: lanes.map((lane) => ({
585
+ key: lane.key,
586
+ stages: lane.stages.map((stage) => ({
587
+ key: stage.key,
588
+ generatedKey: stage.generatedKey,
589
+ ...workflowPlanStringMetadata(stage.params),
590
+ ...(typeof stage.params.as === "string" && stage.params.as.trim() ? { outputName: stage.params.as.trim() } : {}),
591
+ ...(stage.params.outputSchema ? { structured: true } : {}),
592
+ })),
593
+ })) });
594
+ const firstItems = lanes.map((lane) => {
595
+ const first = lane.stages[0];
596
+ return { key: first.generatedKey, ...first.params };
597
+ });
598
+ // Share the runs.all batch launcher while allowing each lane to advance independently.
599
+ const firstBatch = launchRunsAll(firstItems, lanes.map((lane) => lane.key));
600
+ const firstResults = firstBatch.launched.map(({ promise }) => promise.then(decorateWorkflowChildResult));
601
+ let trackedAggregate;
602
+ const observe = (observations) => trackRunObservation(observations, trackedAggregate);
603
+ const laneAggregate = Promise.all(lanes.map((lane, index) => firstResults[index].then(
604
+ (result) => runLane(lane, result, observe),
605
+ (error) => runLane(lane, laneFailure(lane.stages[0].generatedKey, error), observe),
606
+ )));
607
+ trackedAggregate = trackRunObservation(firstBatch.launched.map(({ key, callId }) => ({ key, operation: "run", callId })), laneAggregate);
608
+ return trackedAggregate;
609
+ }
610
+
611
+ function formatRef(result) {
612
+ if (!result || typeof result !== "object") throw new Error("runs.ref(result) requires a run result object.");
613
+ const parts = ["run " + (result.key || "unknown")];
614
+ if (result.runId) parts.push("id=" + String(result.runId).slice(0, 8));
615
+ return "[" + parts.join("; ") + "]";
616
+ }
617
+
618
+ function formatChildResultString(result) {
619
+ const output = typeof result?.output === "string" ? result.output.trim() : "";
620
+ return output || formatRef(result);
621
+ }
622
+
623
+ function decorateWorkflowChildResult(result) {
624
+ if (!result || typeof result !== "object" || Array.isArray(result)) return result;
625
+ Object.defineProperties(result, {
626
+ toString: { value() { return formatChildResultString(this); }, enumerable: false, configurable: true },
627
+ });
628
+ return result;
629
+ }
630
+
631
+ let runFingerprints = new Map();
632
+
633
+ function validateExtensionBindings(value, label) {
634
+ if (value === undefined) return;
635
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(label + " extensionBindings must be a plain JSON object.");
636
+ const keys = Object.keys(value);
637
+ if (keys.length > 16) throw new Error(label + " extensionBindings supports at most 16 namespaces.");
638
+ 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>'.");
639
+ assertJsonValue(value, label + " extensionBindings");
640
+ let propertyCount = 0;
641
+ function visit(entry, depth) {
642
+ if (!entry || typeof entry !== "object") return;
643
+ if (depth > 16) throw new Error(label + " extensionBindings exceeds the maximum nesting depth of 16.");
644
+ if (Array.isArray(entry)) { for (const item of entry) visit(item, depth + 1); return; }
645
+ for (const child of Object.values(entry)) {
646
+ propertyCount++;
647
+ if (propertyCount > 256) throw new Error(label + " extensionBindings exceeds 256 total properties.");
648
+ visit(child, depth + 1);
649
+ }
650
+ }
651
+ visit(value, 0);
652
+ if (utf8ByteLength(stableRunJson(value)) > 16384) throw new Error(label + " extensionBindings canonical JSON exceeds 16384 bytes.");
653
+ }
654
+
655
+ function validateLaneMetadata(value, label, workflowKey) {
656
+ if (value === undefined) return;
657
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(label + " must be a plain JSON object.");
658
+ const fields = Object.keys(value);
659
+ const allowed = ["version", "key", "mode", "sourceRef", "claims", "outputPaths"];
660
+ const unknown = fields.filter((field) => !allowed.includes(field));
661
+ if (unknown.length > 0) throw new Error(label + " has unsupported fields: " + unknown.join(", ") + ".");
662
+ if (value.version !== 1) throw new Error(label + ".version must be 1.");
663
+ if (typeof value.key !== "string" || !value.key.trim() || !runKeyPattern.test(value.key.trim())) throw new Error(label + ".key is invalid.");
664
+ if (workflowKey !== undefined && value.key.trim() !== workflowKey) throw new Error(label + ".key must match workflow key '" + workflowKey + "'.");
665
+ if (value.mode !== undefined && !["mutation", "review", "scout", "gate"].includes(value.mode)) throw new Error(label + ".mode is invalid.");
666
+ const bounded = (entry, maxBytes) => typeof entry === "string" && entry.trim() && utf8ByteLength(entry.trim()) <= maxBytes && !/[\r\n\u0000]/.test(entry);
667
+ if (value.sourceRef !== undefined && !bounded(value.sourceRef, 128)) throw new Error(label + ".sourceRef is invalid.");
668
+ for (const [name, maxItems, maxLength] of [["claims", 20, 160], ["outputPaths", 10, 256]]) {
669
+ if (value[name] === undefined) continue;
670
+ if (!Array.isArray(value[name]) || value[name].length > maxItems || value[name].some((entry) => !bounded(entry, maxLength))) throw new Error(label + "." + name + " is invalid.");
671
+ }
672
+ }
673
+
674
+ // Mirrors parseGateInput in src/runs/shared/acceptance.ts; the sandbox cannot import it.
675
+ function describeGateShapeError(gate) {
676
+ const shape = "gate must be a non-empty command string or { command, output?: \"json\", schema?, timeoutMs? }.";
677
+ if (typeof gate === "string") return gate.trim() ? undefined : shape;
678
+ if (!gate || typeof gate !== "object" || Array.isArray(gate)) return shape;
679
+ for (const key of Object.keys(gate)) {
680
+ if (!["command", "output", "schema", "timeoutMs"].includes(key)) return "gate." + key + " is not supported.";
681
+ }
682
+ if (typeof gate.command !== "string" || !gate.command.trim()) return shape;
683
+ if (gate.output !== undefined && gate.output !== "json") return "gate.output must be \"json\" when present.";
684
+ if (gate.schema !== undefined) {
685
+ if (gate.output !== "json") return "gate.schema requires gate.output: \"json\".";
686
+ if (!gate.schema || typeof gate.schema !== "object" || Array.isArray(gate.schema)) return "gate.schema must be a JSON Schema object.";
687
+ }
688
+ if (gate.timeoutMs !== undefined && (!Number.isInteger(gate.timeoutMs) || gate.timeoutMs < 1)) return "gate.timeoutMs must be an integer >= 1.";
689
+ return undefined;
690
+ }
691
+
692
+ function describeGateAcceptanceConflict(gate, acceptance) {
693
+ const render = (value) => {
694
+ let encoded;
695
+ try {
696
+ encoded = JSON.stringify(value) ?? String(value);
697
+ } catch {
698
+ encoded = String(value);
699
+ }
700
+ return encoded.length > 120 ? encoded.slice(0, 120) + "..." : encoded;
701
+ };
702
+ return " Both fields were present: gate=" + render(gate) + " acceptance=" + render(acceptance) + ".";
703
+ }
704
+
705
+ function validateRunCall(key, params, label, fingerprints) {
706
+ if (typeof key !== "string" || !runKeyPattern.test(key)) throw new Error(label + " has an invalid key.");
707
+ if (hostKeys.has(key)) throw new Error("Workflow key '" + key + "' is already used by runs.host.");
708
+ if (!params || typeof params !== "object" || Array.isArray(params)) throw new Error(label + " requires a params object.");
709
+ 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")) {
710
+ const hint = label === "runs.run" ? "; use runs.all(...) and JavaScript control flow for orchestration." : ".";
711
+ throw new Error(label + " accepts one child via { agent, task } and execution controls only" + hint);
712
+ }
713
+ if (Object.prototype.hasOwnProperty.call(params, "clarify")) throw new Error(label + " does not support clarify UI.");
714
+ if (params.worktree !== undefined && typeof params.worktree !== "boolean") throw new Error(label + " worktree must be true or false.");
715
+ 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.");
716
+ validateLaneMetadata(params.lane, label + " lane", key);
717
+ if (params.gate !== undefined) {
718
+ const gateError = describeGateShapeError(params.gate);
719
+ if (gateError) throw new Error(label + " " + gateError);
720
+ }
721
+ 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));
722
+ if (params.gate !== undefined && params.resume !== undefined) throw new Error(label + " gate is not supported with retained resume.");
723
+ 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.");
724
+ if (params.resume !== undefined && typeof params.resume !== "string") {
725
+ const reference = params.resume;
726
+ if (!reference || typeof reference !== "object" || Array.isArray(reference)) throw new Error(label + " resume must be a retained run id or keyed workflow receipt reference.");
727
+ const fields = Object.keys(reference);
728
+ if (fields.some((field) => field !== "workflowRunId" && field !== "key" && field !== "latest")) throw new Error(label + " keyed resume contains unsupported fields.");
729
+ if (typeof reference.workflowRunId !== "string" || !reference.workflowRunId.trim()) throw new Error(label + " keyed resume workflowRunId must be non-empty.");
730
+ if (typeof reference.key !== "string" || !runKeyPattern.test(reference.key)) throw new Error(label + " keyed resume key is invalid.");
731
+ if (reference.latest !== true) throw new Error(label + " keyed resume requires latest: true.");
732
+ }
733
+ if (typeof params.resume === "string" && !params.resume.trim()) throw new Error(label + " resume must be a non-empty retained run id.");
734
+ if (params.resume !== undefined && params.agent !== undefined) throw new Error(label + " resume and agent are mutually exclusive.");
735
+ if (params.resume !== undefined && (typeof params.task !== "string" || !params.task.trim())) throw new Error(label + " resume requires a non-empty task follow-up.");
736
+ validateExtensionBindings(params.extensionBindings, label);
737
+ assertJsonValue(params, label + " params");
738
+ const fingerprint = stableRunJson(canonicalRunParams(params));
739
+ const existing = fingerprints.get(key);
740
+ if (existing !== undefined && existing !== fingerprint) throw new Error("Duplicate workflow key '" + key + "' used with incompatible launch params.");
741
+ fingerprints.set(key, fingerprint);
742
+ }
743
+
744
+ const hostKeys = new Set();
745
+
746
+ function validateHostCommand(key, params) {
747
+ validateLaneKey(key, "runs.host");
748
+ if (!params || typeof params !== "object" || Array.isArray(params)) throw new Error("runs.host('" + key + "') params must be an object.");
749
+ const allowed = new Set(["kind", "command", "timeoutMs", "output", "role", "provider"]);
750
+ const unknown = Object.keys(params).filter((field) => !allowed.has(field));
751
+ if (unknown.length) {
752
+ const cwdHint = unknown.includes("cwd")
753
+ ? " 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')."
754
+ : "";
755
+ throw new Error("runs.host('" + key + "') params have unsupported fields: " + unknown.join(", ") + "." + cwdHint);
756
+ }
757
+ if (params.kind !== "command") throw new Error("runs.host('" + key + "') kind must be 'command'.");
758
+ if (typeof params.command !== "string" || !params.command.trim() || params.command.includes("\u0000") || utf8ByteLength(params.command.trim()) > 16384) throw new Error("runs.host('" + key + "') command must be a non-empty string of at most 16384 bytes without NUL.");
759
+ 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.");
760
+ if (params.output !== undefined && (typeof params.output !== "string" || !params.output.trim() || /^[/\\]|(?:^|[/\\])\.\.(?:[/\\]|$)/.test(params.output) || /[\u0000-\u001f\u007f]/.test(params.output) || utf8ByteLength(params.output.trim()) > 240)) throw new Error("runs.host('" + key + "') output must be a bounded relative path without traversal or control characters.");
761
+ if (params.role !== undefined && params.role !== "ci" && params.role !== "gate") throw new Error("runs.host('" + key + "') role must be 'ci' or 'gate'.");
762
+ if (params.provider !== undefined && (typeof params.provider !== "string" || !params.provider.trim() || /[\r\n\u0000]/.test(params.provider) || utf8ByteLength(params.provider.trim()) > 64)) throw new Error("runs.host('" + key + "') provider must be a non-empty single-line string of at most 64 bytes.");
763
+ assertJsonValue(params, "runs.host('" + key + "') params");
764
+ if (hostKeys.has(key) || runFingerprints.has(key)) throw new Error("Workflow key '" + key + "' is already in use.");
765
+ if (hostKeys.size >= 32) throw new Error("workflowScript supports at most 32 runs.host calls.");
766
+ hostKeys.add(key);
767
+ }
768
+
769
+ 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 }))).";
770
+
771
+ function runsAllItemThenableInfo(item, index) {
772
+ if (!item || typeof item !== "object" || Array.isArray(item)) return null;
773
+ if (typeof item.then !== "function") return null;
774
+ const tracker = promiseObservationTracker(item);
775
+ const observation = tracker && Array.isArray(tracker.observations) ? tracker.observations.find((entry) => entry && entry.operation === "run") : undefined;
776
+ return {
777
+ key: observation && typeof observation.key === "string" ? observation.key : ("runs.all[" + index + "]"),
778
+ callId: observation && typeof observation.callId === "number" ? observation.callId : null,
779
+ promise: item,
780
+ };
781
+ }
782
+
783
+ let warnedPermissiveRunsAll = false;
784
+
785
+ function launchRunsAll(items, generatedLaneKeys) {
786
+ if (!Array.isArray(items)) throw new Error("runs.all(items) requires an array.");
787
+ const anyThenable = items.some((item, index) => runsAllItemThenableInfo(item, index) !== null);
788
+ if (anyThenable) return launchRunsAllPermissive(items);
789
+ const fingerprints = new Map(runFingerprints);
790
+ const calls = [];
791
+ for (let index = 0; index < items.length; index++) {
792
+ if (!Object.prototype.hasOwnProperty.call(items, index)) throw new Error("runs.all items must not contain sparse entries.");
793
+ const item = items[index];
794
+ if (!item || typeof item !== "object" || Array.isArray(item)) throw new Error("runs.all item " + index + " must be an object.");
795
+ const { key, ...params } = item;
796
+ validateRunCall(key, params, "runs.all item " + index, fingerprints);
797
+ calls.push({ key, params });
798
+ }
799
+ runFingerprints = fingerprints;
800
+ const batch = { id: "batch-" + (++nextCallId), calls };
801
+ const launched = calls.map(({ key, params }, index) => runHostCall(key, params, true, batch, generatedLaneKeys?.[index]));
802
+ return { calls, launched };
803
+ }
804
+
805
+ function launchRunsAllPermissive(items) {
806
+ if (!warnedPermissiveRunsAll) {
807
+ warnedPermissiveRunsAll = true;
808
+ try { capturedConsole.warn(RUNS_ALL_PERMISSIVE_WARNING); } catch { /* console emission is best-effort */ }
809
+ }
810
+ const fingerprints = new Map(runFingerprints);
811
+ const calls = [];
812
+ const launched = [];
813
+ for (let index = 0; index < items.length; index++) {
814
+ if (!Object.prototype.hasOwnProperty.call(items, index)) throw new Error("runs.all items must not contain sparse entries.");
815
+ const item = items[index];
816
+ 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.");
817
+ const thenable = runsAllItemThenableInfo(item, index);
818
+ if (thenable) {
819
+ calls.push({ key: thenable.key, params: {} });
820
+ launched.push(thenable);
821
+ continue;
822
+ }
823
+ const { key, ...params } = item;
824
+ validateRunCall(key, params, "runs.all item " + index, fingerprints);
825
+ calls.push({ key, params });
826
+ launched.push(null);
827
+ }
828
+ runFingerprints = fingerprints;
829
+ return { calls, launched: launched.map((entry, index) => entry ?? runHostCall(calls[index].key, calls[index].params, false, undefined)) };
830
+ }
831
+
832
+ const runs = Object.freeze({
833
+ run(key, params) {
834
+ if (key && typeof key === "object" && !Array.isArray(key)) throw new Error('runs.run expects (key, params); got an object as the first argument. Use runs.run("plan", { agent, task }) or runs.all([{ key, agent, task }]).');
835
+ validateRunCall(key, params, "runs.run", runFingerprints);
836
+ const launched = runHostCall(key, params, false);
837
+ return trackRunObservation([{ key, operation: "run", callId: launched.callId }], launched.promise.then(decorateWorkflowChildResult));
838
+ },
839
+ all(items) {
840
+ const { calls, launched } = launchRunsAll(items);
841
+ 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)))));
842
+ },
843
+ lanes(laneSpecs) {
844
+ return runLanes(laneSpecs);
845
+ },
846
+ host(key, params) {
847
+ validateHostCommand(key, params);
848
+ return hostCall("host", { key, params }, { key, operation: "host" });
849
+ },
850
+ steer(key, message, options = {}) {
851
+ if (typeof key !== "string" || !runKeyPattern.test(key)) throw new Error("runs.steer has an invalid key.");
852
+ if (typeof message !== "string" || !message.trim()) throw new Error("runs.steer message must be a non-empty string.");
853
+ if (!options || typeof options !== "object" || Array.isArray(options)) throw new Error("runs.steer options must be an object.");
854
+ const allowed = new Set(["mode", "index", "ackTimeoutMs"]);
855
+ for (const option of Object.keys(options)) if (!allowed.has(option)) throw new Error("runs.steer options contain unsupported field '" + option + "'.");
856
+ 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'.");
857
+ 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.");
858
+ if (options.ackTimeoutMs !== undefined && (!Number.isInteger(options.ackTimeoutMs) || options.ackTimeoutMs < 1)) throw new Error("runs.steer ackTimeoutMs must be a positive integer.");
859
+ return hostCall("steer", { key, message: message.trim(), options }, { key, operation: "steer" });
860
+ },
861
+ status(keyOrRunId) { return hostCall("status", { keyOrRunId }); },
862
+ ref: formatRef,
863
+ refs(results) {
864
+ if (!Array.isArray(results)) throw new Error("runs.refs(results) requires an array.");
865
+ return results.map(formatRef).join("\n");
866
+ },
867
+ });
868
+
869
+ function validateStateKey(key) {
870
+ 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.");
871
+ return key;
872
+ }
873
+
874
+ const state = Object.freeze({
875
+ get(key) { return hostCall("state.get", { key: validateStateKey(key) }); },
876
+ set(key, value) {
877
+ const validKey = validateStateKey(key);
878
+ assertJsonValue(value, "state.set('" + validKey + "') value");
879
+ return hostCall("state.set", { key: validKey, value });
880
+ },
881
+ });
882
+
883
+ const contextObjectPrototype = scriptRealm.objectPrototype;
884
+
885
+ const capturedConsole = Object.freeze(Object.fromEntries(
886
+ ["log", "info", "warn", "error"].map((level) => [level, (...args) => {
887
+ post({ type: "console", level, text: args.map((value) => typeof value === "string" ? value : inspectValue(value)).join(" ") });
888
+ }]),
889
+ ));
890
+
891
+ function postWorkflowError(error) {
892
+ // Pre-run syntax and portability errors are tagged "validation" where the script is compiled;
893
+ // anything reaching here was thrown while the script ran, including a runtime SyntaxError.
894
+ const taggedKind = error && (typeof error === "object" || typeof error === "function") ? workflowErrorKinds.get(error) : undefined;
895
+ post({ type: "error", error: isSyntaxError(error) ? formatWorkflowScriptSyntaxError(error) : formatWorkflowScriptError(error), errorKind: taggedKind ?? "script" });
896
+ }
897
+ function assertJsonValue(value, path = "emit", seen = new Set()) {
898
+
899
+ if (value === null || typeof value === "string" || typeof value === "boolean") return;
900
+ if (typeof value === "number") {
901
+ if (!Number.isFinite(value)) throw new Error(path + " must contain only finite JSON numbers.");
902
+ return;
903
+ }
904
+ if (typeof value !== "object") throw new Error(path + " must be a JSON value; received " + typeof value + ".");
905
+ if (seen.has(value)) throw new Error(path + " must not contain cycles.");
906
+ seen.add(value);
907
+ if (Array.isArray(value)) {
908
+ for (let index = 0; index < value.length; index++) {
909
+ if (!Object.prototype.hasOwnProperty.call(value, index)) throw new Error(path + " must not contain sparse array entries.");
910
+ assertJsonValue(value[index], path + "[" + index + "]", seen);
911
+ }
912
+ } else {
913
+ const prototype = Object.getPrototypeOf(value);
914
+ if (prototype !== null && prototype !== Object.prototype && prototype !== contextObjectPrototype) throw new Error(path + " must contain only plain JSON objects.");
915
+ if (Object.getOwnPropertySymbols(value).length > 0) throw new Error(path + " must not contain symbol keys.");
916
+ for (const [key, entry] of Object.entries(value)) assertJsonValue(entry, path + "." + key, seen);
917
+ }
918
+ seen.delete(value);
919
+ }
920
+
921
+ function isPlainWorkflowObject(value) {
922
+ if (!value || typeof value !== "object" || Array.isArray(value)) return false;
923
+ const prototype = Object.getPrototypeOf(value);
924
+ return prototype === null || prototype === Object.prototype || prototype === contextObjectPrototype;
925
+ }
926
+
927
+ function unwrapRunsAllResults(value, seen = new Map()) {
928
+ if (value === null || typeof value !== "object") return value;
929
+ const runsAllTarget = runsAllResultTargets.get(value);
930
+ const target = runsAllTarget || value;
931
+ if (seen.has(target)) return seen.get(target);
932
+ if (Array.isArray(target)) {
933
+ const copy = [];
934
+ seen.set(target, copy);
935
+ let changed = !!runsAllTarget;
936
+ for (let index = 0; index < target.length; index++) {
937
+ copy[index] = unwrapRunsAllResults(target[index], seen);
938
+ changed ||= copy[index] !== target[index];
939
+ }
940
+ return changed ? copy : target;
941
+ }
942
+ if (!isPlainWorkflowObject(target) || Object.getOwnPropertySymbols(target).length > 0) return target;
943
+ let changed = false;
944
+ const entries = Object.entries(target).map(([key, entry]) => {
945
+ const unwrapped = unwrapRunsAllResults(entry, seen);
946
+ changed ||= unwrapped !== entry;
947
+ return [key, unwrapped];
948
+ });
949
+ return changed ? Object.fromEntries(entries) : target;
950
+ }
951
+
952
+ function omitUndefinedWorkflowValues(value, seen = new Set()) {
953
+ if (value === null || typeof value !== "object") return value;
954
+ if (seen.has(value)) return value;
955
+ seen.add(value);
956
+ const normalized = Array.isArray(value)
957
+ ? value.map((entry) => entry === undefined ? null : omitUndefinedWorkflowValues(entry, seen))
958
+ : isPlainWorkflowObject(value) && Object.getOwnPropertySymbols(value).length === 0
959
+ ? Object.fromEntries(Object.entries(value).flatMap(([key, entry]) => entry === undefined ? [] : [[key, omitUndefinedWorkflowValues(entry, seen)]]))
960
+ : value;
961
+ seen.delete(value);
962
+ return normalized;
963
+ }
964
+
965
+ const scriptGlobals = { runs, Promise: workflowPromise, emit(value) { const unwrapped = unwrapRunsAllResults(value); const emittedValue = unwrapped === undefined ? null : omitUndefinedWorkflowValues(unwrapped); assertJsonValue(emittedValue); post({ type: "emit", value: emittedValue }); }, console: capturedConsole };
966
+ if (stateEnabled) scriptGlobals.state = state;
967
+
968
+ function deliver(callId, ok, encodedValue, errorText, errorKind) {
969
+ const entry = pending.get(callId);
970
+ if (!entry) return;
971
+ pending.delete(callId);
972
+ if (ok) entry.resolve(JSON.parse(encodedValue).value);
973
+ else {
974
+ const error = new Error(errorText);
975
+ if (errorKind === "child" || errorKind === "detached-child") workflowErrorKinds.set(error, errorKind);
976
+ entry.reject(error);
977
+ }
978
+ }
979
+
980
+ let nativeThenDescriptor;
981
+
982
+ function beginWorkflowScript() {
983
+ try {
984
+ nativeThenDescriptor = Object.getOwnPropertyDescriptor(nativePromisePrototype, "then");
985
+ if (!nativeThenDescriptor || typeof nativeThenDescriptor.value !== "function") throw new Error("workflowScript could not inspect the VM Promise.prototype.then method.");
986
+ const nativeThen = nativeThenDescriptor.value;
987
+ // Some hosts freeze built-ins in every realm, which makes then read-only. The promise hooks
988
+ // still track observation, so skip the wrapper rather than fail every workflow.
989
+ if (nativeThenDescriptor.configurable) Object.defineProperty(nativePromisePrototype, "then", {
990
+ ...nativeThenDescriptor,
991
+ value: function workflowPromiseThen(...args) {
992
+ if (isDirectWorkflowScriptPromiseHandlerCall() || suppressNativePromiseConsumption > 0) {
993
+ return withSuppressedNativePromiseConsumption(() => Reflect.apply(nativeThen, this, args));
994
+ }
995
+ return Reflect.apply(nativeThen, this, args);
996
+ },
997
+ });
998
+ return true;
999
+ } catch (error) {
1000
+ postWorkflowError(error);
1001
+ return false;
1002
+ }
1003
+ }
1004
+
1005
+ function hookBefore(promise) {
1006
+ if (!isWorkflowRealmPromise(promise)) return;
1007
+ activeNativePromises.push(promise);
1008
+ }
1009
+
1010
+ function hookAfter(promise) {
1011
+ // Compare by identity rather than lastIndexOf: this may be a worker promise, and a script can replace Array methods.
1012
+ for (let index = activeNativePromises.length - 1; index >= 0; index--) {
1013
+ if (activeNativePromises[index] !== promise) continue;
1014
+ activeNativePromises.splice(index, 1);
1015
+ return;
1016
+ }
1017
+ }
1018
+
1019
+ function hookInit(promise, parent) {
1020
+ if (!isWorkflowRealmPromise(promise)) return;
1021
+ const childTracker = nativePromiseTracker(promise);
1022
+ if (!parent || !isWorkflowRealmPromise(parent)) return;
1023
+ nativePromiseParents.set(promise, parent);
1024
+ const parentTracker = nativePromiseTracker(parent);
1025
+ addTrackerDependency(childTracker, parentTracker);
1026
+ const activePromise = activeNativePromises.at(-1);
1027
+ if (activePromise && activePromise !== parent) {
1028
+ addTrackerDependency(nativePromiseTracker(activePromise), parentTracker);
1029
+ } else if (!activePromise && suppressNativePromiseConsumption === 0) {
1030
+ markTrackedObservationsConsumed(parentTracker);
1031
+ }
1032
+ }
1033
+
1034
+ function endWorkflowScript() {
1035
+ try {
1036
+ let stopped = false;
1037
+ try {
1038
+ stopped = bridge.stopPromiseHooks();
1039
+ } catch {}
1040
+ if (stopped !== true) throw new Error("Workflow runtime could not stop its promise hooks.");
1041
+ } finally {
1042
+ try {
1043
+ if (nativeThenDescriptor.configurable) Object.defineProperty(nativePromisePrototype, "then", nativeThenDescriptor);
1044
+ } finally {
1045
+ topLevelWorkflowPromise = undefined;
1046
+ activeNativePromises.length = 0;
1047
+ suppressNativePromiseConsumption = 0;
1048
+ nativePromiseTrackers = new WeakMap();
1049
+ nativePromiseParents = new WeakMap();
1050
+ }
1051
+ }
1052
+ }
1053
+
1054
+ function completeWorkflowScript(value) {
1055
+ const persistedValue = value === undefined ? null : omitUndefinedWorkflowValues(value);
1056
+ try {
1057
+ assertJsonValue(persistedValue, "return");
1058
+ } catch (error) {
1059
+ post({ type: "error", errorKind: "return-serialization", errorPhase: "return-serialization", error: formatWorkflowScriptError(error) });
1060
+ return;
1061
+ }
1062
+ post({ type: "complete", value: persistedValue });
1063
+ }
1064
+
1065
+ // The worker ran the compiled script: `result` is its completion value, or what it threw synchronously.
1066
+ function awaitWorkflowScript(threw, result) {
1067
+ let settled;
1068
+ try {
1069
+ if (threw) throw result;
1070
+ topLevelWorkflowPromise = result;
1071
+ markTrackedObservationsConsumed(nativePromiseTracker(result));
1072
+ settled = Promise.resolve(result);
1073
+ } catch (error) {
1074
+ settled = Promise.reject(error);
1075
+ }
1076
+ settled.then((value) => {
1077
+ endWorkflowScript();
1078
+ completeWorkflowScript(value);
1079
+ }, (error) => {
1080
+ endWorkflowScript();
1081
+ postWorkflowError(error);
1082
+ }).catch(postWorkflowError);
1083
+ }
1084
+
1085
+ return Object.freeze({
1086
+ __proto__: null,
1087
+ scriptGlobals: Object.freeze(scriptGlobals),
1088
+ deliver,
1089
+ beginWorkflowScript,
1090
+ hookBefore,
1091
+ hookAfter,
1092
+ hookInit,
1093
+ awaitWorkflowScript,
1094
+ reportError: postWorkflowError,
1095
+ });
1096
+ }
1097
+
1098
+ function formatWorkflowScriptSyntaxError(error) {
1099
+ const details = formatWorkflowScriptError(error);
1100
+ return [
1101
+ "workflowScript must be valid JavaScript.",
1102
+ "If task text contains Markdown fences or backticks, use an array joined with \"\\n\" or escaped strings instead of a raw backtick template literal.",
1103
+ "",
1104
+ "Original SyntaxError:",
1105
+ details,
1106
+ ].join("\n");
1107
+ }
1108
+
1109
+ function formatWorkflowScriptError(error) {
1110
+ const message = error && typeof error.message === "string" ? error.message : String(error);
1111
+ const stack = error && typeof error.stack === "string" ? error.stack : "";
1112
+ if (!stack) return message;
1113
+ return stack.includes(message) ? stack : message + "\n" + stack;
1114
+ }
1115
+
1116
+ function isSyntaxError(error) {
1117
+ return error instanceof SyntaxError || error?.name === "SyntaxError";
1118
+ }
1119
+
1120
+ 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 } };";
1121
+ const AST_SCALAR_KEYS = new Set(["type", "start", "end"]);
1122
+ // A script context has no module loader, and Node and Bun reject import() there with an error built in
1123
+ // the worker realm, so the call is refused before the script runs.
1124
+ const DYNAMIC_IMPORT_WORKFLOW_ERROR = "workflowScript validation failed before child launch; no children launched. workflowScript cannot load modules with import().";
1125
+
1126
+ function assertPortableWorkflowScript(source) {
1127
+ const wrapped = "(async () => {\n" + source + "\n})()";
1128
+ let ast;
1129
+ try {
1130
+ ast = parse(wrapped, { ecmaVersion: "latest", sourceType: "script" });
1131
+ } catch (error) {
1132
+ // The wrapper adds one line before the script; report the script's own line.
1133
+ if (isSyntaxError(error) && typeof error.message === "string") {
1134
+ const message = error.message.replace(/\((\d+):(\d+)\)$/, (_match, line, column) => "(" + Math.max(1, Number(line) - 1) + ":" + column + ")");
1135
+ if (typeof error.stack === "string") error.stack = error.stack.replace(error.message, message);
1136
+ error.message = message;
1137
+ }
1138
+ throw error;
1139
+ }
1140
+ const wrapper = workflowWrapperFunction(ast);
1141
+ // Walk the whole program, not just the wrapper body: a script can close the wrapper early.
1142
+ walkWorkflowAst(ast, wrapper);
1143
+ }
1144
+
1145
+ function workflowWrapperFunction(ast) {
1146
+ const wrapper = ast.body?.[0]?.expression?.callee;
1147
+ if (!wrapper || wrapper.type !== "ArrowFunctionExpression") throw new Error("workflowScript wrapper parse invariant failed.");
1148
+ return wrapper;
1149
+ }
1150
+
1151
+ function isAsyncFunctionNode(node) {
1152
+ return node.async === true && (node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression");
1153
+ }
1154
+
1155
+ function walkWorkflowAst(node, allowedAsyncFunction) {
1156
+ if (!node || typeof node !== "object") return;
1157
+ if (Array.isArray(node)) {
1158
+ for (const item of node) walkWorkflowAst(item, allowedAsyncFunction);
1159
+ return;
1160
+ }
1161
+ if (node !== allowedAsyncFunction && isAsyncFunctionNode(node)) {
1162
+ throw new Error(NESTED_ASYNC_WORKFLOW_ERROR);
1163
+ }
1164
+ if (node.type === "ImportExpression") throw new Error(DYNAMIC_IMPORT_WORKFLOW_ERROR);
1165
+ for (const [key, child] of Object.entries(node)) {
1166
+ if (AST_SCALAR_KEYS.has(key)) continue;
1167
+ walkWorkflowAst(child, allowedAsyncFunction);
1168
+ }
1169
+ }
1170
+
1171
+ // The error-format helpers run in both realms; the runtime realm compiles its own copies from their source.
1172
+ const WORKFLOW_RUNTIME_SOURCE = [
1173
+ "(function (bridge, scriptRealm, stateEnabled) {",
1174
+ "\"use strict\";",
1175
+ formatWorkflowScriptSyntaxError,
1176
+ formatWorkflowScriptError,
1177
+ isSyntaxError,
1178
+ "return (" + workflowRuntime + ")(bridge, scriptRealm, stateEnabled);",
1179
+ "})",
1180
+ ].join("\n");
1181
+
1182
+ const VM_CONTEXT_OPTIONS = { codeGeneration: { strings: false, wasm: false } };
1183
+ const LOCK_PREPARE_STACK_TRACE_SOURCE = "Object.defineProperty(Error, \"prepareStackTrace\", { value: undefined, writable: false, enumerable: false, configurable: false });";
1184
+
1185
+ // A null-prototype sandbox keeps globalThis.constructor out of the worker realm. The sandbox itself is
1186
+ // still a worker-realm object, and Bun forwards a failed global redefinition to it as the worker's
1187
+ // TypeError; lockWorkerRealm makes that error useless. vm.constants.DONT_CONTEXTIFY would avoid the
1188
+ // sandbox, but Bun 1.3 ignores properties defined on such a global, so the script API could not be installed.
1189
+ function createVmRealm() {
1190
+ return vm.createContext(Object.create(null), VM_CONTEXT_OPTIONS);
1191
+ }
1192
+
1193
+ // Runs once the worker has compiled everything it needs, right before the script starts. A worker-realm
1194
+ // value can still reach a script through engine paths (see workflowRuntime), so take away what such a
1195
+ // value would be used for: no worker function's constructor compiles code, and no script can install a
1196
+ // stack formatter that hands it worker frames.
1197
+ function lockWorkerRealm() {
1198
+ const refuse = function Function() {
1199
+ throw new TypeError("Code generation is disabled in the workflow worker.");
1200
+ };
1201
+ const functionPrototypes = [
1202
+ Function.prototype,
1203
+ Object.getPrototypeOf(async function () {}),
1204
+ Object.getPrototypeOf(function* () {}),
1205
+ Object.getPrototypeOf(async function* () {}),
1206
+ ];
1207
+ // A host that froze these already chose their values; redefining them would throw and fail every workflow.
1208
+ const lock = (target, key, value) => {
1209
+ if (Object.getOwnPropertyDescriptor(target, key)?.configurable === false) return;
1210
+ Object.defineProperty(target, key, { value, writable: false, enumerable: false, configurable: false });
1211
+ };
1212
+ for (const prototype of functionPrototypes) lock(prototype, "constructor", refuse);
1213
+ lock(Error, "prepareStackTrace", Error.prepareStackTrace);
1214
+ }
1215
+ const INSPECT_OPTIONS = { depth: 4, breakLength: 120, customInspect: false };
1216
+
1217
+ let runtime;
1218
+ let stopWorkflowPromiseHook;
1219
+
1220
+ // Each method takes and returns only strings, numbers and booleans, and catches its own failures.
1221
+ // inspect is the one exception on input: it formats a script value without calling script-defined
1222
+ // custom inspectors, which would receive worker-realm arguments.
1223
+ const bridge = Object.freeze({
1224
+ __proto__: null,
1225
+ post(json) {
1226
+ try {
1227
+ parentPort.postMessage(JSON.parse(json));
1228
+ return true;
1229
+ } catch {
1230
+ return false;
1231
+ }
1232
+ },
1233
+ inspect(value) {
1234
+ try {
1235
+ return JSON.stringify([true, inspect(value, INSPECT_OPTIONS)]);
1236
+ } catch (error) {
1237
+ const message = error && typeof error.message === "string" ? error.message : "console could not format a value.";
1238
+ return JSON.stringify([false, message]);
1239
+ }
1240
+ },
1241
+ utf8Length(value) {
1242
+ try {
1243
+ return typeof value === "string" ? new TextEncoder().encode(value).byteLength : -1;
1244
+ } catch {
1245
+ return -1;
1246
+ }
1247
+ },
1248
+ utf8Prefix(value, maxBytes) {
1249
+ try {
1250
+ if (typeof value !== "string" || typeof maxBytes !== "number") return undefined;
1251
+ return new TextDecoder().decode(new TextEncoder().encode(value).subarray(0, maxBytes), { stream: true });
1252
+ } catch {
1253
+ return undefined;
1254
+ }
1255
+ },
1256
+ stopPromiseHooks() {
1257
+ const stop = stopWorkflowPromiseHook;
1258
+ stopWorkflowPromiseHook = undefined;
1259
+ try {
1260
+ stop?.();
1261
+ return true;
1262
+ } catch {
1263
+ return false;
1264
+ }
1265
+ },
1266
+ });
1267
+
1268
+ function postWorkerError(error) {
1269
+ parentPort.postMessage({ type: "error", error: isSyntaxError(error) ? formatWorkflowScriptSyntaxError(error) : formatWorkflowScriptError(error), errorKind: "script" });
1270
+ }
1271
+
1272
+ process.on("unhandledRejection", (reason) => {
1273
+ // A worker-realm reason is the worker's own failure; it must not enter the runtime realm.
1274
+ if (runtime && !(reason instanceof Object)) runtime.reportError(reason);
1275
+ else postWorkerError(reason);
1276
+ });
1277
+
1278
+ function deepFreezeWorkflowArgs(value) {
1279
+ if (value === null || typeof value !== "object" || Object.isFrozen(value)) return value;
1280
+ for (const entry of Object.values(value)) deepFreezeWorkflowArgs(entry);
1281
+ return Object.freeze(value);
1282
+ }
1283
+
1284
+ function startWorkflow(message) {
1285
+ const context = createVmRealm();
1286
+ const runtimeContext = createVmRealm();
1287
+ // Bun hands Error.prepareStackTrace call sites (and the array holding them) from the worker's realm,
1288
+ // whatever context the error came from. Lock it in both realms before any code runs there.
1289
+ for (const realm of [context, runtimeContext]) vm.runInContext(LOCK_PREPARE_STACK_TRACE_SOURCE, realm);
1290
+ const scriptRealm = vm.runInContext("({ __proto__: null, objectPrototype: Object.prototype, promisePrototype: (async () => {})().constructor.prototype })", context);
1291
+ const createRuntime = new vm.Script(WORKFLOW_RUNTIME_SOURCE, { filename: "pi-workflow-runtime.js" }).runInContext(runtimeContext);
1292
+ runtime = createRuntime(bridge, scriptRealm, Boolean(message.stateEnabled));
1293
+ Object.assign(context, runtime.scriptGlobals);
1294
+ // Rebuild args inside the VM realm: a worker-realm object would expose the worker's unrestricted
1295
+ // Function through args.constructor.constructor, bypassing codeGeneration.strings: false.
1296
+ context.args = deepFreezeWorkflowArgs(vm.runInContext("JSON.parse", context)(JSON.stringify(message.args ?? {})));
1297
+ let compiled;
1298
+ try {
1299
+ assertPortableWorkflowScript(message.script);
1300
+ compiled = new vm.Script("(async () => {\n" + message.script + "\n})()", { filename: "workflow-script.js", lineOffset: -1 });
1301
+ } catch (error) {
1302
+ parentPort.postMessage({ type: "error", errorKind: "validation", error: isSyntaxError(error) ? formatWorkflowScriptSyntaxError(error) : formatWorkflowScriptError(error) });
1303
+ return;
1304
+ }
1305
+ if (!runtime.beginWorkflowScript()) return;
1306
+ stopWorkflowPromiseHook = createWorkflowPromiseHook({ init: runtime.hookInit, before: runtime.hookBefore, after: runtime.hookAfter });
1307
+ lockWorkerRealm();
1308
+ let result;
1309
+ let threw = false;
1310
+ try {
1311
+ result = compiled.runInContext(context);
1312
+ } catch (error) {
1313
+ threw = true;
1314
+ result = error;
1315
+ }
1316
+ runtime.awaitWorkflowScript(threw, result);
1317
+ }
1318
+
1319
+ parentPort.on("message", (message) => {
1320
+ if (message.type === "response") {
1321
+ if (!runtime || typeof message.callId !== "number") return;
1322
+ if (!message.ok) {
1323
+ runtime.deliver(message.callId, false, undefined, message.error === undefined ? undefined : String(message.error), typeof message.errorKind === "string" ? message.errorKind : undefined);
1324
+ return;
1325
+ }
1326
+ let encodedValue;
1327
+ try {
1328
+ encodedValue = JSON.stringify({ value: message.value });
1329
+ } catch (error) {
1330
+ runtime.deliver(message.callId, false, undefined, "Workflow host response is not JSON: " + error.message, undefined);
1331
+ return;
1332
+ }
1333
+ runtime.deliver(message.callId, true, encodedValue, undefined, undefined);
1334
+ return;
1335
+ }
1336
+ if (message.type !== "start") return;
1337
+ try {
1338
+ startWorkflow(message);
1339
+ } catch (error) {
1340
+ postWorkerError(error);
1341
+ }
1342
+ });