@desplega.ai/agent-swarm 2.7.7 → 2.7.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (401) hide show
  1. package/dist/acp-adapter-dn4gdsgr.js +16 -0
  2. package/dist/{actions-3tt153af.js → actions-g563mbn2.js} +19 -19
  3. package/dist/{amp-adapter-njpts0yr.js → amp-adapter-q61w05eb.js} +3 -3
  4. package/dist/{anthropic-messages-xey2skwx.js → anthropic-messages-jkva0zps.js} +68 -78
  5. package/dist/{app-nky4378f.js → app-a66ssc4k.js} +3 -3
  6. package/dist/{assistant-jnb669pa.js → assistant-p477rjwj.js} +22 -22
  7. package/dist/{azure-openai-responses-26t7j9ra.js → azure-openai-responses-wgtqkbr3.js} +5 -10
  8. package/dist/boot-args-schema-h4qj462e.js +89 -0
  9. package/dist/{boot-reembed-9mgvaztt.js → boot-reembed-n1ehfbsw.js} +1 -1
  10. package/dist/{boot-reembed-qs2djdej.js → boot-reembed-qw4mc0pt.js} +1 -1
  11. package/dist/{boot-scrub-sweep-yjpdj7s1.js → boot-scrub-sweep-9w9jp4sm.js} +4 -4
  12. package/dist/{boot-seeds-5cm6ambd.js → boot-seeds-qdaf3sdy.js} +5 -4
  13. package/dist/{boxd-nv507va8.js → boxd-qbkxy6ap.js} +1 -1
  14. package/dist/{claude-adapter-fn287zmm.js → claude-adapter-348p5hx9.js} +8 -8
  15. package/dist/{claude-managed-adapter-dvs2xw5n.js → claude-managed-adapter-h74d06yz.js} +4 -4
  16. package/dist/{claude-managed-setup-wtdz2mj2.js → claude-managed-setup-7787fxtp.js} +5 -5
  17. package/dist/{claude-sdk-session-x91kqyhm.js → claude-sdk-session-hbszbt8a.js} +7901 -7718
  18. package/dist/{cli-cb2a8pna.js → cli-09kmfkmq.js} +4 -6
  19. package/dist/{cli-m0da8j35.js → cli-0whpms1z.js} +15 -10
  20. package/dist/{cli-5zx699j9.js → cli-12xyjhws.js} +29 -12
  21. package/dist/{cli-snpj5zbj.js → cli-1z4qggfe.js} +9 -36
  22. package/dist/{cli-e0kmphd6.js → cli-21159vea.js} +35 -12
  23. package/dist/{cli-s0qnd4wv.js → cli-28fq781p.js} +1 -1
  24. package/dist/{cli-qh4d4tvk.js → cli-2a8py3sx.js} +6 -6
  25. package/dist/{cli-adeegh7d.js → cli-2ccpqyyf.js} +412 -116
  26. package/dist/{cli-1p89xny0.js → cli-2r0jcc3k.js} +1 -1
  27. package/dist/{cli-rvtm68yy.js → cli-2xv18ywz.js} +2 -2
  28. package/dist/{cli-5xaqj21p.js → cli-3kd08rej.js} +1 -1
  29. package/dist/{cli-1c6tzt8g.js → cli-3tqcamp6.js} +13 -13
  30. package/dist/{cli-ae7mrdf9.js → cli-3vjhs18n.js} +4 -6
  31. package/dist/{cli-vfym7wmz.js → cli-3xcwp3z8.js} +10 -12
  32. package/dist/{cli-az48n0nr.js → cli-4caa1x7d.js} +67 -64
  33. package/dist/{cli-5jnhv72d.js → cli-4t0fmf3z.js} +30 -7
  34. package/dist/{cli-5b456bpf.js → cli-530hkwdy.js} +7 -9
  35. package/dist/{cli-pz4rk021.js → cli-54vrpgm0.js} +1 -1
  36. package/dist/{cli-ddaanqkd.js → cli-587857ys.js} +7 -7
  37. package/dist/{cli-r9jqcehk.js → cli-5mpy301f.js} +38 -2
  38. package/dist/{cli-cppkf404.js → cli-605nn699.js} +80 -43
  39. package/dist/{cli-6pfd54vx.js → cli-650zv9q9.js} +10 -10
  40. package/dist/cli-6pzk82fd.js +778 -0
  41. package/dist/{cli-gz6q4eve.js → cli-715t1gx6.js} +9 -9
  42. package/dist/{cli-08bmz9z9.js → cli-9aezs55w.js} +10 -12
  43. package/dist/{cli-tgrv9cjx.js → cli-9r5gtwjr.js} +3 -3
  44. package/dist/{cli-pc6n7fre.js → cli-a0657jmf.js} +2 -2
  45. package/dist/{cli-pjctyea3.js → cli-agyaeef4.js} +3 -3
  46. package/dist/cli-b932gexn.js +5266 -0
  47. package/dist/{cli-e46hg0xw.js → cli-bc779n4v.js} +3 -3
  48. package/dist/{cli-jtjtabxe.js → cli-btc9cb4c.js} +78 -5
  49. package/dist/{cli-caj33vcq.js → cli-btf6fw39.js} +5 -5
  50. package/dist/{cli-q3tkegby.js → cli-cseh6f8w.js} +5 -5
  51. package/dist/{cli-n6bv12jn.js → cli-cvs2r2vq.js} +23 -14
  52. package/dist/{cli-tfyyvzx6.js → cli-cyn9v8zr.js} +17 -2
  53. package/dist/{cli-a22h291q.js → cli-d6521kb5.js} +1 -1
  54. package/dist/{cli-1b7btd38.js → cli-d84byzn8.js} +869 -5
  55. package/dist/{cli-wx3rhnm0.js → cli-eddnyg3t.js} +1 -1
  56. package/dist/{cli-nmzhp1b5.js → cli-ejkvvqbe.js} +55 -46
  57. package/dist/{cli-ftyxyspd.js → cli-eqtfgfr6.js} +1 -1
  58. package/dist/{cli-mthwvjre.js → cli-f2zenhja.js} +1 -1
  59. package/dist/{cli-ws19768n.js → cli-fayav105.js} +624 -227
  60. package/dist/{cli-ferkkrg9.js → cli-fjggej24.js} +2 -2
  61. package/dist/{cli-g7s47cc5.js → cli-fsgttth8.js} +123 -102
  62. package/dist/{cli-8305gbq0.js → cli-gce09r66.js} +5 -5
  63. package/dist/{cli-mkk9rnzz.js → cli-gxy8y1dt.js} +51 -4
  64. package/dist/{cli-fyt2g4wd.js → cli-hae9j8sv.js} +288 -76
  65. package/dist/{cli-agfm16v9.js → cli-hg42n3hx.js} +12 -12
  66. package/dist/{cli-qghe0h66.js → cli-hwprv9e4.js} +8 -10
  67. package/dist/{cli-yndmfxb3.js → cli-hxpyc9sn.js} +3 -3
  68. package/dist/{cli-72v799xn.js → cli-jfx48xrj.js} +10 -12
  69. package/dist/{cli-dhar9qay.js → cli-jrp1dt73.js} +2 -2
  70. package/dist/{cli-98rw5dt5.js → cli-jrzkw01m.js} +2 -2
  71. package/dist/{cli-ayayvfg4.js → cli-k70e3x9e.js} +24 -20
  72. package/dist/{cli-583frbyr.js → cli-kchjb7qy.js} +1 -1
  73. package/dist/{cli-cm5yqn35.js → cli-kf3pxxdg.js} +1 -0
  74. package/dist/{cli-fmjd0t1y.js → cli-m0cy2vyf.js} +2 -2
  75. package/dist/{cli-4zsenjhy.js → cli-m5akxq8q.js} +16 -3
  76. package/dist/{cli-73jzwksr.js → cli-m88rpzkh.js} +6 -3
  77. package/dist/{cli-95jzxcp3.js → cli-mnrkgg60.js} +4 -4
  78. package/dist/{cli-p82cnnjq.js → cli-ms5m5r1y.js} +1 -1
  79. package/dist/{cli-fy6x31ps.js → cli-n5yexkdg.js} +1 -0
  80. package/dist/{cli-wk5yrfwd.js → cli-neyag5p6.js} +191 -85
  81. package/dist/cli-p0m0p34z.js +9321 -0
  82. package/dist/{cli-yyj3j5m4.js → cli-p17970qv.js} +8 -10
  83. package/dist/{cli-6vcp76qk.js → cli-p74md7t8.js} +42 -23
  84. package/dist/{cli-rjcbm574.js → cli-pr0eze3x.js} +2 -2
  85. package/dist/{cli-35rsp8ye.js → cli-qkdmz8c8.js} +1 -1
  86. package/dist/{cli-rtt8g4v9.js → cli-qmd3mse0.js} +2 -2
  87. package/dist/{cli-je518txm.js → cli-qzt90yze.js} +20 -20
  88. package/dist/cli-rkc97c6a.js +39 -0
  89. package/dist/{cli-75gkpjvw.js → cli-rvhdmjvt.js} +8 -12
  90. package/dist/{cli-6g0hb4cp.js → cli-rwymrnaz.js} +18608 -9089
  91. package/dist/{cli-3fg0bdcv.js → cli-serm8zrx.js} +6 -6
  92. package/dist/{cli-g08zdaec.js → cli-sgs5k6yd.js} +1 -1
  93. package/dist/{cli-afkqkrtw.js → cli-sya22y84.js} +21 -9
  94. package/dist/{cli-318r69gq.js → cli-t73cas91.js} +440 -9
  95. package/dist/{cli-e5bzrn01.js → cli-tqq0hspb.js} +2 -2
  96. package/dist/{cli-pq73h5mz.js → cli-v3cf1ts9.js} +3 -3
  97. package/dist/{cli-bfv7vdg6.js → cli-varqt4d1.js} +28 -16
  98. package/dist/{cli-k899ehvh.js → cli-vxh6acp7.js} +6 -6
  99. package/dist/{cli-g83s9ewh.js → cli-xfjrc279.js} +1 -1
  100. package/dist/{cli-k1nje3v3.js → cli-xk879m3k.js} +129 -115
  101. package/dist/{cli-7cx2m6t2.js → cli-y5rbvxhc.js} +2 -2
  102. package/dist/{cli-8sckt74b.js → cli-y8nbefpb.js} +41 -19
  103. package/dist/{cli-81p9jd57.js → cli-yab6sh8p.js} +9 -3
  104. package/dist/{cli-srye3vdt.js → cli-ybjdc978.js} +1 -1
  105. package/dist/{cli-k5671be5.js → cli-zcfpsfzf.js} +5 -5
  106. package/dist/{cli-vf078p3e.js → cli-zfqg6fzn.js} +1 -1
  107. package/dist/{cli-k8196sh2.js → cli-zgv8gxgs.js} +9 -8
  108. package/dist/cli.js +34 -52
  109. package/dist/{cloudflare-workers-ai-system-one-ef2a980q.js → cloudflare-workers-ai-system-one-9y1zx3pt.js} +2 -2
  110. package/dist/{codex-adapter-cf2yxe9m.js → codex-adapter-ysq6bzha.js} +7 -7
  111. package/dist/{codex-hook-a0c6g6t6.js → codex-hook-fac6175r.js} +1 -1
  112. package/dist/{codex-login-y0pmff1c.js → codex-login-bcda78ge.js} +2 -2
  113. package/dist/{codex-session-runner-6vfzdgbd.js → codex-session-runner-qakzfx93.js} +8 -8
  114. package/dist/{commands-t3mfy7vn.js → commands-rs7hkv9r.js} +3 -3
  115. package/dist/{controller-q7xrbaz0.js → controller-r5x9bg6e.js} +4 -4
  116. package/dist/{controllers-connect-c6nm70kg.js → controllers-connect-498hrxvk.js} +24 -24
  117. package/dist/{cursor-adapter-ftd81ga8.js → cursor-adapter-d46qszer.js} +2 -2
  118. package/dist/{db-vemtpmcc.js → db-pm96nhdb.js} +6 -2
  119. package/dist/{db-dk572x25.js → db-s13dqhr6.js} +3 -3
  120. package/dist/{devin-adapter-r9phbnc9.js → devin-adapter-z46ep5ph.js} +1 -1
  121. package/dist/{dispatcher-kh7ecxh9.js → dispatcher-j3h81t7m.js} +18 -18
  122. package/dist/{docker-c1a3gqmf.js → docker-866qpzt9.js} +2 -2
  123. package/dist/{dsh-adapter-v8628r89.js → dsh-adapter-rw0d5rc4.js} +2 -2
  124. package/dist/{e2b-fr12yccx.js → e2b-jkwfhbcv.js} +2 -2
  125. package/dist/{e2b-x6ywzak3.js → e2b-s16txnpx.js} +2 -3
  126. package/dist/{easter-egg-3d-nenw4x63.js → easter-egg-3d-qtgfxgze.js} +1 -1
  127. package/dist/{embedding-space-0jepb239.js → embedding-space-xh8p4q4x.js} +6 -6
  128. package/dist/{embeddings-xxt49yxg.js → embeddings-wp745m91.js} +1 -1
  129. package/dist/{event-bus-g0ka3pbw.js → event-bus-e66gh7cc.js} +1 -1
  130. package/dist/{execute-1mhw6e4x.js → execute-2fzb9z74.js} +1 -1
  131. package/dist/{external-channel-55v12e60.js → external-channel-ys21h3sy.js} +2 -2
  132. package/dist/fx-adapter-vz0b9z3g.js +19 -0
  133. package/dist/{google-generative-ai-v94hr7h0.js → google-generative-ai-ytpgncx9.js} +7 -12
  134. package/dist/{google-vertex-g7vr6cf8.js → google-vertex-tqhze5j7.js} +7 -12
  135. package/dist/grok-adapter-spea7zkj.js +19 -0
  136. package/dist/handlers-crckt5dq.js +32 -0
  137. package/dist/{heartbeat-k42svnr0.js → heartbeat-8phn1kdq.js} +21 -21
  138. package/dist/{hook-6nphweh0.js → hook-amcj4s10.js} +16 -11
  139. package/dist/{hook-114m7hap.js → hook-bc6n49qn.js} +5 -5
  140. package/dist/{http-r8cc4wz7.js → http-7374brv5.js} +854 -332
  141. package/dist/index-4x08sjtk.js +30 -0
  142. package/dist/{index-6cxzwfen.js → index-5a9jtqde.js} +26 -26
  143. package/dist/index-8ybffts4.js +37 -0
  144. package/dist/{index-nh3wyqdt.js → index-c9y31ytf.js} +16 -16
  145. package/dist/{index-h39zbx67.js → index-hsad2t3r.js} +31 -31
  146. package/dist/index-nfy4kkg5.js +33 -0
  147. package/dist/{index-e3s8wmxy.js → index-p4hjwbvw.js} +1 -1
  148. package/dist/{index-k7fj52d3.js → index-q5cmtbz5.js} +6 -6
  149. package/dist/{index-fpk4bcd9.js → index-w4m9z29z.js} +1 -1
  150. package/dist/{keepalive-x060nt9p.js → keepalive-wy29kbrg.js} +4 -4
  151. package/dist/lead-zdqxsvjn.js +71 -0
  152. package/dist/{llama-cpp-classify-s5c47rwh.js → llama-cpp-classify-nfgswa1m.js} +2 -2
  153. package/dist/{maintenance-2xxfexhf.js → maintenance-h2ds9w6c.js} +1 -1
  154. package/dist/{mistral-conversations-3gjpdb4b.js → mistral-conversations-a45tx39a.js} +29 -51
  155. package/dist/{oauth-refresh-sweep-fckc4ar5.js → oauth-refresh-sweep-q7mtbyp3.js} +3 -3
  156. package/dist/{onboard-zc48j237.js → onboard-vw8r2fdw.js} +68 -16
  157. package/dist/{openai-codex-responses-8pbxq9h5.js → openai-codex-responses-k9gapdze.js} +7 -11
  158. package/dist/{openai-completions-rm00s912.js → openai-completions-xd579js7.js} +50 -58
  159. package/dist/{openai-decisions-8v957r2r.js → openai-decisions-q3hh60wr.js} +2 -2
  160. package/dist/{openai-responses-agxpf96k.js → openai-responses-4d5dx3c7.js} +5 -10
  161. package/dist/{opencode-adapter-r690h1cr.js → opencode-adapter-mtb0953j.js} +6 -6
  162. package/dist/{openrouter-images-3ecegv0d.js → openrouter-images-xr9gme9x.js} +4 -3
  163. package/dist/{otel-impl-r5xbh81q.js → otel-impl-j42czw3r.js} +2 -2
  164. package/dist/{pi-messages-pchtw4he.js → pi-messages-hjbv8v10.js} +28 -12
  165. package/dist/{pi-mono-adapter-c7v8sdec.js → pi-mono-adapter-zk8pg9jr.js} +30 -27
  166. package/dist/{pricing-refresh-3pmre11v.js → pricing-refresh-x7nhv23d.js} +3 -3
  167. package/dist/{rbac-roles-3vbshwsb.js → rbac-roles-9044425x.js} +16 -2
  168. package/dist/rbac-roles-bzvee6cf.js +37 -0
  169. package/dist/{render-v2-pxykkbab.js → render-v2-t7bn4skz.js} +3 -3
  170. package/dist/{resume-adda0bwy.js → resume-x94gemep.js} +7 -7
  171. package/dist/{runtime-fnbm7stk.js → runtime-breq6fmv.js} +1 -1
  172. package/dist/{session-access-2fvamrdc.js → session-access-q7dmqjvt.js} +7 -5
  173. package/dist/{session-source-backfill-08xvv0sm.js → session-source-backfill-440ysamr.js} +3 -3
  174. package/dist/{setup-1aqmvmh1.js → setup-07n4727s.js} +1 -1
  175. package/dist/{typesafe-system-one-0bmqcxfg.js → typesafe-system-one-f2en2knd.js} +2 -2
  176. package/dist/virtual-modules-z5h6mcyf.js +362 -0
  177. package/dist/{work-objects-9s0yrm5j.js → work-objects-pnq5y534.js} +21 -21
  178. package/dist/{worker-follow-up-3q78fqmr.js → worker-follow-up-7z1gfkr8.js} +18 -18
  179. package/dist/worker-y62rvvq3.js +71 -0
  180. package/dist/{x-vmmye1kb.js → x-2fyrt5pp.js} +2 -2
  181. package/openapi.json +1268 -276
  182. package/package.json +10 -10
  183. package/src/apps/catalog.generated.json +299 -82
  184. package/src/apps/page-validator.ts +115 -2
  185. package/src/be/connector-codes.ts +21 -6
  186. package/src/be/db/model-profiles.ts +1 -1
  187. package/src/be/db/session-tree.ts +9 -5
  188. package/src/be/db/session-visibility.ts +25 -9
  189. package/src/be/db/tasks/read.ts +33 -6
  190. package/src/be/db/tasks/write.ts +77 -7
  191. package/src/be/db-queries/tracker.ts +4 -2
  192. package/src/be/db.ts +53 -19
  193. package/src/be/improvements.ts +416 -0
  194. package/src/be/migrations/271_subscription_usage_model.sql +30 -0
  195. package/src/be/migrations/274_improvements.sql +27 -0
  196. package/src/be/migrations/275_task_dispatched_by.sql +8 -0
  197. package/src/be/model-validation.ts +19 -1
  198. package/src/be/rbac-roles.ts +144 -1
  199. package/src/be/runtime-pools/routing.ts +1 -1
  200. package/src/be/scripts/boot-args-schema.ts +95 -0
  201. package/src/be/scripts/extract-schema.ts +15 -10
  202. package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -1
  203. package/src/be/seed-scripts/catalog/boot-triage.ts +1 -1
  204. package/src/be/seed-scripts/catalog/get-child-outputs.ts +1 -1
  205. package/src/be/seed-scripts/catalog/wait-for-task.ts +1 -1
  206. package/src/be/swarm-config-guard.ts +8 -0
  207. package/src/be/users.ts +64 -5
  208. package/src/cli.tsx +5 -25
  209. package/src/commands/claude-managed-setup.ts +1 -1
  210. package/src/commands/codex-login.ts +1 -1
  211. package/src/commands/e2b.ts +0 -1
  212. package/src/commands/onboard/agent-fs-version.ts +1 -1
  213. package/src/commands/onboard/compose-generator.ts +0 -1
  214. package/src/commands/onboard/dashboard-url.ts +31 -0
  215. package/src/commands/onboard/steps/generate.tsx +17 -1
  216. package/src/commands/onboard/steps/post-dashboard.tsx +9 -3
  217. package/src/commands/onboard.tsx +19 -6
  218. package/src/commands/runner.ts +143 -105
  219. package/src/extensions/contract-types.generated.ts +1 -1
  220. package/src/hooks/hook.ts +13 -5
  221. package/src/http/agents.ts +7 -1
  222. package/src/http/all-routes.ts +1 -0
  223. package/src/http/approval-requests.ts +32 -50
  224. package/src/http/auth.ts +5 -4
  225. package/src/http/codex-oauth-accounts.ts +31 -23
  226. package/src/http/codex-oauth-device.ts +3 -3
  227. package/src/http/codex-oauth-keep-warm.ts +1 -1
  228. package/src/http/improvements.ts +317 -0
  229. package/src/http/index.ts +10 -0
  230. package/src/http/mcp-oauth.ts +6 -0
  231. package/src/http/mcp-servers.ts +8 -0
  232. package/src/http/models-catalog.ts +1 -1
  233. package/src/http/operator-actor.ts +2 -1
  234. package/src/http/pages-public.ts +38 -1
  235. package/src/http/person-responder.ts +66 -0
  236. package/src/http/poll.ts +3 -4
  237. package/src/http/prompt-templates.ts +1 -1
  238. package/src/http/schedules.ts +4 -0
  239. package/src/http/script-runs.ts +6 -1
  240. package/src/http/session-access.ts +61 -6
  241. package/src/http/sessions.ts +67 -9
  242. package/src/http/tasks.ts +53 -9
  243. package/src/http/user-roles.ts +11 -2
  244. package/src/http/users.ts +224 -105
  245. package/src/http/utils.ts +2 -1
  246. package/src/http/workflows.ts +11 -7
  247. package/src/prompts/session-templates.ts +1 -0
  248. package/src/providers/acp-targets.ts +1 -1
  249. package/src/providers/amp-adapter.ts +1 -1
  250. package/src/providers/codex-adapter.ts +17 -3
  251. package/src/providers/codex-models.ts +4 -3
  252. package/src/providers/codex-oauth/auth-json.ts +14 -18
  253. package/src/providers/codex-oauth/device.ts +49 -15
  254. package/src/providers/codex-oauth/flow.ts +2 -1
  255. package/src/providers/codex-oauth/storage.ts +2 -2
  256. package/src/providers/pi-mono-adapter.ts +8 -0
  257. package/src/providers/pricing-sources.md +16 -1
  258. package/src/providers/swarm-events-shared.ts +15 -2
  259. package/src/rbac/legacy-policy.ts +3 -0
  260. package/src/rbac/permissions.ts +15 -0
  261. package/src/scheduler/deferred-task-waits.ts +9 -4
  262. package/src/scripts-runtime/extract-args-schema.ts +3 -1
  263. package/src/scripts-runtime/swarm-sdk.ts +1 -1
  264. package/src/scripts-runtime/types/swarm-extension.d.ts +31 -28
  265. package/src/server-user.ts +1 -1
  266. package/src/server.ts +2 -0
  267. package/src/slack/ack.ts +68 -26
  268. package/src/slack/blocks.ts +1 -0
  269. package/src/slack/reaction-shortcode.ts +8 -2
  270. package/src/slack/render-v2.ts +72 -20
  271. package/src/slack/task-output.ts +4 -1
  272. package/src/slack/thread-buffer.ts +2 -2
  273. package/src/tasks/task-skip.ts +28 -0
  274. package/src/tasks/terminal-result-guard.ts +3 -2
  275. package/src/telemetry.ts +28 -1
  276. package/src/tests/agentmail-inbox-mapping.test.ts +73 -0
  277. package/src/tests/api-drain-worker-e2e.test.ts +69 -2
  278. package/src/tests/approval-requests.test.ts +58 -0
  279. package/src/tests/apps-catalog-drift.test.ts +35 -0
  280. package/src/tests/apps-catalog-table.test.ts +203 -0
  281. package/src/tests/apps-element-assembly.test.ts +28 -0
  282. package/src/tests/apps-smart-links.test.ts +151 -0
  283. package/src/tests/apps-table-filters-migration.test.ts +96 -0
  284. package/src/tests/apps-table-selection-migration.test.ts +95 -0
  285. package/src/tests/chatgpt-subscription-session-bench.test.ts +2 -2
  286. package/src/tests/claude-managed-setup.test.ts +36 -0
  287. package/src/tests/claude-worker-parity.test.ts +2 -2
  288. package/src/tests/codex-adapter.test.ts +32 -2
  289. package/src/tests/codex-login.test.ts +2 -2
  290. package/src/tests/codex-oauth-accounts.test.ts +48 -12
  291. package/src/tests/codex-oauth-credential-info.test.ts +77 -1
  292. package/src/tests/codex-oauth-device.test.ts +61 -1
  293. package/src/tests/codex-oauth-keep-warm.test.ts +2 -2
  294. package/src/tests/codex-oauth.test.ts +25 -4
  295. package/src/tests/codex-pool.test.ts +2 -2
  296. package/src/tests/codex-swarm-events.test.ts +43 -1
  297. package/src/tests/context-window.test.ts +14 -0
  298. package/src/tests/db-queries-tracker.test.ts +2 -1
  299. package/src/tests/db-task-read-contract.test.ts +3 -0
  300. package/src/tests/db-task-write-contract.test.ts +3 -0
  301. package/src/tests/deferred-task-wake.test.ts +7 -2
  302. package/src/tests/deploy-one-box.test.ts +39 -1
  303. package/src/tests/docs-index-footprint.test.js +3 -3
  304. package/src/tests/e2e-coverage-contract.test.ts +235 -0
  305. package/src/tests/empty-output-schema.test.ts +160 -0
  306. package/src/tests/env-flag.test.ts +1 -0
  307. package/src/tests/explicit-model-validation.test.ts +14 -0
  308. package/src/tests/fixtures/onboard/content.compose.yml.txt +0 -4
  309. package/src/tests/fixtures/onboard/dev.compose.yml.txt +0 -3
  310. package/src/tests/fixtures/onboard/full-all.compose.yml.txt +0 -11
  311. package/src/tests/fixtures/onboard/full.compose.yml.txt +0 -11
  312. package/src/tests/fixtures/onboard/research.compose.yml.txt +0 -3
  313. package/src/tests/fixtures/onboard/solo.compose.yml.txt +0 -1
  314. package/src/tests/fixtures/prs-app-definition.json.txt +784 -0
  315. package/src/tests/fixtures/prs-filters-migration.patch.json.txt +318 -0
  316. package/src/tests/fixtures/prs-selection-migration.patch.json.txt +373 -0
  317. package/src/tests/fixtures/runner-identity-refresh.ts +3 -0
  318. package/src/tests/fixtures/runner-legacy-resume-prompt.ts +3 -0
  319. package/src/tests/fixtures/runner-task-start-reads.ts +140 -0
  320. package/src/tests/hook-ping-me-order.test.ts +85 -0
  321. package/src/tests/http-api-integration.test.ts +2 -2
  322. package/src/tests/http-users.test.ts +63 -0
  323. package/src/tests/improvements-payload.test.ts +200 -0
  324. package/src/tests/improvements-route.test.ts +419 -0
  325. package/src/tests/install-sh-setup-url.test.ts +190 -0
  326. package/src/tests/mcp-input-caps.test.ts +4 -3
  327. package/src/tests/merge-gate-detect-changes.test.ts +22 -0
  328. package/src/tests/onboard-dashboard-output.test.ts +109 -0
  329. package/src/tests/onboard-dashboard-url.test.ts +83 -0
  330. package/src/tests/operator-granted-credentials.test.ts +561 -0
  331. package/src/tests/operator-granted-role-wire.test.ts +222 -0
  332. package/src/tests/pages-authed-mode.test.ts +13 -2
  333. package/src/tests/pi-mono-adapter.test.ts +39 -4
  334. package/src/tests/rbac-engine.test.ts +3 -0
  335. package/src/tests/runner-context-usage.test.ts +118 -0
  336. package/src/tests/runner-legacy-options.test.ts +55 -0
  337. package/src/tests/runner-slot-reconcile.test.ts +38 -0
  338. package/src/tests/runner-task-start-reads.test.ts +58 -0
  339. package/src/tests/script-connections.test.ts +2 -0
  340. package/src/tests/script-executor-quickjs.test.ts +2 -0
  341. package/src/tests/script-runs-http.test.ts +57 -0
  342. package/src/tests/scripts-boot-args-schema.test.ts +181 -0
  343. package/src/tests/scripts-runtime.test.ts +24 -0
  344. package/src/tests/sdk-store-progress-skipped.test.ts +155 -0
  345. package/src/tests/send-task-dispatched-by.test.ts +129 -0
  346. package/src/tests/session-costs-model-key-normalize.test.ts +59 -0
  347. package/src/tests/session-dispatched-tasks.test.ts +115 -0
  348. package/src/tests/session-sharing.test.ts +402 -3
  349. package/src/tests/slack-file-tools-attachments.test.ts +95 -3
  350. package/src/tests/slack-reaction-config.test.ts +40 -0
  351. package/src/tests/slack-render-v2.test.ts +120 -0
  352. package/src/tests/slack-skip-reaction.test.ts +203 -0
  353. package/src/tests/store-progress-skipped.test.ts +159 -0
  354. package/src/tests/submit-improvement-tool.test.ts +82 -0
  355. package/src/tests/subscription-usage-migration.test.ts +57 -0
  356. package/src/tests/swarm-config-reserved-keys.test.ts +3 -0
  357. package/src/tests/telemetry-endpoint-override.test.ts +27 -0
  358. package/src/tests/tool-annotations.test.ts +1 -1
  359. package/src/tests/trigger-claiming.test.ts +2 -0
  360. package/src/tests/workflow-system-one-extraction.test.ts +29 -0
  361. package/src/tools/create-channel.ts +1 -1
  362. package/src/tools/defer-task.ts +1 -1
  363. package/src/tools/manage-user.ts +88 -58
  364. package/src/tools/register-agentmail-inbox.ts +5 -0
  365. package/src/tools/repos/update-repo.ts +1 -1
  366. package/src/tools/request-human-input.ts +1 -1
  367. package/src/tools/send-task.ts +4 -1
  368. package/src/tools/slack-read.ts +61 -33
  369. package/src/tools/store-progress.ts +39 -8
  370. package/src/tools/submit-improvement.ts +68 -0
  371. package/src/tools/tool-config.ts +3 -0
  372. package/src/tools/tracker/tracker-unlink.ts +2 -1
  373. package/src/tools/workflows/retry-workflow-run.ts +3 -0
  374. package/src/types.ts +16 -2
  375. package/src/utils/context-window.ts +6 -1
  376. package/src/utils/output-schema.ts +23 -0
  377. package/src/utils/request-auth-context.ts +6 -1
  378. package/src/workflows/executors/system-one-providers.ts +25 -6
  379. package/src/workflows/recovery.ts +8 -4
  380. package/src/workflows/resume.ts +19 -0
  381. package/templates/skills/apps/SKILL.md +22 -11
  382. package/templates/skills/apps/content.md +22 -11
  383. package/templates/skills/swarm-scripts/SKILL.md +1 -1
  384. package/templates/skills/swarm-scripts/content.md +1 -1
  385. package/templates/skills/work-on-task/SKILL.md +1 -1
  386. package/templates/skills/work-on-task/content.md +1 -1
  387. package/dist/acp-adapter-7b4vk3h5.js +0 -16
  388. package/dist/cli-5c4hjzne.js +0 -873
  389. package/dist/cli-excnnjg2.js +0 -20222
  390. package/dist/cli-pc5znp64.js +0 -364
  391. package/dist/cli-vz22fyqv.js +0 -428
  392. package/dist/fx-adapter-bs8wqrk5.js +0 -19
  393. package/dist/grok-adapter-gpjqmkcq.js +0 -19
  394. package/dist/handlers-zxmp1ta4.js +0 -32
  395. package/dist/index-a8phxqnk.js +0 -37
  396. package/dist/index-k6h00t4c.js +0 -30
  397. package/dist/index-xrz7te8h.js +0 -33
  398. package/dist/lead-956sd2yc.js +0 -71
  399. package/dist/rbac-roles-910mmkgz.js +0 -26
  400. package/dist/virtual-modules-d2pjk9j1.js +0 -59
  401. package/dist/worker-y15hy08h.js +0 -71
@@ -556,7 +556,7 @@ const updateAgentProfileRoute = route({
556
556
  profileSyncRejection: ProfileSyncRejectionSchema.optional(),
557
557
  }),
558
558
  },
559
- 404: { description: "Agent not found" },
559
+ 404: { description: "Agent not found, or changedByAgentId names no agent" },
560
560
  },
561
561
  });
562
562
 
@@ -994,6 +994,12 @@ export async function handleAgentsRest(
994
994
  return true;
995
995
  }
996
996
 
997
+ // context_versions.changed_by_agent_id is a foreign key: answer 404 instead of a bare 500.
998
+ if (body.changedByAgentId && !(await getAgentById(body.changedByAgentId))) {
999
+ jsonError(res, "changed_by_agent_not_found", 404);
1000
+ return true;
1001
+ }
1002
+
997
1003
  // Build version metadata if provided
998
1004
  const validChangeSources = ["self_edit", "lead_coaching", "api", "system", "session_sync"];
999
1005
  const versionMeta =
@@ -72,6 +72,7 @@ import "./trackers/jira";
72
72
  import "./trackers/linear";
73
73
  import "./ranking";
74
74
  import "./used-by";
75
+ import "./improvements";
75
76
  import "./fleet-benchmark";
76
77
  import "./user-roles";
77
78
  import "./users";
@@ -43,7 +43,8 @@ import {
43
43
  } from "../workflows/approval-notifications";
44
44
  import { workflowEventBus } from "../workflows/event-bus";
45
45
  import { ensureConfigAdmin, runConfigWriteSideEffects } from "./config";
46
- import { agentFirstPrincipal, authUser, authUserId } from "./request-principal";
46
+ import { type ApprovalResponder, approvalResponder, responderKey } from "./person-responder";
47
+ import { agentFirstPrincipal, authUserId } from "./request-principal";
47
48
  import { bodyTask, route } from "./route-def";
48
49
  import { jsonError } from "./utils";
49
50
 
@@ -74,8 +75,14 @@ const QuestionSchema = z.object({
74
75
  ),
75
76
  });
76
77
 
77
- /** Create input: `label` may be omitted on a config question (it defaults to the key). */
78
- const QuestionInputSchema = QuestionSchema.extend({ label: z.string().optional() });
78
+ /**
79
+ * Create input: `label` may be omitted on a config question (it defaults to the key), and
80
+ * `required` defaults to true like the request-human-input tool and the workflow node.
81
+ */
82
+ const QuestionInputSchema = QuestionSchema.extend({
83
+ label: z.string().optional(),
84
+ required: z.boolean().default(true),
85
+ });
79
86
 
80
87
  export type ApprovalQuestion = z.infer<typeof QuestionSchema>;
81
88
 
@@ -310,14 +317,32 @@ function hasRequiredResponse(question: ApprovalQuestion, response: unknown): boo
310
317
  }
311
318
  }
312
319
 
320
+ /** No answer given: absent, null, a blank string or an empty list. */
321
+ function isUnanswered(response: unknown): boolean {
322
+ return (
323
+ response === undefined ||
324
+ response === null ||
325
+ (typeof response === "string" && response.trim() === "") ||
326
+ (Array.isArray(response) && response.length === 0)
327
+ );
328
+ }
329
+
330
+ /**
331
+ * Questions whose answer blocks the response: a required question without a valid answer,
332
+ * or an optional one that was answered with an invalid value. An unanswered optional
333
+ * question passes. Config answers are checked later by `parseConfigAnswer`.
334
+ */
313
335
  export function missingRequiredResponseIds(
314
336
  questions: ApprovalQuestion[],
315
337
  responses: Record<string, unknown>,
316
338
  ): string[] {
317
339
  return questions
318
- .filter(
319
- (question) => question.required && !hasRequiredResponse(question, responses[question.id]),
320
- )
340
+ .filter((question) => {
341
+ const response = responses[question.id];
342
+ if (hasRequiredResponse(question, response)) return false;
343
+ if (question.required) return true;
344
+ return question.type !== "config" && !isUnanswered(response);
345
+ })
321
346
  .map((question) => question.id);
322
347
  }
323
348
 
@@ -556,7 +581,7 @@ export async function handleApprovalRequests(
556
581
  const questions = existing.questions as ApprovalQuestion[];
557
582
  const missingRequired = missingRequiredResponseIds(questions, parsed.body.responses);
558
583
  if (missingRequired.length > 0) {
559
- jsonError(res, `Required responses missing or invalid: ${missingRequired.join(", ")}`, 400);
584
+ jsonError(res, `Responses missing or invalid: ${missingRequired.join(", ")}`, 400);
560
585
  return true;
561
586
  }
562
587
 
@@ -907,49 +932,6 @@ async function approvalCallerPrincipal(
907
932
  return { principal, resolvedBy };
908
933
  }
909
934
 
910
- type ApprovalResponder = { kind: "user"; user: User } | { kind: "operator" };
911
-
912
- const AGENT_RESPONSE_REFUSED =
913
- "Agents cannot answer approval requests. A person must respond with a user token or the dashboard.";
914
-
915
- /**
916
- * The person answering an approval request, taken from the credential and
917
- * never from the request body. Every agent identity is refused: an `aseph_`
918
- * session token, the shared key with an `X-Agent-ID`, and a page session with
919
- * no signed-in user (page code is agent-authored, so it cannot vouch for a
920
- * person). The shared key alone is the operator.
921
- */
922
- async function approvalResponder(
923
- req: IncomingMessage,
924
- ): Promise<{ ok: true; responder: ApprovalResponder } | { ok: false; message: string }> {
925
- const auth = getRequestAuth(req);
926
- const rawAgentId = req.headers["x-agent-id"];
927
- const headerAgentId = Array.isArray(rawAgentId) ? rawAgentId[0] : rawAgentId;
928
- const principal = await agentFirstPrincipal(req, headerAgentId);
929
-
930
- if (principal.kind !== "user" && principal.kind !== "agent" && auth?.page) {
931
- return {
932
- ok: false,
933
- message: "A page session without a signed-in user cannot answer approval requests.",
934
- };
935
- }
936
- const user = authUser(auth);
937
- const responder: ApprovalResponder | null =
938
- principal.kind === "user" && user
939
- ? { kind: "user", user }
940
- : principal.kind === "operator"
941
- ? { kind: "operator" }
942
- : null;
943
-
944
- const decision = can({ principal, verb: "approval.respond", source: "http" });
945
- if (!decision.allow || !responder) return { ok: false, message: AGENT_RESPONSE_REFUSED };
946
- return { ok: true, responder };
947
- }
948
-
949
- function responderKey(responder: ApprovalResponder): string {
950
- return responder.kind === "user" ? responder.user.id : "operator";
951
- }
952
-
953
935
  function userMatchesListed(user: Pick<User, "id" | "email">, listed: string): boolean {
954
936
  if (listed === user.id) return true;
955
937
  return !!user.email && listed.toLowerCase() === user.email.toLowerCase();
package/src/http/auth.ts CHANGED
@@ -4,7 +4,7 @@ import {
4
4
  findUserById,
5
5
  fingerprintApiKey,
6
6
  resolveSessionToken,
7
- resolveUserByToken,
7
+ resolveUserToken,
8
8
  } from "../be/users";
9
9
  import type { User } from "../types";
10
10
  import { verifyPageSession } from "../utils/page-session";
@@ -54,9 +54,10 @@ export async function resolveHttpRequestAuth(
54
54
  }
55
55
 
56
56
  if (bearer.startsWith("aswt_")) {
57
- const user = await resolveUserByToken(bearer);
58
- if (isActiveUser(user)) {
59
- return { kind: "user", userId: user.id, user };
57
+ const resolved = await resolveUserToken(bearer);
58
+ const user = resolved?.user ?? null;
59
+ if (resolved && isActiveUser(user)) {
60
+ return { kind: "user", userId: user.id, user, tokenId: resolved.tokenId };
60
61
  }
61
62
  }
62
63
 
@@ -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
  });
@@ -6,7 +6,7 @@ import { getCodexDeviceFlow, upsertCodexDeviceFlow } from "../be/db/codex-oauth-
6
6
  import { updateOnboardingAiFromCodexDevice } from "../be/onboarding";
7
7
  import { deriveCodexKeySuffix } from "../providers/codex-oauth/auth-json";
8
8
  import {
9
- CODEX_DEVICE_VERIFICATION_URL,
9
+ codexDeviceVerificationUrl,
10
10
  DeviceCodeNotEnabledError,
11
11
  exchangeDeviceAuthorizationCode,
12
12
  pollDeviceToken,
@@ -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" });
@@ -306,7 +306,7 @@ export async function handleCodexOAuthDevice(
306
306
  startDeviceFlow.respond(res, 200, {
307
307
  flowId,
308
308
  userCode: device.userCode,
309
- verificationUrl: CODEX_DEVICE_VERIFICATION_URL,
309
+ verificationUrl: codexDeviceVerificationUrl(),
310
310
  intervalSeconds: device.intervalSeconds,
311
311
  expiresAt: new Date(expiresAt).toISOString(),
312
312
  });
@@ -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),
@@ -910,6 +912,14 @@ httpServer
910
912
  console.error("[embedding-space] startup maintenance failed (non-fatal):", err);
911
913
  });
912
914
 
915
+ // Normalize stored schema JSON so defaulted fields become optional.
916
+ // This repair never executes script source. It is idempotent and non-fatal.
917
+ import("../be/scripts/boot-args-schema")
918
+ .then(({ runBootArgsSchemaBackfill }) => runBootArgsSchemaBackfill())
919
+ .catch((err) => {
920
+ console.error("[boot-args-schema] startup backfill failed (non-fatal):", err);
921
+ });
922
+
913
923
  // Versioned retro-sweep: once per SCRUBBER_RULES_VERSION, redact stored
914
924
  // rows (logs, tasks, memory, events, workflow steps) that pre-date the
915
925
  // current scrubber rules. Idempotent and resumable, tracked via seed_state.
@@ -239,6 +239,10 @@ const metadataRoute = route({
239
239
  },
240
240
  400: { description: "MCP has no URL / invalid transport" },
241
241
  404: { description: "MCP server not found" },
242
+ 502: {
243
+ description:
244
+ "Metadata discovery failed: the protected-resource or authorization-server metadata could not be fetched or was refused by the egress guard",
245
+ },
242
246
  },
243
247
  });
244
248
 
@@ -347,6 +351,8 @@ const disconnectRoute = route({
347
351
  path: "/api/mcp-oauth/{mcpServerId}",
348
352
  pattern: ["api", "mcp-oauth", null],
349
353
  summary: "Revoke and delete the OAuth token for an MCP server",
354
+ description:
355
+ "Idempotent: the connection row is kept with status revoked (its tokens are cleared) and the server returns to static auth, so a repeat call answers 200 and /status keeps returning the revoked token object.",
350
356
  tags: ["MCP OAuth"],
351
357
  auth: { apiKey: true },
352
358
  params: z.object({ mcpServerId: z.string() }),