@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
@@ -2,7 +2,6 @@ import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
3
  import { decryptSecret, getEncryptionKey } from "../be/crypto";
4
4
  import { deleteKv, deleteSwarmConfigByKey, getDbClient, getKeyStatuses, getKv } from "../be/db";
5
- import { retirePoolKeyStatus } from "../be/db/api-keys";
6
5
  import { deriveCodexKeySuffix } from "../providers/codex-oauth/auth-json";
7
6
  import { decodeJwt, extractChatgptPlanType } from "../providers/codex-oauth/flow";
8
7
  import { MAX_CODEX_OAUTH_SLOT } from "../providers/codex-oauth/storage";
@@ -92,11 +91,6 @@ function readCredentials(row: AccountRow): z.infer<typeof AccountCredentialsSche
92
91
  }
93
92
  }
94
93
 
95
- function accountSuffix(row: AccountRow): string | null {
96
- const credentials = readCredentials(row);
97
- return credentials ? deriveCodexKeySuffix(credentials.access, credentials.accountId) : null;
98
- }
99
-
100
94
  async function accountsResponse(): Promise<CodexAccountsResponse> {
101
95
  const rows = await accountRows();
102
96
  const statuses = await getKeyStatuses("CODEX_OAUTH", "global", null);
@@ -116,18 +110,24 @@ async function accountsResponse(): Promise<CodexAccountsResponse> {
116
110
  accounts.push(account);
117
111
  continue;
118
112
  }
119
- account.suffix = deriveCodexKeySuffix(credentials.access, credentials.accountId);
113
+ account.suffix = deriveCodexKeySuffix(credentials.access, credentials.accountId, row.slot);
120
114
  account.plan = extractChatgptPlanType(credentials.access);
121
115
  const profile = decodeJwt(credentials.access)?.["https://api.openai.com/profile"];
122
116
  if (profile && typeof profile === "object" && "email" in profile) {
123
117
  account.email = typeof profile.email === "string" && profile.email ? profile.email : null;
124
118
  }
125
- const status = statuses.find((entry) => entry.keySuffix === account.suffix);
119
+ // Pool availability reads Codex rows by keyIndex, so a row stored at this
120
+ // slot under an older suffix format still decides whether it is benched.
121
+ const slotStatuses = statuses.filter(
122
+ (entry) => entry.keySuffix === account.suffix || entry.keyIndex === row.slot,
123
+ );
124
+ const status = slotStatuses.find((entry) => entry.keySuffix === account.suffix);
126
125
  const marker = await getKv(CODEX_AUTH_WATCH_NAMESPACE, codexAuthBenchMarkerKey(account.suffix));
127
- const statusBenched =
128
- status &&
129
- status.consecutiveAuthFailures >= CODEX_AUTH_FAILURE_BENCH_THRESHOLD &&
130
- status.status === "rate_limited";
126
+ const statusBenched = slotStatuses.some(
127
+ (entry) =>
128
+ entry.consecutiveAuthFailures >= CODEX_AUTH_FAILURE_BENCH_THRESHOLD &&
129
+ entry.status === "rate_limited",
130
+ );
131
131
  account.status = marker || statusBenched ? "needs_login" : status ? "ok" : "unchecked";
132
132
  accounts.push(account);
133
133
  }
@@ -165,17 +165,25 @@ export async function handleCodexOAuthAccounts(
165
165
  const account = rows.find((row) => row.slot === parsed.params.slot);
166
166
  if (!account || !(await deleteSwarmConfigByKey("global", null, account.key))) return null;
167
167
  // A new sign-in takes the first free slot, so it must not inherit this
168
- // account's auth bench (keyed by slot) or its bench marker.
169
- const suffix = accountSuffix(account);
170
- if (suffix) {
171
- const remaining = rows.flatMap((row) => {
172
- const keySuffix = row === account ? null : accountSuffix(row);
173
- return keySuffix ? [{ keySuffix, keyIndex: row.slot }] : [];
174
- });
175
- await retirePoolKeyStatus("CODEX_OAUTH", suffix, remaining);
176
- if (!remaining.some((row) => row.keySuffix === suffix)) {
177
- await deleteKv(CODEX_AUTH_WATCH_NAMESPACE, codexAuthBenchMarkerKey(suffix));
178
- }
168
+ // account's auth bench or its bench marker. Suffixes carry the slot, so
169
+ // every status row at this slot index is this account's, including rows
170
+ // stored under the pre-slot suffix format.
171
+ const credentials = readCredentials(account);
172
+ const suffix = credentials
173
+ ? deriveCodexKeySuffix(credentials.access, credentials.accountId, account.slot)
174
+ : null;
175
+ const retired = await getDbClient().query<{ keySuffix: string }>(
176
+ `DELETE FROM api_key_status
177
+ WHERE keyType = 'CODEX_OAUTH' AND scope = 'global' AND scopeId = ''
178
+ AND (keyIndex = ? OR keySuffix = ?)
179
+ RETURNING keySuffix`,
180
+ [account.slot, suffix],
181
+ );
182
+ for (const keySuffix of new Set([
183
+ ...(suffix ? [suffix] : []),
184
+ ...retired.map((r) => r.keySuffix),
185
+ ])) {
186
+ await deleteKv(CODEX_AUTH_WATCH_NAMESPACE, codexAuthBenchMarkerKey(keySuffix));
179
187
  }
180
188
  return account.key;
181
189
  });
@@ -218,7 +218,7 @@ async function completeFlow(
218
218
  // OpenAI just issued this token. Record the account as checked, so the
219
219
  // account list says "Signed in" now: a worker's Codex check is a presence
220
220
  // check and reports no per-account result.
221
- const keySuffix = deriveCodexKeySuffix(credentials.access, credentials.accountId);
221
+ const keySuffix = deriveCodexKeySuffix(credentials.access, credentials.accountId, slot);
222
222
  const checked = [{ keyIndex: slot, keySuffix, ok: true }];
223
223
  await recordKeyValidation("CODEX_OAUTH", checked, "global", null, { retireAbsent: false });
224
224
  await updateOnboardingAiFromCodexDevice({ status: "complete" });
@@ -106,7 +106,7 @@ export async function handleCodexOAuthKeepWarm(
106
106
  const results: SlotOutcome[] = [];
107
107
 
108
108
  for (const { slot, creds } of slots) {
109
- const keySuffix = deriveCodexKeySuffix(creds.access, creds.accountId);
109
+ const keySuffix = deriveCodexKeySuffix(creds.access, creds.accountId, slot);
110
110
 
111
111
  if (await getKv(CODEX_AUTH_WATCH_NAMESPACE, codexAuthBenchMarkerKey(keySuffix))) {
112
112
  results.push({ slot, keySuffix, outcome: "skipped-benched" });
@@ -0,0 +1,317 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ import { z } from "zod";
3
+ import {
4
+ approveAndSend,
5
+ createImprovement,
6
+ discardImprovement,
7
+ getImprovement,
8
+ IMPROVEMENT_SOURCES,
9
+ IMPROVEMENT_STATUSES,
10
+ IMPROVEMENT_TEXT_MAX,
11
+ type Improvement,
12
+ ImprovementError,
13
+ improvementLeakHints,
14
+ isImprovementsEnabled,
15
+ listImprovements,
16
+ } from "../be/improvements";
17
+ import { can } from "../rbac";
18
+ import { approvalResponder, responderKey } from "./person-responder";
19
+ import { agentFirstPrincipal } from "./request-principal";
20
+ import { route } from "./route-def";
21
+ import { telemetryProxyEndpoint } from "./used-by";
22
+ import { jsonError } from "./utils";
23
+
24
+ // ─── Schemas ─────────────────────────────────────────────────────────────────
25
+
26
+ const ImprovementSchema = z.object({
27
+ id: z.string(),
28
+ text: z.string(),
29
+ email: z.string().nullable(),
30
+ status: z.enum(IMPROVEMENT_STATUSES),
31
+ source: z.enum(IMPROVEMENT_SOURCES),
32
+ requestedByAgentId: z.string().nullable(),
33
+ approvedBy: z.string().nullable(),
34
+ approvedAt: z.string().nullable(),
35
+ sentAt: z.string().nullable(),
36
+ proxyStatus: z.number().nullable(),
37
+ proxyId: z.string().nullable(),
38
+ proxyError: z.string().nullable(),
39
+ createdAt: z.string(),
40
+ updatedAt: z.string(),
41
+ leakHints: z
42
+ .array(z.string())
43
+ .optional()
44
+ .describe(
45
+ "Substrings that look install-specific (agent, repo, host, org or user email). Pending and failed rows only. They warn; they never block.",
46
+ ),
47
+ });
48
+
49
+ const EmailSchema = z
50
+ .string()
51
+ .max(320, "Email must be at most 320 characters")
52
+ .email("Email must be a valid email address");
53
+
54
+ const PERSON_REFUSED =
55
+ "Agents cannot approve improvements. A person must approve with a user token or the dashboard.";
56
+
57
+ // ─── Route Definitions ───────────────────────────────────────────────────────
58
+
59
+ const listRoute = route({
60
+ method: "get",
61
+ path: "/api/improvements",
62
+ pattern: ["api", "improvements"],
63
+ summary: "List product improvements",
64
+ description:
65
+ "Lists improvements newest first, with `enabled` for the `IMPROVEMENTS_ENABLED` switch: every pending and failed row, plus the newest 100 other rows. Pending and failed rows carry `leakHints` for the approver.",
66
+ tags: ["Improvements"],
67
+ responses: {
68
+ 200: {
69
+ description: "Improvements and the switch state",
70
+ schema: z.object({ enabled: z.boolean(), improvements: z.array(ImprovementSchema) }),
71
+ },
72
+ },
73
+ auth: { apiKey: true },
74
+ });
75
+
76
+ const createRoute = route({
77
+ method: "post",
78
+ path: "/api/improvements",
79
+ pattern: ["api", "improvements"],
80
+ summary: "Draft a product improvement, or send one as a person",
81
+ description:
82
+ "Stores the text, scrubbed of known secrets, as `pending_approval`. An agent caller always gets a pending draft. A person (user token, or the shared key with no agent identity) may pass `sendNow: true` to approve and send in one call, unless scrubbing changed the text: then it stays pending so they can review it. `sendNow` needs a valid `email` (400 without one); a draft does not. Only `install_id` (always), `text` and `email` are sent to desplega.",
83
+ tags: ["Improvements"],
84
+ body: z.object({
85
+ text: z.string().max(IMPROVEMENT_TEXT_MAX * 2),
86
+ email: EmailSchema.optional(),
87
+ sendNow: z.boolean().optional(),
88
+ source: z.enum(["ui", "api"]).optional(),
89
+ }),
90
+ responses: {
91
+ 200: {
92
+ description: "A person's `sendNow` was approved and sent (see `status`)",
93
+ schema: z.object({ improvement: ImprovementSchema }),
94
+ },
95
+ 201: {
96
+ description: "Draft stored as `pending_approval`",
97
+ schema: z.object({ improvement: ImprovementSchema }),
98
+ },
99
+ 400: { description: "Invalid text or email, or `sendNow` without an email" },
100
+ 403: { description: "The caller may not draft improvements" },
101
+ 409: { description: "Improvements are turned off" },
102
+ },
103
+ auth: { apiKey: true },
104
+ rbac: { permission: "improvement.submit" },
105
+ });
106
+
107
+ const approveRoute = route({
108
+ method: "post",
109
+ path: "/api/improvements/{id}/approve",
110
+ pattern: ["api", "improvements", null, "approve"],
111
+ summary: "Approve and send a drafted improvement",
112
+ description:
113
+ "Only a person may approve: a user token, or the shared key with no agent identity (recorded as `operator`). `approvedBy` is taken from the credential, never the body. `email` is required and is sent with the text and the install id. The stored text is sent as is; to change it, discard and draft again. A failed send can be approved again. There is no automatic retry.",
114
+ tags: ["Improvements"],
115
+ params: z.object({ id: z.string().uuid() }),
116
+ body: z.object({ email: EmailSchema.describe("The approver's email, sent with the text.") }),
117
+ responses: {
118
+ 200: {
119
+ description: "Approved. `status` is `sent`, or `failed` with the proxy status and error.",
120
+ schema: z.object({ improvement: ImprovementSchema }),
121
+ },
122
+ 400: { description: "Missing or invalid email" },
123
+ 403: { description: "Caller is an agent" },
124
+ 404: { description: "Not found" },
125
+ 409: { description: "Already sent, sending or discarded, or improvements are turned off" },
126
+ },
127
+ auth: { apiKey: true },
128
+ rbac: { permission: "improvement.approve" },
129
+ });
130
+
131
+ const discardRoute = route({
132
+ method: "post",
133
+ path: "/api/improvements/{id}/discard",
134
+ pattern: ["api", "improvements", null, "discard"],
135
+ summary: "Discard a drafted improvement",
136
+ description:
137
+ "A person may discard any pending or failed improvement. An agent may discard only a draft it requested.",
138
+ tags: ["Improvements"],
139
+ params: z.object({ id: z.string().uuid() }),
140
+ responses: {
141
+ 200: {
142
+ description: "Discarded",
143
+ schema: z.object({ improvement: ImprovementSchema }),
144
+ },
145
+ 403: { description: "Caller is an agent that did not request this draft" },
146
+ 404: { description: "Not found" },
147
+ 409: { description: "Already sent or discarded, or improvements are turned off" },
148
+ },
149
+ auth: { apiKey: true },
150
+ rbac: { permission: "improvement.submit" },
151
+ });
152
+
153
+ // ─── Helpers ─────────────────────────────────────────────────────────────────
154
+
155
+ function headerAgentId(req: IncomingMessage): string | undefined {
156
+ const raw = req.headers["x-agent-id"];
157
+ return Array.isArray(raw) ? raw[0] : raw;
158
+ }
159
+
160
+ function writeImprovementError(res: ServerResponse, error: unknown): boolean {
161
+ if (!(error instanceof ImprovementError)) return false;
162
+ const status =
163
+ error.code === "invalid_text" || error.code === "invalid_email"
164
+ ? 400
165
+ : error.code === "not_found"
166
+ ? 404
167
+ : 409; /* conflict, improvements_disabled */
168
+ if (error.code === "improvements_disabled") {
169
+ res.writeHead(409, { "Content-Type": "application/json" });
170
+ res.end(JSON.stringify({ error: error.message, code: error.code }));
171
+ return true;
172
+ }
173
+ jsonError(res, error.message, status);
174
+ return true;
175
+ }
176
+
177
+ async function withLeakHints(improvement: Improvement) {
178
+ if (improvement.status !== "pending_approval" && improvement.status !== "failed") {
179
+ return improvement;
180
+ }
181
+ return { ...improvement, leakHints: await improvementLeakHints(improvement.text) };
182
+ }
183
+
184
+ async function improvementsEndpoint(): Promise<string> {
185
+ return telemetryProxyEndpoint("/v1/improvements");
186
+ }
187
+
188
+ // ─── Handler ─────────────────────────────────────────────────────────────────
189
+
190
+ export async function handleImprovements(
191
+ req: IncomingMessage,
192
+ res: ServerResponse,
193
+ pathSegments: string[],
194
+ queryParams: URLSearchParams,
195
+ ): Promise<boolean> {
196
+ if (listRoute.match(req.method, pathSegments)) {
197
+ const parsed = await listRoute.parse(req, res, pathSegments, queryParams);
198
+ if (!parsed) return true;
199
+ const rows = await listImprovements();
200
+ listRoute.respond(res, 200, {
201
+ enabled: await isImprovementsEnabled(),
202
+ improvements: await Promise.all(rows.map(withLeakHints)),
203
+ });
204
+ return true;
205
+ }
206
+
207
+ if (createRoute.match(req.method, pathSegments)) {
208
+ const parsed = await createRoute.parse(req, res, pathSegments, queryParams);
209
+ if (!parsed) return true;
210
+ const { text, email, sendNow, source } = parsed.body;
211
+ if (sendNow && !email) {
212
+ jsonError(res, "sendNow needs a valid email.", 400);
213
+ return true;
214
+ }
215
+ const principal = await agentFirstPrincipal(req, headerAgentId(req));
216
+ const decision = can({ principal, verb: "improvement.submit", source: "http" });
217
+ if (!decision.allow) {
218
+ jsonError(res, decision.reason, 403);
219
+ return true;
220
+ }
221
+ const agentId = principal.kind === "agent" ? principal.agentId || null : null;
222
+ const userId = principal.kind === "user" ? principal.userId : null;
223
+ try {
224
+ const { improvement, scrubChanged } = await createImprovement({
225
+ text,
226
+ source: source ?? "api",
227
+ requestedByAgentId: agentId,
228
+ createdBy: userId,
229
+ });
230
+ // The send needs a person from the credential. An agent's `sendNow` is
231
+ // ignored: its draft waits for a person.
232
+ if (sendNow && email && !scrubChanged) {
233
+ const person = await approvalResponder(req, {
234
+ verb: "improvement.approve",
235
+ refusedMessage: PERSON_REFUSED,
236
+ });
237
+ if (person.ok) {
238
+ const sent = await approveAndSend(improvement.id, {
239
+ approvedBy: responderKey(person.responder),
240
+ email,
241
+ endpoint: await improvementsEndpoint(),
242
+ updatedBy: person.responder.kind === "user" ? person.responder.user.id : null,
243
+ });
244
+ createRoute.respond(res, 200, { improvement: sent });
245
+ return true;
246
+ }
247
+ }
248
+ createRoute.respond(res, 201, { improvement: await withLeakHints(improvement) });
249
+ } catch (error) {
250
+ if (!writeImprovementError(res, error)) throw error;
251
+ }
252
+ return true;
253
+ }
254
+
255
+ if (approveRoute.match(req.method, pathSegments)) {
256
+ const parsed = await approveRoute.parse(req, res, pathSegments, queryParams);
257
+ if (!parsed) return true;
258
+ const person = await approvalResponder(req, {
259
+ verb: "improvement.approve",
260
+ refusedMessage: PERSON_REFUSED,
261
+ pageMessage: "A page session without a signed-in user cannot approve improvements.",
262
+ });
263
+ if (!person.ok) {
264
+ jsonError(res, person.message, 403);
265
+ return true;
266
+ }
267
+ try {
268
+ const improvement = await approveAndSend(parsed.params.id, {
269
+ approvedBy: responderKey(person.responder),
270
+ email: parsed.body.email,
271
+ endpoint: await improvementsEndpoint(),
272
+ updatedBy: person.responder.kind === "user" ? person.responder.user.id : null,
273
+ });
274
+ approveRoute.respond(res, 200, { improvement });
275
+ } catch (error) {
276
+ if (!writeImprovementError(res, error)) throw error;
277
+ }
278
+ return true;
279
+ }
280
+
281
+ if (discardRoute.match(req.method, pathSegments)) {
282
+ const parsed = await discardRoute.parse(req, res, pathSegments, queryParams);
283
+ if (!parsed) return true;
284
+ const existing = await getImprovement(parsed.params.id);
285
+ if (!existing) {
286
+ jsonError(res, "Improvement not found", 404);
287
+ return true;
288
+ }
289
+ const principal = await agentFirstPrincipal(req, headerAgentId(req));
290
+ let updatedBy: string | null = null;
291
+ if (principal.kind === "agent") {
292
+ if (!principal.agentId || principal.agentId !== existing.requestedByAgentId) {
293
+ jsonError(res, "An agent may discard only an improvement it drafted.", 403);
294
+ return true;
295
+ }
296
+ } else {
297
+ const person = await approvalResponder(req, {
298
+ verb: "improvement.approve",
299
+ refusedMessage: "Only a person or the drafting agent may discard this improvement.",
300
+ });
301
+ if (!person.ok) {
302
+ jsonError(res, person.message, 403);
303
+ return true;
304
+ }
305
+ updatedBy = person.responder.kind === "user" ? person.responder.user.id : null;
306
+ }
307
+ try {
308
+ const improvement = await discardImprovement(parsed.params.id, { updatedBy });
309
+ discardRoute.respond(res, 200, { improvement });
310
+ } catch (error) {
311
+ if (!writeImprovementError(res, error)) throw error;
312
+ }
313
+ return true;
314
+ }
315
+
316
+ return false;
317
+ }
package/src/http/index.ts CHANGED
@@ -94,6 +94,7 @@ import { handleFavorites } from "./favorites";
94
94
  import { handleFleetBenchmark } from "./fleet-benchmark";
95
95
  import { handleFs } from "./fs";
96
96
  import { handleHeartbeat } from "./heartbeat";
97
+ import { handleImprovements } from "./improvements";
97
98
  import { handleInboxState } from "./inbox-state";
98
99
  import { handleIntegrations } from "./integrations";
99
100
  import { handleKv } from "./kv";
@@ -421,6 +422,7 @@ const httpServer = createHttpServer(async (req, res) => {
421
422
  () => handleInboxState(req, res, pathSegments, queryParams),
422
423
  () => handleTelemetryUi(req, res, pathSegments, queryParams, myAgentId),
423
424
  () => handleUsedBy(req, res, pathSegments, queryParams, myAgentId),
425
+ () => handleImprovements(req, res, pathSegments, queryParams),
424
426
  () => handleRanking(req, res, pathSegments, queryParams),
425
427
  () => handleFleetBenchmark(req, res, pathSegments, queryParams),
426
428
  () => handleTaskTemplates(req, res, pathSegments, queryParams),
@@ -46,7 +46,8 @@ export function getOperatorActor(req: IncomingMessage, res: ServerResponse): Ide
46
46
  const auth = getRequestAuth(req);
47
47
  const userId = authUserId(auth);
48
48
  if (userId) {
49
- return { kind: "user", id: userId };
49
+ const tokenId = auth?.kind === "user" ? auth.tokenId : undefined;
50
+ return tokenId ? { kind: "user", id: userId, tokenId } : { kind: "user", id: userId };
50
51
  }
51
52
  if (isOperatorAuth(auth)) {
52
53
  return { kind: "operator", id: auth.fingerprint };
@@ -0,0 +1,66 @@
1
+ import type { IncomingMessage } from "node:http";
2
+ import { getUserGrant } from "../be/rbac-roles";
3
+ import { can, isRbacEnabled, type PermissionVerb } from "../rbac";
4
+ import type { User } from "../types";
5
+ import { getRequestAuth } from "../utils/request-auth-context";
6
+ import { agentFirstPrincipal, authUser } from "./request-principal";
7
+
8
+ export type ApprovalResponder = { kind: "user"; user: User } | { kind: "operator" };
9
+
10
+ const AGENT_RESPONSE_REFUSED =
11
+ "Agents cannot answer approval requests. A person must respond with a user token or the dashboard.";
12
+
13
+ /**
14
+ * The person answering an approval request, taken from the credential and
15
+ * never from the request body. Every agent identity is refused: an `aseph_`
16
+ * session token, the shared key with an `X-Agent-ID`, and a page session with
17
+ * no signed-in user (page code is agent-authored, so it cannot vouch for a
18
+ * person). The shared key alone is the operator.
19
+ *
20
+ * `verb` and `refusedMessage` let other person-gated actions reuse the check
21
+ * with their own permission and wording. With RBAC on, a user must also hold
22
+ * `verb` through a role: route admission checks only the route's own verb, and
23
+ * a route admitted on another verb can still reach this check.
24
+ */
25
+ export async function approvalResponder(
26
+ req: IncomingMessage,
27
+ options?: { verb?: PermissionVerb; refusedMessage?: string; pageMessage?: string },
28
+ ): Promise<{ ok: true; responder: ApprovalResponder } | { ok: false; message: string }> {
29
+ const auth = getRequestAuth(req);
30
+ const rawAgentId = req.headers["x-agent-id"];
31
+ const headerAgentId = Array.isArray(rawAgentId) ? rawAgentId[0] : rawAgentId;
32
+ const principal = await agentFirstPrincipal(req, headerAgentId);
33
+
34
+ if (principal.kind !== "user" && principal.kind !== "agent" && auth?.page) {
35
+ return {
36
+ ok: false,
37
+ message:
38
+ options?.pageMessage ??
39
+ "A page session without a signed-in user cannot answer approval requests.",
40
+ };
41
+ }
42
+ const user = authUser(auth);
43
+ const responder: ApprovalResponder | null =
44
+ principal.kind === "user" && user
45
+ ? { kind: "user", user }
46
+ : principal.kind === "operator"
47
+ ? { kind: "operator" }
48
+ : null;
49
+
50
+ const verb = options?.verb ?? "approval.respond";
51
+ const refused = {
52
+ ok: false as const,
53
+ message: options?.refusedMessage ?? AGENT_RESPONSE_REFUSED,
54
+ };
55
+ const decision = can({ principal, verb, source: "http" });
56
+ if (!decision.allow || !responder) return refused;
57
+ if (responder.kind === "user" && isRbacEnabled()) {
58
+ const grant = await getUserGrant(responder.user.id);
59
+ if (!grant.grantsAll && !grant.verbs.has(verb)) return refused;
60
+ }
61
+ return { ok: true, responder };
62
+ }
63
+
64
+ export function responderKey(responder: ApprovalResponder): string {
65
+ return responder.kind === "user" ? responder.user.id : "operator";
66
+ }
@@ -19,6 +19,7 @@ import {
19
19
  getPendingApprovalsForTasks,
20
20
  getRootTaskChain,
21
21
  getTaskById,
22
+ getTasksDispatchedFrom,
22
23
  listRecentSessions,
23
24
  } from "../be/db";
24
25
  import { getSessionLabels } from "../be/db/session-labels";
@@ -37,9 +38,11 @@ import {
37
38
  import { getUserGrant } from "../be/rbac-roles";
38
39
  import {
39
40
  getSessionRoot,
41
+ getSessionRoots,
40
42
  hasSessionAccess,
41
43
  listActiveSessionShares,
42
44
  type SessionAccess,
45
+ type SessionRoot,
43
46
  sessionAccessForRoot,
44
47
  setSessionShares,
45
48
  toSessionSharesState,
@@ -594,16 +597,17 @@ const listSessions = route({
594
597
  * an empty list for mine or shared.
595
598
  * tree: Sessions that GET /api/session-tree counts: mine plus shared with me,
596
599
  * no ownerless roots. A bypass actor sees every root.
597
- * all: every user's sessions, read-only. Honored for a user who may read
598
- * every session (admin, or `session.read.all`); anyone else gets the
599
- * default list. The `X-Swarm-Session-Scope: all` header opts in the same
600
- * way and also lifts the tree scope.
600
+ * all: every user's sessions, read-only. Honored for a user whose role
601
+ * lists `session.read.all` (the built-in `auditor` role; grant-all admin
602
+ * alone does not count); anyone else gets the default list. The
603
+ * `X-Swarm-Session-Scope: all` header opts in the same way and also lifts
604
+ * the tree scope.
601
605
  */
602
606
  scope: z
603
607
  .enum(["mine", "shared", "tree", "all"])
604
608
  .optional()
605
609
  .describe(
606
- "mine: owned sessions. shared: sessions shared with me. tree: Sessions that GET /api/session-tree counts: mine plus shared with me, no ownerless roots. A bypass actor sees every root with tree scope. all: every user's sessions, read-only, for a user with an admin role or session.read.all; ignored for anyone else. The X-Swarm-Session-Scope: all header opts in the same way, also for tree.",
610
+ "mine: owned sessions. shared: sessions shared with me. tree: Sessions that GET /api/session-tree counts: mine plus shared with me, no ownerless roots. A bypass actor sees every root with tree scope. all: every user's sessions, read-only, for a user whose role lists session.read.all (the built-in auditor role; the grant-all admin role alone does not count); ignored for anyone else. The X-Swarm-Session-Scope: all header opts in the same way, also for tree.",
607
611
  ),
608
612
  /** With `scope=tree`: `mine` (default) or `all`. Must match the tree's `show`. */
609
613
  show: SessionShowSchema,
@@ -787,6 +791,40 @@ async function checkSessionMove(
787
791
  return { taskIds: tasks.map((task) => task.id) };
788
792
  }
789
793
 
794
+ /**
795
+ * The chain plus the tasks it dispatched that hang elsewhere: a
796
+ * continuation's parentTaskId points at an earlier task, so the walk from a
797
+ * non-root task misses it, and that task can sit in another session. A task
798
+ * in another session joins only when the viewer can read that session, so
799
+ * the route grants no access beyond what the viewer already has.
800
+ */
801
+ async function withDispatchedTasks(
802
+ chain: AgentTask[],
803
+ sessionRootId: string,
804
+ actor: SessionActor,
805
+ ): Promise<AgentTask[]> {
806
+ const dispatched = await getTasksDispatchedFrom(chain.map((task) => task.id));
807
+ if (dispatched.length === 0) return chain;
808
+ const roots = await getSessionRoots(dispatched.map((task) => task.id));
809
+ const foreignRoots = new Map<string, SessionRoot>();
810
+ for (const root of roots.values()) {
811
+ if (root.id !== sessionRootId) foreignRoots.set(root.id, root);
812
+ }
813
+ const readable = new Set<string>([sessionRootId]);
814
+ await Promise.all(
815
+ [...foreignRoots.values()].map(async (root) => {
816
+ if ((await accessForRoot(actor, root)) !== "none") readable.add(root.id);
817
+ }),
818
+ );
819
+ const visible = dispatched.filter((task) => {
820
+ const root = roots.get(task.id);
821
+ return root !== undefined && readable.has(root.id);
822
+ });
823
+ if (visible.length === 0) return chain;
824
+ // A stable sort keeps the chain's insertion order on equal timestamps.
825
+ return [...chain, ...visible].sort((a, b) => a.createdAt.localeCompare(b.createdAt));
826
+ }
827
+
790
828
  const getSession = route({
791
829
  method: "get",
792
830
  path: "/api/sessions/{rootTaskId}",
@@ -798,7 +836,7 @@ const getSession = route({
798
836
  responses: {
799
837
  200: {
800
838
  description:
801
- "Root task + chain (ordered by createdAt), plus the caller's `access` and the session `owner`",
839
+ "Root task + chain (ordered by createdAt), plus the caller's `access` and the session `owner`. The chain also holds tasks a chain task dispatched (`dispatchedByTaskId`) that sit elsewhere: in the same session, or in another session the caller can read.",
802
840
  schema: z.object({
803
841
  root: TaskWithSteeringSchema,
804
842
  chain: z.array(TaskWithSteeringSchema),
@@ -1225,7 +1263,11 @@ export async function handleSessions(
1225
1263
  name: ownerUser?.name ?? sessionRoot.requestedByUserId,
1226
1264
  }
1227
1265
  : null;
1228
- const chain = await getRootTaskChain(parsed.params.rootTaskId);
1266
+ const chain = await withDispatchedTasks(
1267
+ await getRootTaskChain(parsed.params.rootTaskId),
1268
+ sessionRoot.id,
1269
+ actor,
1270
+ );
1229
1271
  // Load steering, citations and pending approvals for the already loaded chain.
1230
1272
  const tasks = [root, ...chain];
1231
1273
  const [steering, citations, approvals, read, groupKey] = await Promise.all([
package/src/http/tasks.ts CHANGED
@@ -281,7 +281,7 @@ const listTasks = route({
281
281
  .enum(["all"])
282
282
  .optional()
283
283
  .describe(
284
- "all: every user's tasks, read-only, for a user with an admin role or session.read.all; ignored for anyone else. The X-Swarm-Session-Scope: all header opts in the same way.",
284
+ "all: every user's tasks, read-only, for a user whose role lists session.read.all (the built-in auditor role; the grant-all admin role alone does not count); ignored for anyone else. The X-Swarm-Session-Scope: all header opts in the same way.",
285
285
  ),
286
286
  }),
287
287
  responses: {