airaknit 1.1.2-rc.9

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 (440) hide show
  1. package/LICENSE +84 -0
  2. package/README.md +202 -0
  3. package/bin/airaknit +9 -0
  4. package/bin/airaknit-project +14 -0
  5. package/bin/kanna +9 -0
  6. package/dist/client/assets/CompactSummaryMessage-Yw0BDWEJ.js +1 -0
  7. package/dist/client/assets/ExitPlanModeMessage-DIdkQ4uF.js +1 -0
  8. package/dist/client/assets/LocalFilePreviewDialog-DQx2eiCc.js +3 -0
  9. package/dist/client/assets/LocalProjectsSection-C4xlWkgS.js +1 -0
  10. package/dist/client/assets/TextMessage-B5G39DEJ.js +1 -0
  11. package/dist/client/assets/UserMessage-CIkWk-0L.js +1 -0
  12. package/dist/client/assets/_basePickBy-CVrAFfnZ.js +1 -0
  13. package/dist/client/assets/_baseUniq-JL-aaF4P.js +1 -0
  14. package/dist/client/assets/arc-B07zg7ol.js +1 -0
  15. package/dist/client/assets/architecture-YZFGNWBL-PSLVJL3p.js +1 -0
  16. package/dist/client/assets/architectureDiagram-Q4EWVU46-DfWIF1G_.js +36 -0
  17. package/dist/client/assets/array-BGFCBI0e.js +1 -0
  18. package/dist/client/assets/blockDiagram-DXYQGD6D-CzwIeo_B.js +132 -0
  19. package/dist/client/assets/bundle-mjs-BDE2gWbQ.js +1 -0
  20. package/dist/client/assets/button-DO50qOGv.js +1 -0
  21. package/dist/client/assets/c4Diagram-AHTNJAMY-CR8DCQRE.js +10 -0
  22. package/dist/client/assets/channel-Dj-UUfaF.js +1 -0
  23. package/dist/client/assets/chunk-2KRD3SAO-dznP-cn8.js +1 -0
  24. package/dist/client/assets/chunk-336JU56O-Dqss5Vu6.js +2 -0
  25. package/dist/client/assets/chunk-426QAEUC-CEKis_0_.js +1 -0
  26. package/dist/client/assets/chunk-4BX2VUAB-BYOv0Gm1.js +1 -0
  27. package/dist/client/assets/chunk-4TB4RGXK-BxzubH5S.js +206 -0
  28. package/dist/client/assets/chunk-55IACEB6-BSlTj03a.js +1 -0
  29. package/dist/client/assets/chunk-5FUZZQ4R-9Au93Bi1.js +62 -0
  30. package/dist/client/assets/chunk-5PVQY5BW-BhksHFEZ.js +2 -0
  31. package/dist/client/assets/chunk-67CJDMHE-BFwhz-8t.js +1 -0
  32. package/dist/client/assets/chunk-7N4EOEYR-BDUPds87.js +1 -0
  33. package/dist/client/assets/chunk-AA7GKIK3-CEWTdyXO.js +1 -0
  34. package/dist/client/assets/chunk-BO2N2NFS-D0LvxnhU.js +103 -0
  35. package/dist/client/assets/chunk-BSJP7CBP-BNJnK6sq.js +1 -0
  36. package/dist/client/assets/chunk-Bj-mKKzh.js +1 -0
  37. package/dist/client/assets/chunk-CIAEETIT-CYhfoCeN.js +1 -0
  38. package/dist/client/assets/chunk-EDXVE4YY-C5ovJLc0.js +1 -0
  39. package/dist/client/assets/chunk-ENJZ2VHE-HOhYaeGr.js +10 -0
  40. package/dist/client/assets/chunk-FMBD7UC4-BLCiKcAQ.js +15 -0
  41. package/dist/client/assets/chunk-FOC6F5B3-B6GtY2ek.js +1 -0
  42. package/dist/client/assets/chunk-ICPOFSXX-DPoIZoC5.js +122 -0
  43. package/dist/client/assets/chunk-K5T4RW27-BsKN63rv.js +94 -0
  44. package/dist/client/assets/chunk-KGLVRYIC-BUGn9uuY.js +1 -0
  45. package/dist/client/assets/chunk-LIHQZDEY-DhaZyo03.js +1 -0
  46. package/dist/client/assets/chunk-ORNJ4GCN-DlpeeJyi.js +1 -0
  47. package/dist/client/assets/chunk-OYMX7WX6-Dc9q7aYA.js +231 -0
  48. package/dist/client/assets/chunk-QZHKN3VN-BEdrPoSb.js +1 -0
  49. package/dist/client/assets/chunk-U2HBQHQK-CIB3Bjjd.js +70 -0
  50. package/dist/client/assets/chunk-X2U36JSP-CtB-o8Yp.js +1 -0
  51. package/dist/client/assets/chunk-XPW4576I-C6iHhX_8.js +32 -0
  52. package/dist/client/assets/chunk-YZCP3GAM-CTmKr6ZH.js +1 -0
  53. package/dist/client/assets/chunk-ZZ45TVLE-BgU8A2RF.js +1 -0
  54. package/dist/client/assets/classDiagram-6PBFFD2Q-Bqk5e679.js +1 -0
  55. package/dist/client/assets/classDiagram-v2-HSJHXN6E-6pSaZOkC.js +1 -0
  56. package/dist/client/assets/client-BrKWI4CM.js +1 -0
  57. package/dist/client/assets/client-CGgNRU9w.js +1 -0
  58. package/dist/client/assets/client-DMSLRzg9.js +6 -0
  59. package/dist/client/assets/clone-DWcL7whJ.js +1 -0
  60. package/dist/client/assets/cose-bilkent-S5V4N54A-CrV5wsV_.js +1 -0
  61. package/dist/client/assets/cytoscape.esm--aLzKuep.js +321 -0
  62. package/dist/client/assets/dagre-CuRxWcrj.js +1 -0
  63. package/dist/client/assets/dagre-KV5264BT-BIDiVnkA.js +4 -0
  64. package/dist/client/assets/defaultLocale-CRZydyG6.js +1 -0
  65. package/dist/client/assets/diagram-5BDNPKRD-i1kjKRCB.js +10 -0
  66. package/dist/client/assets/diagram-G4DWMVQ6-9ZSLuhbl.js +24 -0
  67. package/dist/client/assets/diagram-MMDJMWI5-B4_CUjgv.js +43 -0
  68. package/dist/client/assets/diagram-TYMM5635-Ct5eTGS8.js +24 -0
  69. package/dist/client/assets/dist-CuB4kiSK.js +1 -0
  70. package/dist/client/assets/erDiagram-SMLLAGMA-Cy38ercc.js +85 -0
  71. package/dist/client/assets/flowDiagram-DWJPFMVM-CZKuYl0V.js +162 -0
  72. package/dist/client/assets/ganttDiagram-T4ZO3ILL-DLPjCh7a.js +292 -0
  73. package/dist/client/assets/gitGraph-7Q5UKJZL-DqbrtEp9.js +1 -0
  74. package/dist/client/assets/gitGraphDiagram-UUTBAWPF-BoRBkDhQ.js +106 -0
  75. package/dist/client/assets/graphlib-BcQ6qlQh.js +1 -0
  76. package/dist/client/assets/highlighted-body-OFNGDK62-BEpBVDTX.js +1 -0
  77. package/dist/client/assets/index-CetCiuqP.js +105 -0
  78. package/dist/client/assets/index-N29Mip7A.css +1 -0
  79. package/dist/client/assets/info-OMHHGYJF-D98DRBJX.js +1 -0
  80. package/dist/client/assets/infoDiagram-42DDH7IO-BAcdTWbt.js +2 -0
  81. package/dist/client/assets/init-B8gtcn7T.js +1 -0
  82. package/dist/client/assets/isArrayLikeObject-D8SJFmkN.js +1 -0
  83. package/dist/client/assets/isEmpty-BF3YX5Jk.js +1 -0
  84. package/dist/client/assets/ishikawaDiagram-UXIWVN3A-Ynu2VKdC.js +70 -0
  85. package/dist/client/assets/journeyDiagram-VCZTEJTY-BjfhQaN3.js +139 -0
  86. package/dist/client/assets/jsx-runtime-CyI9ICYU.js +1 -0
  87. package/dist/client/assets/kanban-definition-6JOO6SKY-JLXH9zUJ.js +89 -0
  88. package/dist/client/assets/katex-B94qP8b6.js +265 -0
  89. package/dist/client/assets/lib--QVjyxmL.js +29 -0
  90. package/dist/client/assets/lib-B6rgJiZ9.js +1 -0
  91. package/dist/client/assets/line-DCrYfLBn.js +1 -0
  92. package/dist/client/assets/linear-_4upLmeo.js +1 -0
  93. package/dist/client/assets/mermaid-GHXKKRXX-rwJHYUmW.js +1 -0
  94. package/dist/client/assets/mermaid-parser.core-KZinfW8o.js +4 -0
  95. package/dist/client/assets/mermaid.core-QqY9gSNe.js +11 -0
  96. package/dist/client/assets/mindmap-definition-QFDTVHPH-TWgHDAzp.js +96 -0
  97. package/dist/client/assets/ordinal-CCj7PWgZ.js +1 -0
  98. package/dist/client/assets/packet-4T2RLAQJ-DEvfkn3F.js +1 -0
  99. package/dist/client/assets/path-DZF-JdEe.js +1 -0
  100. package/dist/client/assets/pie-ZZUOXDRM-72e6WVjb.js +1 -0
  101. package/dist/client/assets/pieDiagram-DEJITSTG-Cl8PCsoj.js +30 -0
  102. package/dist/client/assets/preload-helper-rov5CBGT.js +1 -0
  103. package/dist/client/assets/pty-client-DZ27IS00.js +1 -0
  104. package/dist/client/assets/ptyInstancesStore-D9ag7SYd.js +1 -0
  105. package/dist/client/assets/quadrantDiagram-34T5L4WZ-CHyVGp9E.js +7 -0
  106. package/dist/client/assets/radar-PYXPWWZC-Cp7xd_EY.js +1 -0
  107. package/dist/client/assets/react-CClhXMB2.js +1 -0
  108. package/dist/client/assets/react-Dd6D81m0.js +1 -0
  109. package/dist/client/assets/react-dom--G6_6fQ_.js +1 -0
  110. package/dist/client/assets/requirementDiagram-MS252O5E-DaanG2iM.js +84 -0
  111. package/dist/client/assets/rough.esm-BsmKo2S5.js +1 -0
  112. package/dist/client/assets/sankeyDiagram-XADWPNL6-B_fhLY36.js +10 -0
  113. package/dist/client/assets/sequenceDiagram-FGHM5R23-C5FNrveI.js +157 -0
  114. package/dist/client/assets/src-DeTlMJAU.js +1 -0
  115. package/dist/client/assets/stateDiagram-FHFEXIEX-nTTcdjjQ.js +1 -0
  116. package/dist/client/assets/stateDiagram-v2-QKLJ7IA2-Dw0632j_.js +1 -0
  117. package/dist/client/assets/timeline-definition-GMOUNBTQ-DkQV1yP8.js +120 -0
  118. package/dist/client/assets/treeView-SZITEDCU-ZLIgC7_K.js +1 -0
  119. package/dist/client/assets/treemap-W4RFUUIX-BqaMbB6N.js +1 -0
  120. package/dist/client/assets/uiIdentityOverlay-Ba7GNj7m.js +1 -0
  121. package/dist/client/assets/vennDiagram-DHZGUBPP-DbZ2xgs6.js +34 -0
  122. package/dist/client/assets/wardley-RL74JXVD-DXQS8zf4.js +1 -0
  123. package/dist/client/assets/wardleyDiagram-NUSXRM2D-BzCJ6MAu.js +20 -0
  124. package/dist/client/assets/xychartDiagram-5P7HB3ND-BSlFecop.js +7 -0
  125. package/dist/client/favicon.png +0 -0
  126. package/dist/client/favicon.svg +15 -0
  127. package/dist/client/fonts/body-medium.woff2 +0 -0
  128. package/dist/client/fonts/body-regular-italic.woff2 +0 -0
  129. package/dist/client/fonts/body-regular.woff2 +0 -0
  130. package/dist/client/fonts/body-semibold.woff2 +0 -0
  131. package/dist/client/index.html +31 -0
  132. package/dist/client/manifest.webmanifest +12 -0
  133. package/dist/client/sw.js +32 -0
  134. package/package.json +122 -0
  135. package/src/nats/auth-callout/callout-config.test.ts +93 -0
  136. package/src/nats/auth-callout/callout-config.ts +109 -0
  137. package/src/nats/auth-callout/callout.integration.test.ts +332 -0
  138. package/src/nats/auth-callout/keys.ts +103 -0
  139. package/src/nats/auth-callout/responder.ts +241 -0
  140. package/src/nats/auth-callout/scope-policy.test.ts +159 -0
  141. package/src/nats/auth-callout/scope-policy.ts +210 -0
  142. package/src/nats/auth-callout/token.test.ts +163 -0
  143. package/src/nats/auth-callout/token.ts +157 -0
  144. package/src/nats/nats-daemon-callout.ts +194 -0
  145. package/src/nats/nats-daemon.test.ts +77 -0
  146. package/src/nats/nats-daemon.ts +50 -0
  147. package/src/nats/nats-token.test.ts +61 -0
  148. package/src/nats/nats-token.ts +59 -0
  149. package/src/runner/coordination-mcp-integration.test.ts +134 -0
  150. package/src/runner/nats-coordination-client.test.ts +49 -0
  151. package/src/runner/nats-coordination-client.ts +94 -0
  152. package/src/runner/runner-agent.test.ts +469 -0
  153. package/src/runner/runner-agent.ts +453 -0
  154. package/src/runner/runner-credential.test.ts +93 -0
  155. package/src/runner/runner-credential.ts +82 -0
  156. package/src/runner/runner-nats.test.ts +495 -0
  157. package/src/runner/runner-nats.ts +323 -0
  158. package/src/runner/runner-pair.test.ts +107 -0
  159. package/src/runner/runner-pair.ts +81 -0
  160. package/src/runner/runner.test.ts +135 -0
  161. package/src/runner/runner.ts +212 -0
  162. package/src/runner/turn-factories.test.ts +97 -0
  163. package/src/runner/turn-factories.ts +475 -0
  164. package/src/server/agent-config-journey.test.ts +106 -0
  165. package/src/server/agent.ts +8 -0
  166. package/src/server/auto-continue/auth-error-detector.ts +66 -0
  167. package/src/server/auto-continue/limit-detector.ts +194 -0
  168. package/src/server/bm25.test.ts +92 -0
  169. package/src/server/bm25.ts +101 -0
  170. package/src/server/chat-events-jetstream.test.ts +135 -0
  171. package/src/server/claude-harness.ts +360 -0
  172. package/src/server/claude-pty/agent-normalizers.ts +309 -0
  173. package/src/server/claude-pty/auth.test.ts +38 -0
  174. package/src/server/claude-pty/auth.ts +32 -0
  175. package/src/server/claude-pty/claude-session-registry.adapter.ts +81 -0
  176. package/src/server/claude-pty/claude-session-registry.test.ts +149 -0
  177. package/src/server/claude-pty/driver.test.ts +902 -0
  178. package/src/server/claude-pty/driver.ts +807 -0
  179. package/src/server/claude-pty/jsonl-path.adapter.ts +57 -0
  180. package/src/server/claude-pty/jsonl-path.test.ts +114 -0
  181. package/src/server/claude-pty/jsonl-to-event.test.ts +241 -0
  182. package/src/server/claude-pty/jsonl-to-event.ts +174 -0
  183. package/src/server/claude-pty/output-ring.test.ts +35 -0
  184. package/src/server/claude-pty/output-ring.ts +25 -0
  185. package/src/server/claude-pty/parity-matrix.test.ts +227 -0
  186. package/src/server/claude-pty/pid-registry.adapter.ts +135 -0
  187. package/src/server/claude-pty/pid-registry.test.ts +122 -0
  188. package/src/server/claude-pty/preflight/binary-fingerprint.adapter.ts +20 -0
  189. package/src/server/claude-pty/preflight/binary-fingerprint.test.ts +32 -0
  190. package/src/server/claude-pty/pty-instance-registry.test.ts +177 -0
  191. package/src/server/claude-pty/pty-instance-registry.ts +166 -0
  192. package/src/server/claude-pty/pty-memory-sampler.adapter.test.ts +103 -0
  193. package/src/server/claude-pty/pty-memory-sampler.adapter.ts +85 -0
  194. package/src/server/claude-pty/pty-process.adapter.ts +66 -0
  195. package/src/server/claude-pty/pty-process.test.ts +49 -0
  196. package/src/server/claude-pty/resolve-binary.adapter.ts +106 -0
  197. package/src/server/claude-pty/resolve-binary.test.ts +118 -0
  198. package/src/server/claude-pty/runtime-dir.adapter.ts +19 -0
  199. package/src/server/claude-pty/settings-writer.adapter.ts +27 -0
  200. package/src/server/claude-pty/settings-writer.test.ts +22 -0
  201. package/src/server/claude-pty/smoke-test-io.adapter.ts +28 -0
  202. package/src/server/claude-pty/smoke-test.test.ts +191 -0
  203. package/src/server/claude-pty/smoke-test.ts +185 -0
  204. package/src/server/claude-pty/subagent-orchestrator.ts +887 -0
  205. package/src/server/claude-pty/tool-callback.ts +274 -0
  206. package/src/server/claude-pty/tui-control.test.ts +272 -0
  207. package/src/server/claude-pty/tui-control.ts +182 -0
  208. package/src/server/claude-pty/tui-source.adapter.test.ts +360 -0
  209. package/src/server/claude-pty/tui-source.adapter.ts +343 -0
  210. package/src/server/claude-pty/tunnel-gateway.ts +12 -0
  211. package/src/server/claude-pty-mcp/canonical-args.ts +15 -0
  212. package/src/server/claude-pty-mcp/fs-stat.adapter.ts +8 -0
  213. package/src/server/claude-pty-mcp/history-primer.ts +90 -0
  214. package/src/server/claude-pty-mcp/http-server.adapter.ts +33 -0
  215. package/src/server/claude-pty-mcp/mcp-http.ts +177 -0
  216. package/src/server/claude-pty-mcp/mcp.ts +412 -0
  217. package/src/server/claude-pty-mcp/mention-parser.ts +25 -0
  218. package/src/server/claude-pty-mcp/paths.ts +24 -0
  219. package/src/server/claude-pty-mcp/permission-gate.ts +243 -0
  220. package/src/server/claude-pty-mcp/terminal-pid-registry.adapter.ts +107 -0
  221. package/src/server/claude-pty-mcp/tools/ask-user-question.test.ts +119 -0
  222. package/src/server/claude-pty-mcp/tools/ask-user-question.ts +61 -0
  223. package/src/server/claude-pty-mcp/tools/bash.adapter.ts +76 -0
  224. package/src/server/claude-pty-mcp/tools/bash.test.ts +56 -0
  225. package/src/server/claude-pty-mcp/tools/delegate-subagent.test.ts +155 -0
  226. package/src/server/claude-pty-mcp/tools/delegate-subagent.ts +111 -0
  227. package/src/server/claude-pty-mcp/tools/edit.adapter.ts +95 -0
  228. package/src/server/claude-pty-mcp/tools/edit.test.ts +93 -0
  229. package/src/server/claude-pty-mcp/tools/exit-plan-mode.test.ts +61 -0
  230. package/src/server/claude-pty-mcp/tools/exit-plan-mode.ts +50 -0
  231. package/src/server/claude-pty-mcp/tools/glob.adapter.ts +86 -0
  232. package/src/server/claude-pty-mcp/tools/glob.test.ts +61 -0
  233. package/src/server/claude-pty-mcp/tools/grep.adapter.ts +126 -0
  234. package/src/server/claude-pty-mcp/tools/grep.test.ts +62 -0
  235. package/src/server/claude-pty-mcp/tools/read.adapter.ts +58 -0
  236. package/src/server/claude-pty-mcp/tools/read.test.ts +62 -0
  237. package/src/server/claude-pty-mcp/tools/tool-callback-shim.ts +42 -0
  238. package/src/server/claude-pty-mcp/tools/webfetch.test.ts +81 -0
  239. package/src/server/claude-pty-mcp/tools/webfetch.ts +82 -0
  240. package/src/server/claude-pty-mcp/tools/websearch.test.ts +40 -0
  241. package/src/server/claude-pty-mcp/tools/websearch.ts +42 -0
  242. package/src/server/claude-pty-mcp/tools/write.adapter.ts +60 -0
  243. package/src/server/claude-pty-mcp/tools/write.test.ts +52 -0
  244. package/src/server/claude-pty-mcp/uploads.adapter.ts +98 -0
  245. package/src/server/claude-pty-mcp/uploads.ts +38 -0
  246. package/src/server/claude-turn.test.ts +176 -0
  247. package/src/server/cli-runtime.test.ts +456 -0
  248. package/src/server/cli-runtime.ts +374 -0
  249. package/src/server/cli-supervisor.ts +81 -0
  250. package/src/server/cli.ts +78 -0
  251. package/src/server/client-log-forwarder.test.ts +74 -0
  252. package/src/server/client-log-forwarder.ts +75 -0
  253. package/src/server/codex-app-server-protocol.ts +449 -0
  254. package/src/server/codex-app-server.test.ts +2990 -0
  255. package/src/server/codex-app-server.ts +1713 -0
  256. package/src/server/coordination-integration.test.ts +63 -0
  257. package/src/server/coordination-mcp.test.ts +149 -0
  258. package/src/server/coordination-mcp.ts +197 -0
  259. package/src/server/delegation-coordinator.test.ts +675 -0
  260. package/src/server/delegation-coordinator.ts +454 -0
  261. package/src/server/discovery.test.ts +211 -0
  262. package/src/server/discovery.ts +301 -0
  263. package/src/server/event-store-agent-config.test.ts +124 -0
  264. package/src/server/event-store-coordination.test.ts +149 -0
  265. package/src/server/event-store-profile.test.ts +132 -0
  266. package/src/server/event-store-repo.test.ts +154 -0
  267. package/src/server/event-store-runner-team.test.ts +104 -0
  268. package/src/server/event-store.test.ts +342 -0
  269. package/src/server/event-store.ts +2208 -0
  270. package/src/server/events.ts +379 -0
  271. package/src/server/extension-router.test.ts +183 -0
  272. package/src/server/extension-router.ts +114 -0
  273. package/src/server/extensions/agents/server.test.ts +191 -0
  274. package/src/server/extensions/agents/server.ts +108 -0
  275. package/src/server/extensions/c3/server.test.ts +284 -0
  276. package/src/server/extensions/c3/server.ts +212 -0
  277. package/src/server/extensions/code/server.test.ts +200 -0
  278. package/src/server/extensions/code/server.ts +150 -0
  279. package/src/server/extensions.config.ts +10 -0
  280. package/src/server/external-open.ts +69 -0
  281. package/src/server/generate-fork-context.ts +58 -0
  282. package/src/server/generate-merge-context.test.ts +290 -0
  283. package/src/server/generate-merge-context.ts +141 -0
  284. package/src/server/generate-title.ts +36 -0
  285. package/src/server/git-clone-policy.test.ts +138 -0
  286. package/src/server/git-clone-policy.ts +27 -0
  287. package/src/server/harness-types.ts +1 -0
  288. package/src/server/journey-verification.test.ts +640 -0
  289. package/src/server/journey-verification.ts +195 -0
  290. package/src/server/machine-name.ts +22 -0
  291. package/src/server/nats-auth.test.ts +92 -0
  292. package/src/server/nats-auth.ts +6 -0
  293. package/src/server/nats-bind-guard.test.ts +71 -0
  294. package/src/server/nats-bind-guard.ts +42 -0
  295. package/src/server/nats-bridge.test.ts +141 -0
  296. package/src/server/nats-bridge.ts +111 -0
  297. package/src/server/nats-connector.test.ts +56 -0
  298. package/src/server/nats-connector.ts +71 -0
  299. package/src/server/nats-daemon-manager.test.ts +76 -0
  300. package/src/server/nats-daemon-manager.ts +174 -0
  301. package/src/server/nats-publisher.test.ts +356 -0
  302. package/src/server/nats-publisher.ts +271 -0
  303. package/src/server/nats-responders.test.ts +1018 -0
  304. package/src/server/nats-responders.ts +925 -0
  305. package/src/server/nats-streams.test.ts +112 -0
  306. package/src/server/nats-streams.ts +129 -0
  307. package/src/server/oauth-pool/oauth-responders.ts +185 -0
  308. package/src/server/oauth-pool/oauth-settings-store.ts +173 -0
  309. package/src/server/oauth-pool/oauth-token-pool.ts +303 -0
  310. package/src/server/orchestration.test.ts +1063 -0
  311. package/src/server/orchestration.ts +716 -0
  312. package/src/server/pairing-endpoints.test.ts +171 -0
  313. package/src/server/pairing-store.test.ts +154 -0
  314. package/src/server/pairing-store.ts +124 -0
  315. package/src/server/paths.ts +27 -0
  316. package/src/server/pr3-liveness.test.ts +252 -0
  317. package/src/server/process-utils.ts +10 -0
  318. package/src/server/project-cli.ts +180 -0
  319. package/src/server/provider-catalog.test.ts +177 -0
  320. package/src/server/provider-catalog.ts +146 -0
  321. package/src/server/pty-responders.ts +345 -0
  322. package/src/server/push-notifications.test.ts +234 -0
  323. package/src/server/push-notifications.ts +188 -0
  324. package/src/server/quick-response.test.ts +196 -0
  325. package/src/server/quick-response.ts +154 -0
  326. package/src/server/read-models-agent-config.test.ts +59 -0
  327. package/src/server/read-models-coordination.test.ts +69 -0
  328. package/src/server/read-models.test.ts +332 -0
  329. package/src/server/read-models.ts +258 -0
  330. package/src/server/repo-journey.test.ts +96 -0
  331. package/src/server/repo-manager.test.ts +118 -0
  332. package/src/server/repo-manager.ts +97 -0
  333. package/src/server/repo-status.test.ts +54 -0
  334. package/src/server/repo-status.ts +82 -0
  335. package/src/server/restart.test.ts +27 -0
  336. package/src/server/restart.ts +30 -0
  337. package/src/server/runner-incompatible-gate.test.ts +383 -0
  338. package/src/server/runner-manager.test.ts +72 -0
  339. package/src/server/runner-manager.ts +312 -0
  340. package/src/server/runner-pairing-urls.test.ts +59 -0
  341. package/src/server/runner-pairing-urls.ts +67 -0
  342. package/src/server/runner-proxy.test.ts +456 -0
  343. package/src/server/runner-proxy.ts +494 -0
  344. package/src/server/runner-router.test.ts +429 -0
  345. package/src/server/runner-router.ts +212 -0
  346. package/src/server/runner-routing.test.ts +584 -0
  347. package/src/server/runtime-registry.test.ts +436 -0
  348. package/src/server/runtime-registry.ts +307 -0
  349. package/src/server/sandbox-health.test.ts +127 -0
  350. package/src/server/sandbox-health.ts +94 -0
  351. package/src/server/sandbox-journey.test.ts +232 -0
  352. package/src/server/sandbox-manager.test.ts +146 -0
  353. package/src/server/sandbox-manager.ts +159 -0
  354. package/src/server/server.test.ts +287 -0
  355. package/src/server/server.ts +1108 -0
  356. package/src/server/session-discovery.test.ts +129 -0
  357. package/src/server/session-discovery.ts +475 -0
  358. package/src/server/session-index.test.ts +362 -0
  359. package/src/server/session-index.ts +119 -0
  360. package/src/server/session-seed.ts +288 -0
  361. package/src/server/share.test.ts +108 -0
  362. package/src/server/share.ts +113 -0
  363. package/src/server/skill-discovery.test.ts +201 -0
  364. package/src/server/skill-discovery.ts +77 -0
  365. package/src/server/storage/test-helpers.ts +67 -0
  366. package/src/server/terminal-manager.test.ts +309 -0
  367. package/src/server/terminal-manager.ts +354 -0
  368. package/src/server/transcript-consumer.test.ts +339 -0
  369. package/src/server/transcript-consumer.ts +162 -0
  370. package/src/server/transcript-search.test.ts +193 -0
  371. package/src/server/transcript-search.ts +83 -0
  372. package/src/server/transcript-utils.ts +52 -0
  373. package/src/server/update-manager.test.ts +107 -0
  374. package/src/server/update-manager.ts +230 -0
  375. package/src/server/workflow-engine.test.ts +251 -0
  376. package/src/server/workflow-engine.ts +169 -0
  377. package/src/server/workflow-mcp.ts +49 -0
  378. package/src/server/workflow-store.test.ts +155 -0
  379. package/src/server/workflow-store.ts +139 -0
  380. package/src/server/workspace-agent-integration.test.ts +167 -0
  381. package/src/server/workspace-agent-routes.test.ts +127 -0
  382. package/src/server/workspace-agent-routes.ts +89 -0
  383. package/src/server/workspace-agent.test.ts +103 -0
  384. package/src/server/workspace-agent.ts +102 -0
  385. package/src/server/workspace-cli.test.ts +79 -0
  386. package/src/server/workspace-config-manager.test.ts +109 -0
  387. package/src/server/workspace-config-manager.ts +83 -0
  388. package/src/server/workspace-directory-policy.test.ts +109 -0
  389. package/src/server/workspace-directory-policy.ts +56 -0
  390. package/src/shared/agent-config-types.ts +25 -0
  391. package/src/shared/branding.test.ts +42 -0
  392. package/src/shared/branding.ts +54 -0
  393. package/src/shared/compression.test.ts +85 -0
  394. package/src/shared/compression.ts +42 -0
  395. package/src/shared/coordination-store.test.ts +24 -0
  396. package/src/shared/coordination-store.ts +26 -0
  397. package/src/shared/dev-ports.test.ts +84 -0
  398. package/src/shared/dev-ports.ts +100 -0
  399. package/src/shared/extension-types.ts +45 -0
  400. package/src/shared/fork-presets.ts +54 -0
  401. package/src/shared/harness-types.test.ts +15 -0
  402. package/src/shared/harness-types.ts +21 -0
  403. package/src/shared/log-sink.test.ts +112 -0
  404. package/src/shared/log-sink.ts +185 -0
  405. package/src/shared/mention-pattern.ts +7 -0
  406. package/src/shared/merge-presets.ts +41 -0
  407. package/src/shared/nats-subjects.test.ts +61 -0
  408. package/src/shared/nats-subjects.ts +131 -0
  409. package/src/shared/permission-policy.ts +136 -0
  410. package/src/shared/ports.ts +3 -0
  411. package/src/shared/preset-types.ts +15 -0
  412. package/src/shared/profile-types.ts +49 -0
  413. package/src/shared/projectFileUrl.ts +36 -0
  414. package/src/shared/protocol.ts +153 -0
  415. package/src/shared/pty-instance.ts +43 -0
  416. package/src/shared/puggy/diagnostics/result.ts +18 -0
  417. package/src/shared/puggy/expressions/evaluate.ts +292 -0
  418. package/src/shared/puggy/index.test.ts +101 -0
  419. package/src/shared/puggy/index.ts +69 -0
  420. package/src/shared/puggy/parser/ast.ts +110 -0
  421. package/src/shared/puggy/parser/parser.ts +624 -0
  422. package/src/shared/puggy/renderer/html.ts +447 -0
  423. package/src/shared/runner-protocol.test.ts +277 -0
  424. package/src/shared/runner-protocol.ts +210 -0
  425. package/src/shared/runner-team-types.ts +73 -0
  426. package/src/shared/runtime-types.ts +48 -0
  427. package/src/shared/sandbox-types.ts +53 -0
  428. package/src/shared/tailwind-build.test.ts +12 -0
  429. package/src/shared/tinkaria-system-prompt.ts +101 -0
  430. package/src/shared/tools.test.ts +335 -0
  431. package/src/shared/tools.ts +397 -0
  432. package/src/shared/transcript-entries.ts +27 -0
  433. package/src/shared/transcript-render.test.ts +225 -0
  434. package/src/shared/transcript-render.ts +467 -0
  435. package/src/shared/types.ts +1031 -0
  436. package/src/shared/vite-config.test.ts +47 -0
  437. package/src/shared/web-context.test.ts +110 -0
  438. package/src/shared/web-context.ts +76 -0
  439. package/src/shared/workflow-types.ts +51 -0
  440. package/src/shared/workspace-types.ts +100 -0
@@ -0,0 +1,230 @@
1
+ import type { UpdateInstallResult, UpdateSnapshot } from "../shared/types"
2
+ import { APP_NAME, PACKAGE_NAME } from "../shared/branding"
3
+ import { compareVersions, type UpdateInstallAttemptResult } from "./cli-runtime"
4
+
5
+ const UPDATE_CACHE_TTL_MS = 5 * 60 * 1000
6
+
7
+ export interface UpdateManagerDeps {
8
+ currentVersion: string
9
+ fetchLatestVersion: (packageName: string) => Promise<string>
10
+ installVersion: (packageName: string, version: string) => UpdateInstallAttemptResult
11
+ devMode?: boolean
12
+ }
13
+
14
+ export class UpdateManager {
15
+ private readonly deps: UpdateManagerDeps
16
+ private readonly listeners = new Set<(snapshot: UpdateSnapshot) => void>()
17
+ private snapshot: UpdateSnapshot
18
+ private checkPromise: Promise<UpdateSnapshot> | null = null
19
+ private installPromise: Promise<UpdateInstallResult> | null = null
20
+
21
+ constructor(deps: UpdateManagerDeps) {
22
+ this.deps = deps
23
+ this.snapshot = {
24
+ currentVersion: deps.currentVersion,
25
+ latestVersion: deps.devMode ? `${deps.currentVersion}-dev` : null,
26
+ status: deps.devMode ? "available" : "idle",
27
+ updateAvailable: Boolean(deps.devMode),
28
+ lastCheckedAt: deps.devMode ? Date.now() : null,
29
+ error: null,
30
+ installAction: "restart",
31
+ }
32
+ }
33
+
34
+ getSnapshot() {
35
+ return this.snapshot
36
+ }
37
+
38
+ onChange(listener: (snapshot: UpdateSnapshot) => void) {
39
+ this.listeners.add(listener)
40
+ return () => {
41
+ this.listeners.delete(listener)
42
+ }
43
+ }
44
+
45
+ async checkForUpdates(options: { force?: boolean } = {}) {
46
+ if (this.deps.devMode) {
47
+ return this.snapshot
48
+ }
49
+
50
+ if (this.snapshot.status === "updating" || this.snapshot.status === "restart_pending") {
51
+ return this.snapshot
52
+ }
53
+
54
+ if (this.checkPromise) {
55
+ return this.checkPromise
56
+ }
57
+
58
+ if (!options.force && this.snapshot.lastCheckedAt && Date.now() - this.snapshot.lastCheckedAt < UPDATE_CACHE_TTL_MS) {
59
+ return this.snapshot
60
+ }
61
+
62
+ this.setSnapshot({
63
+ ...this.snapshot,
64
+ status: "checking",
65
+ error: null,
66
+ })
67
+
68
+ const checkPromise = this.runCheck()
69
+ this.checkPromise = checkPromise
70
+
71
+ try {
72
+ return await checkPromise
73
+ } finally {
74
+ if (this.checkPromise === checkPromise) {
75
+ this.checkPromise = null
76
+ }
77
+ }
78
+ }
79
+
80
+ async installUpdate(): Promise<UpdateInstallResult> {
81
+ if (this.deps.devMode) {
82
+ this.setSnapshot({
83
+ ...this.snapshot,
84
+ status: "updating",
85
+ error: null,
86
+ })
87
+
88
+ this.setSnapshot({
89
+ ...this.snapshot,
90
+ status: "restart_pending",
91
+ updateAvailable: false,
92
+ error: null,
93
+ })
94
+
95
+ return {
96
+ ok: true,
97
+ action: "restart",
98
+ errorCode: null,
99
+ userTitle: null,
100
+ userMessage: null,
101
+ }
102
+ }
103
+
104
+ if (this.snapshot.status === "updating" || this.snapshot.status === "restart_pending") {
105
+ return {
106
+ ok: this.snapshot.updateAvailable,
107
+ action: "restart",
108
+ errorCode: null,
109
+ userTitle: null,
110
+ userMessage: null,
111
+ }
112
+ }
113
+
114
+ if (this.installPromise) {
115
+ return this.installPromise
116
+ }
117
+
118
+ const installPromise = this.runInstall()
119
+ this.installPromise = installPromise
120
+
121
+ try {
122
+ return await installPromise
123
+ } finally {
124
+ if (this.installPromise === installPromise) {
125
+ this.installPromise = null
126
+ }
127
+ }
128
+ }
129
+
130
+ private async runCheck() {
131
+ try {
132
+ const latestVersion = await this.deps.fetchLatestVersion(PACKAGE_NAME)
133
+ const updateAvailable = compareVersions(this.snapshot.currentVersion, latestVersion) < 0
134
+ const nextSnapshot: UpdateSnapshot = {
135
+ ...this.snapshot,
136
+ latestVersion,
137
+ updateAvailable,
138
+ status: updateAvailable ? "available" : "up_to_date",
139
+ lastCheckedAt: Date.now(),
140
+ error: null,
141
+ }
142
+ this.setSnapshot(nextSnapshot)
143
+ return nextSnapshot
144
+ } catch (error) {
145
+ const nextSnapshot: UpdateSnapshot = {
146
+ ...this.snapshot,
147
+ status: "error",
148
+ lastCheckedAt: Date.now(),
149
+ error: error instanceof Error ? error.message : String(error),
150
+ }
151
+ this.setSnapshot(nextSnapshot)
152
+ return nextSnapshot
153
+ }
154
+ }
155
+
156
+ private async runInstall(): Promise<UpdateInstallResult> {
157
+ if (!this.snapshot.updateAvailable) {
158
+ const snapshot = await this.checkForUpdates({ force: true })
159
+ if (!snapshot.updateAvailable) {
160
+ return {
161
+ ok: false,
162
+ action: "restart",
163
+ errorCode: null,
164
+ userTitle: null,
165
+ userMessage: null,
166
+ }
167
+ }
168
+ }
169
+
170
+ this.setSnapshot({
171
+ ...this.snapshot,
172
+ status: "updating",
173
+ error: null,
174
+ })
175
+
176
+ const targetVersion = this.snapshot.latestVersion
177
+ if (!targetVersion) {
178
+ this.setSnapshot({
179
+ ...this.snapshot,
180
+ status: "error",
181
+ error: "Unable to determine which version to install.",
182
+ })
183
+ return {
184
+ ok: false,
185
+ action: "restart",
186
+ errorCode: "install_failed",
187
+ userTitle: "Update failed",
188
+ userMessage: `${APP_NAME} could not determine which version to install.`,
189
+ }
190
+ }
191
+
192
+ const installed = this.deps.installVersion(PACKAGE_NAME, targetVersion)
193
+ if (!installed.ok) {
194
+ this.setSnapshot({
195
+ ...this.snapshot,
196
+ status: "error",
197
+ error: installed.userMessage ?? "Unable to install the latest version.",
198
+ })
199
+ return {
200
+ ok: false,
201
+ action: "restart",
202
+ errorCode: installed.errorCode,
203
+ userTitle: installed.userTitle,
204
+ userMessage: installed.userMessage,
205
+ }
206
+ }
207
+
208
+ this.setSnapshot({
209
+ ...this.snapshot,
210
+ currentVersion: this.snapshot.latestVersion ?? this.snapshot.currentVersion,
211
+ status: "restart_pending",
212
+ updateAvailable: false,
213
+ error: null,
214
+ })
215
+ return {
216
+ ok: true,
217
+ action: "restart",
218
+ errorCode: null,
219
+ userTitle: null,
220
+ userMessage: null,
221
+ }
222
+ }
223
+
224
+ private setSnapshot(snapshot: UpdateSnapshot) {
225
+ this.snapshot = snapshot
226
+ for (const listener of this.listeners) {
227
+ listener(snapshot)
228
+ }
229
+ }
230
+ }
@@ -0,0 +1,251 @@
1
+ import { describe, test, expect, afterEach } from "bun:test"
2
+ import type { WorkflowDefinition } from "../shared/workflow-types"
3
+ import { WorkflowEngine, type McpDispatcher, type WorkflowEventEmitter } from "./workflow-engine"
4
+
5
+ function makeDef(overrides?: Partial<WorkflowDefinition>): WorkflowDefinition {
6
+ return {
7
+ id: "test-workflow",
8
+ name: "Test Workflow",
9
+ trigger: "manual",
10
+ target: "all",
11
+ steps: [
12
+ { mcp_tool: "tool_a", params: { key: "val" } },
13
+ { mcp_tool: "tool_b", params: {} },
14
+ ],
15
+ on_failure: "stop",
16
+ ...overrides,
17
+ }
18
+ }
19
+
20
+ function makeEmitter(): WorkflowEventEmitter & { calls: Array<{ method: string; args: unknown[] }> } {
21
+ const calls: Array<{ method: string; args: unknown[] }> = []
22
+ const handler = (method: string) =>
23
+ async (...args: unknown[]) => {
24
+ calls.push({ method, args })
25
+ }
26
+ return {
27
+ calls,
28
+ emitWorkflowStarted: handler("emitWorkflowStarted") as WorkflowEventEmitter["emitWorkflowStarted"],
29
+ emitWorkflowStepStarted: handler("emitWorkflowStepStarted") as WorkflowEventEmitter["emitWorkflowStepStarted"],
30
+ emitWorkflowStepCompleted: handler("emitWorkflowStepCompleted") as WorkflowEventEmitter["emitWorkflowStepCompleted"],
31
+ emitWorkflowStepFailed: handler("emitWorkflowStepFailed") as WorkflowEventEmitter["emitWorkflowStepFailed"],
32
+ emitWorkflowCompleted: handler("emitWorkflowCompleted") as WorkflowEventEmitter["emitWorkflowCompleted"],
33
+ emitWorkflowFailed: handler("emitWorkflowFailed") as WorkflowEventEmitter["emitWorkflowFailed"],
34
+ emitWorkflowCancelled: handler("emitWorkflowCancelled") as WorkflowEventEmitter["emitWorkflowCancelled"],
35
+ }
36
+ }
37
+
38
+ function makeDispatcher(fn?: (tool: string, params: Record<string, unknown>) => Promise<string>): McpDispatcher {
39
+ return {
40
+ dispatch: fn ?? (async () => "ok"),
41
+ }
42
+ }
43
+
44
+ describe("WorkflowEngine", () => {
45
+ let engine: WorkflowEngine
46
+
47
+ afterEach(() => {
48
+ engine = undefined as unknown as WorkflowEngine
49
+ })
50
+
51
+ test("successful 2-step run emits correct event sequence", async () => {
52
+ const emitter = makeEmitter()
53
+ engine = new WorkflowEngine({
54
+ emitter,
55
+ dispatcher: makeDispatcher(),
56
+ resolveRepos: async () => ["repo-1"],
57
+ })
58
+
59
+ const runId = await engine.run("wf-1", "ws-1", makeDef(), "user-1")
60
+
61
+ expect(typeof runId).toBe("string")
62
+ expect(runId.length).toBeGreaterThan(0)
63
+
64
+ const methods = emitter.calls.map((c: { method: string; args: unknown[] }) => c.method)
65
+ expect(methods).toEqual([
66
+ "emitWorkflowStarted",
67
+ "emitWorkflowStepStarted",
68
+ "emitWorkflowStepCompleted",
69
+ "emitWorkflowStepStarted",
70
+ "emitWorkflowStepCompleted",
71
+ "emitWorkflowCompleted",
72
+ ])
73
+ })
74
+
75
+ test("on_failure: stop — halts on first failure", async () => {
76
+ const emitter = makeEmitter()
77
+ const dispatched: string[] = []
78
+ engine = new WorkflowEngine({
79
+ emitter,
80
+ dispatcher: makeDispatcher(async (tool) => {
81
+ dispatched.push(tool)
82
+ if (tool === "tool_b") throw new Error("boom")
83
+ return "ok"
84
+ }),
85
+ resolveRepos: async () => ["repo-1"],
86
+ })
87
+
88
+ await engine.run("wf-1", "ws-1", makeDef({ on_failure: "stop" }), "user-1")
89
+
90
+ const methods = emitter.calls.map((c: { method: string; args: unknown[] }) => c.method)
91
+ expect(methods).toContain("emitWorkflowStepFailed")
92
+ expect(methods).toContain("emitWorkflowFailed")
93
+ expect(methods).not.toContain("emitWorkflowCompleted")
94
+ // tool_b was attempted but failed; no further steps
95
+ expect(dispatched).toEqual(["tool_a", "tool_b"])
96
+ })
97
+
98
+ test("on_failure: continue — proceeds after failure", async () => {
99
+ const emitter = makeEmitter()
100
+ engine = new WorkflowEngine({
101
+ emitter,
102
+ dispatcher: makeDispatcher(async (tool) => {
103
+ if (tool === "tool_a") throw new Error("fail-a")
104
+ return "ok"
105
+ }),
106
+ resolveRepos: async () => ["repo-1"],
107
+ })
108
+
109
+ await engine.run("wf-1", "ws-1", makeDef({ on_failure: "continue" }), "user-1")
110
+
111
+ const methods = emitter.calls.map((c: { method: string; args: unknown[] }) => c.method)
112
+ expect(methods).toContain("emitWorkflowStepFailed")
113
+ expect(methods).toContain("emitWorkflowStepCompleted")
114
+ expect(methods).toContain("emitWorkflowCompleted")
115
+ expect(methods).not.toContain("emitWorkflowFailed")
116
+ })
117
+
118
+ test("on_failure: rollback — re-dispatches previous steps with _rollback", async () => {
119
+ const emitter = makeEmitter()
120
+ const dispatched: Array<{ tool: string; params: Record<string, unknown> }> = []
121
+ engine = new WorkflowEngine({
122
+ emitter,
123
+ dispatcher: makeDispatcher(async (tool, params) => {
124
+ dispatched.push({ tool, params })
125
+ if (tool === "tool_b" && !params._rollback) throw new Error("fail-b")
126
+ return "ok"
127
+ }),
128
+ resolveRepos: async () => ["repo-1"],
129
+ })
130
+
131
+ await engine.run("wf-1", "ws-1", makeDef({ on_failure: "rollback" }), "user-1")
132
+
133
+ // After tool_b fails, tool_a should be re-dispatched with _rollback: true
134
+ const rollbackCalls = dispatched.filter((d) => d.params._rollback === true)
135
+ expect(rollbackCalls.length).toBe(1)
136
+ expect(rollbackCalls[0].tool).toBe("tool_a")
137
+
138
+ const methods = emitter.calls.map((c: { method: string; args: unknown[] }) => c.method)
139
+ expect(methods).toContain("emitWorkflowStepFailed")
140
+ expect(methods).toContain("emitWorkflowFailed")
141
+ expect(methods).not.toContain("emitWorkflowCompleted")
142
+ })
143
+
144
+ test("cancel() aborts a running workflow", async () => {
145
+ const emitter = makeEmitter()
146
+ let resolveStep: (() => void) | undefined
147
+ const stepPromise = new Promise<void>((r) => {
148
+ resolveStep = r
149
+ })
150
+
151
+ engine = new WorkflowEngine({
152
+ emitter,
153
+ dispatcher: makeDispatcher(async (tool) => {
154
+ if (tool === "tool_a") {
155
+ await stepPromise
156
+ }
157
+ return "ok"
158
+ }),
159
+ resolveRepos: async () => ["repo-1"],
160
+ })
161
+
162
+ const def = makeDef()
163
+ const runPromise = engine.run("wf-1", "ws-1", def, "user-1")
164
+
165
+ // Wait for step_started to be emitted
166
+ await new Promise((r) => setTimeout(r, 10))
167
+
168
+ expect(engine.isRunning(runPromise as unknown as string)).toBe(false) // runId not returned yet
169
+ // Cancel using the emitted runId
170
+ const startedCall = emitter.calls.find((c: { method: string; args: unknown[] }) => c.method === "emitWorkflowStarted")
171
+ expect(startedCall).toBeDefined()
172
+ const runId = startedCall!.args[0] as string
173
+
174
+ expect(engine.isRunning(runId)).toBe(true)
175
+ await engine.cancel(runId, "ws-1")
176
+
177
+ // Unblock the step so the run can finish
178
+ resolveStep!()
179
+ await runPromise
180
+
181
+ const methods = emitter.calls.map((c: { method: string; args: unknown[] }) => c.method)
182
+ expect(methods).toContain("emitWorkflowCancelled")
183
+ })
184
+
185
+ test("target: all — dispatches each step per repo", async () => {
186
+ const emitter = makeEmitter()
187
+ const dispatched: Array<{ tool: string; params: Record<string, unknown> }> = []
188
+ engine = new WorkflowEngine({
189
+ emitter,
190
+ dispatcher: makeDispatcher(async (tool, params) => {
191
+ dispatched.push({ tool, params })
192
+ return "ok"
193
+ }),
194
+ resolveRepos: async () => ["repo-1", "repo-2"],
195
+ })
196
+
197
+ await engine.run("wf-1", "ws-1", makeDef({ target: "all" }), "user-1")
198
+
199
+ // Each step dispatched once per repo
200
+ const toolACalls = dispatched.filter((d) => d.tool === "tool_a")
201
+ expect(toolACalls.length).toBe(2)
202
+ expect(toolACalls.map((c) => c.params.repoId)).toEqual(["repo-1", "repo-2"])
203
+
204
+ // Events include repoId
205
+ const stepStarted = emitter.calls.filter((c: { method: string; args: unknown[] }) => c.method === "emitWorkflowStepStarted")
206
+ expect(stepStarted.length).toBe(4) // 2 steps × 2 repos
207
+ })
208
+
209
+ test("target: specific repoId — dispatches with that single repoId", async () => {
210
+ const emitter = makeEmitter()
211
+ const dispatched: Array<{ tool: string; params: Record<string, unknown> }> = []
212
+ engine = new WorkflowEngine({
213
+ emitter,
214
+ dispatcher: makeDispatcher(async (tool, params) => {
215
+ dispatched.push({ tool, params })
216
+ return "ok"
217
+ }),
218
+ resolveRepos: async () => {
219
+ throw new Error("should not be called")
220
+ },
221
+ })
222
+
223
+ await engine.run("wf-1", "ws-1", makeDef({ target: "my-repo" }), "user-1")
224
+
225
+ expect(dispatched.every((d) => d.params.repoId === "my-repo")).toBe(true)
226
+ expect(dispatched.length).toBe(2)
227
+ })
228
+
229
+ test("isRunning() returns true during run, false after", async () => {
230
+ const emitter = makeEmitter()
231
+ let capturedRunning = false
232
+
233
+ engine = new WorkflowEngine({
234
+ emitter,
235
+ dispatcher: makeDispatcher(async () => {
236
+ // Check isRunning mid-execution
237
+ const startCall = emitter.calls.find((c: { method: string; args: unknown[] }) => c.method === "emitWorkflowStarted")
238
+ if (startCall) {
239
+ capturedRunning = engine.isRunning(startCall.args[0] as string)
240
+ }
241
+ return "ok"
242
+ }),
243
+ resolveRepos: async () => ["repo-1"],
244
+ })
245
+
246
+ const runId = await engine.run("wf-1", "ws-1", makeDef(), "user-1")
247
+
248
+ expect(capturedRunning).toBe(true)
249
+ expect(engine.isRunning(runId)).toBe(false)
250
+ })
251
+ })
@@ -0,0 +1,169 @@
1
+ import { LOG_PREFIX } from "../shared/branding"
2
+ import type { WorkflowDefinition } from "../shared/workflow-types"
3
+
4
+ export interface McpDispatcher {
5
+ dispatch(tool: string, params: Record<string, unknown>): Promise<string>
6
+ }
7
+
8
+ export interface WorkflowEventEmitter {
9
+ emitWorkflowStarted(runId: string, workflowId: string, workspaceId: string, targetRepoIds: string[], triggeredBy: string): Promise<void>
10
+ emitWorkflowStepStarted(runId: string, workspaceId: string, stepIndex: number, mcpTool: string, repoId?: string): Promise<void>
11
+ emitWorkflowStepCompleted(runId: string, workspaceId: string, stepIndex: number, output: string, repoId?: string): Promise<void>
12
+ emitWorkflowStepFailed(runId: string, workspaceId: string, stepIndex: number, error: string, repoId?: string): Promise<void>
13
+ emitWorkflowCompleted(runId: string, workspaceId: string): Promise<void>
14
+ emitWorkflowFailed(runId: string, workspaceId: string, error: string, failedStep: number): Promise<void>
15
+ emitWorkflowCancelled(runId: string, workspaceId: string): Promise<void>
16
+ }
17
+
18
+ export interface WorkflowEngineOptions {
19
+ emitter: WorkflowEventEmitter
20
+ dispatcher: McpDispatcher
21
+ resolveRepos(workspaceId: string): Promise<string[]>
22
+ onProgress?: () => void
23
+ }
24
+
25
+ export class WorkflowEngine {
26
+ private readonly activeRuns = new Map<string, AbortController>()
27
+
28
+ constructor(private readonly opts: WorkflowEngineOptions) {}
29
+
30
+ /**
31
+ * Start a workflow run. Returns the runId immediately after emitting
32
+ * workflow_started. Step execution continues in the background.
33
+ */
34
+ async start(
35
+ workflowId: string,
36
+ workspaceId: string,
37
+ definition: WorkflowDefinition,
38
+ triggeredBy: string,
39
+ ): Promise<string> {
40
+ const runId = crypto.randomUUID()
41
+ const controller = new AbortController()
42
+ this.activeRuns.set(runId, controller)
43
+
44
+ const targetRepoIds =
45
+ definition.target === "all"
46
+ ? await this.opts.resolveRepos(workspaceId)
47
+ : [definition.target]
48
+
49
+ await this.opts.emitter.emitWorkflowStarted(runId, workflowId, workspaceId, targetRepoIds, triggeredBy)
50
+ this.opts.onProgress?.()
51
+
52
+ // Execute steps in background
53
+ this.executeSteps(runId, workspaceId, definition, targetRepoIds, controller).catch((err: unknown) => {
54
+ console.warn(LOG_PREFIX, `workflow ${runId} failed unexpectedly: ${err instanceof Error ? err.message : String(err)}`)
55
+ })
56
+
57
+ return runId
58
+ }
59
+
60
+ /**
61
+ * Run a workflow synchronously (all steps awaited). Used in tests.
62
+ */
63
+ async run(
64
+ workflowId: string,
65
+ workspaceId: string,
66
+ definition: WorkflowDefinition,
67
+ triggeredBy: string,
68
+ ): Promise<string> {
69
+ const runId = crypto.randomUUID()
70
+ const controller = new AbortController()
71
+ this.activeRuns.set(runId, controller)
72
+
73
+ const targetRepoIds =
74
+ definition.target === "all"
75
+ ? await this.opts.resolveRepos(workspaceId)
76
+ : [definition.target]
77
+
78
+ await this.opts.emitter.emitWorkflowStarted(runId, workflowId, workspaceId, targetRepoIds, triggeredBy)
79
+
80
+ await this.executeSteps(runId, workspaceId, definition, targetRepoIds, controller)
81
+
82
+ return runId
83
+ }
84
+
85
+ private async executeSteps(
86
+ runId: string,
87
+ workspaceId: string,
88
+ definition: WorkflowDefinition,
89
+ targetRepoIds: string[],
90
+ controller: AbortController,
91
+ ): Promise<void> {
92
+ const repos = targetRepoIds.length > 0 ? targetRepoIds : [undefined]
93
+
94
+ try {
95
+ for (let stepIdx = 0; stepIdx < definition.steps.length; stepIdx++) {
96
+ if (controller.signal.aborted) break
97
+
98
+ const step = definition.steps[stepIdx]
99
+
100
+ for (const repoId of repos) {
101
+ if (controller.signal.aborted) break
102
+
103
+ await this.opts.emitter.emitWorkflowStepStarted(runId, workspaceId, stepIdx, step.mcp_tool, repoId)
104
+ this.opts.onProgress?.()
105
+
106
+ try {
107
+ const params: Record<string, unknown> = { ...step.params, ...(repoId ? { repoId } : {}) }
108
+ const output = await this.opts.dispatcher.dispatch(step.mcp_tool, params)
109
+ await this.opts.emitter.emitWorkflowStepCompleted(runId, workspaceId, stepIdx, output, repoId)
110
+ this.opts.onProgress?.()
111
+ } catch (err: unknown) {
112
+ const errorMsg = err instanceof Error ? err.message : String(err)
113
+ await this.opts.emitter.emitWorkflowStepFailed(runId, workspaceId, stepIdx, errorMsg, repoId)
114
+ this.opts.onProgress?.()
115
+
116
+ if (definition.on_failure === "stop") {
117
+ await this.opts.emitter.emitWorkflowFailed(runId, workspaceId, errorMsg, stepIdx)
118
+ this.opts.onProgress?.()
119
+ return
120
+ }
121
+
122
+ if (definition.on_failure === "rollback") {
123
+ for (let rb = stepIdx - 1; rb >= 0; rb--) {
124
+ const rbStep = definition.steps[rb]
125
+ for (const rbRepo of repos) {
126
+ const rbParams: Record<string, unknown> = {
127
+ ...rbStep.params,
128
+ ...(rbRepo ? { repoId: rbRepo } : {}),
129
+ _rollback: true,
130
+ }
131
+ try {
132
+ await this.opts.dispatcher.dispatch(rbStep.mcp_tool, rbParams)
133
+ } catch {
134
+ // Best-effort rollback — ignore errors
135
+ }
136
+ }
137
+ }
138
+ await this.opts.emitter.emitWorkflowFailed(runId, workspaceId, errorMsg, stepIdx)
139
+ this.opts.onProgress?.()
140
+ return
141
+ }
142
+
143
+ // on_failure === "continue": proceed
144
+ }
145
+ }
146
+ }
147
+
148
+ if (!controller.signal.aborted) {
149
+ await this.opts.emitter.emitWorkflowCompleted(runId, workspaceId)
150
+ this.opts.onProgress?.()
151
+ }
152
+ } finally {
153
+ this.activeRuns.delete(runId)
154
+ }
155
+ }
156
+
157
+ async cancel(runId: string, workspaceId: string): Promise<void> {
158
+ const controller = this.activeRuns.get(runId)
159
+ if (!controller) return
160
+ controller.abort()
161
+ this.activeRuns.delete(runId)
162
+ await this.opts.emitter.emitWorkflowCancelled(runId, workspaceId)
163
+ this.opts.onProgress?.()
164
+ }
165
+
166
+ isRunning(runId: string): boolean {
167
+ return this.activeRuns.has(runId)
168
+ }
169
+ }
@@ -0,0 +1,49 @@
1
+ import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk"
2
+ import { z } from "zod/v4"
3
+ import type { WorkflowEngine } from "./workflow-engine"
4
+ import type { WorkflowStore } from "./workflow-store"
5
+
6
+ function json(data: unknown) {
7
+ return { content: [{ type: "text" as const, text: JSON.stringify(data) }] }
8
+ }
9
+
10
+ export function createWorkflowMcpServer(engine: WorkflowEngine, store: WorkflowStore) {
11
+ return createSdkMcpServer({
12
+ name: "workflow",
13
+ tools: [
14
+ tool(
15
+ "workflow_list",
16
+ "List available workflows in this workspace",
17
+ { workspaceId: z.string() },
18
+ async () => json(await store.list()),
19
+ ),
20
+ tool(
21
+ "workflow_run",
22
+ "Execute a workflow by ID",
23
+ {
24
+ workspaceId: z.string(),
25
+ workflowId: z.string(),
26
+ triggeredBy: z.string().optional(),
27
+ },
28
+ async (args) => {
29
+ const def = await store.get(args.workflowId)
30
+ if (!def) return json({ error: "workflow not found" })
31
+ const runId = await engine.start(args.workflowId, args.workspaceId, def, args.triggeredBy ?? "agent")
32
+ return json({ runId })
33
+ },
34
+ ),
35
+ tool(
36
+ "workflow_cancel",
37
+ "Cancel an active workflow run",
38
+ {
39
+ workspaceId: z.string(),
40
+ runId: z.string(),
41
+ },
42
+ async (args) => {
43
+ await engine.cancel(args.runId, args.workspaceId)
44
+ return json({ ok: true })
45
+ },
46
+ ),
47
+ ],
48
+ })
49
+ }