@stigmer/runner 3.0.1

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 (904) hide show
  1. package/README.md +212 -0
  2. package/dist/.build-fingerprint +1 -0
  3. package/dist/activities/call-agent-status.d.ts +37 -0
  4. package/dist/activities/call-agent-status.js +91 -0
  5. package/dist/activities/call-agent-status.js.map +1 -0
  6. package/dist/activities/call-agent.d.ts +25 -0
  7. package/dist/activities/call-agent.js +233 -0
  8. package/dist/activities/call-agent.js.map +1 -0
  9. package/dist/activities/call-eval.d.ts +50 -0
  10. package/dist/activities/call-eval.js +244 -0
  11. package/dist/activities/call-eval.js.map +1 -0
  12. package/dist/activities/call-function.d.ts +21 -0
  13. package/dist/activities/call-function.js +54 -0
  14. package/dist/activities/call-function.js.map +1 -0
  15. package/dist/activities/call-grpc.d.ts +22 -0
  16. package/dist/activities/call-grpc.js +101 -0
  17. package/dist/activities/call-grpc.js.map +1 -0
  18. package/dist/activities/call-http.d.ts +32 -0
  19. package/dist/activities/call-http.js +134 -0
  20. package/dist/activities/call-http.js.map +1 -0
  21. package/dist/activities/call-llm.d.ts +39 -0
  22. package/dist/activities/call-llm.js +260 -0
  23. package/dist/activities/call-llm.js.map +1 -0
  24. package/dist/activities/call-transform.d.ts +20 -0
  25. package/dist/activities/call-transform.js +33 -0
  26. package/dist/activities/call-transform.js.map +1 -0
  27. package/dist/activities/call-validate.d.ts +41 -0
  28. package/dist/activities/call-validate.js +163 -0
  29. package/dist/activities/call-validate.js.map +1 -0
  30. package/dist/activities/classify-tool-approvals.d.ts +47 -0
  31. package/dist/activities/classify-tool-approvals.js +207 -0
  32. package/dist/activities/classify-tool-approvals.js.map +1 -0
  33. package/dist/activities/discover-mcp-server.d.ts +65 -0
  34. package/dist/activities/discover-mcp-server.js +269 -0
  35. package/dist/activities/discover-mcp-server.js.map +1 -0
  36. package/dist/activities/emit-event.d.ts +46 -0
  37. package/dist/activities/emit-event.js +125 -0
  38. package/dist/activities/emit-event.js.map +1 -0
  39. package/dist/activities/ensure-thread.d.ts +24 -0
  40. package/dist/activities/ensure-thread.js +44 -0
  41. package/dist/activities/ensure-thread.js.map +1 -0
  42. package/dist/activities/evaluate-expressions.d.ts +21 -0
  43. package/dist/activities/evaluate-expressions.js +39 -0
  44. package/dist/activities/evaluate-expressions.js.map +1 -0
  45. package/dist/activities/execute-cursor/approval-policy.d.ts +104 -0
  46. package/dist/activities/execute-cursor/approval-policy.js +193 -0
  47. package/dist/activities/execute-cursor/approval-policy.js.map +1 -0
  48. package/dist/activities/execute-cursor/approval-state.d.ts +157 -0
  49. package/dist/activities/execute-cursor/approval-state.js +223 -0
  50. package/dist/activities/execute-cursor/approval-state.js.map +1 -0
  51. package/dist/activities/execute-cursor/attachment-resolver.d.ts +19 -0
  52. package/dist/activities/execute-cursor/attachment-resolver.js +52 -0
  53. package/dist/activities/execute-cursor/attachment-resolver.js.map +1 -0
  54. package/dist/activities/execute-cursor/blueprint-resolver.d.ts +66 -0
  55. package/dist/activities/execute-cursor/blueprint-resolver.js +169 -0
  56. package/dist/activities/execute-cursor/blueprint-resolver.js.map +1 -0
  57. package/dist/activities/execute-cursor/connect-backfill.d.ts +18 -0
  58. package/dist/activities/execute-cursor/connect-backfill.js +27 -0
  59. package/dist/activities/execute-cursor/connect-backfill.js.map +1 -0
  60. package/dist/activities/execute-cursor/cursor-event-recorder.d.ts +24 -0
  61. package/dist/activities/execute-cursor/cursor-event-recorder.js +66 -0
  62. package/dist/activities/execute-cursor/cursor-event-recorder.js.map +1 -0
  63. package/dist/activities/execute-cursor/cursor-mode.d.ts +32 -0
  64. package/dist/activities/execute-cursor/cursor-mode.js +36 -0
  65. package/dist/activities/execute-cursor/cursor-mode.js.map +1 -0
  66. package/dist/activities/execute-cursor/delta-enricher.d.ts +87 -0
  67. package/dist/activities/execute-cursor/delta-enricher.js +265 -0
  68. package/dist/activities/execute-cursor/delta-enricher.js.map +1 -0
  69. package/dist/activities/execute-cursor/env-resolver.d.ts +19 -0
  70. package/dist/activities/execute-cursor/env-resolver.js +47 -0
  71. package/dist/activities/execute-cursor/env-resolver.js.map +1 -0
  72. package/dist/activities/execute-cursor/error-classifier.d.ts +73 -0
  73. package/dist/activities/execute-cursor/error-classifier.js +185 -0
  74. package/dist/activities/execute-cursor/error-classifier.js.map +1 -0
  75. package/dist/activities/execute-cursor/fetch-interceptor.d.ts +59 -0
  76. package/dist/activities/execute-cursor/fetch-interceptor.js +317 -0
  77. package/dist/activities/execute-cursor/fetch-interceptor.js.map +1 -0
  78. package/dist/activities/execute-cursor/hitl-diagnostics.d.ts +32 -0
  79. package/dist/activities/execute-cursor/hitl-diagnostics.js +73 -0
  80. package/dist/activities/execute-cursor/hitl-diagnostics.js.map +1 -0
  81. package/dist/activities/execute-cursor/hook-script.d.ts +47 -0
  82. package/dist/activities/execute-cursor/hook-script.js +156 -0
  83. package/dist/activities/execute-cursor/hook-script.js.map +1 -0
  84. package/dist/activities/execute-cursor/http2-interceptor.d.ts +94 -0
  85. package/dist/activities/execute-cursor/http2-interceptor.js +209 -0
  86. package/dist/activities/execute-cursor/http2-interceptor.js.map +1 -0
  87. package/dist/activities/execute-cursor/index.d.ts +67 -0
  88. package/dist/activities/execute-cursor/index.js +1176 -0
  89. package/dist/activities/execute-cursor/index.js.map +1 -0
  90. package/dist/activities/execute-cursor/mcp-config.d.ts +30 -0
  91. package/dist/activities/execute-cursor/mcp-config.js +39 -0
  92. package/dist/activities/execute-cursor/mcp-config.js.map +1 -0
  93. package/dist/activities/execute-cursor/mcp-resolver.d.ts +91 -0
  94. package/dist/activities/execute-cursor/mcp-resolver.js +178 -0
  95. package/dist/activities/execute-cursor/mcp-resolver.js.map +1 -0
  96. package/dist/activities/execute-cursor/message-translator.d.ts +211 -0
  97. package/dist/activities/execute-cursor/message-translator.js +786 -0
  98. package/dist/activities/execute-cursor/message-translator.js.map +1 -0
  99. package/dist/activities/execute-cursor/model-pricing-data.d.ts +40 -0
  100. package/dist/activities/execute-cursor/model-pricing-data.js +114 -0
  101. package/dist/activities/execute-cursor/model-pricing-data.js.map +1 -0
  102. package/dist/activities/execute-cursor/model-pricing.d.ts +42 -0
  103. package/dist/activities/execute-cursor/model-pricing.js +141 -0
  104. package/dist/activities/execute-cursor/model-pricing.js.map +1 -0
  105. package/dist/activities/execute-cursor/placeholder-resolver.d.ts +34 -0
  106. package/dist/activities/execute-cursor/placeholder-resolver.js +82 -0
  107. package/dist/activities/execute-cursor/placeholder-resolver.js.map +1 -0
  108. package/dist/activities/execute-cursor/prompt-builder.d.ts +80 -0
  109. package/dist/activities/execute-cursor/prompt-builder.js +280 -0
  110. package/dist/activities/execute-cursor/prompt-builder.js.map +1 -0
  111. package/dist/activities/execute-cursor/rejection-capture.d.ts +30 -0
  112. package/dist/activities/execute-cursor/rejection-capture.js +80 -0
  113. package/dist/activities/execute-cursor/rejection-capture.js.map +1 -0
  114. package/dist/activities/execute-cursor/session-lifecycle.d.ts +189 -0
  115. package/dist/activities/execute-cursor/session-lifecycle.js +285 -0
  116. package/dist/activities/execute-cursor/session-lifecycle.js.map +1 -0
  117. package/dist/activities/execute-cursor/skill-resolver.d.ts +29 -0
  118. package/dist/activities/execute-cursor/skill-resolver.js +134 -0
  119. package/dist/activities/execute-cursor/skill-resolver.js.map +1 -0
  120. package/dist/activities/execute-cursor/subagent-config.d.ts +34 -0
  121. package/dist/activities/execute-cursor/subagent-config.js +55 -0
  122. package/dist/activities/execute-cursor/subagent-config.js.map +1 -0
  123. package/dist/activities/execute-cursor/todo-tracker.d.ts +35 -0
  124. package/dist/activities/execute-cursor/todo-tracker.js +108 -0
  125. package/dist/activities/execute-cursor/todo-tracker.js.map +1 -0
  126. package/dist/activities/execute-cursor/usage-accumulator.d.ts +55 -0
  127. package/dist/activities/execute-cursor/usage-accumulator.js +89 -0
  128. package/dist/activities/execute-cursor/usage-accumulator.js.map +1 -0
  129. package/dist/activities/execute-cursor/workspace-provision.d.ts +22 -0
  130. package/dist/activities/execute-cursor/workspace-provision.js +37 -0
  131. package/dist/activities/execute-cursor/workspace-provision.js.map +1 -0
  132. package/dist/activities/execute-cursor/workspace-setup.d.ts +27 -0
  133. package/dist/activities/execute-cursor/workspace-setup.js +61 -0
  134. package/dist/activities/execute-cursor/workspace-setup.js.map +1 -0
  135. package/dist/activities/execute-deep-agent/__test-utils__/v3-event-fixtures.d.ts +71 -0
  136. package/dist/activities/execute-deep-agent/__test-utils__/v3-event-fixtures.js +182 -0
  137. package/dist/activities/execute-deep-agent/__test-utils__/v3-event-fixtures.js.map +1 -0
  138. package/dist/activities/execute-deep-agent/attachment-injector.d.ts +67 -0
  139. package/dist/activities/execute-deep-agent/attachment-injector.js +306 -0
  140. package/dist/activities/execute-deep-agent/attachment-injector.js.map +1 -0
  141. package/dist/activities/execute-deep-agent/auto-publish.d.ts +17 -0
  142. package/dist/activities/execute-deep-agent/auto-publish.js +71 -0
  143. package/dist/activities/execute-deep-agent/auto-publish.js.map +1 -0
  144. package/dist/activities/execute-deep-agent/environment.d.ts +24 -0
  145. package/dist/activities/execute-deep-agent/environment.js +50 -0
  146. package/dist/activities/execute-deep-agent/environment.js.map +1 -0
  147. package/dist/activities/execute-deep-agent/event-recorder.d.ts +21 -0
  148. package/dist/activities/execute-deep-agent/event-recorder.js +67 -0
  149. package/dist/activities/execute-deep-agent/event-recorder.js.map +1 -0
  150. package/dist/activities/execute-deep-agent/execution-state.d.ts +61 -0
  151. package/dist/activities/execute-deep-agent/execution-state.js +76 -0
  152. package/dist/activities/execute-deep-agent/execution-state.js.map +1 -0
  153. package/dist/activities/execute-deep-agent/execution-status-writer.d.ts +17 -0
  154. package/dist/activities/execute-deep-agent/execution-status-writer.js +9 -0
  155. package/dist/activities/execute-deep-agent/execution-status-writer.js.map +1 -0
  156. package/dist/activities/execute-deep-agent/hitl.d.ts +58 -0
  157. package/dist/activities/execute-deep-agent/hitl.js +155 -0
  158. package/dist/activities/execute-deep-agent/hitl.js.map +1 -0
  159. package/dist/activities/execute-deep-agent/index.d.ts +14 -0
  160. package/dist/activities/execute-deep-agent/index.js +286 -0
  161. package/dist/activities/execute-deep-agent/index.js.map +1 -0
  162. package/dist/activities/execute-deep-agent/inline-publisher.d.ts +36 -0
  163. package/dist/activities/execute-deep-agent/inline-publisher.js +105 -0
  164. package/dist/activities/execute-deep-agent/inline-publisher.js.map +1 -0
  165. package/dist/activities/execute-deep-agent/post-stream.d.ts +23 -0
  166. package/dist/activities/execute-deep-agent/post-stream.js +71 -0
  167. package/dist/activities/execute-deep-agent/post-stream.js.map +1 -0
  168. package/dist/activities/execute-deep-agent/prompt-builder.d.ts +27 -0
  169. package/dist/activities/execute-deep-agent/prompt-builder.js +200 -0
  170. package/dist/activities/execute-deep-agent/prompt-builder.js.map +1 -0
  171. package/dist/activities/execute-deep-agent/setup.d.ts +55 -0
  172. package/dist/activities/execute-deep-agent/setup.js +411 -0
  173. package/dist/activities/execute-deep-agent/setup.js.map +1 -0
  174. package/dist/activities/execute-deep-agent/status-builder-shared.d.ts +39 -0
  175. package/dist/activities/execute-deep-agent/status-builder-shared.js +120 -0
  176. package/dist/activities/execute-deep-agent/status-builder-shared.js.map +1 -0
  177. package/dist/activities/execute-deep-agent/status-builder.d.ts +81 -0
  178. package/dist/activities/execute-deep-agent/status-builder.js +312 -0
  179. package/dist/activities/execute-deep-agent/status-builder.js.map +1 -0
  180. package/dist/activities/execute-deep-agent/streaming-scheduler.d.ts +60 -0
  181. package/dist/activities/execute-deep-agent/streaming-scheduler.js +114 -0
  182. package/dist/activities/execute-deep-agent/streaming-scheduler.js.map +1 -0
  183. package/dist/activities/execute-deep-agent/streaming-side-effects.d.ts +22 -0
  184. package/dist/activities/execute-deep-agent/streaming-side-effects.js +83 -0
  185. package/dist/activities/execute-deep-agent/streaming-side-effects.js.map +1 -0
  186. package/dist/activities/execute-deep-agent/streaming-terminal.d.ts +12 -0
  187. package/dist/activities/execute-deep-agent/streaming-terminal.js +71 -0
  188. package/dist/activities/execute-deep-agent/streaming-terminal.js.map +1 -0
  189. package/dist/activities/execute-deep-agent/streaming-v3.d.ts +13 -0
  190. package/dist/activities/execute-deep-agent/streaming-v3.js +170 -0
  191. package/dist/activities/execute-deep-agent/streaming-v3.js.map +1 -0
  192. package/dist/activities/execute-deep-agent/streaming.d.ts +66 -0
  193. package/dist/activities/execute-deep-agent/streaming.js +169 -0
  194. package/dist/activities/execute-deep-agent/streaming.js.map +1 -0
  195. package/dist/activities/execute-deep-agent/subagent-tracker.d.ts +90 -0
  196. package/dist/activities/execute-deep-agent/subagent-tracker.js +364 -0
  197. package/dist/activities/execute-deep-agent/subagent-tracker.js.map +1 -0
  198. package/dist/activities/execute-deep-agent/subagent-transformer.d.ts +150 -0
  199. package/dist/activities/execute-deep-agent/subagent-transformer.js +450 -0
  200. package/dist/activities/execute-deep-agent/subagent-transformer.js.map +1 -0
  201. package/dist/activities/execute-deep-agent/subagent-wiring.d.ts +28 -0
  202. package/dist/activities/execute-deep-agent/subagent-wiring.js +40 -0
  203. package/dist/activities/execute-deep-agent/subagent-wiring.js.map +1 -0
  204. package/dist/activities/execute-deep-agent/v3-event-recorder.d.ts +31 -0
  205. package/dist/activities/execute-deep-agent/v3-event-recorder.js +71 -0
  206. package/dist/activities/execute-deep-agent/v3-event-recorder.js.map +1 -0
  207. package/dist/activities/execute-deep-agent/v3-events.d.ts +102 -0
  208. package/dist/activities/execute-deep-agent/v3-events.js +35 -0
  209. package/dist/activities/execute-deep-agent/v3-events.js.map +1 -0
  210. package/dist/activities/execute-deep-agent/v3-protocol-normalizer.d.ts +15 -0
  211. package/dist/activities/execute-deep-agent/v3-protocol-normalizer.js +235 -0
  212. package/dist/activities/execute-deep-agent/v3-protocol-normalizer.js.map +1 -0
  213. package/dist/activities/execute-deep-agent/v3-status-builder.d.ts +68 -0
  214. package/dist/activities/execute-deep-agent/v3-status-builder.js +394 -0
  215. package/dist/activities/execute-deep-agent/v3-status-builder.js.map +1 -0
  216. package/dist/activities/execute-deep-agent/writeback-coordinator.d.ts +71 -0
  217. package/dist/activities/execute-deep-agent/writeback-coordinator.js +295 -0
  218. package/dist/activities/execute-deep-agent/writeback-coordinator.js.map +1 -0
  219. package/dist/activities/hydrate-workflow-execution.d.ts +32 -0
  220. package/dist/activities/hydrate-workflow-execution.js +212 -0
  221. package/dist/activities/hydrate-workflow-execution.js.map +1 -0
  222. package/dist/activities/notification.d.ts +19 -0
  223. package/dist/activities/notification.js +47 -0
  224. package/dist/activities/notification.js.map +1 -0
  225. package/dist/activities/promote-task-output.d.ts +38 -0
  226. package/dist/activities/promote-task-output.js +90 -0
  227. package/dist/activities/promote-task-output.js.map +1 -0
  228. package/dist/activities/run-command.d.ts +15 -0
  229. package/dist/activities/run-command.js +123 -0
  230. package/dist/activities/run-command.js.map +1 -0
  231. package/dist/activities/workflow-event-activities.d.ts +48 -0
  232. package/dist/activities/workflow-event-activities.js +415 -0
  233. package/dist/activities/workflow-event-activities.js.map +1 -0
  234. package/dist/bootstrap.d.ts +80 -0
  235. package/dist/bootstrap.js +114 -0
  236. package/dist/bootstrap.js.map +1 -0
  237. package/dist/budget/index.d.ts +1 -0
  238. package/dist/budget/index.js +2 -0
  239. package/dist/budget/index.js.map +1 -0
  240. package/dist/budget/tracker.d.ts +52 -0
  241. package/dist/budget/tracker.js +123 -0
  242. package/dist/budget/tracker.js.map +1 -0
  243. package/dist/claimcheck/compressor.d.ts +2 -0
  244. package/dist/claimcheck/compressor.js +8 -0
  245. package/dist/claimcheck/compressor.js.map +1 -0
  246. package/dist/claimcheck/config.d.ts +7 -0
  247. package/dist/claimcheck/config.js +10 -0
  248. package/dist/claimcheck/config.js.map +1 -0
  249. package/dist/claimcheck/index.d.ts +3 -0
  250. package/dist/claimcheck/index.js +4 -0
  251. package/dist/claimcheck/index.js.map +1 -0
  252. package/dist/claimcheck/payload-codec.d.ts +23 -0
  253. package/dist/claimcheck/payload-codec.js +81 -0
  254. package/dist/claimcheck/payload-codec.js.map +1 -0
  255. package/dist/client/server-contracts.d.ts +52 -0
  256. package/dist/client/server-contracts.js +72 -0
  257. package/dist/client/server-contracts.js.map +1 -0
  258. package/dist/client/stigmer-client.d.ts +131 -0
  259. package/dist/client/stigmer-client.js +239 -0
  260. package/dist/client/stigmer-client.js.map +1 -0
  261. package/dist/config.d.ts +64 -0
  262. package/dist/config.js +123 -0
  263. package/dist/config.js.map +1 -0
  264. package/dist/idle-watchdog.d.ts +11 -0
  265. package/dist/idle-watchdog.js +24 -0
  266. package/dist/idle-watchdog.js.map +1 -0
  267. package/dist/index.d.ts +43 -0
  268. package/dist/index.js +42 -0
  269. package/dist/index.js.map +1 -0
  270. package/dist/interceptors/workflow-metrics-sink.d.ts +11 -0
  271. package/dist/interceptors/workflow-metrics-sink.js +51 -0
  272. package/dist/interceptors/workflow-metrics-sink.js.map +1 -0
  273. package/dist/ipc-protocol-fixtures.d.ts +32 -0
  274. package/dist/ipc-protocol-fixtures.js +69 -0
  275. package/dist/ipc-protocol-fixtures.js.map +1 -0
  276. package/dist/ipc-protocol.d.ts +60 -0
  277. package/dist/ipc-protocol.js +19 -0
  278. package/dist/ipc-protocol.js.map +1 -0
  279. package/dist/main.d.ts +19 -0
  280. package/dist/main.js +292 -0
  281. package/dist/main.js.map +1 -0
  282. package/dist/middleware/approval-gate.d.ts +30 -0
  283. package/dist/middleware/approval-gate.js +125 -0
  284. package/dist/middleware/approval-gate.js.map +1 -0
  285. package/dist/middleware/cost-cap.d.ts +22 -0
  286. package/dist/middleware/cost-cap.js +159 -0
  287. package/dist/middleware/cost-cap.js.map +1 -0
  288. package/dist/middleware/error-hints.d.ts +27 -0
  289. package/dist/middleware/error-hints.js +116 -0
  290. package/dist/middleware/error-hints.js.map +1 -0
  291. package/dist/middleware/execution-budget.d.ts +20 -0
  292. package/dist/middleware/execution-budget.js +151 -0
  293. package/dist/middleware/execution-budget.js.map +1 -0
  294. package/dist/middleware/graceful-stop.d.ts +17 -0
  295. package/dist/middleware/graceful-stop.js +63 -0
  296. package/dist/middleware/graceful-stop.js.map +1 -0
  297. package/dist/middleware/index.d.ts +27 -0
  298. package/dist/middleware/index.js +45 -0
  299. package/dist/middleware/index.js.map +1 -0
  300. package/dist/middleware/loop-detection.d.ts +14 -0
  301. package/dist/middleware/loop-detection.js +156 -0
  302. package/dist/middleware/loop-detection.js.map +1 -0
  303. package/dist/middleware/otel-spans.d.ts +11 -0
  304. package/dist/middleware/otel-spans.js +177 -0
  305. package/dist/middleware/otel-spans.js.map +1 -0
  306. package/dist/middleware/think-tool.d.ts +23 -0
  307. package/dist/middleware/think-tool.js +33 -0
  308. package/dist/middleware/think-tool.js.map +1 -0
  309. package/dist/middleware/tool-truncation.d.ts +16 -0
  310. package/dist/middleware/tool-truncation.js +67 -0
  311. package/dist/middleware/tool-truncation.js.map +1 -0
  312. package/dist/middleware/types.d.ts +100 -0
  313. package/dist/middleware/types.js +9 -0
  314. package/dist/middleware/types.js.map +1 -0
  315. package/dist/notification/index.d.ts +2 -0
  316. package/dist/notification/index.js +6 -0
  317. package/dist/notification/index.js.map +1 -0
  318. package/dist/notification/provider.d.ts +29 -0
  319. package/dist/notification/provider.js +25 -0
  320. package/dist/notification/provider.js.map +1 -0
  321. package/dist/notification/webhook.d.ts +13 -0
  322. package/dist/notification/webhook.js +55 -0
  323. package/dist/notification/webhook.js.map +1 -0
  324. package/dist/otel-metrics.d.ts +21 -0
  325. package/dist/otel-metrics.js +54 -0
  326. package/dist/otel-metrics.js.map +1 -0
  327. package/dist/otel.d.ts +57 -0
  328. package/dist/otel.js +164 -0
  329. package/dist/otel.js.map +1 -0
  330. package/dist/runner-manager.d.ts +113 -0
  331. package/dist/runner-manager.js +412 -0
  332. package/dist/runner-manager.js.map +1 -0
  333. package/dist/runner-token-coordinator.d.ts +56 -0
  334. package/dist/runner-token-coordinator.js +84 -0
  335. package/dist/runner-token-coordinator.js.map +1 -0
  336. package/dist/runner.d.ts +104 -0
  337. package/dist/runner.js +234 -0
  338. package/dist/runner.js.map +1 -0
  339. package/dist/shared/approval-policy.d.ts +45 -0
  340. package/dist/shared/approval-policy.js +122 -0
  341. package/dist/shared/approval-policy.js.map +1 -0
  342. package/dist/shared/artifact-storage.d.ts +44 -0
  343. package/dist/shared/artifact-storage.js +162 -0
  344. package/dist/shared/artifact-storage.js.map +1 -0
  345. package/dist/shared/checkpointer/factory.d.ts +28 -0
  346. package/dist/shared/checkpointer/factory.js +55 -0
  347. package/dist/shared/checkpointer/factory.js.map +1 -0
  348. package/dist/shared/checkpointer/http-saver.d.ts +34 -0
  349. package/dist/shared/checkpointer/http-saver.js +274 -0
  350. package/dist/shared/checkpointer/http-saver.js.map +1 -0
  351. package/dist/shared/checkpointer/types.d.ts +12 -0
  352. package/dist/shared/checkpointer/types.js +2 -0
  353. package/dist/shared/checkpointer/types.js.map +1 -0
  354. package/dist/shared/connect-backfill.d.ts +58 -0
  355. package/dist/shared/connect-backfill.js +119 -0
  356. package/dist/shared/connect-backfill.js.map +1 -0
  357. package/dist/shared/extract-json.d.ts +26 -0
  358. package/dist/shared/extract-json.js +140 -0
  359. package/dist/shared/extract-json.js.map +1 -0
  360. package/dist/shared/grpc-retry.d.ts +35 -0
  361. package/dist/shared/grpc-retry.js +78 -0
  362. package/dist/shared/grpc-retry.js.map +1 -0
  363. package/dist/shared/heartbeat.d.ts +22 -0
  364. package/dist/shared/heartbeat.js +55 -0
  365. package/dist/shared/heartbeat.js.map +1 -0
  366. package/dist/shared/json-schema-to-zod.d.ts +13 -0
  367. package/dist/shared/json-schema-to-zod.js +49 -0
  368. package/dist/shared/json-schema-to-zod.js.map +1 -0
  369. package/dist/shared/llm-proxy.d.ts +57 -0
  370. package/dist/shared/llm-proxy.js +116 -0
  371. package/dist/shared/llm-proxy.js.map +1 -0
  372. package/dist/shared/mcp-manager.d.ts +47 -0
  373. package/dist/shared/mcp-manager.js +118 -0
  374. package/dist/shared/mcp-manager.js.map +1 -0
  375. package/dist/shared/mcp-resolver.d.ts +41 -0
  376. package/dist/shared/mcp-resolver.js +96 -0
  377. package/dist/shared/mcp-resolver.js.map +1 -0
  378. package/dist/shared/model-pricing-data.d.ts +18 -0
  379. package/dist/shared/model-pricing-data.js +78 -0
  380. package/dist/shared/model-pricing-data.js.map +1 -0
  381. package/dist/shared/model-pricing.d.ts +24 -0
  382. package/dist/shared/model-pricing.js +58 -0
  383. package/dist/shared/model-pricing.js.map +1 -0
  384. package/dist/shared/model-registry.d.ts +55 -0
  385. package/dist/shared/model-registry.js +178 -0
  386. package/dist/shared/model-registry.js.map +1 -0
  387. package/dist/shared/placeholder-resolver.d.ts +27 -0
  388. package/dist/shared/placeholder-resolver.js +75 -0
  389. package/dist/shared/placeholder-resolver.js.map +1 -0
  390. package/dist/shared/plan-artifact.d.ts +56 -0
  391. package/dist/shared/plan-artifact.js +98 -0
  392. package/dist/shared/plan-artifact.js.map +1 -0
  393. package/dist/shared/skill-relevance.d.ts +65 -0
  394. package/dist/shared/skill-relevance.js +175 -0
  395. package/dist/shared/skill-relevance.js.map +1 -0
  396. package/dist/shared/skill-writer.d.ts +73 -0
  397. package/dist/shared/skill-writer.js +230 -0
  398. package/dist/shared/skill-writer.js.map +1 -0
  399. package/dist/shared/status.d.ts +37 -0
  400. package/dist/shared/status.js +73 -0
  401. package/dist/shared/status.js.map +1 -0
  402. package/dist/shared/subagent-gate.d.ts +41 -0
  403. package/dist/shared/subagent-gate.js +93 -0
  404. package/dist/shared/subagent-gate.js.map +1 -0
  405. package/dist/shared/tool-kind.d.ts +22 -0
  406. package/dist/shared/tool-kind.js +79 -0
  407. package/dist/shared/tool-kind.js.map +1 -0
  408. package/dist/shared/workspace/file-tree.d.ts +13 -0
  409. package/dist/shared/workspace/file-tree.js +101 -0
  410. package/dist/shared/workspace/file-tree.js.map +1 -0
  411. package/dist/shared/workspace/local-backend.d.ts +41 -0
  412. package/dist/shared/workspace/local-backend.js +113 -0
  413. package/dist/shared/workspace/local-backend.js.map +1 -0
  414. package/dist/shared/workspace/platform-dir.d.ts +25 -0
  415. package/dist/shared/workspace/platform-dir.js +36 -0
  416. package/dist/shared/workspace/platform-dir.js.map +1 -0
  417. package/dist/shared/workspace/platform-mount.d.ts +95 -0
  418. package/dist/shared/workspace/platform-mount.js +157 -0
  419. package/dist/shared/workspace/platform-mount.js.map +1 -0
  420. package/dist/shared/workspace/provisioner.d.ts +47 -0
  421. package/dist/shared/workspace/provisioner.js +84 -0
  422. package/dist/shared/workspace/provisioner.js.map +1 -0
  423. package/dist/shared/workspace/sources/empty.d.ts +8 -0
  424. package/dist/shared/workspace/sources/empty.js +18 -0
  425. package/dist/shared/workspace/sources/empty.js.map +1 -0
  426. package/dist/shared/workspace/sources/git.d.ts +22 -0
  427. package/dist/shared/workspace/sources/git.js +207 -0
  428. package/dist/shared/workspace/sources/git.js.map +1 -0
  429. package/dist/shared/workspace/sources/local-path.d.ts +17 -0
  430. package/dist/shared/workspace/sources/local-path.js +57 -0
  431. package/dist/shared/workspace/sources/local-path.js.map +1 -0
  432. package/dist/shared/workspace/types.d.ts +58 -0
  433. package/dist/shared/workspace/types.js +25 -0
  434. package/dist/shared/workspace/types.js.map +1 -0
  435. package/dist/shared/zip-extract.d.ts +30 -0
  436. package/dist/shared/zip-extract.js +150 -0
  437. package/dist/shared/zip-extract.js.map +1 -0
  438. package/dist/worker.d.ts +27 -0
  439. package/dist/worker.js +65 -0
  440. package/dist/worker.js.map +1 -0
  441. package/dist/workflow-engine/clone.d.ts +11 -0
  442. package/dist/workflow-engine/clone.js +21 -0
  443. package/dist/workflow-engine/clone.js.map +1 -0
  444. package/dist/workflow-engine/do-executor.d.ts +27 -0
  445. package/dist/workflow-engine/do-executor.js +418 -0
  446. package/dist/workflow-engine/do-executor.js.map +1 -0
  447. package/dist/workflow-engine/duration.d.ts +12 -0
  448. package/dist/workflow-engine/duration.js +25 -0
  449. package/dist/workflow-engine/duration.js.map +1 -0
  450. package/dist/workflow-engine/error-utils.d.ts +42 -0
  451. package/dist/workflow-engine/error-utils.js +77 -0
  452. package/dist/workflow-engine/error-utils.js.map +1 -0
  453. package/dist/workflow-engine/errors.d.ts +46 -0
  454. package/dist/workflow-engine/errors.js +105 -0
  455. package/dist/workflow-engine/errors.js.map +1 -0
  456. package/dist/workflow-engine/expression-utils.d.ts +60 -0
  457. package/dist/workflow-engine/expression-utils.js +108 -0
  458. package/dist/workflow-engine/expression-utils.js.map +1 -0
  459. package/dist/workflow-engine/expression.d.ts +132 -0
  460. package/dist/workflow-engine/expression.js +366 -0
  461. package/dist/workflow-engine/expression.js.map +1 -0
  462. package/dist/workflow-engine/loader.d.ts +23 -0
  463. package/dist/workflow-engine/loader.js +429 -0
  464. package/dist/workflow-engine/loader.js.map +1 -0
  465. package/dist/workflow-engine/recovery.d.ts +53 -0
  466. package/dist/workflow-engine/recovery.js +46 -0
  467. package/dist/workflow-engine/recovery.js.map +1 -0
  468. package/dist/workflow-engine/resolve.d.ts +83 -0
  469. package/dist/workflow-engine/resolve.js +257 -0
  470. package/dist/workflow-engine/resolve.js.map +1 -0
  471. package/dist/workflow-engine/retry.d.ts +30 -0
  472. package/dist/workflow-engine/retry.js +97 -0
  473. package/dist/workflow-engine/retry.js.map +1 -0
  474. package/dist/workflow-engine/state.d.ts +26 -0
  475. package/dist/workflow-engine/state.js +49 -0
  476. package/dist/workflow-engine/state.js.map +1 -0
  477. package/dist/workflow-engine/task-factory.d.ts +20 -0
  478. package/dist/workflow-engine/task-factory.js +133 -0
  479. package/dist/workflow-engine/task-factory.js.map +1 -0
  480. package/dist/workflow-engine/task-status-accumulator.d.ts +59 -0
  481. package/dist/workflow-engine/task-status-accumulator.js +164 -0
  482. package/dist/workflow-engine/task-status-accumulator.js.map +1 -0
  483. package/dist/workflow-engine/tasks/call-agent-output.d.ts +26 -0
  484. package/dist/workflow-engine/tasks/call-agent-output.js +109 -0
  485. package/dist/workflow-engine/tasks/call-agent-output.js.map +1 -0
  486. package/dist/workflow-engine/tasks/call-agent.d.ts +31 -0
  487. package/dist/workflow-engine/tasks/call-agent.js +161 -0
  488. package/dist/workflow-engine/tasks/call-agent.js.map +1 -0
  489. package/dist/workflow-engine/tasks/call-function.d.ts +19 -0
  490. package/dist/workflow-engine/tasks/call-function.js +64 -0
  491. package/dist/workflow-engine/tasks/call-function.js.map +1 -0
  492. package/dist/workflow-engine/tasks/call-grpc.d.ts +15 -0
  493. package/dist/workflow-engine/tasks/call-grpc.js +27 -0
  494. package/dist/workflow-engine/tasks/call-grpc.js.map +1 -0
  495. package/dist/workflow-engine/tasks/call-http.d.ts +19 -0
  496. package/dist/workflow-engine/tasks/call-http.js +31 -0
  497. package/dist/workflow-engine/tasks/call-http.js.map +1 -0
  498. package/dist/workflow-engine/tasks/for.d.ts +39 -0
  499. package/dist/workflow-engine/tasks/for.js +154 -0
  500. package/dist/workflow-engine/tasks/for.js.map +1 -0
  501. package/dist/workflow-engine/tasks/fork.d.ts +42 -0
  502. package/dist/workflow-engine/tasks/fork.js +142 -0
  503. package/dist/workflow-engine/tasks/fork.js.map +1 -0
  504. package/dist/workflow-engine/tasks/human-input.d.ts +33 -0
  505. package/dist/workflow-engine/tasks/human-input.js +109 -0
  506. package/dist/workflow-engine/tasks/human-input.js.map +1 -0
  507. package/dist/workflow-engine/tasks/listen.d.ts +34 -0
  508. package/dist/workflow-engine/tasks/listen.js +119 -0
  509. package/dist/workflow-engine/tasks/listen.js.map +1 -0
  510. package/dist/workflow-engine/tasks/raise.d.ts +18 -0
  511. package/dist/workflow-engine/tasks/raise.js +60 -0
  512. package/dist/workflow-engine/tasks/raise.js.map +1 -0
  513. package/dist/workflow-engine/tasks/run.d.ts +39 -0
  514. package/dist/workflow-engine/tasks/run.js +114 -0
  515. package/dist/workflow-engine/tasks/run.js.map +1 -0
  516. package/dist/workflow-engine/tasks/set.d.ts +15 -0
  517. package/dist/workflow-engine/tasks/set.js +31 -0
  518. package/dist/workflow-engine/tasks/set.js.map +1 -0
  519. package/dist/workflow-engine/tasks/switch.d.ts +25 -0
  520. package/dist/workflow-engine/tasks/switch.js +76 -0
  521. package/dist/workflow-engine/tasks/switch.js.map +1 -0
  522. package/dist/workflow-engine/tasks/try.d.ts +49 -0
  523. package/dist/workflow-engine/tasks/try.js +189 -0
  524. package/dist/workflow-engine/tasks/try.js.map +1 -0
  525. package/dist/workflow-engine/tasks/wait.d.ts +24 -0
  526. package/dist/workflow-engine/tasks/wait.js +39 -0
  527. package/dist/workflow-engine/tasks/wait.js.map +1 -0
  528. package/dist/workflow-engine/types.d.ts +682 -0
  529. package/dist/workflow-engine/types.js +47 -0
  530. package/dist/workflow-engine/types.js.map +1 -0
  531. package/dist/workflows/call-agent-orchestrator.d.ts +31 -0
  532. package/dist/workflows/call-agent-orchestrator.js +214 -0
  533. package/dist/workflows/call-agent-orchestrator.js.map +1 -0
  534. package/dist/workflows/connect-mcp-server.d.ts +20 -0
  535. package/dist/workflows/connect-mcp-server.js +113 -0
  536. package/dist/workflows/connect-mcp-server.js.map +1 -0
  537. package/dist/workflows/engine-core.d.ts +36 -0
  538. package/dist/workflows/engine-core.js +272 -0
  539. package/dist/workflows/engine-core.js.map +1 -0
  540. package/dist/workflows/execute-from-execution.d.ts +32 -0
  541. package/dist/workflows/execute-from-execution.js +71 -0
  542. package/dist/workflows/execute-from-execution.js.map +1 -0
  543. package/dist/workflows/execute-serverless-workflow.d.ts +32 -0
  544. package/dist/workflows/execute-serverless-workflow.js +36 -0
  545. package/dist/workflows/execute-serverless-workflow.js.map +1 -0
  546. package/dist/workflows/human-input-orchestrator.d.ts +19 -0
  547. package/dist/workflows/human-input-orchestrator.js +59 -0
  548. package/dist/workflows/human-input-orchestrator.js.map +1 -0
  549. package/dist/workflows/index.d.ts +22 -0
  550. package/dist/workflows/index.js +23 -0
  551. package/dist/workflows/index.js.map +1 -0
  552. package/dist/workflows/listen-orchestrator.d.ts +29 -0
  553. package/dist/workflows/listen-orchestrator.js +143 -0
  554. package/dist/workflows/listen-orchestrator.js.map +1 -0
  555. package/dist/workflows/metrics-sink.d.ts +33 -0
  556. package/dist/workflows/metrics-sink.js +21 -0
  557. package/dist/workflows/metrics-sink.js.map +1 -0
  558. package/dist/workflows/run-orchestrator.d.ts +15 -0
  559. package/dist/workflows/run-orchestrator.js +27 -0
  560. package/dist/workflows/run-orchestrator.js.map +1 -0
  561. package/dist/workflows/types.d.ts +46 -0
  562. package/dist/workflows/types.js +15 -0
  563. package/dist/workflows/types.js.map +1 -0
  564. package/dist/workflows/workflow-signals.d.ts +29 -0
  565. package/dist/workflows/workflow-signals.js +46 -0
  566. package/dist/workflows/workflow-signals.js.map +1 -0
  567. package/package.json +108 -0
  568. package/src/__test-utils__/__tests__/replay-fetch.test.ts +155 -0
  569. package/src/__test-utils__/mock-client.ts +44 -0
  570. package/src/__test-utils__/mock-workspace.ts +28 -0
  571. package/src/__test-utils__/proto-helpers.ts +41 -0
  572. package/src/__test-utils__/replay-fetch.ts +523 -0
  573. package/src/__tests__/bootstrap.test.ts +221 -0
  574. package/src/__tests__/claimcheck-codec.test.ts +257 -0
  575. package/src/__tests__/config.test.ts +150 -0
  576. package/src/__tests__/deterministic-eval-llm.test.ts +269 -0
  577. package/src/__tests__/deterministic-mcp-hitl.test.ts +405 -0
  578. package/src/__tests__/golden-e2e.test.ts +250 -0
  579. package/src/__tests__/ipc-protocol-fixtures.test.ts +66 -0
  580. package/src/__tests__/ipc-protocol.test.ts +32 -0
  581. package/src/__tests__/otel-metrics.test.ts +40 -0
  582. package/src/__tests__/runner-manager.test.ts +55 -0
  583. package/src/__tests__/runner-token-coordinator.test.ts +166 -0
  584. package/src/__tests__/runner.test.ts +182 -0
  585. package/src/__tests__/worker.test.ts +18 -0
  586. package/src/activities/__tests__/call-agent-contracts.test.ts +483 -0
  587. package/src/activities/__tests__/call-agent.test.ts +263 -0
  588. package/src/activities/__tests__/call-function.test.ts +47 -0
  589. package/src/activities/__tests__/call-grpc.test.ts +39 -0
  590. package/src/activities/__tests__/call-http.test.ts +288 -0
  591. package/src/activities/__tests__/call-llm.test.ts +301 -0
  592. package/src/activities/__tests__/classify-tool-approvals.test.ts +430 -0
  593. package/src/activities/__tests__/discover-mcp-server.test.ts +641 -0
  594. package/src/activities/__tests__/ensure-thread.test.ts +96 -0
  595. package/src/activities/__tests__/error-classifier.test.ts +372 -0
  596. package/src/activities/__tests__/evaluate-expressions.test.ts +114 -0
  597. package/src/activities/__tests__/hydrate-workflow-execution.test.ts +321 -0
  598. package/src/activities/__tests__/notification.test.ts +151 -0
  599. package/src/activities/__tests__/workflow-event-activities.test.ts +664 -0
  600. package/src/activities/call-agent-status.ts +130 -0
  601. package/src/activities/call-agent.ts +302 -0
  602. package/src/activities/call-eval.ts +333 -0
  603. package/src/activities/call-function.ts +73 -0
  604. package/src/activities/call-grpc.ts +140 -0
  605. package/src/activities/call-http.ts +185 -0
  606. package/src/activities/call-llm.ts +379 -0
  607. package/src/activities/call-transform.ts +54 -0
  608. package/src/activities/call-validate.ts +223 -0
  609. package/src/activities/classify-tool-approvals.ts +319 -0
  610. package/src/activities/discover-mcp-server.ts +411 -0
  611. package/src/activities/emit-event.ts +195 -0
  612. package/src/activities/ensure-thread.ts +45 -0
  613. package/src/activities/evaluate-expressions.ts +47 -0
  614. package/src/activities/execute-cursor/__tests__/approval-gate.test.ts +188 -0
  615. package/src/activities/execute-cursor/__tests__/build-prompt.test.ts +111 -0
  616. package/src/activities/execute-cursor/__tests__/cursor-baseurl-routing.test.ts +86 -0
  617. package/src/activities/execute-cursor/__tests__/cursor-fetch-interceptor-bypass.test.ts +64 -0
  618. package/src/activities/execute-cursor/__tests__/cursor-mode.test.ts +95 -0
  619. package/src/activities/execute-cursor/__tests__/cursor-sdk-auth-smoke.test.ts +90 -0
  620. package/src/activities/execute-cursor/__tests__/delta-enricher.test.ts +242 -0
  621. package/src/activities/execute-cursor/__tests__/error-classifier-introspection.test.ts +156 -0
  622. package/src/activities/execute-cursor/__tests__/fetch-interceptor.test.ts +211 -0
  623. package/src/activities/execute-cursor/__tests__/hitl-ledger.test.ts +298 -0
  624. package/src/activities/execute-cursor/__tests__/http2-interceptor.test.ts +360 -0
  625. package/src/activities/execute-cursor/__tests__/message-translator.test.ts +657 -0
  626. package/src/activities/execute-cursor/__tests__/model-pricing.test.ts +92 -0
  627. package/src/activities/execute-cursor/__tests__/prompt-builder-delegation.test.ts +101 -0
  628. package/src/activities/execute-cursor/__tests__/runner-error-regressions.test.ts +144 -0
  629. package/src/activities/execute-cursor/__tests__/session-lifecycle.test.ts +65 -0
  630. package/src/activities/execute-cursor/__tests__/skill-resolver.test.ts +265 -0
  631. package/src/activities/execute-cursor/__tests__/subagent-config.test.ts +107 -0
  632. package/src/activities/execute-cursor/__tests__/todo-tracker.test.ts +498 -0
  633. package/src/activities/execute-cursor/__tests__/workspace-provision.test.ts +283 -0
  634. package/src/activities/execute-cursor/approval-policy.ts +224 -0
  635. package/src/activities/execute-cursor/approval-state.ts +311 -0
  636. package/src/activities/execute-cursor/attachment-resolver.ts +78 -0
  637. package/src/activities/execute-cursor/blueprint-resolver.ts +234 -0
  638. package/src/activities/execute-cursor/connect-backfill.ts +49 -0
  639. package/src/activities/execute-cursor/cursor-event-recorder.ts +83 -0
  640. package/src/activities/execute-cursor/cursor-mode.ts +42 -0
  641. package/src/activities/execute-cursor/delta-enricher.ts +307 -0
  642. package/src/activities/execute-cursor/env-resolver.ts +64 -0
  643. package/src/activities/execute-cursor/error-classifier.ts +247 -0
  644. package/src/activities/execute-cursor/fetch-interceptor.ts +382 -0
  645. package/src/activities/execute-cursor/hitl-diagnostics.ts +82 -0
  646. package/src/activities/execute-cursor/hook-script.ts +159 -0
  647. package/src/activities/execute-cursor/http2-interceptor.ts +253 -0
  648. package/src/activities/execute-cursor/index.ts +1439 -0
  649. package/src/activities/execute-cursor/mcp-config.ts +66 -0
  650. package/src/activities/execute-cursor/mcp-resolver.ts +271 -0
  651. package/src/activities/execute-cursor/message-translator.ts +896 -0
  652. package/src/activities/execute-cursor/model-pricing-data.ts +167 -0
  653. package/src/activities/execute-cursor/model-pricing.ts +167 -0
  654. package/src/activities/execute-cursor/placeholder-resolver.ts +109 -0
  655. package/src/activities/execute-cursor/prompt-builder.ts +349 -0
  656. package/src/activities/execute-cursor/rejection-capture.ts +100 -0
  657. package/src/activities/execute-cursor/session-lifecycle.ts +429 -0
  658. package/src/activities/execute-cursor/skill-resolver.ts +176 -0
  659. package/src/activities/execute-cursor/subagent-config.ts +62 -0
  660. package/src/activities/execute-cursor/todo-tracker.ts +133 -0
  661. package/src/activities/execute-cursor/usage-accumulator.ts +126 -0
  662. package/src/activities/execute-cursor/workspace-provision.ts +55 -0
  663. package/src/activities/execute-cursor/workspace-setup.ts +75 -0
  664. package/src/activities/execute-deep-agent/__test-utils__/v3-event-fixtures.ts +281 -0
  665. package/src/activities/execute-deep-agent/__tests__/attachment-injector.test.ts +720 -0
  666. package/src/activities/execute-deep-agent/__tests__/auto-publish.test.ts +146 -0
  667. package/src/activities/execute-deep-agent/__tests__/environment.test.ts +103 -0
  668. package/src/activities/execute-deep-agent/__tests__/event-recorder.test.ts +150 -0
  669. package/src/activities/execute-deep-agent/__tests__/execution-state-extended.test.ts +150 -0
  670. package/src/activities/execute-deep-agent/__tests__/execution-state.test.ts +157 -0
  671. package/src/activities/execute-deep-agent/__tests__/hitl-integration.test.ts +223 -0
  672. package/src/activities/execute-deep-agent/__tests__/hitl.test.ts +244 -0
  673. package/src/activities/execute-deep-agent/__tests__/index.test.ts +91 -0
  674. package/src/activities/execute-deep-agent/__tests__/inline-publisher.test.ts +240 -0
  675. package/src/activities/execute-deep-agent/__tests__/post-stream.test.ts +112 -0
  676. package/src/activities/execute-deep-agent/__tests__/prompt-builder.test.ts +208 -0
  677. package/src/activities/execute-deep-agent/__tests__/status-builder.test.ts +1771 -0
  678. package/src/activities/execute-deep-agent/__tests__/streaming-scheduler.test.ts +199 -0
  679. package/src/activities/execute-deep-agent/__tests__/streaming-v3.test.ts +527 -0
  680. package/src/activities/execute-deep-agent/__tests__/streaming.test.ts +508 -0
  681. package/src/activities/execute-deep-agent/__tests__/subagent-tracker.test.ts +474 -0
  682. package/src/activities/execute-deep-agent/__tests__/subagent-transformer.test.ts +734 -0
  683. package/src/activities/execute-deep-agent/__tests__/subagent-wiring.test.ts +71 -0
  684. package/src/activities/execute-deep-agent/__tests__/summarization-verification.test.ts +323 -0
  685. package/src/activities/execute-deep-agent/__tests__/v3-event-recorder.test.ts +186 -0
  686. package/src/activities/execute-deep-agent/__tests__/v3-protocol-normalizer.test.ts +324 -0
  687. package/src/activities/execute-deep-agent/__tests__/v3-status-builder.test.ts +504 -0
  688. package/src/activities/execute-deep-agent/__tests__/writeback-coordinator.test.ts +399 -0
  689. package/src/activities/execute-deep-agent/attachment-injector.ts +470 -0
  690. package/src/activities/execute-deep-agent/auto-publish.ts +80 -0
  691. package/src/activities/execute-deep-agent/environment.ts +67 -0
  692. package/src/activities/execute-deep-agent/event-recorder.ts +95 -0
  693. package/src/activities/execute-deep-agent/execution-state.ts +87 -0
  694. package/src/activities/execute-deep-agent/execution-status-writer.ts +19 -0
  695. package/src/activities/execute-deep-agent/hitl.ts +221 -0
  696. package/src/activities/execute-deep-agent/index.ts +342 -0
  697. package/src/activities/execute-deep-agent/inline-publisher.ts +134 -0
  698. package/src/activities/execute-deep-agent/post-stream.ts +109 -0
  699. package/src/activities/execute-deep-agent/prompt-builder.ts +264 -0
  700. package/src/activities/execute-deep-agent/setup.ts +599 -0
  701. package/src/activities/execute-deep-agent/status-builder-shared.ts +136 -0
  702. package/src/activities/execute-deep-agent/status-builder.ts +412 -0
  703. package/src/activities/execute-deep-agent/streaming-scheduler.ts +159 -0
  704. package/src/activities/execute-deep-agent/streaming-side-effects.ts +89 -0
  705. package/src/activities/execute-deep-agent/streaming-terminal.ts +96 -0
  706. package/src/activities/execute-deep-agent/streaming-v3.ts +272 -0
  707. package/src/activities/execute-deep-agent/streaming.ts +303 -0
  708. package/src/activities/execute-deep-agent/subagent-tracker.ts +445 -0
  709. package/src/activities/execute-deep-agent/subagent-transformer.ts +648 -0
  710. package/src/activities/execute-deep-agent/subagent-wiring.ts +56 -0
  711. package/src/activities/execute-deep-agent/v3-event-recorder.ts +111 -0
  712. package/src/activities/execute-deep-agent/v3-events.ts +153 -0
  713. package/src/activities/execute-deep-agent/v3-protocol-normalizer.ts +264 -0
  714. package/src/activities/execute-deep-agent/v3-status-builder.ts +490 -0
  715. package/src/activities/execute-deep-agent/writeback-coordinator.ts +420 -0
  716. package/src/activities/hydrate-workflow-execution.ts +306 -0
  717. package/src/activities/notification.ts +71 -0
  718. package/src/activities/promote-task-output.ts +126 -0
  719. package/src/activities/run-command.ts +148 -0
  720. package/src/activities/workflow-event-activities.ts +481 -0
  721. package/src/bootstrap.ts +173 -0
  722. package/src/budget/__tests__/tracker.test.ts +293 -0
  723. package/src/budget/index.ts +9 -0
  724. package/src/budget/tracker.ts +171 -0
  725. package/src/claimcheck/compressor.ts +9 -0
  726. package/src/claimcheck/config.ts +20 -0
  727. package/src/claimcheck/index.ts +3 -0
  728. package/src/claimcheck/payload-codec.ts +107 -0
  729. package/src/client/__tests__/server-contracts.test.ts +149 -0
  730. package/src/client/__tests__/stigmer-client.test.ts +142 -0
  731. package/src/client/server-contracts.ts +125 -0
  732. package/src/client/stigmer-client.ts +339 -0
  733. package/src/config.ts +185 -0
  734. package/src/idle-watchdog.ts +28 -0
  735. package/src/index.ts +48 -0
  736. package/src/interceptors/workflow-metrics-sink.ts +56 -0
  737. package/src/ipc-protocol-fixtures.ts +117 -0
  738. package/src/ipc-protocol.ts +113 -0
  739. package/src/main.ts +324 -0
  740. package/src/middleware/__tests__/approval-gate.test.ts +231 -0
  741. package/src/middleware/__tests__/cost-cap.test.ts +192 -0
  742. package/src/middleware/__tests__/error-hints.test.ts +90 -0
  743. package/src/middleware/__tests__/execution-budget.test.ts +138 -0
  744. package/src/middleware/__tests__/graceful-stop.test.ts +105 -0
  745. package/src/middleware/__tests__/loop-detection.test.ts +137 -0
  746. package/src/middleware/__tests__/otel-spans.test.ts +89 -0
  747. package/src/middleware/__tests__/think-tool.test.ts +26 -0
  748. package/src/middleware/__tests__/tool-truncation.test.ts +112 -0
  749. package/src/middleware/approval-gate.ts +179 -0
  750. package/src/middleware/cost-cap.ts +213 -0
  751. package/src/middleware/error-hints.ts +136 -0
  752. package/src/middleware/execution-budget.ts +176 -0
  753. package/src/middleware/graceful-stop.ts +86 -0
  754. package/src/middleware/index.ts +70 -0
  755. package/src/middleware/loop-detection.ts +192 -0
  756. package/src/middleware/otel-spans.ts +205 -0
  757. package/src/middleware/think-tool.ts +38 -0
  758. package/src/middleware/tool-truncation.ts +94 -0
  759. package/src/middleware/types.ts +114 -0
  760. package/src/notification/__tests__/provider.test.ts +85 -0
  761. package/src/notification/__tests__/webhook.test.ts +127 -0
  762. package/src/notification/index.ts +15 -0
  763. package/src/notification/provider.ts +52 -0
  764. package/src/notification/webhook.ts +61 -0
  765. package/src/otel-metrics.ts +73 -0
  766. package/src/otel.ts +194 -0
  767. package/src/runner-manager.ts +652 -0
  768. package/src/runner-token-coordinator.ts +135 -0
  769. package/src/runner.ts +380 -0
  770. package/src/shared/__tests__/approval-policy.test.ts +256 -0
  771. package/src/shared/__tests__/artifact-storage-extended.test.ts +208 -0
  772. package/src/shared/__tests__/artifact-storage.test.ts +365 -0
  773. package/src/shared/__tests__/connect-backfill.test.ts +346 -0
  774. package/src/shared/__tests__/extract-json.test.ts +153 -0
  775. package/src/shared/__tests__/grpc-retry-extended.test.ts +176 -0
  776. package/src/shared/__tests__/grpc-retry.test.ts +172 -0
  777. package/src/shared/__tests__/json-schema-to-zod.test.ts +227 -0
  778. package/src/shared/__tests__/llm-proxy.test.ts +179 -0
  779. package/src/shared/__tests__/mcp-manager.test.ts +154 -0
  780. package/src/shared/__tests__/model-pricing.test.ts +85 -0
  781. package/src/shared/__tests__/model-registry.test.ts +197 -0
  782. package/src/shared/__tests__/placeholder-resolver.test.ts +210 -0
  783. package/src/shared/__tests__/plan-artifact.test.ts +142 -0
  784. package/src/shared/__tests__/skill-relevance.test.ts +292 -0
  785. package/src/shared/__tests__/skill-writer.test.ts +349 -0
  786. package/src/shared/__tests__/status.test.ts +142 -0
  787. package/src/shared/__tests__/subagent-gate.test.ts +112 -0
  788. package/src/shared/__tests__/tool-kind.test.ts +58 -0
  789. package/src/shared/__tests__/zip-extract.test.ts +204 -0
  790. package/src/shared/approval-policy.ts +146 -0
  791. package/src/shared/artifact-storage.ts +207 -0
  792. package/src/shared/checkpointer/__tests__/factory.test.ts +42 -0
  793. package/src/shared/checkpointer/__tests__/http-saver.test.ts +176 -0
  794. package/src/shared/checkpointer/factory.ts +73 -0
  795. package/src/shared/checkpointer/http-saver.ts +349 -0
  796. package/src/shared/checkpointer/types.ts +12 -0
  797. package/src/shared/connect-backfill.ts +162 -0
  798. package/src/shared/extract-json.ts +153 -0
  799. package/src/shared/grpc-retry.ts +113 -0
  800. package/src/shared/heartbeat.ts +70 -0
  801. package/src/shared/json-schema-to-zod.ts +53 -0
  802. package/src/shared/llm-proxy.ts +138 -0
  803. package/src/shared/mcp-manager.ts +150 -0
  804. package/src/shared/mcp-resolver.ts +150 -0
  805. package/src/shared/model-pricing-data.ts +109 -0
  806. package/src/shared/model-pricing.ts +81 -0
  807. package/src/shared/model-registry.ts +214 -0
  808. package/src/shared/placeholder-resolver.ts +102 -0
  809. package/src/shared/plan-artifact.ts +120 -0
  810. package/src/shared/skill-relevance.ts +222 -0
  811. package/src/shared/skill-writer.ts +300 -0
  812. package/src/shared/status.ts +94 -0
  813. package/src/shared/subagent-gate.ts +117 -0
  814. package/src/shared/tool-kind.ts +91 -0
  815. package/src/shared/workspace/__tests__/file-tree.test.ts +210 -0
  816. package/src/shared/workspace/__tests__/git-source.test.ts +423 -0
  817. package/src/shared/workspace/__tests__/local-backend-platform.test.ts +259 -0
  818. package/src/shared/workspace/__tests__/local-backend.test.ts +154 -0
  819. package/src/shared/workspace/__tests__/platform-mount.test.ts +378 -0
  820. package/src/shared/workspace/__tests__/provisioner.test.ts +145 -0
  821. package/src/shared/workspace/file-tree.ts +116 -0
  822. package/src/shared/workspace/local-backend.ts +140 -0
  823. package/src/shared/workspace/platform-dir.ts +38 -0
  824. package/src/shared/workspace/platform-mount.ts +190 -0
  825. package/src/shared/workspace/provisioner.ts +150 -0
  826. package/src/shared/workspace/sources/empty.ts +20 -0
  827. package/src/shared/workspace/sources/git.ts +285 -0
  828. package/src/shared/workspace/sources/local-path.ts +89 -0
  829. package/src/shared/workspace/types.ts +69 -0
  830. package/src/shared/zip-extract.ts +193 -0
  831. package/src/worker.ts +98 -0
  832. package/src/workflow-engine/__tests__/do-executor-recovery.test.ts +382 -0
  833. package/src/workflow-engine/__tests__/do-executor.test.ts +963 -0
  834. package/src/workflow-engine/__tests__/errors.test.ts +174 -0
  835. package/src/workflow-engine/__tests__/expression.test.ts +776 -0
  836. package/src/workflow-engine/__tests__/for.test.ts +575 -0
  837. package/src/workflow-engine/__tests__/fork.test.ts +838 -0
  838. package/src/workflow-engine/__tests__/golden-execution.test.ts +1085 -0
  839. package/src/workflow-engine/__tests__/jq-wasm-spike.test.ts +90 -0
  840. package/src/workflow-engine/__tests__/loader.test.ts +1393 -0
  841. package/src/workflow-engine/__tests__/pause-resume.test.ts +267 -0
  842. package/src/workflow-engine/__tests__/recovery.test.ts +115 -0
  843. package/src/workflow-engine/__tests__/resolve.test.ts +432 -0
  844. package/src/workflow-engine/__tests__/retry.test.ts +306 -0
  845. package/src/workflow-engine/__tests__/state.test.ts +174 -0
  846. package/src/workflow-engine/__tests__/task-status-accumulator.test.ts +373 -0
  847. package/src/workflow-engine/__tests__/tasks/call-agent-output.test.ts +120 -0
  848. package/src/workflow-engine/__tests__/tasks/call-agent.test.ts +816 -0
  849. package/src/workflow-engine/__tests__/tasks/call-function.test.ts +205 -0
  850. package/src/workflow-engine/__tests__/tasks/call-grpc.test.ts +133 -0
  851. package/src/workflow-engine/__tests__/tasks/call-http.test.ts +150 -0
  852. package/src/workflow-engine/__tests__/tasks/emit-event.test.ts +322 -0
  853. package/src/workflow-engine/__tests__/tasks/human-input.test.ts +416 -0
  854. package/src/workflow-engine/__tests__/tasks/listen.test.ts +422 -0
  855. package/src/workflow-engine/__tests__/tasks/raise.test.ts +166 -0
  856. package/src/workflow-engine/__tests__/tasks/run.test.ts +272 -0
  857. package/src/workflow-engine/__tests__/tasks/set.test.ts +127 -0
  858. package/src/workflow-engine/__tests__/tasks/switch.test.ts +277 -0
  859. package/src/workflow-engine/__tests__/tasks/try.test.ts +590 -0
  860. package/src/workflow-engine/__tests__/tasks/wait.test.ts +173 -0
  861. package/src/workflow-engine/clone.ts +18 -0
  862. package/src/workflow-engine/do-executor.ts +569 -0
  863. package/src/workflow-engine/duration.ts +22 -0
  864. package/src/workflow-engine/error-utils.ts +97 -0
  865. package/src/workflow-engine/errors.ts +130 -0
  866. package/src/workflow-engine/expression-utils.ts +129 -0
  867. package/src/workflow-engine/expression.ts +430 -0
  868. package/src/workflow-engine/loader.ts +524 -0
  869. package/src/workflow-engine/recovery.ts +80 -0
  870. package/src/workflow-engine/resolve.ts +342 -0
  871. package/src/workflow-engine/retry.ts +109 -0
  872. package/src/workflow-engine/state.ts +56 -0
  873. package/src/workflow-engine/task-factory.ts +160 -0
  874. package/src/workflow-engine/task-status-accumulator.ts +204 -0
  875. package/src/workflow-engine/tasks/call-agent-output.ts +132 -0
  876. package/src/workflow-engine/tasks/call-agent.ts +221 -0
  877. package/src/workflow-engine/tasks/call-function.ts +107 -0
  878. package/src/workflow-engine/tasks/call-grpc.ts +47 -0
  879. package/src/workflow-engine/tasks/call-http.ts +51 -0
  880. package/src/workflow-engine/tasks/for.ts +244 -0
  881. package/src/workflow-engine/tasks/fork.ts +228 -0
  882. package/src/workflow-engine/tasks/human-input.ts +147 -0
  883. package/src/workflow-engine/tasks/listen.ts +166 -0
  884. package/src/workflow-engine/tasks/raise.ts +81 -0
  885. package/src/workflow-engine/tasks/run.ts +142 -0
  886. package/src/workflow-engine/tasks/set.ts +47 -0
  887. package/src/workflow-engine/tasks/switch.ts +102 -0
  888. package/src/workflow-engine/tasks/try.ts +274 -0
  889. package/src/workflow-engine/tasks/wait.ts +53 -0
  890. package/src/workflow-engine/types.ts +911 -0
  891. package/src/workflows/__tests__/connect-mcp-server.test.ts +359 -0
  892. package/src/workflows/__tests__/execute-serverless-workflow.test.ts +277 -0
  893. package/src/workflows/call-agent-orchestrator.ts +283 -0
  894. package/src/workflows/connect-mcp-server.ts +152 -0
  895. package/src/workflows/engine-core.ts +406 -0
  896. package/src/workflows/execute-from-execution.ts +101 -0
  897. package/src/workflows/execute-serverless-workflow.ts +60 -0
  898. package/src/workflows/human-input-orchestrator.ts +76 -0
  899. package/src/workflows/index.ts +32 -0
  900. package/src/workflows/listen-orchestrator.ts +200 -0
  901. package/src/workflows/metrics-sink.ts +48 -0
  902. package/src/workflows/run-orchestrator.ts +34 -0
  903. package/src/workflows/types.ts +64 -0
  904. package/src/workflows/workflow-signals.ts +55 -0
@@ -0,0 +1,838 @@
1
+ import { describe, it, expect } from "vitest";
2
+ import { executeForkTask } from "../tasks/fork.js";
3
+ import { executeDoTasks } from "../do-executor.js";
4
+ import { createState } from "../state.js";
5
+ import { evaluateExpressionBatch } from "../expression.js";
6
+ import type { TaskList, WorkflowModel, ForkTaskDef, TaskEntry } from "../types.js";
7
+
8
+ const doc: WorkflowModel = {
9
+ document: { dsl: "1.0.0", name: "fork-test-workflow" },
10
+ do: [],
11
+ };
12
+
13
+ function forkTask(
14
+ name: string,
15
+ taskDef: Omit<ForkTaskDef, "kind">,
16
+ ): TaskEntry {
17
+ return { key: name, task: { kind: "fork", ...taskDef } as ForkTaskDef };
18
+ }
19
+
20
+ // ─────────────────────────────────────────────────────────────────────
21
+ // Non-Compete Mode (default)
22
+ // ─────────────────────────────────────────────────────────────────────
23
+
24
+ describe("fork task execution", () => {
25
+ describe("non-compete: all branches", () => {
26
+ it("executes two branches in parallel — output keyed by branch name", async () => {
27
+ const tasks: TaskList = [
28
+ forkTask("parallel", {
29
+ fork: {
30
+ branches: [
31
+ { key: "branchA", task: { kind: "do", do: [
32
+ { key: "setA", task: { kind: "set", set: { result: "from-A" } } },
33
+ ]}},
34
+ { key: "branchB", task: { kind: "do", do: [
35
+ { key: "setB", task: { kind: "set", set: { result: "from-B" } } },
36
+ ]}},
37
+ ],
38
+ },
39
+ }),
40
+ ];
41
+
42
+ const state = createState();
43
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
44
+
45
+ expect(state.output).toEqual({
46
+ branchA: { result: "from-A" },
47
+ branchB: { result: "from-B" },
48
+ });
49
+ });
50
+
51
+ it("executes three branches — all contribute to output", async () => {
52
+ const tasks: TaskList = [
53
+ forkTask("parallel", {
54
+ fork: {
55
+ branches: [
56
+ { key: "alpha", task: { kind: "do", do: [
57
+ { key: "s1", task: { kind: "set", set: { value: 1 } } },
58
+ ]}},
59
+ { key: "beta", task: { kind: "do", do: [
60
+ { key: "s2", task: { kind: "set", set: { value: 2 } } },
61
+ ]}},
62
+ { key: "gamma", task: { kind: "do", do: [
63
+ { key: "s3", task: { kind: "set", set: { value: 3 } } },
64
+ ]}},
65
+ ],
66
+ },
67
+ }),
68
+ ];
69
+
70
+ const state = createState();
71
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
72
+
73
+ expect(state.output).toEqual({
74
+ alpha: { value: 1 },
75
+ beta: { value: 2 },
76
+ gamma: { value: 3 },
77
+ });
78
+ });
79
+
80
+ it("handles single branch", async () => {
81
+ const tasks: TaskList = [
82
+ forkTask("solo", {
83
+ fork: {
84
+ branches: [
85
+ { key: "only", task: { kind: "do", do: [
86
+ { key: "set", task: { kind: "set", set: { alone: true } } },
87
+ ]}},
88
+ ],
89
+ },
90
+ }),
91
+ ];
92
+
93
+ const state = createState();
94
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
95
+
96
+ expect(state.output).toEqual({ only: { alone: true } });
97
+ });
98
+
99
+ it("branches with multiple sequential tasks", async () => {
100
+ const tasks: TaskList = [
101
+ forkTask("parallel", {
102
+ fork: {
103
+ branches: [
104
+ { key: "branch", task: { kind: "do", do: [
105
+ { key: "step1", task: { kind: "set", set: { first: true } } },
106
+ { key: "step2", task: { kind: "set", set: { second: true } } },
107
+ { key: "step3", task: { kind: "set", set: { third: true } } },
108
+ ]}},
109
+ ],
110
+ },
111
+ }),
112
+ ];
113
+
114
+ const state = createState();
115
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
116
+
117
+ expect(state.output).toEqual({
118
+ branch: { third: true },
119
+ });
120
+ });
121
+
122
+ it("branch output is the last task output of that branch", async () => {
123
+ const tasks: TaskList = [
124
+ forkTask("parallel", {
125
+ fork: {
126
+ branches: [
127
+ { key: "a", task: { kind: "do", do: [
128
+ { key: "s1", task: { kind: "set", set: { x: 10 } } },
129
+ { key: "s2", task: { kind: "set", set: { y: 20 } } },
130
+ ]}},
131
+ { key: "b", task: { kind: "do", do: [
132
+ { key: "s1", task: { kind: "set", set: { z: 30 } } },
133
+ ]}},
134
+ ],
135
+ },
136
+ }),
137
+ ];
138
+
139
+ const state = createState();
140
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
141
+
142
+ expect(state.output).toEqual({
143
+ a: { y: 20 },
144
+ b: { z: 30 },
145
+ });
146
+ });
147
+ });
148
+
149
+ // ─────────────────────────────────────────────────────────────────────
150
+ // State Isolation
151
+ // ─────────────────────────────────────────────────────────────────────
152
+
153
+ describe("state isolation", () => {
154
+ it("branches see the parent state snapshot but cannot mutate it", async () => {
155
+ const tasks: TaskList = [
156
+ { key: "setup", task: { kind: "set", set: { shared: "original" } } },
157
+ forkTask("parallel", {
158
+ fork: {
159
+ branches: [
160
+ { key: "a", task: { kind: "do", do: [
161
+ { key: "mutate", task: { kind: "set", set: { shared: "mutated-by-a" } } },
162
+ ]}},
163
+ { key: "b", task: { kind: "do", do: [
164
+ { key: "read", task: { kind: "set", set: { saw: "${ $data.shared }" } } },
165
+ ]}},
166
+ ],
167
+ },
168
+ }),
169
+ { key: "verify", task: { kind: "set", set: { final: "${ $data.shared }" } } },
170
+ ];
171
+
172
+ const state = createState();
173
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
174
+
175
+ expect(state.data.final).toBe("original");
176
+ });
177
+
178
+ it("branches do not see each other's mutations", async () => {
179
+ const tasks: TaskList = [
180
+ forkTask("parallel", {
181
+ fork: {
182
+ branches: [
183
+ { key: "writer", task: { kind: "do", do: [
184
+ { key: "write", task: { kind: "set", set: { secret: "hidden" } } },
185
+ ]}},
186
+ { key: "reader", task: { kind: "do", do: [
187
+ { key: "read", task: { kind: "set", set: { found: "${ $data.secret // \"not-found\" }" } } },
188
+ ]}},
189
+ ],
190
+ },
191
+ }),
192
+ ];
193
+
194
+ const state = createState();
195
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
196
+
197
+ const output = state.output as Record<string, unknown>;
198
+ expect(output.reader).toEqual({ found: "not-found" });
199
+ });
200
+
201
+ it("each branch starts with cleared output", async () => {
202
+ const tasks: TaskList = [
203
+ { key: "prior", task: { kind: "set", set: { priorResult: "exists" } } },
204
+ forkTask("parallel", {
205
+ fork: {
206
+ branches: [
207
+ { key: "check", task: { kind: "do", do: [
208
+ { key: "inspect", task: { kind: "set", set: { sawOutput: "${ $output // \"null\" }" } } },
209
+ ]}},
210
+ ],
211
+ },
212
+ }),
213
+ ];
214
+
215
+ const state = createState();
216
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
217
+
218
+ const output = state.output as Record<string, unknown>;
219
+ expect(output.check).toEqual({ sawOutput: "null" });
220
+ });
221
+
222
+ it("parent context is visible to branches", async () => {
223
+ const tasks: TaskList = [
224
+ {
225
+ key: "init",
226
+ task: {
227
+ kind: "set",
228
+ set: { config: "production" },
229
+ export: { as: "${ . }" },
230
+ },
231
+ },
232
+ forkTask("parallel", {
233
+ fork: {
234
+ branches: [
235
+ { key: "a", task: { kind: "do", do: [
236
+ { key: "read", task: { kind: "set", set: { env: "${ $context.init.config }" } } },
237
+ ]}},
238
+ ],
239
+ },
240
+ }),
241
+ ];
242
+
243
+ const state = createState();
244
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
245
+
246
+ const output = state.output as Record<string, unknown>;
247
+ expect(output.a).toEqual({ env: "production" });
248
+ });
249
+
250
+ it("parent env is visible to branches", async () => {
251
+ const state = createState();
252
+ state.env = { API_KEY: "test-key" };
253
+
254
+ const forkDef: ForkTaskDef = {
255
+ kind: "fork",
256
+ fork: {
257
+ branches: [
258
+ { key: "a", task: { kind: "do", do: [
259
+ { key: "read", task: { kind: "set", set: { key: "${ $env.API_KEY }" } } },
260
+ ]}},
261
+ ],
262
+ },
263
+ };
264
+
265
+ const result = await executeForkTask(
266
+ forkDef, null, state, doc, evaluateExpressionBatch,
267
+ );
268
+
269
+ expect(result).toEqual({ a: { key: "test-key" } });
270
+ });
271
+ });
272
+
273
+ // ─────────────────────────────────────────────────────────────────────
274
+ // Error Handling
275
+ // ─────────────────────────────────────────────────────────────────────
276
+
277
+ describe("error handling", () => {
278
+ it("throws when branches array is empty", async () => {
279
+ const forkDef: ForkTaskDef = {
280
+ kind: "fork",
281
+ fork: { branches: [] },
282
+ };
283
+
284
+ const state = createState();
285
+ await expect(
286
+ executeForkTask(forkDef, null, state, doc, evaluateExpressionBatch),
287
+ ).rejects.toThrow("at least one branch");
288
+ });
289
+
290
+ it("non-compete: error in one branch fails the entire fork", async () => {
291
+ const tasks: TaskList = [
292
+ forkTask("parallel", {
293
+ fork: {
294
+ branches: [
295
+ { key: "good", task: { kind: "do", do: [
296
+ { key: "ok", task: { kind: "set", set: { fine: true } } },
297
+ ]}},
298
+ { key: "bad", task: { kind: "do", do: [
299
+ { key: "fail", task: {
300
+ kind: "raise",
301
+ raise: { error: { type: "test/error", status: 500, title: "Branch failed" } },
302
+ }},
303
+ ]}},
304
+ ],
305
+ },
306
+ }),
307
+ ];
308
+
309
+ const state = createState();
310
+ await expect(
311
+ executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch),
312
+ ).rejects.toThrow();
313
+ });
314
+
315
+ it("non-compete: parent state is not corrupted after branch error", async () => {
316
+ const state = createState();
317
+ state.addData({ marker: "before" });
318
+
319
+ const forkDef: ForkTaskDef = {
320
+ kind: "fork",
321
+ fork: {
322
+ branches: [
323
+ { key: "fail", task: { kind: "do", do: [
324
+ { key: "boom", task: {
325
+ kind: "raise",
326
+ raise: { error: { type: "test/error", status: 500 } },
327
+ }},
328
+ ]}},
329
+ ],
330
+ },
331
+ };
332
+
333
+ await expect(
334
+ executeForkTask(forkDef, null, state, doc, evaluateExpressionBatch),
335
+ ).rejects.toThrow();
336
+
337
+ expect(state.data.marker).toBe("before");
338
+ });
339
+
340
+ it("fork inside try/catch — error is catchable", async () => {
341
+ const tasks: TaskList = [
342
+ {
343
+ key: "tryCatch",
344
+ task: {
345
+ kind: "try",
346
+ try: [
347
+ forkTask("parallel", {
348
+ fork: {
349
+ branches: [
350
+ { key: "fail", task: { kind: "do", do: [
351
+ { key: "boom", task: {
352
+ kind: "raise",
353
+ raise: { error: { type: "fork/error", status: 503, title: "Service down" } },
354
+ }},
355
+ ]}},
356
+ ],
357
+ },
358
+ }),
359
+ ],
360
+ catch: {
361
+ as: "caught",
362
+ do: [
363
+ { key: "handle", task: { kind: "set", set: { recovered: true } } },
364
+ ],
365
+ },
366
+ },
367
+ },
368
+ ];
369
+
370
+ const state = createState();
371
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
372
+
373
+ expect(state.data.recovered).toBe(true);
374
+ const caught = state.data.caught as Record<string, unknown>;
375
+ expect(caught.type).toBe("fork/error");
376
+ });
377
+ });
378
+
379
+ // ─────────────────────────────────────────────────────────────────────
380
+ // Compete Mode (Race)
381
+ // ─────────────────────────────────────────────────────────────────────
382
+
383
+ describe("compete mode", () => {
384
+ it("returns the winning branch output directly (not keyed by name)", async () => {
385
+ const forkDef: ForkTaskDef = {
386
+ kind: "fork",
387
+ fork: {
388
+ compete: true,
389
+ branches: [
390
+ { key: "fast", task: { kind: "do", do: [
391
+ { key: "result", task: { kind: "set", set: { winner: true } } },
392
+ ]}},
393
+ { key: "slow", task: { kind: "do", do: [
394
+ { key: "result", task: { kind: "set", set: { winner: false } } },
395
+ ]}},
396
+ ],
397
+ },
398
+ };
399
+
400
+ const state = createState();
401
+ const result = await executeForkTask(
402
+ forkDef, null, state, doc, evaluateExpressionBatch,
403
+ );
404
+
405
+ // Both branches are synchronous set tasks, so either could win.
406
+ // The output should be a raw branch result, NOT { fast: ..., slow: ... }
407
+ expect(result).toHaveProperty("winner");
408
+ expect(typeof (result as Record<string, unknown>).winner).toBe("boolean");
409
+ });
410
+
411
+ it("compete output is not wrapped in branch name", async () => {
412
+ const forkDef: ForkTaskDef = {
413
+ kind: "fork",
414
+ fork: {
415
+ compete: true,
416
+ branches: [
417
+ { key: "only", task: { kind: "do", do: [
418
+ { key: "result", task: { kind: "set", set: { value: 42 } } },
419
+ ]}},
420
+ ],
421
+ },
422
+ };
423
+
424
+ const state = createState();
425
+ const result = await executeForkTask(
426
+ forkDef, null, state, doc, evaluateExpressionBatch,
427
+ );
428
+
429
+ expect(result).toEqual({ value: 42 });
430
+ });
431
+
432
+ it("compete: error in any branch fails the fork", async () => {
433
+ const forkDef: ForkTaskDef = {
434
+ kind: "fork",
435
+ fork: {
436
+ compete: true,
437
+ branches: [
438
+ { key: "fail", task: { kind: "do", do: [
439
+ { key: "boom", task: {
440
+ kind: "raise",
441
+ raise: { error: { type: "test/error", status: 500 } },
442
+ }},
443
+ ]}},
444
+ { key: "ok", task: { kind: "do", do: [
445
+ { key: "set", task: { kind: "set", set: { fine: true } } },
446
+ ]}},
447
+ ],
448
+ },
449
+ };
450
+
451
+ const state = createState();
452
+ // The race semantics mean either the error or the success could win.
453
+ // With synchronous set tasks, both resolve ~simultaneously.
454
+ // We verify the function doesn't hang or throw unhandled rejection.
455
+ try {
456
+ await executeForkTask(
457
+ forkDef, null, state, doc, evaluateExpressionBatch,
458
+ );
459
+ } catch {
460
+ // Error from the failing branch is acceptable
461
+ }
462
+ });
463
+
464
+ it("compete with compete: false falls back to non-compete", async () => {
465
+ const forkDef: ForkTaskDef = {
466
+ kind: "fork",
467
+ fork: {
468
+ compete: false,
469
+ branches: [
470
+ { key: "a", task: { kind: "do", do: [
471
+ { key: "s", task: { kind: "set", set: { x: 1 } } },
472
+ ]}},
473
+ { key: "b", task: { kind: "do", do: [
474
+ { key: "s", task: { kind: "set", set: { y: 2 } } },
475
+ ]}},
476
+ ],
477
+ },
478
+ };
479
+
480
+ const state = createState();
481
+ const result = await executeForkTask(
482
+ forkDef, null, state, doc, evaluateExpressionBatch,
483
+ );
484
+
485
+ expect(result).toEqual({
486
+ a: { x: 1 },
487
+ b: { y: 2 },
488
+ });
489
+ });
490
+ });
491
+
492
+ // ─────────────────────────────────────────────────────────────────────
493
+ // Branch Normalization
494
+ // ─────────────────────────────────────────────────────────────────────
495
+
496
+ describe("branch normalization", () => {
497
+ it("wraps a single leaf task (non-do) into a task list", async () => {
498
+ const forkDef: ForkTaskDef = {
499
+ kind: "fork",
500
+ fork: {
501
+ branches: [
502
+ { key: "leaf", task: { kind: "set", set: { direct: true } } },
503
+ ],
504
+ },
505
+ };
506
+
507
+ const state = createState();
508
+ const result = await executeForkTask(
509
+ forkDef, null, state, doc, evaluateExpressionBatch,
510
+ );
511
+
512
+ expect(result).toEqual({ leaf: { direct: true } });
513
+ });
514
+
515
+ it("unwraps a do branch into its task list", async () => {
516
+ const forkDef: ForkTaskDef = {
517
+ kind: "fork",
518
+ fork: {
519
+ branches: [
520
+ { key: "wrapped", task: { kind: "do", do: [
521
+ { key: "inner1", task: { kind: "set", set: { a: 1 } } },
522
+ { key: "inner2", task: { kind: "set", set: { b: 2 } } },
523
+ ]}},
524
+ ],
525
+ },
526
+ };
527
+
528
+ const state = createState();
529
+ const result = await executeForkTask(
530
+ forkDef, null, state, doc, evaluateExpressionBatch,
531
+ );
532
+
533
+ expect(result).toEqual({ wrapped: { b: 2 } });
534
+ });
535
+ });
536
+
537
+ // ─────────────────────────────────────────────────────────────────────
538
+ // Nested Orchestration
539
+ // ─────────────────────────────────────────────────────────────────────
540
+
541
+ describe("nested orchestration", () => {
542
+ it("fork inside for loop", async () => {
543
+ const tasks: TaskList = [
544
+ { key: "setup", task: { kind: "set", set: { items: [1, 2] } } },
545
+ {
546
+ key: "loop",
547
+ task: {
548
+ kind: "for",
549
+ for: { in: "${ $data.items }" },
550
+ do: [
551
+ forkTask("inner", {
552
+ fork: {
553
+ branches: [
554
+ { key: "a", task: { kind: "do", do: [
555
+ { key: "s", task: { kind: "set", set: { val: "${ $data.item }" } } },
556
+ ]}},
557
+ { key: "b", task: { kind: "do", do: [
558
+ { key: "s", task: { kind: "set", set: { doubled: "${ $data.item * 2 }" } } },
559
+ ]}},
560
+ ],
561
+ },
562
+ }),
563
+ ],
564
+ },
565
+ },
566
+ ];
567
+
568
+ const state = createState();
569
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
570
+
571
+ const results = state.output as Record<string, unknown>[];
572
+ expect(results).toHaveLength(2);
573
+ expect(results[0]).toEqual({ a: { val: 1 }, b: { doubled: 2 } });
574
+ expect(results[1]).toEqual({ a: { val: 2 }, b: { doubled: 4 } });
575
+ });
576
+
577
+ it("for loop inside fork branch", async () => {
578
+ const tasks: TaskList = [
579
+ { key: "setup", task: { kind: "set", set: { nums: [10, 20, 30] } } },
580
+ forkTask("parallel", {
581
+ fork: {
582
+ branches: [
583
+ { key: "looper", task: { kind: "do", do: [
584
+ {
585
+ key: "iterate",
586
+ task: {
587
+ kind: "for",
588
+ for: { in: "${ $data.nums }" },
589
+ do: [
590
+ { key: "capture", task: { kind: "set", set: { n: "${ $data.item }" } } },
591
+ ],
592
+ },
593
+ },
594
+ ]}},
595
+ { key: "static", task: { kind: "do", do: [
596
+ { key: "fixed", task: { kind: "set", set: { constant: true } } },
597
+ ]}},
598
+ ],
599
+ },
600
+ }),
601
+ ];
602
+
603
+ const state = createState();
604
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
605
+
606
+ const output = state.output as Record<string, unknown>;
607
+ expect(output.looper).toEqual([{ n: 10 }, { n: 20 }, { n: 30 }]);
608
+ expect(output.static).toEqual({ constant: true });
609
+ });
610
+
611
+ it("switch inside fork branch", async () => {
612
+ const tasks: TaskList = [
613
+ { key: "setup", task: { kind: "set", set: { mode: "fast" } } },
614
+ forkTask("parallel", {
615
+ fork: {
616
+ branches: [
617
+ { key: "decider", task: { kind: "do", do: [
618
+ {
619
+ key: "decide",
620
+ task: {
621
+ kind: "switch",
622
+ switch: [
623
+ { name: "fastPath", when: "${ $data.mode == \"fast\" }", then: "result" },
624
+ { name: "default", then: "end" },
625
+ ],
626
+ },
627
+ },
628
+ { key: "skipped", task: { kind: "set", set: { slow: true } } },
629
+ { key: "result", task: { kind: "set", set: { fast: true } } },
630
+ ]}},
631
+ ],
632
+ },
633
+ }),
634
+ ];
635
+
636
+ const state = createState();
637
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
638
+
639
+ const output = state.output as Record<string, unknown>;
640
+ expect(output.decider).toEqual({ fast: true });
641
+ });
642
+
643
+ it("nested fork (fork inside fork)", async () => {
644
+ const tasks: TaskList = [
645
+ forkTask("outer", {
646
+ fork: {
647
+ branches: [
648
+ { key: "left", task: { kind: "do", do: [
649
+ forkTask("innerLeft", {
650
+ fork: {
651
+ branches: [
652
+ { key: "ll", task: { kind: "do", do: [
653
+ { key: "s", task: { kind: "set", set: { pos: "left-left" } } },
654
+ ]}},
655
+ { key: "lr", task: { kind: "do", do: [
656
+ { key: "s", task: { kind: "set", set: { pos: "left-right" } } },
657
+ ]}},
658
+ ],
659
+ },
660
+ }),
661
+ ]}},
662
+ { key: "right", task: { kind: "do", do: [
663
+ { key: "s", task: { kind: "set", set: { pos: "right" } } },
664
+ ]}},
665
+ ],
666
+ },
667
+ }),
668
+ ];
669
+
670
+ const state = createState();
671
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
672
+
673
+ const output = state.output as Record<string, unknown>;
674
+ expect(output.left).toEqual({
675
+ ll: { pos: "left-left" },
676
+ lr: { pos: "left-right" },
677
+ });
678
+ expect(output.right).toEqual({ pos: "right" });
679
+ });
680
+ });
681
+
682
+ // ─────────────────────────────────────────────────────────────────────
683
+ // Output / Export Integration
684
+ // ─────────────────────────────────────────────────────────────────────
685
+
686
+ describe("output and export integration", () => {
687
+ it("output.as transforms the fork result", async () => {
688
+ const tasks: TaskList = [
689
+ {
690
+ key: "parallel",
691
+ task: {
692
+ kind: "fork",
693
+ fork: {
694
+ branches: [
695
+ { key: "a", task: { kind: "do", do: [
696
+ { key: "s", task: { kind: "set", set: { v: 1 } } },
697
+ ]}},
698
+ { key: "b", task: { kind: "do", do: [
699
+ { key: "s", task: { kind: "set", set: { v: 2 } } },
700
+ ]}},
701
+ ],
702
+ },
703
+ output: { as: "${ . | keys | length }" },
704
+ } as ForkTaskDef,
705
+ },
706
+ ];
707
+
708
+ const state = createState();
709
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
710
+
711
+ expect(state.output).toBe(2);
712
+ });
713
+
714
+ it("export.as stores fork result in context", async () => {
715
+ const tasks: TaskList = [
716
+ {
717
+ key: "parallel",
718
+ task: {
719
+ kind: "fork",
720
+ fork: {
721
+ branches: [
722
+ { key: "a", task: { kind: "do", do: [
723
+ { key: "s", task: { kind: "set", set: { x: 10 } } },
724
+ ]}},
725
+ { key: "b", task: { kind: "do", do: [
726
+ { key: "s", task: { kind: "set", set: { y: 20 } } },
727
+ ]}},
728
+ ],
729
+ },
730
+ export: { as: "${ . }" },
731
+ } as ForkTaskDef,
732
+ },
733
+ ];
734
+
735
+ const state = createState();
736
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
737
+
738
+ expect(state.context).toEqual({
739
+ parallel: { a: { x: 10 }, b: { y: 20 } },
740
+ });
741
+ });
742
+
743
+ it("downstream task accesses fork output via expression", async () => {
744
+ const tasks: TaskList = [
745
+ forkTask("parallel", {
746
+ fork: {
747
+ branches: [
748
+ { key: "branchA", task: { kind: "do", do: [
749
+ { key: "s", task: { kind: "set", set: { data: "alpha" } } },
750
+ ]}},
751
+ { key: "branchB", task: { kind: "do", do: [
752
+ { key: "s", task: { kind: "set", set: { data: "beta" } } },
753
+ ]}},
754
+ ],
755
+ },
756
+ }),
757
+ {
758
+ key: "aggregate",
759
+ task: {
760
+ kind: "set",
761
+ set: {
762
+ fromA: "${ $output.branchA.data }",
763
+ fromB: "${ $output.branchB.data }",
764
+ },
765
+ },
766
+ },
767
+ ];
768
+
769
+ const state = createState();
770
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
771
+
772
+ expect(state.output).toEqual({
773
+ fromA: "alpha",
774
+ fromB: "beta",
775
+ });
776
+ });
777
+ });
778
+
779
+ // ─────────────────────────────────────────────────────────────────────
780
+ // Input Propagation
781
+ // ─────────────────────────────────────────────────────────────────────
782
+
783
+ describe("input propagation", () => {
784
+ it("branches receive the workflow input", async () => {
785
+ const forkDef: ForkTaskDef = {
786
+ kind: "fork",
787
+ fork: {
788
+ branches: [
789
+ { key: "a", task: { kind: "do", do: [
790
+ { key: "read", task: { kind: "set", set: { got: "${ $input }" } } },
791
+ ]}},
792
+ ],
793
+ },
794
+ };
795
+
796
+ const state = createState();
797
+ state.input = { payload: "hello" };
798
+ const result = await executeForkTask(
799
+ forkDef, { payload: "hello" }, state, doc, evaluateExpressionBatch,
800
+ );
801
+
802
+ expect(result).toEqual({ a: { got: { payload: "hello" } } });
803
+ });
804
+ });
805
+
806
+ // ─────────────────────────────────────────────────────────────────────
807
+ // Conditional Fork (if guard)
808
+ // ─────────────────────────────────────────────────────────────────────
809
+
810
+ describe("conditional fork (if guard)", () => {
811
+ it("skips fork when if condition is false", async () => {
812
+ const tasks: TaskList = [
813
+ { key: "setup", task: { kind: "set", set: { skip: true } } },
814
+ {
815
+ key: "parallel",
816
+ task: {
817
+ kind: "fork",
818
+ if: "${ $data.skip == false }",
819
+ fork: {
820
+ branches: [
821
+ { key: "a", task: { kind: "do", do: [
822
+ { key: "s", task: { kind: "set", set: { ran: true } } },
823
+ ]}},
824
+ ],
825
+ },
826
+ } as ForkTaskDef,
827
+ },
828
+ { key: "after", task: { kind: "set", set: { completed: true } } },
829
+ ];
830
+
831
+ const state = createState();
832
+ await executeDoTasks(tasks, null, state, doc, evaluateExpressionBatch);
833
+
834
+ expect(state.data.completed).toBe(true);
835
+ expect(state.output).toEqual({ completed: true });
836
+ });
837
+ });
838
+ });