@xzzpig/pi-subagents 0.22.0 → 0.24.0

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