@desplega.ai/agent-swarm 2.7.7 → 2.7.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 (401) hide show
  1. package/dist/acp-adapter-dn4gdsgr.js +16 -0
  2. package/dist/{actions-3tt153af.js → actions-g563mbn2.js} +19 -19
  3. package/dist/{amp-adapter-njpts0yr.js → amp-adapter-q61w05eb.js} +3 -3
  4. package/dist/{anthropic-messages-xey2skwx.js → anthropic-messages-jkva0zps.js} +68 -78
  5. package/dist/{app-nky4378f.js → app-a66ssc4k.js} +3 -3
  6. package/dist/{assistant-jnb669pa.js → assistant-p477rjwj.js} +22 -22
  7. package/dist/{azure-openai-responses-26t7j9ra.js → azure-openai-responses-wgtqkbr3.js} +5 -10
  8. package/dist/boot-args-schema-h4qj462e.js +89 -0
  9. package/dist/{boot-reembed-9mgvaztt.js → boot-reembed-n1ehfbsw.js} +1 -1
  10. package/dist/{boot-reembed-qs2djdej.js → boot-reembed-qw4mc0pt.js} +1 -1
  11. package/dist/{boot-scrub-sweep-yjpdj7s1.js → boot-scrub-sweep-9w9jp4sm.js} +4 -4
  12. package/dist/{boot-seeds-5cm6ambd.js → boot-seeds-qdaf3sdy.js} +5 -4
  13. package/dist/{boxd-nv507va8.js → boxd-qbkxy6ap.js} +1 -1
  14. package/dist/{claude-adapter-fn287zmm.js → claude-adapter-348p5hx9.js} +8 -8
  15. package/dist/{claude-managed-adapter-dvs2xw5n.js → claude-managed-adapter-h74d06yz.js} +4 -4
  16. package/dist/{claude-managed-setup-wtdz2mj2.js → claude-managed-setup-7787fxtp.js} +5 -5
  17. package/dist/{claude-sdk-session-x91kqyhm.js → claude-sdk-session-hbszbt8a.js} +7901 -7718
  18. package/dist/{cli-cb2a8pna.js → cli-09kmfkmq.js} +4 -6
  19. package/dist/{cli-m0da8j35.js → cli-0whpms1z.js} +15 -10
  20. package/dist/{cli-5zx699j9.js → cli-12xyjhws.js} +29 -12
  21. package/dist/{cli-snpj5zbj.js → cli-1z4qggfe.js} +9 -36
  22. package/dist/{cli-e0kmphd6.js → cli-21159vea.js} +35 -12
  23. package/dist/{cli-s0qnd4wv.js → cli-28fq781p.js} +1 -1
  24. package/dist/{cli-qh4d4tvk.js → cli-2a8py3sx.js} +6 -6
  25. package/dist/{cli-adeegh7d.js → cli-2ccpqyyf.js} +412 -116
  26. package/dist/{cli-1p89xny0.js → cli-2r0jcc3k.js} +1 -1
  27. package/dist/{cli-rvtm68yy.js → cli-2xv18ywz.js} +2 -2
  28. package/dist/{cli-5xaqj21p.js → cli-3kd08rej.js} +1 -1
  29. package/dist/{cli-1c6tzt8g.js → cli-3tqcamp6.js} +13 -13
  30. package/dist/{cli-ae7mrdf9.js → cli-3vjhs18n.js} +4 -6
  31. package/dist/{cli-vfym7wmz.js → cli-3xcwp3z8.js} +10 -12
  32. package/dist/{cli-az48n0nr.js → cli-4caa1x7d.js} +67 -64
  33. package/dist/{cli-5jnhv72d.js → cli-4t0fmf3z.js} +30 -7
  34. package/dist/{cli-5b456bpf.js → cli-530hkwdy.js} +7 -9
  35. package/dist/{cli-pz4rk021.js → cli-54vrpgm0.js} +1 -1
  36. package/dist/{cli-ddaanqkd.js → cli-587857ys.js} +7 -7
  37. package/dist/{cli-r9jqcehk.js → cli-5mpy301f.js} +38 -2
  38. package/dist/{cli-cppkf404.js → cli-605nn699.js} +80 -43
  39. package/dist/{cli-6pfd54vx.js → cli-650zv9q9.js} +10 -10
  40. package/dist/cli-6pzk82fd.js +778 -0
  41. package/dist/{cli-gz6q4eve.js → cli-715t1gx6.js} +9 -9
  42. package/dist/{cli-08bmz9z9.js → cli-9aezs55w.js} +10 -12
  43. package/dist/{cli-tgrv9cjx.js → cli-9r5gtwjr.js} +3 -3
  44. package/dist/{cli-pc6n7fre.js → cli-a0657jmf.js} +2 -2
  45. package/dist/{cli-pjctyea3.js → cli-agyaeef4.js} +3 -3
  46. package/dist/cli-b932gexn.js +5266 -0
  47. package/dist/{cli-e46hg0xw.js → cli-bc779n4v.js} +3 -3
  48. package/dist/{cli-jtjtabxe.js → cli-btc9cb4c.js} +78 -5
  49. package/dist/{cli-caj33vcq.js → cli-btf6fw39.js} +5 -5
  50. package/dist/{cli-q3tkegby.js → cli-cseh6f8w.js} +5 -5
  51. package/dist/{cli-n6bv12jn.js → cli-cvs2r2vq.js} +23 -14
  52. package/dist/{cli-tfyyvzx6.js → cli-cyn9v8zr.js} +17 -2
  53. package/dist/{cli-a22h291q.js → cli-d6521kb5.js} +1 -1
  54. package/dist/{cli-1b7btd38.js → cli-d84byzn8.js} +869 -5
  55. package/dist/{cli-wx3rhnm0.js → cli-eddnyg3t.js} +1 -1
  56. package/dist/{cli-nmzhp1b5.js → cli-ejkvvqbe.js} +55 -46
  57. package/dist/{cli-ftyxyspd.js → cli-eqtfgfr6.js} +1 -1
  58. package/dist/{cli-mthwvjre.js → cli-f2zenhja.js} +1 -1
  59. package/dist/{cli-ws19768n.js → cli-fayav105.js} +624 -227
  60. package/dist/{cli-ferkkrg9.js → cli-fjggej24.js} +2 -2
  61. package/dist/{cli-g7s47cc5.js → cli-fsgttth8.js} +123 -102
  62. package/dist/{cli-8305gbq0.js → cli-gce09r66.js} +5 -5
  63. package/dist/{cli-mkk9rnzz.js → cli-gxy8y1dt.js} +51 -4
  64. package/dist/{cli-fyt2g4wd.js → cli-hae9j8sv.js} +288 -76
  65. package/dist/{cli-agfm16v9.js → cli-hg42n3hx.js} +12 -12
  66. package/dist/{cli-qghe0h66.js → cli-hwprv9e4.js} +8 -10
  67. package/dist/{cli-yndmfxb3.js → cli-hxpyc9sn.js} +3 -3
  68. package/dist/{cli-72v799xn.js → cli-jfx48xrj.js} +10 -12
  69. package/dist/{cli-dhar9qay.js → cli-jrp1dt73.js} +2 -2
  70. package/dist/{cli-98rw5dt5.js → cli-jrzkw01m.js} +2 -2
  71. package/dist/{cli-ayayvfg4.js → cli-k70e3x9e.js} +24 -20
  72. package/dist/{cli-583frbyr.js → cli-kchjb7qy.js} +1 -1
  73. package/dist/{cli-cm5yqn35.js → cli-kf3pxxdg.js} +1 -0
  74. package/dist/{cli-fmjd0t1y.js → cli-m0cy2vyf.js} +2 -2
  75. package/dist/{cli-4zsenjhy.js → cli-m5akxq8q.js} +16 -3
  76. package/dist/{cli-73jzwksr.js → cli-m88rpzkh.js} +6 -3
  77. package/dist/{cli-95jzxcp3.js → cli-mnrkgg60.js} +4 -4
  78. package/dist/{cli-p82cnnjq.js → cli-ms5m5r1y.js} +1 -1
  79. package/dist/{cli-fy6x31ps.js → cli-n5yexkdg.js} +1 -0
  80. package/dist/{cli-wk5yrfwd.js → cli-neyag5p6.js} +191 -85
  81. package/dist/cli-p0m0p34z.js +9321 -0
  82. package/dist/{cli-yyj3j5m4.js → cli-p17970qv.js} +8 -10
  83. package/dist/{cli-6vcp76qk.js → cli-p74md7t8.js} +42 -23
  84. package/dist/{cli-rjcbm574.js → cli-pr0eze3x.js} +2 -2
  85. package/dist/{cli-35rsp8ye.js → cli-qkdmz8c8.js} +1 -1
  86. package/dist/{cli-rtt8g4v9.js → cli-qmd3mse0.js} +2 -2
  87. package/dist/{cli-je518txm.js → cli-qzt90yze.js} +20 -20
  88. package/dist/cli-rkc97c6a.js +39 -0
  89. package/dist/{cli-75gkpjvw.js → cli-rvhdmjvt.js} +8 -12
  90. package/dist/{cli-6g0hb4cp.js → cli-rwymrnaz.js} +18608 -9089
  91. package/dist/{cli-3fg0bdcv.js → cli-serm8zrx.js} +6 -6
  92. package/dist/{cli-g08zdaec.js → cli-sgs5k6yd.js} +1 -1
  93. package/dist/{cli-afkqkrtw.js → cli-sya22y84.js} +21 -9
  94. package/dist/{cli-318r69gq.js → cli-t73cas91.js} +440 -9
  95. package/dist/{cli-e5bzrn01.js → cli-tqq0hspb.js} +2 -2
  96. package/dist/{cli-pq73h5mz.js → cli-v3cf1ts9.js} +3 -3
  97. package/dist/{cli-bfv7vdg6.js → cli-varqt4d1.js} +28 -16
  98. package/dist/{cli-k899ehvh.js → cli-vxh6acp7.js} +6 -6
  99. package/dist/{cli-g83s9ewh.js → cli-xfjrc279.js} +1 -1
  100. package/dist/{cli-k1nje3v3.js → cli-xk879m3k.js} +129 -115
  101. package/dist/{cli-7cx2m6t2.js → cli-y5rbvxhc.js} +2 -2
  102. package/dist/{cli-8sckt74b.js → cli-y8nbefpb.js} +41 -19
  103. package/dist/{cli-81p9jd57.js → cli-yab6sh8p.js} +9 -3
  104. package/dist/{cli-srye3vdt.js → cli-ybjdc978.js} +1 -1
  105. package/dist/{cli-k5671be5.js → cli-zcfpsfzf.js} +5 -5
  106. package/dist/{cli-vf078p3e.js → cli-zfqg6fzn.js} +1 -1
  107. package/dist/{cli-k8196sh2.js → cli-zgv8gxgs.js} +9 -8
  108. package/dist/cli.js +34 -52
  109. package/dist/{cloudflare-workers-ai-system-one-ef2a980q.js → cloudflare-workers-ai-system-one-9y1zx3pt.js} +2 -2
  110. package/dist/{codex-adapter-cf2yxe9m.js → codex-adapter-ysq6bzha.js} +7 -7
  111. package/dist/{codex-hook-a0c6g6t6.js → codex-hook-fac6175r.js} +1 -1
  112. package/dist/{codex-login-y0pmff1c.js → codex-login-bcda78ge.js} +2 -2
  113. package/dist/{codex-session-runner-6vfzdgbd.js → codex-session-runner-qakzfx93.js} +8 -8
  114. package/dist/{commands-t3mfy7vn.js → commands-rs7hkv9r.js} +3 -3
  115. package/dist/{controller-q7xrbaz0.js → controller-r5x9bg6e.js} +4 -4
  116. package/dist/{controllers-connect-c6nm70kg.js → controllers-connect-498hrxvk.js} +24 -24
  117. package/dist/{cursor-adapter-ftd81ga8.js → cursor-adapter-d46qszer.js} +2 -2
  118. package/dist/{db-vemtpmcc.js → db-pm96nhdb.js} +6 -2
  119. package/dist/{db-dk572x25.js → db-s13dqhr6.js} +3 -3
  120. package/dist/{devin-adapter-r9phbnc9.js → devin-adapter-z46ep5ph.js} +1 -1
  121. package/dist/{dispatcher-kh7ecxh9.js → dispatcher-j3h81t7m.js} +18 -18
  122. package/dist/{docker-c1a3gqmf.js → docker-866qpzt9.js} +2 -2
  123. package/dist/{dsh-adapter-v8628r89.js → dsh-adapter-rw0d5rc4.js} +2 -2
  124. package/dist/{e2b-fr12yccx.js → e2b-jkwfhbcv.js} +2 -2
  125. package/dist/{e2b-x6ywzak3.js → e2b-s16txnpx.js} +2 -3
  126. package/dist/{easter-egg-3d-nenw4x63.js → easter-egg-3d-qtgfxgze.js} +1 -1
  127. package/dist/{embedding-space-0jepb239.js → embedding-space-xh8p4q4x.js} +6 -6
  128. package/dist/{embeddings-xxt49yxg.js → embeddings-wp745m91.js} +1 -1
  129. package/dist/{event-bus-g0ka3pbw.js → event-bus-e66gh7cc.js} +1 -1
  130. package/dist/{execute-1mhw6e4x.js → execute-2fzb9z74.js} +1 -1
  131. package/dist/{external-channel-55v12e60.js → external-channel-ys21h3sy.js} +2 -2
  132. package/dist/fx-adapter-vz0b9z3g.js +19 -0
  133. package/dist/{google-generative-ai-v94hr7h0.js → google-generative-ai-ytpgncx9.js} +7 -12
  134. package/dist/{google-vertex-g7vr6cf8.js → google-vertex-tqhze5j7.js} +7 -12
  135. package/dist/grok-adapter-spea7zkj.js +19 -0
  136. package/dist/handlers-crckt5dq.js +32 -0
  137. package/dist/{heartbeat-k42svnr0.js → heartbeat-8phn1kdq.js} +21 -21
  138. package/dist/{hook-6nphweh0.js → hook-amcj4s10.js} +16 -11
  139. package/dist/{hook-114m7hap.js → hook-bc6n49qn.js} +5 -5
  140. package/dist/{http-r8cc4wz7.js → http-7374brv5.js} +854 -332
  141. package/dist/index-4x08sjtk.js +30 -0
  142. package/dist/{index-6cxzwfen.js → index-5a9jtqde.js} +26 -26
  143. package/dist/index-8ybffts4.js +37 -0
  144. package/dist/{index-nh3wyqdt.js → index-c9y31ytf.js} +16 -16
  145. package/dist/{index-h39zbx67.js → index-hsad2t3r.js} +31 -31
  146. package/dist/index-nfy4kkg5.js +33 -0
  147. package/dist/{index-e3s8wmxy.js → index-p4hjwbvw.js} +1 -1
  148. package/dist/{index-k7fj52d3.js → index-q5cmtbz5.js} +6 -6
  149. package/dist/{index-fpk4bcd9.js → index-w4m9z29z.js} +1 -1
  150. package/dist/{keepalive-x060nt9p.js → keepalive-wy29kbrg.js} +4 -4
  151. package/dist/lead-zdqxsvjn.js +71 -0
  152. package/dist/{llama-cpp-classify-s5c47rwh.js → llama-cpp-classify-nfgswa1m.js} +2 -2
  153. package/dist/{maintenance-2xxfexhf.js → maintenance-h2ds9w6c.js} +1 -1
  154. package/dist/{mistral-conversations-3gjpdb4b.js → mistral-conversations-a45tx39a.js} +29 -51
  155. package/dist/{oauth-refresh-sweep-fckc4ar5.js → oauth-refresh-sweep-q7mtbyp3.js} +3 -3
  156. package/dist/{onboard-zc48j237.js → onboard-vw8r2fdw.js} +68 -16
  157. package/dist/{openai-codex-responses-8pbxq9h5.js → openai-codex-responses-k9gapdze.js} +7 -11
  158. package/dist/{openai-completions-rm00s912.js → openai-completions-xd579js7.js} +50 -58
  159. package/dist/{openai-decisions-8v957r2r.js → openai-decisions-q3hh60wr.js} +2 -2
  160. package/dist/{openai-responses-agxpf96k.js → openai-responses-4d5dx3c7.js} +5 -10
  161. package/dist/{opencode-adapter-r690h1cr.js → opencode-adapter-mtb0953j.js} +6 -6
  162. package/dist/{openrouter-images-3ecegv0d.js → openrouter-images-xr9gme9x.js} +4 -3
  163. package/dist/{otel-impl-r5xbh81q.js → otel-impl-j42czw3r.js} +2 -2
  164. package/dist/{pi-messages-pchtw4he.js → pi-messages-hjbv8v10.js} +28 -12
  165. package/dist/{pi-mono-adapter-c7v8sdec.js → pi-mono-adapter-zk8pg9jr.js} +30 -27
  166. package/dist/{pricing-refresh-3pmre11v.js → pricing-refresh-x7nhv23d.js} +3 -3
  167. package/dist/{rbac-roles-3vbshwsb.js → rbac-roles-9044425x.js} +16 -2
  168. package/dist/rbac-roles-bzvee6cf.js +37 -0
  169. package/dist/{render-v2-pxykkbab.js → render-v2-t7bn4skz.js} +3 -3
  170. package/dist/{resume-adda0bwy.js → resume-x94gemep.js} +7 -7
  171. package/dist/{runtime-fnbm7stk.js → runtime-breq6fmv.js} +1 -1
  172. package/dist/{session-access-2fvamrdc.js → session-access-q7dmqjvt.js} +7 -5
  173. package/dist/{session-source-backfill-08xvv0sm.js → session-source-backfill-440ysamr.js} +3 -3
  174. package/dist/{setup-1aqmvmh1.js → setup-07n4727s.js} +1 -1
  175. package/dist/{typesafe-system-one-0bmqcxfg.js → typesafe-system-one-f2en2knd.js} +2 -2
  176. package/dist/virtual-modules-z5h6mcyf.js +362 -0
  177. package/dist/{work-objects-9s0yrm5j.js → work-objects-pnq5y534.js} +21 -21
  178. package/dist/{worker-follow-up-3q78fqmr.js → worker-follow-up-7z1gfkr8.js} +18 -18
  179. package/dist/worker-y62rvvq3.js +71 -0
  180. package/dist/{x-vmmye1kb.js → x-2fyrt5pp.js} +2 -2
  181. package/openapi.json +1268 -276
  182. package/package.json +10 -10
  183. package/src/apps/catalog.generated.json +299 -82
  184. package/src/apps/page-validator.ts +115 -2
  185. package/src/be/connector-codes.ts +21 -6
  186. package/src/be/db/model-profiles.ts +1 -1
  187. package/src/be/db/session-tree.ts +9 -5
  188. package/src/be/db/session-visibility.ts +25 -9
  189. package/src/be/db/tasks/read.ts +33 -6
  190. package/src/be/db/tasks/write.ts +77 -7
  191. package/src/be/db-queries/tracker.ts +4 -2
  192. package/src/be/db.ts +53 -19
  193. package/src/be/improvements.ts +416 -0
  194. package/src/be/migrations/271_subscription_usage_model.sql +30 -0
  195. package/src/be/migrations/274_improvements.sql +27 -0
  196. package/src/be/migrations/275_task_dispatched_by.sql +8 -0
  197. package/src/be/model-validation.ts +19 -1
  198. package/src/be/rbac-roles.ts +144 -1
  199. package/src/be/runtime-pools/routing.ts +1 -1
  200. package/src/be/scripts/boot-args-schema.ts +95 -0
  201. package/src/be/scripts/extract-schema.ts +15 -10
  202. package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -1
  203. package/src/be/seed-scripts/catalog/boot-triage.ts +1 -1
  204. package/src/be/seed-scripts/catalog/get-child-outputs.ts +1 -1
  205. package/src/be/seed-scripts/catalog/wait-for-task.ts +1 -1
  206. package/src/be/swarm-config-guard.ts +8 -0
  207. package/src/be/users.ts +64 -5
  208. package/src/cli.tsx +5 -25
  209. package/src/commands/claude-managed-setup.ts +1 -1
  210. package/src/commands/codex-login.ts +1 -1
  211. package/src/commands/e2b.ts +0 -1
  212. package/src/commands/onboard/agent-fs-version.ts +1 -1
  213. package/src/commands/onboard/compose-generator.ts +0 -1
  214. package/src/commands/onboard/dashboard-url.ts +31 -0
  215. package/src/commands/onboard/steps/generate.tsx +17 -1
  216. package/src/commands/onboard/steps/post-dashboard.tsx +9 -3
  217. package/src/commands/onboard.tsx +19 -6
  218. package/src/commands/runner.ts +143 -105
  219. package/src/extensions/contract-types.generated.ts +1 -1
  220. package/src/hooks/hook.ts +13 -5
  221. package/src/http/agents.ts +7 -1
  222. package/src/http/all-routes.ts +1 -0
  223. package/src/http/approval-requests.ts +32 -50
  224. package/src/http/auth.ts +5 -4
  225. package/src/http/codex-oauth-accounts.ts +31 -23
  226. package/src/http/codex-oauth-device.ts +3 -3
  227. package/src/http/codex-oauth-keep-warm.ts +1 -1
  228. package/src/http/improvements.ts +317 -0
  229. package/src/http/index.ts +10 -0
  230. package/src/http/mcp-oauth.ts +6 -0
  231. package/src/http/mcp-servers.ts +8 -0
  232. package/src/http/models-catalog.ts +1 -1
  233. package/src/http/operator-actor.ts +2 -1
  234. package/src/http/pages-public.ts +38 -1
  235. package/src/http/person-responder.ts +66 -0
  236. package/src/http/poll.ts +3 -4
  237. package/src/http/prompt-templates.ts +1 -1
  238. package/src/http/schedules.ts +4 -0
  239. package/src/http/script-runs.ts +6 -1
  240. package/src/http/session-access.ts +61 -6
  241. package/src/http/sessions.ts +67 -9
  242. package/src/http/tasks.ts +53 -9
  243. package/src/http/user-roles.ts +11 -2
  244. package/src/http/users.ts +224 -105
  245. package/src/http/utils.ts +2 -1
  246. package/src/http/workflows.ts +11 -7
  247. package/src/prompts/session-templates.ts +1 -0
  248. package/src/providers/acp-targets.ts +1 -1
  249. package/src/providers/amp-adapter.ts +1 -1
  250. package/src/providers/codex-adapter.ts +17 -3
  251. package/src/providers/codex-models.ts +4 -3
  252. package/src/providers/codex-oauth/auth-json.ts +14 -18
  253. package/src/providers/codex-oauth/device.ts +49 -15
  254. package/src/providers/codex-oauth/flow.ts +2 -1
  255. package/src/providers/codex-oauth/storage.ts +2 -2
  256. package/src/providers/pi-mono-adapter.ts +8 -0
  257. package/src/providers/pricing-sources.md +16 -1
  258. package/src/providers/swarm-events-shared.ts +15 -2
  259. package/src/rbac/legacy-policy.ts +3 -0
  260. package/src/rbac/permissions.ts +15 -0
  261. package/src/scheduler/deferred-task-waits.ts +9 -4
  262. package/src/scripts-runtime/extract-args-schema.ts +3 -1
  263. package/src/scripts-runtime/swarm-sdk.ts +1 -1
  264. package/src/scripts-runtime/types/swarm-extension.d.ts +31 -28
  265. package/src/server-user.ts +1 -1
  266. package/src/server.ts +2 -0
  267. package/src/slack/ack.ts +68 -26
  268. package/src/slack/blocks.ts +1 -0
  269. package/src/slack/reaction-shortcode.ts +8 -2
  270. package/src/slack/render-v2.ts +72 -20
  271. package/src/slack/task-output.ts +4 -1
  272. package/src/slack/thread-buffer.ts +2 -2
  273. package/src/tasks/task-skip.ts +28 -0
  274. package/src/tasks/terminal-result-guard.ts +3 -2
  275. package/src/telemetry.ts +28 -1
  276. package/src/tests/agentmail-inbox-mapping.test.ts +73 -0
  277. package/src/tests/api-drain-worker-e2e.test.ts +69 -2
  278. package/src/tests/approval-requests.test.ts +58 -0
  279. package/src/tests/apps-catalog-drift.test.ts +35 -0
  280. package/src/tests/apps-catalog-table.test.ts +203 -0
  281. package/src/tests/apps-element-assembly.test.ts +28 -0
  282. package/src/tests/apps-smart-links.test.ts +151 -0
  283. package/src/tests/apps-table-filters-migration.test.ts +96 -0
  284. package/src/tests/apps-table-selection-migration.test.ts +95 -0
  285. package/src/tests/chatgpt-subscription-session-bench.test.ts +2 -2
  286. package/src/tests/claude-managed-setup.test.ts +36 -0
  287. package/src/tests/claude-worker-parity.test.ts +2 -2
  288. package/src/tests/codex-adapter.test.ts +32 -2
  289. package/src/tests/codex-login.test.ts +2 -2
  290. package/src/tests/codex-oauth-accounts.test.ts +48 -12
  291. package/src/tests/codex-oauth-credential-info.test.ts +77 -1
  292. package/src/tests/codex-oauth-device.test.ts +61 -1
  293. package/src/tests/codex-oauth-keep-warm.test.ts +2 -2
  294. package/src/tests/codex-oauth.test.ts +25 -4
  295. package/src/tests/codex-pool.test.ts +2 -2
  296. package/src/tests/codex-swarm-events.test.ts +43 -1
  297. package/src/tests/context-window.test.ts +14 -0
  298. package/src/tests/db-queries-tracker.test.ts +2 -1
  299. package/src/tests/db-task-read-contract.test.ts +3 -0
  300. package/src/tests/db-task-write-contract.test.ts +3 -0
  301. package/src/tests/deferred-task-wake.test.ts +7 -2
  302. package/src/tests/deploy-one-box.test.ts +39 -1
  303. package/src/tests/docs-index-footprint.test.js +3 -3
  304. package/src/tests/e2e-coverage-contract.test.ts +235 -0
  305. package/src/tests/empty-output-schema.test.ts +160 -0
  306. package/src/tests/env-flag.test.ts +1 -0
  307. package/src/tests/explicit-model-validation.test.ts +14 -0
  308. package/src/tests/fixtures/onboard/content.compose.yml.txt +0 -4
  309. package/src/tests/fixtures/onboard/dev.compose.yml.txt +0 -3
  310. package/src/tests/fixtures/onboard/full-all.compose.yml.txt +0 -11
  311. package/src/tests/fixtures/onboard/full.compose.yml.txt +0 -11
  312. package/src/tests/fixtures/onboard/research.compose.yml.txt +0 -3
  313. package/src/tests/fixtures/onboard/solo.compose.yml.txt +0 -1
  314. package/src/tests/fixtures/prs-app-definition.json.txt +784 -0
  315. package/src/tests/fixtures/prs-filters-migration.patch.json.txt +318 -0
  316. package/src/tests/fixtures/prs-selection-migration.patch.json.txt +373 -0
  317. package/src/tests/fixtures/runner-identity-refresh.ts +3 -0
  318. package/src/tests/fixtures/runner-legacy-resume-prompt.ts +3 -0
  319. package/src/tests/fixtures/runner-task-start-reads.ts +140 -0
  320. package/src/tests/hook-ping-me-order.test.ts +85 -0
  321. package/src/tests/http-api-integration.test.ts +2 -2
  322. package/src/tests/http-users.test.ts +63 -0
  323. package/src/tests/improvements-payload.test.ts +200 -0
  324. package/src/tests/improvements-route.test.ts +419 -0
  325. package/src/tests/install-sh-setup-url.test.ts +190 -0
  326. package/src/tests/mcp-input-caps.test.ts +4 -3
  327. package/src/tests/merge-gate-detect-changes.test.ts +22 -0
  328. package/src/tests/onboard-dashboard-output.test.ts +109 -0
  329. package/src/tests/onboard-dashboard-url.test.ts +83 -0
  330. package/src/tests/operator-granted-credentials.test.ts +561 -0
  331. package/src/tests/operator-granted-role-wire.test.ts +222 -0
  332. package/src/tests/pages-authed-mode.test.ts +13 -2
  333. package/src/tests/pi-mono-adapter.test.ts +39 -4
  334. package/src/tests/rbac-engine.test.ts +3 -0
  335. package/src/tests/runner-context-usage.test.ts +118 -0
  336. package/src/tests/runner-legacy-options.test.ts +55 -0
  337. package/src/tests/runner-slot-reconcile.test.ts +38 -0
  338. package/src/tests/runner-task-start-reads.test.ts +58 -0
  339. package/src/tests/script-connections.test.ts +2 -0
  340. package/src/tests/script-executor-quickjs.test.ts +2 -0
  341. package/src/tests/script-runs-http.test.ts +57 -0
  342. package/src/tests/scripts-boot-args-schema.test.ts +181 -0
  343. package/src/tests/scripts-runtime.test.ts +24 -0
  344. package/src/tests/sdk-store-progress-skipped.test.ts +155 -0
  345. package/src/tests/send-task-dispatched-by.test.ts +129 -0
  346. package/src/tests/session-costs-model-key-normalize.test.ts +59 -0
  347. package/src/tests/session-dispatched-tasks.test.ts +115 -0
  348. package/src/tests/session-sharing.test.ts +402 -3
  349. package/src/tests/slack-file-tools-attachments.test.ts +95 -3
  350. package/src/tests/slack-reaction-config.test.ts +40 -0
  351. package/src/tests/slack-render-v2.test.ts +120 -0
  352. package/src/tests/slack-skip-reaction.test.ts +203 -0
  353. package/src/tests/store-progress-skipped.test.ts +159 -0
  354. package/src/tests/submit-improvement-tool.test.ts +82 -0
  355. package/src/tests/subscription-usage-migration.test.ts +57 -0
  356. package/src/tests/swarm-config-reserved-keys.test.ts +3 -0
  357. package/src/tests/telemetry-endpoint-override.test.ts +27 -0
  358. package/src/tests/tool-annotations.test.ts +1 -1
  359. package/src/tests/trigger-claiming.test.ts +2 -0
  360. package/src/tests/workflow-system-one-extraction.test.ts +29 -0
  361. package/src/tools/create-channel.ts +1 -1
  362. package/src/tools/defer-task.ts +1 -1
  363. package/src/tools/manage-user.ts +88 -58
  364. package/src/tools/register-agentmail-inbox.ts +5 -0
  365. package/src/tools/repos/update-repo.ts +1 -1
  366. package/src/tools/request-human-input.ts +1 -1
  367. package/src/tools/send-task.ts +4 -1
  368. package/src/tools/slack-read.ts +61 -33
  369. package/src/tools/store-progress.ts +39 -8
  370. package/src/tools/submit-improvement.ts +68 -0
  371. package/src/tools/tool-config.ts +3 -0
  372. package/src/tools/tracker/tracker-unlink.ts +2 -1
  373. package/src/tools/workflows/retry-workflow-run.ts +3 -0
  374. package/src/types.ts +16 -2
  375. package/src/utils/context-window.ts +6 -1
  376. package/src/utils/output-schema.ts +23 -0
  377. package/src/utils/request-auth-context.ts +6 -1
  378. package/src/workflows/executors/system-one-providers.ts +25 -6
  379. package/src/workflows/recovery.ts +8 -4
  380. package/src/workflows/resume.ts +19 -0
  381. package/templates/skills/apps/SKILL.md +22 -11
  382. package/templates/skills/apps/content.md +22 -11
  383. package/templates/skills/swarm-scripts/SKILL.md +1 -1
  384. package/templates/skills/swarm-scripts/content.md +1 -1
  385. package/templates/skills/work-on-task/SKILL.md +1 -1
  386. package/templates/skills/work-on-task/content.md +1 -1
  387. package/dist/acp-adapter-7b4vk3h5.js +0 -16
  388. package/dist/cli-5c4hjzne.js +0 -873
  389. package/dist/cli-excnnjg2.js +0 -20222
  390. package/dist/cli-pc5znp64.js +0 -364
  391. package/dist/cli-vz22fyqv.js +0 -428
  392. package/dist/fx-adapter-bs8wqrk5.js +0 -19
  393. package/dist/grok-adapter-gpjqmkcq.js +0 -19
  394. package/dist/handlers-zxmp1ta4.js +0 -32
  395. package/dist/index-a8phxqnk.js +0 -37
  396. package/dist/index-k6h00t4c.js +0 -30
  397. package/dist/index-xrz7te8h.js +0 -33
  398. package/dist/lead-956sd2yc.js +0 -71
  399. package/dist/rbac-roles-910mmkgz.js +0 -26
  400. package/dist/virtual-modules-d2pjk9j1.js +0 -59
  401. package/dist/worker-y15hy08h.js +0 -71
@@ -18,6 +18,8 @@ import type { AgentTask } from "@/types";
18
18
  * deployment mounts the shared volume there.
19
19
  */
20
20
  const AUTO_DOWNLOAD_DIR = "/app/shared/downloads/slack";
21
+ /** Parallel users.info calls per slack-read (Slack Tier 4, so a small cap is enough). */
22
+ const USERS_INFO_CONCURRENCY = 4;
21
23
 
22
24
  const SlackFileSchema = z.looseObject({
23
25
  id: z.string().optional(),
@@ -204,43 +206,69 @@ export const registerSlackReadTool = (server: McpServer) => {
204
206
  blocks?: unknown[];
205
207
  };
206
208
 
207
- let rawMessages: RawMessage[] = [];
208
-
209
- if (slackThreadTs) {
210
- // Fetch thread replies — auto-join public channels on not_in_channel
211
- const result = await withAutoJoin(client, slackChannelId, () =>
212
- client.conversations.replies({ channel: slackChannelId, ts: slackThreadTs!, limit }),
213
- );
214
- rawMessages = (result.messages || []) as RawMessage[];
215
- } else {
216
- // Fetch channel history — auto-join public channels on not_in_channel
217
- const result = await withAutoJoin(client, slackChannelId, () =>
218
- client.conversations.history({ channel: slackChannelId, limit }),
219
- );
220
- rawMessages = (result.messages || []) as RawMessage[];
221
- }
222
-
223
- // Get bot user ID for identification
224
- const authResult = await client.auth.test();
225
- const botUserId = authResult.user_id as string;
226
-
227
- // Cache for user display names
228
- const userNameCache = new Map<string, string>();
229
-
230
- async function getUserDisplayName(userId: string): Promise<string> {
231
- if (userNameCache.has(userId)) {
232
- return userNameCache.get(userId)!;
233
- }
234
- try {
235
- const result = await client.users.info({ user: userId });
236
- const name = result.user?.profile?.display_name || result.user?.real_name || userId;
209
+ // The bot user id (for identification) does not depend on the messages,
210
+ // so auth.test runs alongside the history read. allSettled, not all:
211
+ // an early auth.test failure must not return while withAutoJoin can
212
+ // still join the channel, and a history error keeps precedence over an
213
+ // auth error, as when the two ran in sequence.
214
+ const [fetchedSettled, authSettled] = await Promise.allSettled([
215
+ slackThreadTs
216
+ ? // Fetch thread replies — auto-join public channels on not_in_channel
217
+ withAutoJoin(client, slackChannelId, () =>
218
+ client.conversations.replies({ channel: slackChannelId, ts: slackThreadTs, limit }),
219
+ )
220
+ : // Fetch channel history — auto-join public channels on not_in_channel
221
+ withAutoJoin(client, slackChannelId, () =>
222
+ client.conversations.history({ channel: slackChannelId, limit }),
223
+ ),
224
+ client.auth.test(),
225
+ ]);
226
+ if (fetchedSettled.status === "rejected") throw fetchedSettled.reason;
227
+ if (authSettled.status === "rejected") throw authSettled.reason;
228
+ const rawMessages = (fetchedSettled.value.messages || []) as RawMessage[];
229
+ const botUserId = authSettled.value.user_id as string;
230
+
231
+ // One users.info per distinct user, shared by every message they wrote.
232
+ const userNameCache = new Map<string, Promise<string>>();
233
+
234
+ function getUserDisplayName(userId: string): Promise<string> {
235
+ let name = userNameCache.get(userId);
236
+ if (!name) {
237
+ name = client.users
238
+ .info({ user: userId })
239
+ .then(
240
+ (result) => result.user?.profile?.display_name || result.user?.real_name || userId,
241
+ )
242
+ .catch(() => userId);
237
243
  userNameCache.set(userId, name);
238
- return name;
239
- } catch {
240
- return userId;
241
244
  }
245
+ return name;
242
246
  }
243
247
 
248
+ // Resolve the human authors up front, a few at a time, instead of one
249
+ // round trip per author inside the formatting loop below.
250
+ const authorIds = [
251
+ ...new Set(
252
+ rawMessages.flatMap((m) =>
253
+ m.user &&
254
+ m.user !== botUserId &&
255
+ m.bot_id === undefined &&
256
+ m.subtype !== "bot_message" &&
257
+ // Same filter as the loop below: skipped messages need no name.
258
+ (extractSlackMessageText(m) || collectSlackMessageFiles(m).length > 0)
259
+ ? [m.user]
260
+ : [],
261
+ ),
262
+ ),
263
+ ];
264
+ await Promise.all(
265
+ Array.from({ length: Math.min(USERS_INFO_CONCURRENCY, authorIds.length) }, async () => {
266
+ for (let id = authorIds.shift(); id; id = authorIds.shift()) {
267
+ await getUserDisplayName(id);
268
+ }
269
+ }),
270
+ );
271
+
244
272
  // Get token for auto-download
245
273
  const token = process.env.SLACK_BOT_TOKEN;
246
274
 
@@ -10,6 +10,7 @@ import {
10
10
  getResolvedConfig,
11
11
  getTaskById,
12
12
  insertTaskAttachment,
13
+ skipTask,
13
14
  updateAgentStatusFromCapacity,
14
15
  updateTaskProgress,
15
16
  } from "@/be/db";
@@ -27,6 +28,7 @@ import {
27
28
  } from "@/be/task-citations";
28
29
  import { AgentFsProvider } from "@/fs/agent-fs-provider";
29
30
  import { can } from "@/rbac";
31
+ import { finalizeSkippedTaskReaction, skipReasonFrom } from "@/tasks/task-skip";
30
32
  import { runTaskTerminalEffects } from "@/tasks/task-terminal-effects";
31
33
  import {
32
34
  getTaskOutputValidationError,
@@ -149,7 +151,7 @@ export const registerStoreProgressTool = (server: McpServer) => {
149
151
  {
150
152
  title: "Store task progress",
151
153
  description:
152
- "Stores the progress of a specific task. Can also mark task as completed or failed, which will set the agent back to idle.",
154
+ "Stores the progress of a specific task. Can also mark task as completed, failed, or skipped, which will set the agent back to idle. Use skipped only when the work is not yours to handle, such as a Slack thread message addressed to someone else; never skip an explicit @mention of you or work assigned to you.",
153
155
  annotations: { idempotentHint: true },
154
156
 
155
157
  inputSchema: z.object({
@@ -161,10 +163,10 @@ export const registerStoreProgressTool = (server: McpServer) => {
161
163
  ),
162
164
  progress: z.string().optional().describe("The progress update to store."),
163
165
  status: z
164
- .enum(["completed", "failed", "in_progress", "pending"])
166
+ .enum(["completed", "failed", "skipped", "in_progress", "pending"])
165
167
  .optional()
166
168
  .describe(
167
- "Set to 'completed' or 'failed' to finish the task. 'in_progress' and 'pending' store progress only and do not change task status.",
169
+ "Set to 'completed' or 'failed' to finish the task. Set 'skipped' to end a task that is not yours to handle (a Slack thread message addressed to someone else, or one you have nothing to add to); it posts nothing to the thread, creates no follow-up, and needs a one-line reason in failureReason. Never skip an explicit @mention of you or work assigned to you. 'in_progress' and 'pending' store progress only and do not change task status.",
168
170
  ),
169
171
  output: z
170
172
  .string()
@@ -175,7 +177,9 @@ export const registerStoreProgressTool = (server: McpServer) => {
175
177
  failureReason: z
176
178
  .string()
177
179
  .optional()
178
- .describe("The reason for failure (used when failing)."),
180
+ .describe(
181
+ "The reason for failure (used when failing), or the one-line reason for a skip (required with status 'skipped').",
182
+ ),
179
183
  attachments: z
180
184
  .array(AttachmentInputSchema)
181
185
  .max(20)
@@ -255,9 +259,19 @@ export const registerStoreProgressTool = (server: McpServer) => {
255
259
  }
256
260
  }
257
261
  const status =
258
- requestedStatus === "completed" || requestedStatus === "failed"
262
+ requestedStatus === "completed" ||
263
+ requestedStatus === "failed" ||
264
+ requestedStatus === "skipped"
259
265
  ? requestedStatus
260
266
  : undefined;
267
+ const skipReason = status === "skipped" ? skipReasonFrom(failureReason, output) : undefined;
268
+ if (status === "skipped") {
269
+ if (!skipReason) {
270
+ return toolErr(
271
+ 'Status "skipped" needs a one-line reason in failureReason. The task was not changed.',
272
+ );
273
+ }
274
+ }
261
275
 
262
276
  // Stock Claude occasionally puts the next tool parameter inside output.
263
277
  // Strip the leaked tail before validation/persistence; recovered pointers
@@ -510,8 +524,7 @@ export const registerStoreProgressTool = (server: McpServer) => {
510
524
  // fields untouched.
511
525
  const terminalResultGuard = await guardTerminalTaskResultWrite(existingTask, {
512
526
  status,
513
- output,
514
- failureReason,
527
+ ...(status === "skipped" ? { failureReason: skipReason } : { output, failureReason }),
515
528
  force,
516
529
  });
517
530
  if (terminalResultGuard.handled) {
@@ -646,6 +659,14 @@ export const registerStoreProgressTool = (server: McpServer) => {
646
659
  await updateAgentStatusFromCapacity(existingTask.agentId);
647
660
  }
648
661
  }
662
+ } else if (status === "skipped") {
663
+ const result = await skipTask(taskId, skipReason!);
664
+ if (result) {
665
+ updatedTask = result;
666
+ if (existingTask.agentId) {
667
+ await updateAgentStatusFromCapacity(existingTask.agentId);
668
+ }
669
+ }
649
670
  } else {
650
671
  // Progress update - ensure status reflects current load
651
672
  if (existingTask.agentId) {
@@ -681,7 +702,7 @@ export const registerStoreProgressTool = (server: McpServer) => {
681
702
  // src/tasks/task-terminal-effects.ts. Skipped on no-op (idempotent
682
703
  // re-call on a terminal task) and on forced text-only overwrites, so a
683
704
  // replay never duplicates memories or follow-up tasks.
684
- if (shouldRunTerminalSideEffects && status) {
705
+ if (shouldRunTerminalSideEffects && (status === "completed" || status === "failed")) {
685
706
  await runTaskTerminalEffects({
686
707
  task: result.task!,
687
708
  status,
@@ -692,6 +713,16 @@ export const registerStoreProgressTool = (server: McpServer) => {
692
713
  });
693
714
  }
694
715
 
716
+ // runTaskTerminalEffects above is completed/failed only: a skip posts
717
+ // nothing and only swaps the trigger message's reaction.
718
+ const skipWasFresh =
719
+ status === "skipped" &&
720
+ result.success &&
721
+ result.task?.status === "skipped" &&
722
+ !("wasNoOp" in result && result.wasNoOp) &&
723
+ !("wasForcedOverwrite" in result && result.wasForcedOverwrite);
724
+ if (skipWasFresh && result.task) finalizeSkippedTaskReaction(result.task, "store-progress");
725
+
695
726
  const learningResult = await learningWrite;
696
727
  const { success } = result;
697
728
  const message = learningResult
@@ -0,0 +1,68 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import * as z from "zod";
3
+ import { getAgentById } from "@/be/db";
4
+ import { createImprovement, IMPROVEMENT_TEXT_MAX, ImprovementError } from "@/be/improvements";
5
+ import { can } from "@/rbac";
6
+ import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
7
+
8
+ export const submitImprovementInputSchema = z.object({
9
+ text: z
10
+ .string()
11
+ .min(1)
12
+ .max(IMPROVEMENT_TEXT_MAX)
13
+ .describe(
14
+ "The product improvement for desplega, in plain words. Do not include names, repos, hosts, customer details or secrets.",
15
+ ),
16
+ });
17
+
18
+ export const submitImprovementOutputSchema = swarmToolOutputSchema({
19
+ id: z.string().optional(),
20
+ status: z.string().optional(),
21
+ });
22
+
23
+ /**
24
+ * Drafts only. The draft waits in `pending_approval` until a person approves
25
+ * it in the dashboard; there is no approve tool, and nothing is sent here.
26
+ */
27
+ export const registerSubmitImprovementTool = (server: McpServer) => {
28
+ createToolRegistrar(server)(
29
+ "submit-improvement",
30
+ {
31
+ title: "Draft a product improvement",
32
+ description:
33
+ "Draft a short product improvement for the agent-swarm team at desplega. It is stored as a pending draft and is never sent by this tool: a person must approve it from the Improvements button in the dashboard header. Only the text you write, the install id and the approver's email are sent.",
34
+ annotations: { destructiveHint: false },
35
+ inputSchema: submitImprovementInputSchema,
36
+ outputSchema: submitImprovementOutputSchema,
37
+ },
38
+ async ({ text }, info) => {
39
+ if (info.callOrigin === "script-sdk" || info.callOrigin === "extension") {
40
+ return toolErr("Scripts and extensions cannot draft improvements.");
41
+ }
42
+ if (!info.agentId) {
43
+ return toolErr('Agent ID not found. Set the "X-Agent-ID" header.');
44
+ }
45
+ const agent = await getAgentById(info.agentId);
46
+ const decision = can({
47
+ principal: { kind: "agent", agentId: info.agentId, isLead: agent?.isLead ?? false },
48
+ verb: "improvement.submit",
49
+ source: "mcp",
50
+ });
51
+ if (!decision.allow) return toolErr(decision.reason);
52
+ try {
53
+ const { improvement } = await createImprovement({
54
+ text,
55
+ source: "mcp",
56
+ requestedByAgentId: info.agentId,
57
+ });
58
+ return toolOk(
59
+ `Drafted improvement ${improvement.id}. A person must approve it from the Improvements button in the dashboard header before anything is sent.`,
60
+ { data: { id: improvement.id, status: improvement.status } },
61
+ );
62
+ } catch (error) {
63
+ if (error instanceof ImprovementError) return toolErr(error.message);
64
+ throw error;
65
+ }
66
+ },
67
+ );
68
+ };
@@ -155,6 +155,9 @@ export const DEFERRED_TOOLS = new Set([
155
155
  "request-human-input",
156
156
  "cancel-approval-request",
157
157
 
158
+ // Improvements (1)
159
+ "submit-improvement",
160
+
158
161
  // Decisions (1)
159
162
  "system-one-decide",
160
163
 
@@ -18,7 +18,8 @@ export const registerTrackerUnlinkTool = (server: McpServer) => {
18
18
  },
19
19
  async (args, _requestInfo, _meta) => {
20
20
  try {
21
- await deleteTrackerSync(args.syncId);
21
+ const removed = await deleteTrackerSync(args.syncId);
22
+ if (!removed) return toolErr(`No tracker mapping ${args.syncId}`);
22
23
  return toolOk(`Removed tracker sync mapping ${args.syncId}.`);
23
24
  } catch (error) {
24
25
  const message = error instanceof Error ? error.message : "Unknown error";
@@ -1,5 +1,6 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import { z } from "zod";
3
+ import { getWorkflowRunSummary } from "@/be/db/workflow-runs";
3
4
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
4
5
  import { getExecutorRegistry, retryFailedRun } from "@/workflows";
5
6
 
@@ -18,6 +19,8 @@ export const registerRetryWorkflowRunTool = (server: McpServer) => {
18
19
  },
19
20
  async ({ runId }) => {
20
21
  try {
22
+ if (!(await getWorkflowRunSummary(runId)))
23
+ return toolErr(`Workflow run not found: ${runId}`);
21
24
  await retryFailedRun(runId, getExecutorRegistry());
22
25
  return toolOk(`Retrying workflow run ${runId}.`);
23
26
  } catch (err) {
package/src/types.ts CHANGED
@@ -319,6 +319,7 @@ export const AgentTaskStatusSchema = z.enum([
319
319
  "failed",
320
320
  "cancelled", // Task was cancelled by lead or creator
321
321
  "superseded", // Original terminated, replaced by a follow-up "resume" task
322
+ "skipped", // Agent declined: the work was not its to handle (e.g. a Slack thread message addressed to someone else)
322
323
  ]);
323
324
 
324
325
  /**
@@ -337,7 +338,13 @@ export const AgentTaskStatusSchema = z.enum([
337
338
  * - `status = CASE WHEN status IN ('completed'` — setProgress guard
338
339
  * and update every site.
339
340
  */
340
- export const TERMINAL_TASK_STATUSES = ["completed", "failed", "cancelled", "superseded"] as const;
341
+ export const TERMINAL_TASK_STATUSES = [
342
+ "completed",
343
+ "failed",
344
+ "cancelled",
345
+ "superseded",
346
+ "skipped",
347
+ ] as const;
341
348
  export type TerminalTaskStatus = (typeof TERMINAL_TASK_STATUSES)[number];
342
349
 
343
350
  export function isTerminalTaskStatus(status: string): status is TerminalTaskStatus {
@@ -753,6 +760,9 @@ export const AgentTaskSchema = z
753
760
  // Session attachment (optional). z.string(), not z.uuid(): accepted
754
761
  // verbatim from the create-task body (see dependsOn note above).
755
762
  parentTaskId: z.string().optional(),
763
+ // The task whose session called send-task to create this one. Unlike
764
+ // parentTaskId (context continuity), this is where the dispatch happened.
765
+ dispatchedByTaskId: z.string().optional(),
756
766
  claudeSessionId: z.string().optional(),
757
767
 
758
768
  // Model selection (optional — provider-specific; can be "opus", "gpt-4o",
@@ -913,6 +923,8 @@ export const CreateTaskOptionsSchema = z.object({
913
923
  workflowRunId: z.string().optional(),
914
924
  workflowRunStepId: z.string().optional(),
915
925
  sourceTaskId: z.string().optional(),
926
+ /** Persisted as `dispatchedByTaskId`: the caller's task when send-task created this one. */
927
+ dispatchedByTaskId: z.string().optional(),
916
928
  /**
917
929
  * Optional JSON Schema the agent's final output must conform to.
918
930
  *
@@ -2075,7 +2087,9 @@ export const SwarmRepoSchema = z
2075
2087
  clonePath: z.string().min(1),
2076
2088
  defaultBranch: z.string().default("main"),
2077
2089
  autoClone: z.boolean().default(true),
2078
- hooks: RepoHooksSchema.optional().default({ enabled: false }),
2090
+ hooks: RepoHooksSchema.describe(
2091
+ "Worker hook installation. Enabled by default: a repo created without `hooks` stores { enabled: true }. Disable with { enabled: false }. A repo with no stored hooks config reads as disabled.",
2092
+ ),
2079
2093
  guidelines: RepoGuidelinesSchema.nullable().optional(),
2080
2094
  createdAt: z.string(),
2081
2095
  lastUpdatedAt: z.string(),
@@ -64,9 +64,14 @@ function catalogContext(provider: string, model: string): number | undefined {
64
64
  * (`src/utils/runtime-model-catalog.ts`: live `model_catalog` + overlay,
65
65
  * vendored models.dev snapshot offline). Accepts Anthropic ids (dated or
66
66
  * not), Claude CLI shortnames, OpenAI/Codex ids and `provider/model` ids.
67
+ * A positive finite `reportedWindow` from the running harness takes precedence.
67
68
  * Unknown models get a conservative 200k so percent math stays finite.
68
69
  */
69
- export function getContextWindowSize(model: string): number {
70
+ export function getContextWindowSize(model: string, reportedWindow?: number | null): number {
71
+ // Harness limits can be smaller than the model's API/catalog maximum.
72
+ if (reportedWindow != null && Number.isFinite(reportedWindow) && reportedWindow > 0) {
73
+ return reportedWindow;
74
+ }
70
75
  return getKnownContextWindowSize(model) ?? DEFAULT_CONTEXT_WINDOW;
71
76
  }
72
77
 
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Task `outputSchema` presence rules, shared by the API server and workers.
3
+ *
4
+ * An explicit empty schema (`{}`) means "no output schema". Callers pass it on
5
+ * purpose to stop a child task from inheriting the parent's schema. It must
6
+ * never reach a harness as a contract: a worker told to return JSON matching
7
+ * `{}` completes with the literal output "{}" and drops its real result.
8
+ */
9
+
10
+ /** True when `schema` is a non-empty JSON Schema object the task must satisfy. */
11
+ export function isEffectiveOutputSchema(schema: unknown): schema is Record<string, unknown> {
12
+ return (
13
+ !!schema &&
14
+ typeof schema === "object" &&
15
+ !Array.isArray(schema) &&
16
+ Object.keys(schema).length > 0
17
+ );
18
+ }
19
+
20
+ /** Returns the schema when it is effective, otherwise `undefined`. */
21
+ export function normalizeOutputSchema(schema: unknown): Record<string, unknown> | undefined {
22
+ return isEffectiveOutputSchema(schema) ? schema : undefined;
23
+ }
@@ -4,7 +4,12 @@ import type { User } from "../types";
4
4
 
5
5
  export type HttpRequestAuth = (
6
6
  | { kind: "operator"; fingerprint: string }
7
- | { kind: "user"; userId: string; user: User }
7
+ /**
8
+ * `tokenId` is the `user_tokens` row the request authenticated with, unset
9
+ * for a page session. Credential and identity writes recheck it in their
10
+ * write transaction (`assertMayActOnOperatorGrantedTarget`).
11
+ */
12
+ | { kind: "user"; userId: string; user: User; tokenId?: string }
8
13
  /** Password-page viewer with no user identity. Least privilege: every gate denies it. */
9
14
  | { kind: "guest" }
10
15
  | { kind: "controller"; controllerId: string; tokenId: string; expiresAt: string }
@@ -51,7 +51,7 @@ export interface SystemOneBuiltEndpoint {
51
51
  /** What the value is, for messages: "the account id of a Cloudflare account". */
52
52
  readonly describe: string;
53
53
  /** Request URL, or null when the value is not usable. `model` is already allowlisted. */
54
- readonly build: (value: string, model: string) => string | null;
54
+ readonly build: (value: string, model: string, env: NodeJS.ProcessEnv) => string | null;
55
55
  }
56
56
 
57
57
  export type SystemOneEndpoint = string | SystemOneConfiguredEndpoint | SystemOneBuiltEndpoint;
@@ -155,11 +155,30 @@ async function readFirstGlobalConfig(
155
155
  const CLOUDFLARE_ENDPOINT: SystemOneBuiltEndpoint = {
156
156
  configKey: CLOUDFLARE_ACCOUNT_KEY,
157
157
  describe: "the 32-character id of a Cloudflare account",
158
- build: (accountId, model) => {
158
+ build: (accountId, model, env) => {
159
159
  const id = accountId.trim();
160
- return CLOUDFLARE_ACCOUNT_RE.test(id)
161
- ? `https://api.cloudflare.com/client/v4/accounts/${id}/ai/run/@cf/cloudflare/${model}`
162
- : null;
160
+ if (!CLOUDFLARE_ACCOUNT_RE.test(id)) return null;
161
+ const path = `/client/v4/accounts/${id}/ai/run/@cf/cloudflare/${model}`;
162
+ // Test traffic can reach a local mock. Config rows cannot set this reserved key.
163
+ if (env.NODE_ENV === "test" && env.CLOUDFLARE_API_BASE_URL) {
164
+ try {
165
+ const url = new URL(env.CLOUDFLARE_API_BASE_URL);
166
+ if (
167
+ url.protocol === "http:" &&
168
+ LOOPBACK_HOSTS.has(url.hostname) &&
169
+ url.pathname === "/" &&
170
+ !url.username &&
171
+ !url.password &&
172
+ !url.search &&
173
+ !url.hash
174
+ ) {
175
+ return `${url.origin}${path}`;
176
+ }
177
+ } catch {
178
+ // Ignore an invalid override and use the production endpoint.
179
+ }
180
+ }
181
+ return `https://api.cloudflare.com${path}`;
163
182
  },
164
183
  };
165
184
 
@@ -576,7 +595,7 @@ export async function resolveSystemOneTarget(
576
595
  errors.push(systemOneUrlMissingMessage(id, capability));
577
596
  } else {
578
597
  const resolved = isBuiltEndpoint(service.endpoint)
579
- ? service.endpoint.build(base, overrides.model ?? service.defaultModel ?? "")
598
+ ? service.endpoint.build(base, overrides.model ?? service.defaultModel ?? "", ctx.env)
580
599
  : systemOneEndpointFromBase(base, service.endpoint.path);
581
600
  if (resolved) endpoint = resolved;
582
601
  else errors.push(systemOneUrlInvalidMessage(id, capability));
@@ -254,6 +254,12 @@ async function completeIfSettled(runId: string, ctx: Record<string, unknown>): P
254
254
  * Check waiting runs whose linked tasks may have completed/failed/cancelled
255
255
  * while the server was down.
256
256
  */
257
+ function recoveredTaskReason(taskStatus: string): string {
258
+ if (taskStatus === "failed") return "Task failed (recovered)";
259
+ if (taskStatus === "skipped") return "Task skipped (recovered)";
260
+ return "Task cancelled (recovered)";
261
+ }
262
+
257
263
  async function recoverWaitingRuns(registry: ExecutorRegistry): Promise<number> {
258
264
  const stuckRuns = await getStuckWorkflowRuns();
259
265
  let recovered = 0;
@@ -288,8 +294,7 @@ async function recoverWaitingRuns(registry: ExecutorRegistry): Promise<number> {
288
294
  // Claimed: this sweep runs on every heartbeat, so the live task.failed
289
295
  // bus event may already have routed this step — a blind write here
290
296
  // would kill a run that is already advancing.
291
- const reason =
292
- stuck.taskStatus === "failed" ? "Task failed (recovered)" : "Task cancelled (recovered)";
297
+ const reason = recoveredTaskReason(stuck.taskStatus);
293
298
  const failed = await failStepAndRunIfWaiting(
294
299
  workflow.definition,
295
300
  stuck.stepId,
@@ -304,8 +309,7 @@ async function recoverWaitingRuns(registry: ExecutorRegistry): Promise<number> {
304
309
  }
305
310
 
306
311
  const ctx = (run.context ?? {}) as Record<string, unknown>;
307
- const reason =
308
- stuck.taskStatus === "failed" ? "Task failed (recovered)" : "Task cancelled (recovered)";
312
+ const reason = recoveredTaskReason(stuck.taskStatus);
309
313
  const stepOutput = {
310
314
  taskId: stuck.taskId,
311
315
  taskOutput: taskCompleted
@@ -144,6 +144,24 @@ export function setupWorkflowResumeListener(
144
144
  };
145
145
  eventBus.on("task.cancelled", onTaskCancelled);
146
146
 
147
+ // A skipped task did not do the node's work: route it like a cancel, never
148
+ // as a success, so the node's failure policy decides what happens next.
149
+ const onTaskSkipped = async (data: unknown) => {
150
+ try {
151
+ const event = data as TaskEvent;
152
+ if (!event.workflowRunId || !event.workflowRunStepId) return;
153
+ await handleTaskFailure(
154
+ event,
155
+ `Task was skipped: ${event.failureReason ?? "no reason given"}`,
156
+ registry,
157
+ { retryable: false },
158
+ );
159
+ } catch (err) {
160
+ console.error("[workflows] Handle task skip error:", err);
161
+ }
162
+ };
163
+ eventBus.on("task.skipped", onTaskSkipped);
164
+
147
165
  const onApprovalResolved = async (data: unknown) => {
148
166
  try {
149
167
  const event = data as ApprovalEvent;
@@ -170,6 +188,7 @@ export function setupWorkflowResumeListener(
170
188
  eventBus.off("task.completed", onTaskCompleted);
171
189
  eventBus.off("task.failed", onTaskFailed);
172
190
  eventBus.off("task.cancelled", onTaskCancelled);
191
+ eventBus.off("task.skipped", onTaskSkipped);
173
192
  eventBus.off("approval.resolved", onApprovalResolved);
174
193
  eventBus.off("workflow.child.finished", onChildRunFinished);
175
194
  };