@desplega.ai/agent-swarm 2.7.8 → 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 (309) hide show
  1. package/dist/acp-adapter-dn4gdsgr.js +16 -0
  2. package/dist/{actions-4m1ct4nh.js → actions-g563mbn2.js} +19 -19
  3. package/dist/{amp-adapter-txqh7eqj.js → amp-adapter-q61w05eb.js} +3 -3
  4. package/dist/{anthropic-messages-xey2skwx.js → anthropic-messages-jkva0zps.js} +68 -78
  5. package/dist/{app-e00m45gn.js → app-a66ssc4k.js} +3 -3
  6. package/dist/{assistant-gd08kr9e.js → assistant-p477rjwj.js} +21 -21
  7. package/dist/{azure-openai-responses-26t7j9ra.js → azure-openai-responses-wgtqkbr3.js} +5 -10
  8. package/dist/{boot-args-schema-tjrkpbvm.js → boot-args-schema-h4qj462e.js} +1 -1
  9. package/dist/{boot-reembed-21hbck22.js → boot-reembed-n1ehfbsw.js} +1 -1
  10. package/dist/{boot-reembed-mdxd3wgp.js → boot-reembed-qw4mc0pt.js} +1 -1
  11. package/dist/{boot-scrub-sweep-qy0zr9t2.js → boot-scrub-sweep-9w9jp4sm.js} +4 -4
  12. package/dist/{boot-seeds-n46eaxdv.js → boot-seeds-qdaf3sdy.js} +5 -4
  13. package/dist/{boxd-nv507va8.js → boxd-qbkxy6ap.js} +1 -1
  14. package/dist/{claude-adapter-j37w2eds.js → claude-adapter-348p5hx9.js} +8 -8
  15. package/dist/{claude-managed-adapter-8jvcma9a.js → claude-managed-adapter-h74d06yz.js} +4 -4
  16. package/dist/{claude-managed-setup-rzkjmgc1.js → claude-managed-setup-7787fxtp.js} +4 -4
  17. package/dist/{claude-sdk-session-4k7w73t0.js → claude-sdk-session-hbszbt8a.js} +7901 -7718
  18. package/dist/{cli-sq4n7af4.js → cli-09kmfkmq.js} +4 -6
  19. package/dist/{cli-p3vsj0d3.js → cli-0whpms1z.js} +15 -10
  20. package/dist/{cli-4t50yq3j.js → cli-12xyjhws.js} +29 -12
  21. package/dist/{cli-snpj5zbj.js → cli-1z4qggfe.js} +9 -36
  22. package/dist/{cli-bb0mmdk8.js → cli-21159vea.js} +35 -12
  23. package/dist/{cli-s0qnd4wv.js → cli-28fq781p.js} +1 -1
  24. package/dist/{cli-rjknb2ae.js → cli-2a8py3sx.js} +6 -6
  25. package/dist/{cli-tpksw2nr.js → cli-2ccpqyyf.js} +397 -105
  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-bbw9wj9m.js → cli-3tqcamp6.js} +12 -12
  30. package/dist/{cli-ae7mrdf9.js → cli-3vjhs18n.js} +4 -6
  31. package/dist/{cli-ssnjfg5p.js → cli-3xcwp3z8.js} +8 -10
  32. package/dist/{cli-az48n0nr.js → cli-4caa1x7d.js} +67 -64
  33. package/dist/{cli-269q28a1.js → cli-4t0fmf3z.js} +27 -6
  34. package/dist/{cli-1cxrbkk6.js → cli-530hkwdy.js} +7 -9
  35. package/dist/{cli-pz4rk021.js → cli-54vrpgm0.js} +1 -1
  36. package/dist/{cli-eyg1pa00.js → cli-587857ys.js} +7 -7
  37. package/dist/{cli-r9jqcehk.js → cli-5mpy301f.js} +38 -2
  38. package/dist/{cli-xq9r2wtt.js → cli-605nn699.js} +47 -34
  39. package/dist/{cli-msg9m2ny.js → cli-650zv9q9.js} +8 -10
  40. package/dist/cli-6pzk82fd.js +778 -0
  41. package/dist/{cli-84rj785g.js → cli-715t1gx6.js} +9 -9
  42. package/dist/{cli-btfsp3mv.js → cli-9aezs55w.js} +9 -11
  43. package/dist/{cli-dq8x79v8.js → cli-9r5gtwjr.js} +2 -2
  44. package/dist/{cli-jdv6ypxs.js → cli-a0657jmf.js} +2 -2
  45. package/dist/{cli-bshb7jas.js → cli-agyaeef4.js} +3 -3
  46. package/dist/cli-b932gexn.js +5266 -0
  47. package/dist/{cli-gvx71kqv.js → cli-bc779n4v.js} +3 -3
  48. package/dist/{cli-z1srzaf6.js → cli-btc9cb4c.js} +70 -5
  49. package/dist/{cli-s4ss5g59.js → cli-btf6fw39.js} +5 -5
  50. package/dist/{cli-fzachfnf.js → cli-cseh6f8w.js} +5 -5
  51. package/dist/{cli-5j0m12ns.js → cli-cvs2r2vq.js} +13 -11
  52. package/dist/{cli-njwac61j.js → cli-cyn9v8zr.js} +12 -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-7axf41jq.js → cli-ejkvvqbe.js} +40 -42
  57. package/dist/{cli-mthwvjre.js → cli-f2zenhja.js} +1 -1
  58. package/dist/{cli-8sdejs1f.js → cli-fayav105.js} +538 -205
  59. package/dist/{cli-ferkkrg9.js → cli-fjggej24.js} +2 -2
  60. package/dist/{cli-g7s47cc5.js → cli-fsgttth8.js} +123 -102
  61. package/dist/{cli-9m8hdawy.js → cli-gce09r66.js} +4 -4
  62. package/dist/{cli-mkk9rnzz.js → cli-gxy8y1dt.js} +51 -4
  63. package/dist/{cli-85gzce7b.js → cli-hae9j8sv.js} +287 -75
  64. package/dist/{cli-agfm16v9.js → cli-hg42n3hx.js} +12 -12
  65. package/dist/{cli-8rpcng8j.js → cli-hwprv9e4.js} +8 -10
  66. package/dist/{cli-yndmfxb3.js → cli-hxpyc9sn.js} +3 -3
  67. package/dist/{cli-ppjxh6ah.js → cli-jfx48xrj.js} +10 -12
  68. package/dist/{cli-5ja3b75e.js → cli-jrp1dt73.js} +1 -1
  69. package/dist/{cli-98rw5dt5.js → cli-jrzkw01m.js} +2 -2
  70. package/dist/{cli-ga786dzg.js → cli-k70e3x9e.js} +18 -17
  71. package/dist/{cli-583frbyr.js → cli-kchjb7qy.js} +1 -1
  72. package/dist/{cli-fmjd0t1y.js → cli-m0cy2vyf.js} +2 -2
  73. package/dist/{cli-c0kqky8y.js → cli-m5akxq8q.js} +1 -1
  74. package/dist/{cli-ycscb2ar.js → cli-m88rpzkh.js} +2 -2
  75. package/dist/{cli-m0hmeqma.js → cli-mnrkgg60.js} +4 -4
  76. package/dist/{cli-yqefz277.js → cli-ms5m5r1y.js} +1 -1
  77. package/dist/{cli-fy6x31ps.js → cli-n5yexkdg.js} +1 -0
  78. package/dist/{cli-w4xnbm46.js → cli-neyag5p6.js} +53 -39
  79. package/dist/cli-p0m0p34z.js +9321 -0
  80. package/dist/{cli-gazw7kpa.js → cli-p17970qv.js} +8 -10
  81. package/dist/{cli-6vcp76qk.js → cli-p74md7t8.js} +42 -23
  82. package/dist/{cli-rjcbm574.js → cli-pr0eze3x.js} +2 -2
  83. package/dist/{cli-3e4snnzf.js → cli-qkdmz8c8.js} +1 -1
  84. package/dist/{cli-0ykgn1h5.js → cli-qmd3mse0.js} +2 -2
  85. package/dist/{cli-t60ajbbp.js → cli-qzt90yze.js} +20 -20
  86. package/dist/cli-rkc97c6a.js +39 -0
  87. package/dist/{cli-qd57hhhh.js → cli-rvhdmjvt.js} +6 -10
  88. package/dist/{cli-kyr67fgx.js → cli-rwymrnaz.js} +18608 -9089
  89. package/dist/{cli-8h0ayw8c.js → cli-serm8zrx.js} +6 -6
  90. package/dist/{cli-66ww7fer.js → cli-sgs5k6yd.js} +1 -1
  91. package/dist/{cli-nbsf8yvn.js → cli-sya22y84.js} +9 -9
  92. package/dist/{cli-318r69gq.js → cli-t73cas91.js} +440 -9
  93. package/dist/{cli-zkky4t5g.js → cli-tqq0hspb.js} +2 -2
  94. package/dist/{cli-z75yxkjh.js → cli-v3cf1ts9.js} +3 -3
  95. package/dist/{cli-xr8908my.js → cli-varqt4d1.js} +26 -14
  96. package/dist/{cli-q4ebh7h7.js → cli-vxh6acp7.js} +6 -6
  97. package/dist/{cli-g83s9ewh.js → cli-xfjrc279.js} +1 -1
  98. package/dist/{cli-32m9eda8.js → cli-xk879m3k.js} +111 -109
  99. package/dist/{cli-7cx2m6t2.js → cli-y5rbvxhc.js} +2 -2
  100. package/dist/{cli-fyhr5h4s.js → cli-y8nbefpb.js} +13 -13
  101. package/dist/{cli-81p9jd57.js → cli-yab6sh8p.js} +9 -3
  102. package/dist/{cli-srye3vdt.js → cli-ybjdc978.js} +1 -1
  103. package/dist/{cli-k5671be5.js → cli-zcfpsfzf.js} +5 -5
  104. package/dist/{cli-vf078p3e.js → cli-zfqg6fzn.js} +1 -1
  105. package/dist/{cli-wemma3jd.js → cli-zgv8gxgs.js} +7 -7
  106. package/dist/cli.js +31 -51
  107. package/dist/{cloudflare-workers-ai-system-one-ef2a980q.js → cloudflare-workers-ai-system-one-9y1zx3pt.js} +2 -2
  108. package/dist/{codex-adapter-88z6psm4.js → codex-adapter-ysq6bzha.js} +7 -7
  109. package/dist/{codex-login-74wa4hmq.js → codex-login-bcda78ge.js} +2 -2
  110. package/dist/{codex-session-runner-zwbcwzvx.js → codex-session-runner-qakzfx93.js} +8 -8
  111. package/dist/{commands-7amxs716.js → commands-rs7hkv9r.js} +3 -3
  112. package/dist/{controller-5rkkc37m.js → controller-r5x9bg6e.js} +4 -4
  113. package/dist/{controllers-connect-m7d4vxxb.js → controllers-connect-498hrxvk.js} +24 -24
  114. package/dist/{cursor-adapter-x1q18693.js → cursor-adapter-d46qszer.js} +2 -2
  115. package/dist/{db-athc68zt.js → db-pm96nhdb.js} +4 -2
  116. package/dist/{db-h2fsfve3.js → db-s13dqhr6.js} +3 -3
  117. package/dist/{devin-adapter-r9phbnc9.js → devin-adapter-z46ep5ph.js} +1 -1
  118. package/dist/{dispatcher-b1yz2bnn.js → dispatcher-j3h81t7m.js} +18 -18
  119. package/dist/{docker-c1a3gqmf.js → docker-866qpzt9.js} +2 -2
  120. package/dist/{dsh-adapter-e33bkxq9.js → dsh-adapter-rw0d5rc4.js} +2 -2
  121. package/dist/{e2b-fr12yccx.js → e2b-jkwfhbcv.js} +2 -2
  122. package/dist/{e2b-x6ywzak3.js → e2b-s16txnpx.js} +2 -3
  123. package/dist/{easter-egg-3d-pv5qnzc8.js → easter-egg-3d-qtgfxgze.js} +1 -1
  124. package/dist/{embedding-space-b4txbwrk.js → embedding-space-xh8p4q4x.js} +6 -6
  125. package/dist/{embeddings-m6zn6tad.js → embeddings-wp745m91.js} +1 -1
  126. package/dist/{event-bus-g0ka3pbw.js → event-bus-e66gh7cc.js} +1 -1
  127. package/dist/{execute-68nwny8m.js → execute-2fzb9z74.js} +1 -1
  128. package/dist/{external-channel-gkckmhzh.js → external-channel-ys21h3sy.js} +2 -2
  129. package/dist/fx-adapter-vz0b9z3g.js +19 -0
  130. package/dist/{google-generative-ai-v94hr7h0.js → google-generative-ai-ytpgncx9.js} +7 -12
  131. package/dist/{google-vertex-g7vr6cf8.js → google-vertex-tqhze5j7.js} +7 -12
  132. package/dist/grok-adapter-spea7zkj.js +19 -0
  133. package/dist/handlers-crckt5dq.js +32 -0
  134. package/dist/{heartbeat-6c2y3267.js → heartbeat-8phn1kdq.js} +21 -21
  135. package/dist/{hook-q5fv0jy2.js → hook-amcj4s10.js} +16 -11
  136. package/dist/{hook-w0q2wcrv.js → hook-bc6n49qn.js} +5 -5
  137. package/dist/{http-bxat8dg3.js → http-7374brv5.js} +642 -260
  138. package/dist/index-4x08sjtk.js +30 -0
  139. package/dist/{index-6cxzwfen.js → index-5a9jtqde.js} +26 -26
  140. package/dist/index-8ybffts4.js +37 -0
  141. package/dist/{index-bxrexmfy.js → index-c9y31ytf.js} +13 -13
  142. package/dist/{index-h39zbx67.js → index-hsad2t3r.js} +31 -31
  143. package/dist/index-nfy4kkg5.js +33 -0
  144. package/dist/{index-cqhqpgrv.js → index-p4hjwbvw.js} +1 -1
  145. package/dist/{index-k7fj52d3.js → index-q5cmtbz5.js} +6 -6
  146. package/dist/{index-fm0czesf.js → index-w4m9z29z.js} +1 -1
  147. package/dist/{keepalive-qnt21cv0.js → keepalive-wy29kbrg.js} +4 -4
  148. package/dist/lead-zdqxsvjn.js +71 -0
  149. package/dist/{llama-cpp-classify-s5c47rwh.js → llama-cpp-classify-nfgswa1m.js} +2 -2
  150. package/dist/{maintenance-btdr68y4.js → maintenance-h2ds9w6c.js} +1 -1
  151. package/dist/{mistral-conversations-3gjpdb4b.js → mistral-conversations-a45tx39a.js} +29 -51
  152. package/dist/{oauth-refresh-sweep-vczabeh4.js → oauth-refresh-sweep-q7mtbyp3.js} +3 -3
  153. package/dist/{onboard-k33ezyq8.js → onboard-vw8r2fdw.js} +68 -16
  154. package/dist/{openai-codex-responses-8pbxq9h5.js → openai-codex-responses-k9gapdze.js} +7 -11
  155. package/dist/{openai-completions-rm00s912.js → openai-completions-xd579js7.js} +50 -58
  156. package/dist/{openai-decisions-8v957r2r.js → openai-decisions-q3hh60wr.js} +2 -2
  157. package/dist/{openai-responses-agxpf96k.js → openai-responses-4d5dx3c7.js} +5 -10
  158. package/dist/{opencode-adapter-3dst2ka7.js → opencode-adapter-mtb0953j.js} +6 -6
  159. package/dist/{openrouter-images-3ecegv0d.js → openrouter-images-xr9gme9x.js} +4 -3
  160. package/dist/{otel-impl-13am7a65.js → otel-impl-j42czw3r.js} +2 -2
  161. package/dist/{pi-messages-pchtw4he.js → pi-messages-hjbv8v10.js} +28 -12
  162. package/dist/{pi-mono-adapter-c53de1gd.js → pi-mono-adapter-zk8pg9jr.js} +23 -26
  163. package/dist/{pricing-refresh-9fcbnq3f.js → pricing-refresh-x7nhv23d.js} +3 -3
  164. package/dist/{rbac-roles-gw0p9h3j.js → rbac-roles-9044425x.js} +16 -2
  165. package/dist/{rbac-roles-66j5h4y5.js → rbac-roles-bzvee6cf.js} +12 -3
  166. package/dist/{render-v2-fg8bmdn4.js → render-v2-t7bn4skz.js} +3 -3
  167. package/dist/{resume-1c8kr3nh.js → resume-x94gemep.js} +7 -7
  168. package/dist/{runtime-tzf9j7tc.js → runtime-breq6fmv.js} +1 -1
  169. package/dist/{session-access-d0atq10j.js → session-access-q7dmqjvt.js} +4 -4
  170. package/dist/{session-source-backfill-0vscqmsa.js → session-source-backfill-440ysamr.js} +3 -3
  171. package/dist/{setup-tvfa7rwe.js → setup-07n4727s.js} +1 -1
  172. package/dist/{typesafe-system-one-0bmqcxfg.js → typesafe-system-one-f2en2knd.js} +2 -2
  173. package/dist/virtual-modules-z5h6mcyf.js +362 -0
  174. package/dist/{work-objects-ks71xqeb.js → work-objects-pnq5y534.js} +21 -21
  175. package/dist/{worker-follow-up-bfx0h9hg.js → worker-follow-up-7z1gfkr8.js} +18 -18
  176. package/dist/worker-y62rvvq3.js +71 -0
  177. package/dist/{x-vmmye1kb.js → x-2fyrt5pp.js} +2 -2
  178. package/openapi.json +1169 -257
  179. package/package.json +8 -10
  180. package/src/apps/catalog.generated.json +299 -82
  181. package/src/apps/page-validator.ts +115 -2
  182. package/src/be/connector-codes.ts +21 -6
  183. package/src/be/db/tasks/read.ts +22 -0
  184. package/src/be/db.ts +4 -2
  185. package/src/be/improvements.ts +416 -0
  186. package/src/be/migrations/274_improvements.sql +27 -0
  187. package/src/be/migrations/275_task_dispatched_by.sql +8 -0
  188. package/src/be/rbac-roles.ts +123 -1
  189. package/src/be/swarm-config-guard.ts +1 -0
  190. package/src/be/users.ts +58 -1
  191. package/src/cli.tsx +5 -25
  192. package/src/commands/codex-login.ts +1 -1
  193. package/src/commands/e2b.ts +0 -1
  194. package/src/commands/onboard/agent-fs-version.ts +1 -1
  195. package/src/commands/onboard/compose-generator.ts +0 -1
  196. package/src/commands/onboard/dashboard-url.ts +31 -0
  197. package/src/commands/onboard/steps/generate.tsx +17 -1
  198. package/src/commands/onboard/steps/post-dashboard.tsx +9 -3
  199. package/src/commands/onboard.tsx +19 -6
  200. package/src/commands/runner.ts +117 -96
  201. package/src/extensions/contract-types.generated.ts +1 -1
  202. package/src/hooks/hook.ts +13 -5
  203. package/src/http/all-routes.ts +1 -0
  204. package/src/http/approval-requests.ts +2 -44
  205. package/src/http/auth.ts +5 -4
  206. package/src/http/codex-oauth-accounts.ts +31 -23
  207. package/src/http/codex-oauth-device.ts +1 -1
  208. package/src/http/codex-oauth-keep-warm.ts +1 -1
  209. package/src/http/improvements.ts +317 -0
  210. package/src/http/index.ts +2 -0
  211. package/src/http/operator-actor.ts +2 -1
  212. package/src/http/person-responder.ts +66 -0
  213. package/src/http/sessions.ts +49 -7
  214. package/src/http/tasks.ts +1 -1
  215. package/src/http/user-roles.ts +11 -2
  216. package/src/http/users.ts +194 -104
  217. package/src/providers/acp-targets.ts +1 -1
  218. package/src/providers/amp-adapter.ts +1 -1
  219. package/src/providers/codex-adapter.ts +8 -1
  220. package/src/providers/codex-models.ts +4 -3
  221. package/src/providers/codex-oauth/auth-json.ts +14 -18
  222. package/src/providers/codex-oauth/storage.ts +2 -2
  223. package/src/rbac/legacy-policy.ts +2 -0
  224. package/src/rbac/permissions.ts +10 -0
  225. package/src/scripts-runtime/types/swarm-extension.d.ts +2 -0
  226. package/src/server.ts +2 -0
  227. package/src/slack/ack.ts +20 -14
  228. package/src/slack/render-v2.ts +42 -17
  229. package/src/tests/api-drain-worker-e2e.test.ts +69 -2
  230. package/src/tests/apps-catalog-drift.test.ts +35 -0
  231. package/src/tests/apps-catalog-table.test.ts +203 -0
  232. package/src/tests/apps-element-assembly.test.ts +28 -0
  233. package/src/tests/apps-smart-links.test.ts +151 -0
  234. package/src/tests/apps-table-filters-migration.test.ts +96 -0
  235. package/src/tests/apps-table-selection-migration.test.ts +95 -0
  236. package/src/tests/chatgpt-subscription-session-bench.test.ts +2 -2
  237. package/src/tests/claude-worker-parity.test.ts +2 -2
  238. package/src/tests/codex-adapter.test.ts +30 -0
  239. package/src/tests/codex-login.test.ts +2 -2
  240. package/src/tests/codex-oauth-accounts.test.ts +48 -12
  241. package/src/tests/codex-oauth-credential-info.test.ts +77 -1
  242. package/src/tests/codex-oauth-device.test.ts +1 -1
  243. package/src/tests/codex-oauth-keep-warm.test.ts +2 -2
  244. package/src/tests/codex-oauth.test.ts +25 -4
  245. package/src/tests/codex-pool.test.ts +2 -2
  246. package/src/tests/db-task-read-contract.test.ts +2 -0
  247. package/src/tests/db-task-write-contract.test.ts +1 -0
  248. package/src/tests/deploy-one-box.test.ts +39 -1
  249. package/src/tests/docs-index-footprint.test.js +3 -3
  250. package/src/tests/fixtures/onboard/content.compose.yml.txt +0 -4
  251. package/src/tests/fixtures/onboard/dev.compose.yml.txt +0 -3
  252. package/src/tests/fixtures/onboard/full-all.compose.yml.txt +0 -11
  253. package/src/tests/fixtures/onboard/full.compose.yml.txt +0 -11
  254. package/src/tests/fixtures/onboard/research.compose.yml.txt +0 -3
  255. package/src/tests/fixtures/onboard/solo.compose.yml.txt +0 -1
  256. package/src/tests/fixtures/prs-app-definition.json.txt +784 -0
  257. package/src/tests/fixtures/prs-filters-migration.patch.json.txt +318 -0
  258. package/src/tests/fixtures/prs-selection-migration.patch.json.txt +373 -0
  259. package/src/tests/fixtures/runner-identity-refresh.ts +3 -0
  260. package/src/tests/fixtures/runner-legacy-resume-prompt.ts +3 -0
  261. package/src/tests/fixtures/runner-task-start-reads.ts +140 -0
  262. package/src/tests/hook-ping-me-order.test.ts +85 -0
  263. package/src/tests/improvements-payload.test.ts +200 -0
  264. package/src/tests/improvements-route.test.ts +419 -0
  265. package/src/tests/install-sh-setup-url.test.ts +190 -0
  266. package/src/tests/onboard-dashboard-output.test.ts +109 -0
  267. package/src/tests/onboard-dashboard-url.test.ts +83 -0
  268. package/src/tests/operator-granted-credentials.test.ts +561 -0
  269. package/src/tests/operator-granted-role-wire.test.ts +222 -0
  270. package/src/tests/rbac-engine.test.ts +2 -0
  271. package/src/tests/runner-context-usage.test.ts +0 -1
  272. package/src/tests/runner-legacy-options.test.ts +55 -0
  273. package/src/tests/runner-slot-reconcile.test.ts +38 -0
  274. package/src/tests/runner-task-start-reads.test.ts +58 -0
  275. package/src/tests/send-task-dispatched-by.test.ts +129 -0
  276. package/src/tests/session-dispatched-tasks.test.ts +115 -0
  277. package/src/tests/session-sharing.test.ts +198 -9
  278. package/src/tests/slack-file-tools-attachments.test.ts +95 -3
  279. package/src/tests/slack-reaction-config.test.ts +39 -0
  280. package/src/tests/slack-render-v2.test.ts +47 -0
  281. package/src/tests/submit-improvement-tool.test.ts +82 -0
  282. package/src/tests/tool-annotations.test.ts +1 -1
  283. package/src/tools/manage-user.ts +88 -58
  284. package/src/tools/send-task.ts +3 -0
  285. package/src/tools/slack-read.ts +61 -33
  286. package/src/tools/submit-improvement.ts +68 -0
  287. package/src/tools/tool-config.ts +3 -0
  288. package/src/types.ts +5 -0
  289. package/src/utils/request-auth-context.ts +6 -1
  290. package/templates/skills/apps/SKILL.md +22 -11
  291. package/templates/skills/apps/content.md +22 -11
  292. package/templates/skills/swarm-scripts/SKILL.md +1 -1
  293. package/templates/skills/swarm-scripts/content.md +1 -1
  294. package/templates/skills/work-on-task/SKILL.md +1 -1
  295. package/templates/skills/work-on-task/content.md +1 -1
  296. package/dist/acp-adapter-vg5hqkvj.js +0 -16
  297. package/dist/cli-5c4hjzne.js +0 -873
  298. package/dist/cli-ae0dnfee.js +0 -20222
  299. package/dist/cli-nn3ysbqk.js +0 -428
  300. package/dist/cli-pc5znp64.js +0 -364
  301. package/dist/fx-adapter-m5jbgd5q.js +0 -19
  302. package/dist/grok-adapter-csvv7sac.js +0 -19
  303. package/dist/handlers-8x5gfbzx.js +0 -32
  304. package/dist/index-hpfte8jd.js +0 -33
  305. package/dist/index-ncf7yb5s.js +0 -30
  306. package/dist/index-vte6dyeh.js +0 -37
  307. package/dist/lead-4bvftzm6.js +0 -71
  308. package/dist/virtual-modules-efxcp740.js +0 -59
  309. package/dist/worker-e7v2bvm9.js +0 -71
@@ -53,6 +53,7 @@ const UI_STATE_COMPONENTS = new Set([
53
53
  "Tabs",
54
54
  "Chips",
55
55
  "Tree",
56
+ "Table",
56
57
  ]);
57
58
 
58
59
  /**
@@ -61,7 +62,7 @@ const UI_STATE_COMPONENTS = new Set([
61
62
  * whose items each carry a chain) are listed in `ITEM_ACTION_CHAINS`.
62
63
  */
63
64
  const PROP_ACTION_CHAINS: Record<string, readonly string[]> = {
64
- Table: ["onRowClick"],
65
+ Table: ["onRowClick", "onRetry"],
65
66
  Form: ["onSubmit"],
66
67
  Kanban: ["onMove", "onCardClick"],
67
68
  Calendar: ["onSelect"],
@@ -71,11 +72,12 @@ const PROP_ACTION_CHAINS: Record<string, readonly string[]> = {
71
72
  /**
72
73
  * `[arrayProp, chainKey]` pairs: every item of `props[arrayProp]` carries an
73
74
  * action chain under `chainKey` (Table `rowActions[].actions`, Table
74
- * `columns[].onChange`, Drawer footer `actions[].actions`).
75
+ * `bulkActions[].actions`, Table `columns[].onChange`, Drawer footer `actions[].actions`).
75
76
  */
76
77
  const ITEM_ACTION_CHAINS: Record<string, readonly (readonly [string, string])[]> = {
77
78
  Table: [
78
79
  ["rowActions", "actions"],
80
+ ["bulkActions", "actions"],
79
81
  ["columns", "onChange"],
80
82
  ],
81
83
  Drawer: [["actions", "actions"]],
@@ -699,6 +701,66 @@ function fieldBindingIssue(
699
701
  return issue(path, `unknown or hidden column "${columnName}" on model "${modelName}"`);
700
702
  }
701
703
 
704
+ /** Most fields a Table cell popover lists. */
705
+ const POPOVER_MAX_FIELDS = 12;
706
+
707
+ /** Props of each component holding items whose `href` (and a column's popover fields) name row fields. */
708
+ const LINK_FIELD_PROPS: Record<string, string> = {
709
+ Table: "columns",
710
+ DetailList: "fields",
711
+ CardGrid: "fields",
712
+ };
713
+
714
+ /**
715
+ * `href` on Table columns, DetailList fields and CardGrid fields, and the
716
+ * `key` / `href` of a Table column's popover fields, name row fields of the
717
+ * bound query's model. A typo'd name would render a link with no target, so
718
+ * cross-check them like the other row-field props.
719
+ */
720
+ function collectLinkFieldIssues(
721
+ definition: AppDefinition,
722
+ type: unknown,
723
+ props: Record<string, unknown>,
724
+ elementPath: string,
725
+ issues: AppValidationIssue[],
726
+ ): void {
727
+ const itemsProp = typeof type === "string" ? LINK_FIELD_PROPS[type] : undefined;
728
+ const items = itemsProp ? props[itemsProp] : undefined;
729
+ if (!itemsProp || !Array.isArray(items)) return;
730
+ // The JSON-schema subset this validator evaluates has no `minItems` / `maxItems`.
731
+ for (const [index, item] of items.entries()) {
732
+ const fields = isPlainObject(item) && isPlainObject(item.popover) ? item.popover.fields : null;
733
+ if (Array.isArray(fields) && (fields.length === 0 || fields.length > POPOVER_MAX_FIELDS)) {
734
+ issues.push(
735
+ issue(
736
+ `${elementPath}.props.${itemsProp}.${index}.popover.fields`,
737
+ `must list 1 to ${POPOVER_MAX_FIELDS} fields`,
738
+ ),
739
+ );
740
+ }
741
+ }
742
+ const queryModel = queryModelFromDataBinding(definition, props.data);
743
+ if (!queryModel) return;
744
+ const check = (name: unknown, path: string) => {
745
+ if (typeof name !== "string") return;
746
+ const found = fieldBindingIssue(queryModel.modelName, queryModel.model, name, path);
747
+ if (found) issues.push(found);
748
+ };
749
+ for (const [index, item] of items.entries()) {
750
+ if (!isPlainObject(item)) continue;
751
+ const itemPath = `${elementPath}.props.${itemsProp}.${index}`;
752
+ check(item.href, `${itemPath}.href`);
753
+ const popoverFields = isPlainObject(item.popover) ? item.popover.fields : undefined;
754
+ if (!Array.isArray(popoverFields)) continue;
755
+ for (const [fieldIndex, field] of popoverFields.entries()) {
756
+ if (!isPlainObject(field)) continue;
757
+ const fieldPath = `${itemPath}.popover.fields.${fieldIndex}`;
758
+ check(field.key, `${fieldPath}.key`);
759
+ check(field.href, `${fieldPath}.href`);
760
+ }
761
+ }
762
+ }
763
+
702
764
  function collectRowFieldIssues(
703
765
  value: unknown,
704
766
  path: string,
@@ -1377,7 +1439,58 @@ export function validatePage(
1377
1439
  ),
1378
1440
  );
1379
1441
  }
1442
+ collectLinkFieldIssues(definition, type, rawElement.props, elementPath, issues);
1380
1443
  if (type === "Table") {
1444
+ // Row selection lives at `/ui/<id>/selected`, so it needs an id to root it.
1445
+ const tableProps = rawElement.props;
1446
+ const selectionProps = ["selectable", "bulkActions"].filter((prop) => {
1447
+ const value = tableProps[prop];
1448
+ return value === true || (Array.isArray(value) && value.length > 0);
1449
+ });
1450
+ if (
1451
+ selectionProps.length > 0 &&
1452
+ (typeof tableProps.id !== "string" || tableProps.id === "")
1453
+ ) {
1454
+ issues.push(
1455
+ issue(
1456
+ `${elementPath}.props.id`,
1457
+ `is required with ${selectionProps.join(" / ")}: the selection is stored at /ui/<id>/selected`,
1458
+ ),
1459
+ );
1460
+ }
1461
+ // Column filters live at `/ui/<id>/filters`: same id requirement.
1462
+ const filterProps: string[] = [];
1463
+ if (tableProps.filterable === true) filterProps.push("filterable");
1464
+ if (
1465
+ Array.isArray(tableProps.columns) &&
1466
+ tableProps.columns.some(
1467
+ (column) =>
1468
+ isPlainObject(column) && (column.filter === "values" || column.filter === "text"),
1469
+ )
1470
+ ) {
1471
+ filterProps.push("columns[].filter");
1472
+ }
1473
+ if (filterProps.length > 0 && (typeof tableProps.id !== "string" || tableProps.id === "")) {
1474
+ issues.push(
1475
+ issue(
1476
+ `${elementPath}.props.id`,
1477
+ `is required with ${filterProps.join(" / ")}: the filters are stored at /ui/<id>/filters`,
1478
+ ),
1479
+ );
1480
+ }
1481
+ // `clearState` entries are state paths "Clear filters" resets: only UI
1482
+ // control slots, and the control must exist on the page.
1483
+ if (Array.isArray(tableProps.clearState)) {
1484
+ for (const [index, entry] of tableProps.clearState.entries()) {
1485
+ if (typeof entry !== "string") continue;
1486
+ const entryPath = `${elementPath}.props.clearState.${index}`;
1487
+ if (!/^\/ui\/[^/]+\/.+/.test(entry)) {
1488
+ issues.push(issue(entryPath, `must be a /ui/<id>/... state path (got "${entry}")`));
1489
+ } else {
1490
+ stateRefs.push({ path: entryPath, value: entry });
1491
+ }
1492
+ }
1493
+ }
1381
1494
  const queryModel = queryModelFromDataBinding(definition, rawElement.props.data);
1382
1495
  if (queryModel) {
1383
1496
  if (Array.isArray(rawElement.props.columns)) {
@@ -19,6 +19,7 @@
19
19
 
20
20
  import { createHash, randomBytes } from "node:crypto";
21
21
  import { getDbClient } from "./db";
22
+ import { assertMayActOnOperatorGrantedTarget, userHoldsOperatorGrantedRole } from "./rbac-roles";
22
23
  import { type IdentityActor, mintToken, recordIdentityEvent } from "./users";
23
24
 
24
25
  export type ConnectorCodeKind = "connector" | "invite";
@@ -46,12 +47,17 @@ export async function createConnectorCode(
46
47
  const ttlMs = opts.ttlMs ?? CONNECTOR_CODE_TTL_MS;
47
48
  const code = randomBytes(32).toString("base64url");
48
49
  const expiresAt = new Date(now.getTime() + ttlMs).toISOString();
49
- await getDbClient().run(
50
- `INSERT INTO connector_codes
51
- (code_hash, user_id, label, actor_kind, actor_id, created_at, expires_at, kind)
52
- VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
53
- [sha256Hex(code), userId, label, actor.kind, actor.id, now.toISOString(), expiresAt, kind],
54
- );
50
+ // Check and insert under one write lock, so an operator grant cannot land
51
+ // between them (OperatorGrantedTargetError for another user's auditor).
52
+ await getDbClient().transaction(async (tx) => {
53
+ await assertMayActOnOperatorGrantedTarget(actor, userId);
54
+ await tx.run(
55
+ `INSERT INTO connector_codes
56
+ (code_hash, user_id, label, actor_kind, actor_id, created_at, expires_at, kind)
57
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
58
+ [sha256Hex(code), userId, label, actor.kind, actor.id, now.toISOString(), expiresAt, kind],
59
+ );
60
+ });
55
61
  return { code, expiresAt };
56
62
  }
57
63
 
@@ -82,6 +88,15 @@ export async function exchangeConnectorCode(
82
88
  );
83
89
  if (!row) return null;
84
90
  const actor: IdentityActor = { kind: row.actor_kind, id: row.actor_id };
91
+ // Another user's code must not become a credential for an operator-granted
92
+ // role the target gained after the code was created. The code is spent.
93
+ if (
94
+ actor.kind !== "operator" &&
95
+ actor.id !== row.user_id &&
96
+ (await userHoldsOperatorGrantedRole(row.user_id))
97
+ ) {
98
+ return null;
99
+ }
85
100
 
86
101
  if (kind === "invite") {
87
102
  const activated = await tx.run(
@@ -87,6 +87,7 @@ export type AgentTaskRow = {
87
87
  mentionChannelId: string | null;
88
88
  dir: string | null;
89
89
  parentTaskId: string | null;
90
+ dispatchedByTaskId?: string | null;
90
91
  claudeSessionId: string | null;
91
92
  model: string | null;
92
93
  modelTier: string | null;
@@ -343,6 +344,7 @@ export function rowToAgentTask(row: AgentTaskRow): AgentTask {
343
344
  mentionChannelId: row.mentionChannelId ?? undefined,
344
345
  dir: row.dir ?? undefined,
345
346
  parentTaskId: row.parentTaskId ?? undefined,
347
+ dispatchedByTaskId: row.dispatchedByTaskId ?? undefined,
346
348
  claudeSessionId: row.claudeSessionId ?? undefined,
347
349
  model: row.model ?? undefined,
348
350
  modelTier: parseModelTier(row.modelTier) ?? undefined,
@@ -715,6 +717,26 @@ export async function getTasksByAgentId(
715
717
  return rows.map(rowToAgentTask);
716
718
  }
717
719
 
720
+ /**
721
+ * Tasks that one of `taskIds` dispatched (send-task) and that are not in
722
+ * `taskIds`. A continuation keeps parentTaskId on an earlier task, so the
723
+ * task that sent it does not reach it by the parentTaskId walk.
724
+ */
725
+ export async function getTasksDispatchedFrom(taskIds: string[]): Promise<AgentTask[]> {
726
+ if (taskIds.length === 0) return [];
727
+ const ids = JSON.stringify(taskIds);
728
+ const rows = await getDbClient().query<AgentTaskRow>(
729
+ `SELECT t.*,
730
+ (SELECT SUM(totalCostUsd) FROM session_costs WHERE session_costs.taskId = t.id) AS totalCostUsd
731
+ FROM agent_tasks t
732
+ WHERE t.dispatchedByTaskId IN (SELECT value FROM json_each(?))
733
+ AND t.id NOT IN (SELECT value FROM json_each(?))
734
+ ORDER BY t.createdAt, t.rowid`,
735
+ [ids, ids],
736
+ );
737
+ return rows.map(rowToAgentTask);
738
+ }
739
+
718
740
  /**
719
741
  * Get the most recently updated in-progress task for an agent.
720
742
  * Used as a fallback when X-Source-Task-Id header is missing (e.g. lead agent HITL requests).
package/src/be/db.ts CHANGED
@@ -380,6 +380,7 @@ export {
380
380
  getTasksByAgentId,
381
381
  getTasksByStatus,
382
382
  getTasksCount,
383
+ getTasksDispatchedFrom,
383
384
  giveUpStaleChatRelays,
384
385
  hasNonTerminalRerouteDecisionChild,
385
386
  hasNonTerminalResumeChild,
@@ -2962,9 +2963,9 @@ export async function createTaskExtended(
2962
2963
  vcsProvider, vcsRepo, vcsEventType, vcsNumber, vcsCommentId, vcsAuthor, vcsUrl,
2963
2964
  vcsInstallationId, vcsNodeId,
2964
2965
  agentmailInboxId, agentmailMessageId, agentmailThreadId,
2965
- mentionMessageId, mentionChannelId, dir, parentTaskId, model, modelTier, effort, profile, scheduleId,
2966
+ mentionMessageId, mentionChannelId, dir, parentTaskId, dispatchedByTaskId, model, modelTier, effort, profile, scheduleId,
2966
2967
  workflowRunId, workflowRunStepId, outputSchema, followUpConfig, requestedByUserId, requestedByUserIdInherited, contextKey, routingAffinity, swarmVersion, createdAt, lastUpdatedAt, created_by, updated_by, isHumanFree
2967
- ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
2968
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
2968
2969
  [
2969
2970
  id,
2970
2971
  insertKey,
@@ -3003,6 +3004,7 @@ export async function createTaskExtended(
3003
3004
  options?.mentionChannelId ?? null,
3004
3005
  options?.dir ?? null,
3005
3006
  options?.parentTaskId ?? null,
3007
+ options?.dispatchedByTaskId ?? null,
3006
3008
  options?.model ?? null,
3007
3009
  options?.modelTier ?? null,
3008
3010
  options?.effort ?? null,
@@ -0,0 +1,416 @@
1
+ /**
2
+ * Improvements: short product comments an install sends to desplega through
3
+ * the telemetry proxy (`POST /v1/improvements`).
4
+ *
5
+ * Invariants:
6
+ * - An agent can only draft. A row leaves `pending_approval` only through
7
+ * `approveAndSend`, whose caller passes the approving person taken from the
8
+ * credential (a user id or `operator`). The DB refuses a `sending` / `sent`
9
+ * row without `approved_by`.
10
+ * - Exactly `install_id`, `text` and `email` leave the install, built by
11
+ * `buildImprovementPayload`. All three always go: the approver must give a
12
+ * valid email, and `install_id` is minted here when telemetry never did.
13
+ * - `IMPROVEMENTS_ENABLED=false` refuses every create, send and discard.
14
+ */
15
+ import { parseEnvFlag } from "../utils/env-flag";
16
+ import { scrubSecrets } from "../utils/secret-scrubber";
17
+ import { getDbClient, getSwarmConfigs, upsertSwarmConfig } from "./db";
18
+
19
+ export const IMPROVEMENTS_ENABLED_KEY = "IMPROVEMENTS_ENABLED";
20
+ export const IMPROVEMENT_TEXT_MAX = 4000;
21
+ const SEND_TIMEOUT_MS = 10_000;
22
+ const PROXY_ERROR_MAX = 1024;
23
+ const LEAK_HINTS_MAX = 50;
24
+ const INSTALL_ID_KEY = "telemetry_installation_id";
25
+ const EMAIL_MAX = 320;
26
+ const VALID_EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
27
+
28
+ /** A trimmed email of at most 320 characters with a local part, an `@` and a dotted domain. */
29
+ export function isValidImprovementEmail(value: string | null | undefined): value is string {
30
+ const trimmed = value?.trim() ?? "";
31
+ return trimmed.length > 0 && trimmed.length <= EMAIL_MAX && VALID_EMAIL_RE.test(trimmed);
32
+ }
33
+
34
+ export const IMPROVEMENT_STATUSES = [
35
+ "pending_approval",
36
+ "sending",
37
+ "sent",
38
+ "failed",
39
+ "discarded",
40
+ ] as const;
41
+ export type ImprovementStatus = (typeof IMPROVEMENT_STATUSES)[number];
42
+ export const IMPROVEMENT_SOURCES = ["mcp", "api", "ui"] as const;
43
+ export type ImprovementSource = (typeof IMPROVEMENT_SOURCES)[number];
44
+
45
+ export type Improvement = {
46
+ id: string;
47
+ text: string;
48
+ email: string | null;
49
+ status: ImprovementStatus;
50
+ source: ImprovementSource;
51
+ requestedByAgentId: string | null;
52
+ approvedBy: string | null;
53
+ approvedAt: string | null;
54
+ sentAt: string | null;
55
+ proxyStatus: number | null;
56
+ proxyId: string | null;
57
+ proxyError: string | null;
58
+ createdAt: string;
59
+ updatedAt: string;
60
+ };
61
+
62
+ type ImprovementRow = {
63
+ id: string;
64
+ text: string;
65
+ email: string | null;
66
+ status: ImprovementStatus;
67
+ source: ImprovementSource;
68
+ requested_by_agent_id: string | null;
69
+ approved_by: string | null;
70
+ approved_at: string | null;
71
+ sent_at: string | null;
72
+ proxy_status: number | null;
73
+ proxy_id: string | null;
74
+ proxy_error: string | null;
75
+ created_at: string;
76
+ updated_at: string;
77
+ };
78
+
79
+ function toImprovement(row: ImprovementRow): Improvement {
80
+ return {
81
+ id: row.id,
82
+ text: row.text,
83
+ email: row.email,
84
+ status: row.status,
85
+ source: row.source,
86
+ requestedByAgentId: row.requested_by_agent_id,
87
+ approvedBy: row.approved_by,
88
+ approvedAt: row.approved_at,
89
+ sentAt: row.sent_at,
90
+ proxyStatus: row.proxy_status,
91
+ proxyId: row.proxy_id,
92
+ proxyError: row.proxy_error,
93
+ createdAt: row.created_at,
94
+ updatedAt: row.updated_at,
95
+ };
96
+ }
97
+
98
+ export type ImprovementErrorCode =
99
+ | "improvements_disabled"
100
+ | "invalid_text"
101
+ | "invalid_email"
102
+ | "not_found"
103
+ | "conflict";
104
+
105
+ export class ImprovementError extends Error {
106
+ constructor(
107
+ readonly code: ImprovementErrorCode,
108
+ message: string,
109
+ ) {
110
+ super(message);
111
+ this.name = "ImprovementError";
112
+ }
113
+ }
114
+
115
+ /** A global config value, stored rows first, then the deployment env. */
116
+ async function globalValue(key: string): Promise<string | undefined> {
117
+ const stored = (await getSwarmConfigs({ scope: "global", key }))?.[0]?.value;
118
+ return (stored ?? process.env[key])?.trim() || undefined;
119
+ }
120
+
121
+ /** The kill switch. On unless `IMPROVEMENTS_ENABLED` is set to false. */
122
+ export async function isImprovementsEnabled(): Promise<boolean> {
123
+ return parseEnvFlag(await globalValue(IMPROVEMENTS_ENABLED_KEY), true);
124
+ }
125
+
126
+ async function assertEnabled(): Promise<void> {
127
+ if (!(await isImprovementsEnabled())) {
128
+ throw new ImprovementError(
129
+ "improvements_disabled",
130
+ "Improvements are turned off (IMPROVEMENTS_ENABLED=false).",
131
+ );
132
+ }
133
+ }
134
+
135
+ export type ImprovementPayload = { install_id: string; text: string; email: string };
136
+
137
+ /**
138
+ * The only body that leaves the install. It copies exactly three named fields,
139
+ * so no row, config or agent value can ride along.
140
+ */
141
+ export function buildImprovementPayload(input: {
142
+ installId: string;
143
+ text: string;
144
+ email: string;
145
+ }): ImprovementPayload {
146
+ return { install_id: input.installId, text: input.text, email: input.email };
147
+ }
148
+
149
+ /**
150
+ * The install id, whether or not telemetry is on. An install that never ran
151
+ * with telemetry has none, so the first send mints one in the telemetry
152
+ * format and stores it under the same key: turning telemetry on later reuses
153
+ * it. The read and the insert share one write transaction, so two first
154
+ * sends cannot mint two ids.
155
+ */
156
+ export async function improvementInstallId(): Promise<string> {
157
+ return getDbClient().transaction(async () => {
158
+ const existing = await globalValue(INSTALL_ID_KEY);
159
+ if (existing) return existing;
160
+ const minted = `install_${crypto.randomUUID().replace(/-/g, "").slice(0, 16)}`;
161
+ await upsertSwarmConfig({ scope: "global", key: INSTALL_ID_KEY, value: minted });
162
+ return minted;
163
+ });
164
+ }
165
+
166
+ export async function getImprovement(id: string): Promise<Improvement | null> {
167
+ const row = await getDbClient().get<ImprovementRow>("SELECT * FROM improvements WHERE id = ?", [
168
+ id,
169
+ ]);
170
+ return row ? toImprovement(row) : null;
171
+ }
172
+
173
+ /**
174
+ * Every row a person still has to act on (`pending_approval`, `failed`), plus
175
+ * the newest `historyLimit` other rows, newest first. Only history is capped:
176
+ * an actionable draft must stay reachable however many newer rows exist.
177
+ */
178
+ export async function listImprovements(historyLimit = 100): Promise<Improvement[]> {
179
+ const rows = await getDbClient().query<ImprovementRow>(
180
+ `SELECT * FROM improvements WHERE status IN ('pending_approval', 'failed')
181
+ UNION ALL
182
+ SELECT * FROM (
183
+ SELECT * FROM improvements WHERE status NOT IN ('pending_approval', 'failed')
184
+ ORDER BY created_at DESC, id DESC LIMIT ?
185
+ )
186
+ ORDER BY created_at DESC, id DESC`,
187
+ [historyLimit],
188
+ );
189
+ return rows.map(toImprovement);
190
+ }
191
+
192
+ /**
193
+ * Store a draft as `pending_approval`. The text is scrubbed before it is
194
+ * stored; `scrubChanged` tells a person's direct send to stop at pending, so
195
+ * they see the redacted text before it leaves.
196
+ */
197
+ export async function createImprovement(input: {
198
+ text: string;
199
+ source: ImprovementSource;
200
+ requestedByAgentId?: string | null;
201
+ createdBy?: string | null;
202
+ }): Promise<{ improvement: Improvement; scrubChanged: boolean }> {
203
+ await assertEnabled();
204
+ const trimmed = input.text.trim();
205
+ const scrubbed = scrubSecrets(trimmed);
206
+ if (scrubbed.length === 0 || scrubbed.length > IMPROVEMENT_TEXT_MAX) {
207
+ throw new ImprovementError(
208
+ "invalid_text",
209
+ `Text must be 1 to ${IMPROVEMENT_TEXT_MAX} characters after trimming.`,
210
+ );
211
+ }
212
+ const id = crypto.randomUUID();
213
+ const now = new Date().toISOString();
214
+ await getDbClient().run(
215
+ `INSERT INTO improvements
216
+ (id, text, status, source, requested_by_agent_id, created_at, updated_at, created_by, updated_by)
217
+ VALUES (?, ?, 'pending_approval', ?, ?, ?, ?, ?, ?)`,
218
+ [
219
+ id,
220
+ scrubbed,
221
+ input.source,
222
+ input.requestedByAgentId ?? null,
223
+ now,
224
+ now,
225
+ input.createdBy ?? null,
226
+ input.createdBy ?? null,
227
+ ],
228
+ );
229
+ const improvement = await getImprovement(id);
230
+ if (!improvement) throw new Error(`Improvement ${id} vanished after insert`);
231
+ return { improvement, scrubChanged: scrubbed !== trimmed };
232
+ }
233
+
234
+ /**
235
+ * Approve a draft and send it. `approvedBy` must come from the caller's
236
+ * credential (a user id or `operator`), never from a request body. `email` is
237
+ * required: a draft carries none until its approver gives one. The claim
238
+ * (`pending_approval` or `failed` → `sending`) is one conditional UPDATE, so a
239
+ * double approve gets a conflict instead of a second send. There is no
240
+ * automatic retry: the proxy has no idempotency key.
241
+ */
242
+ export async function approveAndSend(
243
+ id: string,
244
+ approval: {
245
+ approvedBy: string;
246
+ email: string;
247
+ endpoint: string;
248
+ updatedBy?: string | null;
249
+ },
250
+ ): Promise<Improvement> {
251
+ await assertEnabled();
252
+ if (!isValidImprovementEmail(approval.email)) {
253
+ throw new ImprovementError("invalid_email", "A valid email is required to send.");
254
+ }
255
+ const email = approval.email.trim();
256
+ // Resolved before the claim, so a failed mint cannot strand a row in `sending`.
257
+ const installId = await improvementInstallId();
258
+ const approvedAt = new Date().toISOString();
259
+ const claimed = await getDbClient().transaction(async (tx) => {
260
+ const result = await tx.run(
261
+ `UPDATE improvements
262
+ SET status = 'sending', approved_by = ?, approved_at = ?, email = ?,
263
+ proxy_status = NULL, proxy_id = NULL, proxy_error = NULL,
264
+ updated_at = ?, updated_by = ?
265
+ WHERE id = ? AND status IN ('pending_approval', 'failed')`,
266
+ [approval.approvedBy, approvedAt, email, approvedAt, approval.updatedBy ?? null, id],
267
+ );
268
+ if (result.changes === 1) {
269
+ return tx.get<ImprovementRow>("SELECT * FROM improvements WHERE id = ?", [id]);
270
+ }
271
+ return null;
272
+ });
273
+ if (!claimed) {
274
+ const existing = await getImprovement(id);
275
+ if (!existing) throw new ImprovementError("not_found", `Improvement ${id} not found.`);
276
+ throw new ImprovementError(
277
+ "conflict",
278
+ `Improvement ${id} is ${existing.status}; only pending or failed improvements can be approved.`,
279
+ );
280
+ }
281
+
282
+ const payload = buildImprovementPayload({
283
+ installId,
284
+ text: claimed.text,
285
+ email,
286
+ });
287
+ let proxyStatus: number | null = null;
288
+ let proxyId: string | null = null;
289
+ let proxyError: string | null = null;
290
+ try {
291
+ const response = await fetch(approval.endpoint, {
292
+ method: "POST",
293
+ headers: { "Content-Type": "application/json" },
294
+ body: JSON.stringify(payload),
295
+ signal: AbortSignal.timeout(SEND_TIMEOUT_MS),
296
+ });
297
+ proxyStatus = response.status;
298
+ const body = await response.text().catch(() => "");
299
+ if (response.ok) {
300
+ try {
301
+ const parsed = JSON.parse(body) as { id?: unknown };
302
+ proxyId = typeof parsed.id === "string" ? parsed.id : null;
303
+ } catch {
304
+ proxyId = null;
305
+ }
306
+ } else {
307
+ proxyError = body || `HTTP ${response.status}`;
308
+ }
309
+ } catch (error) {
310
+ proxyError = error instanceof Error ? error.message : String(error);
311
+ }
312
+
313
+ const sent = proxyStatus !== null && proxyStatus >= 200 && proxyStatus < 300;
314
+ const finishedAt = new Date().toISOString();
315
+ await getDbClient().run(
316
+ `UPDATE improvements
317
+ SET status = ?, sent_at = ?, proxy_status = ?, proxy_id = ?, proxy_error = ?, updated_at = ?
318
+ WHERE id = ?`,
319
+ [
320
+ sent ? "sent" : "failed",
321
+ sent ? finishedAt : null,
322
+ proxyStatus,
323
+ proxyId,
324
+ proxyError ? scrubSecrets(proxyError).slice(0, PROXY_ERROR_MAX) : null,
325
+ finishedAt,
326
+ id,
327
+ ],
328
+ );
329
+ const finished = await getImprovement(id);
330
+ if (!finished) throw new Error(`Improvement ${id} vanished after send`);
331
+ return finished;
332
+ }
333
+
334
+ /** Discard a pending or failed draft. The caller checks who may discard. */
335
+ export async function discardImprovement(
336
+ id: string,
337
+ options?: { updatedBy?: string | null },
338
+ ): Promise<Improvement> {
339
+ await assertEnabled();
340
+ const now = new Date().toISOString();
341
+ const result = await getDbClient().run(
342
+ `UPDATE improvements SET status = 'discarded', updated_at = ?, updated_by = ?
343
+ WHERE id = ? AND status IN ('pending_approval', 'failed')`,
344
+ [now, options?.updatedBy ?? null, id],
345
+ );
346
+ const existing = await getImprovement(id);
347
+ if (!existing) throw new ImprovementError("not_found", `Improvement ${id} not found.`);
348
+ if (result.changes !== 1) {
349
+ throw new ImprovementError(
350
+ "conflict",
351
+ `Improvement ${id} is ${existing.status}; only pending or failed improvements can be discarded.`,
352
+ );
353
+ }
354
+ return existing;
355
+ }
356
+
357
+ function hostOf(value: string | undefined): string | null {
358
+ if (!value) return null;
359
+ try {
360
+ return new URL(value.includes("://") ? value : `https://${value}`).host || null;
361
+ } catch {
362
+ return null;
363
+ }
364
+ }
365
+
366
+ const URL_RE = /\bhttps?:\/\/[^\s<>"')]+/gi;
367
+ const EMAIL_RE = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g;
368
+
369
+ /**
370
+ * Substrings of `text` that look like install-specific details: agent names,
371
+ * repo names and URLs, the dashboard and API hosts, the org name and website,
372
+ * user emails, and any URL or email. They warn the approver; they never block.
373
+ */
374
+ export async function improvementLeakHints(text: string): Promise<string[]> {
375
+ const client = getDbClient();
376
+ const [agents, repos, users] = await Promise.all([
377
+ client.query<{ name: string | null }>("SELECT name FROM agents"),
378
+ client.query<{ name: string | null; url: string | null }>("SELECT name, url FROM swarm_repos"),
379
+ client.query<{ email: string | null }>("SELECT email FROM users WHERE email IS NOT NULL"),
380
+ ]);
381
+ const terms = new Set<string>();
382
+ const add = (value: string | null | undefined) => {
383
+ const trimmed = value?.trim();
384
+ if (trimmed && trimmed.length >= 3) terms.add(trimmed);
385
+ };
386
+ for (const agent of agents) add(agent.name);
387
+ for (const repo of repos) {
388
+ add(repo.name);
389
+ add(repo.url);
390
+ }
391
+ for (const user of users) add(user.email);
392
+ add(hostOf(process.env.MCP_BASE_URL));
393
+ add(hostOf(process.env.APP_URL));
394
+ const orgName = await globalValue("SWARM_ORG_NAME");
395
+ const orgWebsite = await globalValue("SWARM_ORG_WEBSITE");
396
+ add(orgName);
397
+ add(orgWebsite);
398
+ add(hostOf(orgWebsite));
399
+
400
+ const hits: string[] = [];
401
+ const seen = new Set<string>();
402
+ const push = (hit: string) => {
403
+ const key = hit.toLowerCase();
404
+ if (seen.has(key) || hits.length >= LEAK_HINTS_MAX) return;
405
+ seen.add(key);
406
+ hits.push(hit);
407
+ };
408
+ const lower = text.toLowerCase();
409
+ for (const term of terms) {
410
+ const at = lower.indexOf(term.toLowerCase());
411
+ if (at >= 0) push(text.slice(at, at + term.length));
412
+ }
413
+ for (const match of text.matchAll(URL_RE)) push(match[0]);
414
+ for (const match of text.matchAll(EMAIL_RE)) push(match[0]);
415
+ return hits;
416
+ }