@desplega.ai/agent-swarm 2.9.0 → 2.10.0

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 (453) hide show
  1. package/dist/acp-adapter-bht22g3k.js +16 -0
  2. package/dist/{acp-targets-swxq55dr.js → acp-targets-arrwv4f0.js} +7 -7
  3. package/dist/{actions-pb678g3e.js → actions-y0d2n1c2.js} +102 -21
  4. package/dist/{agent-fs-provision-dmhnc38q.js → agent-fs-provision-tpj7sktd.js} +4 -4
  5. package/dist/{amp-adapter-3pa66q27.js → amp-adapter-vmmnmw8d.js} +2 -2
  6. package/dist/{anthropic-messages-x2cp5fvf.js → anthropic-messages-zdca3gv1.js} +22 -22
  7. package/dist/{app-17d12ev4.js → app-wb7w45dq.js} +6 -3
  8. package/dist/{approval-notifications-h7vd9pmg.js → approval-notifications-7mqr6vbd.js} +8 -5
  9. package/dist/{assistant-t7k39ree.js → assistant-gf60454p.js} +23 -21
  10. package/dist/{boot-args-schema-0gqmkfbe.js → boot-args-schema-qxmd59sr.js} +1 -1
  11. package/dist/{boot-reembed-f064w382.js → boot-reembed-5tmeskj2.js} +1 -1
  12. package/dist/{boot-reembed-n6anc01d.js → boot-reembed-wb44vc3s.js} +1 -1
  13. package/dist/boot-scrub-sweep-25bxhnw4.js +9 -0
  14. package/dist/{boot-seeds-f99fjs5q.js → boot-seeds-nj9za0vk.js} +4 -4
  15. package/dist/{claude-adapter-gvznwxgc.js → claude-adapter-d3krpdyb.js} +7 -7
  16. package/dist/{claude-managed-adapter-pbrbvc64.js → claude-managed-adapter-t8nfgcgz.js} +2 -2
  17. package/dist/{claude-managed-setup-kdxttvc3.js → claude-managed-setup-7y4pwd81.js} +3 -3
  18. package/dist/{claude-sdk-session-0t2teq6n.js → claude-sdk-session-d138zy0e.js} +7 -7
  19. package/dist/{cli-6dp0jkfj.js → cli-01k6wpr9.js} +4 -4
  20. package/dist/{cli-c07v0qfa.js → cli-124ntmf0.js} +83 -74
  21. package/dist/{cli-1tvdx9t5.js → cli-2rnd5j3t.js} +1 -1
  22. package/dist/{cli-4ghh072d.js → cli-2spnz7ye.js} +36 -36
  23. package/dist/{cli-dd37e0cm.js → cli-2v2zdm0a.js} +1 -1
  24. package/dist/{cli-aa8s22gn.js → cli-3aaeb78m.js} +195 -186
  25. package/dist/{cli-8x8y70av.js → cli-3caf7pmg.js} +2 -2
  26. package/dist/{cli-jd3kxppb.js → cli-3et6fmfe.js} +1 -1
  27. package/dist/{cli-kaa4bd7x.js → cli-3f8zbtqa.js} +9 -8
  28. package/dist/{cli-57pvhnyt.js → cli-43evxwj4.js} +1 -1
  29. package/dist/cli-43ms35q9.js +270 -0
  30. package/dist/cli-47hz21se.js +25584 -0
  31. package/dist/{cli-n515ex5z.js → cli-4ymxrwg5.js} +16 -16
  32. package/dist/{cli-2tnbc3gw.js → cli-539h29es.js} +2379 -66
  33. package/dist/{cli-rts1qvb4.js → cli-5qhfv9rw.js} +2 -2
  34. package/dist/{cli-faf46gdq.js → cli-6037prsx.js} +10 -10
  35. package/dist/{cli-bk9v1xrv.js → cli-6cwr32fe.js} +25 -25
  36. package/dist/{cli-812paz57.js → cli-6ehs4mta.js} +18 -2
  37. package/dist/{cli-95930z69.js → cli-6ym4jhzp.js} +2 -2
  38. package/dist/{cli-zg3z63x3.js → cli-7mv4h3sn.js} +1 -1
  39. package/dist/{cli-9a2rtd77.js → cli-7r162fxe.js} +24 -15
  40. package/dist/{cli-eg437b5p.js → cli-7sf9sb0w.js} +2 -1
  41. package/dist/{cli-vw5x18yj.js → cli-8st34zhr.js} +20 -10
  42. package/dist/{cli-fgphc007.js → cli-91pkxres.js} +1 -1
  43. package/dist/{cli-2kg31ted.js → cli-9fjr27ez.js} +11 -11
  44. package/dist/{cli-wr1h0k28.js → cli-9w8712tq.js} +617 -278
  45. package/dist/cli-aw83sr40.js +98 -0
  46. package/dist/{cli-ssvdrk4y.js → cli-b6px1k1q.js} +1 -1
  47. package/dist/{cli-w7dxb2fj.js → cli-cc93xzes.js} +6 -6
  48. package/dist/{cli-js8zrfyg.js → cli-fcfbct2j.js} +5 -5
  49. package/dist/{cli-3zxdz9r7.js → cli-fq2rr3jb.js} +6 -6
  50. package/dist/{boot-scrub-sweep-ejd5dnrz.js → cli-had1p04a.js} +8 -9
  51. package/dist/{cli-7cgf614g.js → cli-j6te8keb.js} +5 -5
  52. package/dist/{cli-25nstr34.js → cli-jrbq4djp.js} +1 -1
  53. package/dist/{cli-pz1c00aa.js → cli-k3q2va86.js} +2 -2
  54. package/dist/{cli-nhq5js1b.js → cli-k5yewqgd.js} +3 -3
  55. package/dist/cli-kbtzfrxj.js +404 -0
  56. package/dist/{cli-dx439zpg.js → cli-kpgcm7xy.js} +13 -1
  57. package/dist/{cli-mc1fx4xd.js → cli-m9cvf7vs.js} +10 -10
  58. package/dist/{cli-kmvcm34h.js → cli-md50mj0r.js} +2 -2
  59. package/dist/{cli-q8cfh1t9.js → cli-mk7c5ac4.js} +1 -1
  60. package/dist/cli-mys27d03.js +321 -0
  61. package/dist/{cli-spzkdgtg.js → cli-n3qe7tyr.js} +172 -168
  62. package/dist/{cli-7akn6ze9.js → cli-nh7x3133.js} +7 -28
  63. package/dist/{cli-fnh4b12r.js → cli-nstkanmx.js} +6 -6
  64. package/dist/{cli-g3zzby8t.js → cli-nv4xsvmk.js} +5 -5
  65. package/dist/{cli-sn4pc4qx.js → cli-p0c3vtch.js} +2 -2
  66. package/dist/{cli-5ntc4we6.js → cli-p0n7b5rz.js} +859 -2058
  67. package/dist/{cli-pn1v1pb0.js → cli-psffsanb.js} +3 -2
  68. package/dist/{cli-svc803vq.js → cli-q5srsxq2.js} +15 -15
  69. package/dist/{cli-nmcpzbty.js → cli-qrta34nb.js} +4 -4
  70. package/dist/{cli-k09cxm6m.js → cli-qx4f057j.js} +2 -2
  71. package/dist/{cli-eepnpee7.js → cli-s1khw52h.js} +12 -12
  72. package/dist/{cli-h474mvp5.js → cli-s1zqk1aj.js} +21 -11
  73. package/dist/{cli-8axx8vnw.js → cli-sb4426be.js} +10 -10
  74. package/dist/{cli-kqh27v2y.js → cli-th1dkc2v.js} +1 -1
  75. package/dist/{cli-cw7mc1je.js → cli-tr27kwyg.js} +3 -3
  76. package/dist/{cli-5kcmxwxv.js → cli-tvgqesec.js} +7 -5
  77. package/dist/{cli-a9hfzg2r.js → cli-ty3gha1p.js} +6 -6
  78. package/dist/{cli-fjggej24.js → cli-v46zsvqk.js} +1 -1
  79. package/dist/{cli-5gygrr67.js → cli-v8z0yga9.js} +4 -4
  80. package/dist/{cli-k7pt28ad.js → cli-vfqvrd82.js} +5 -5
  81. package/dist/{cli-vvgaz8t6.js → cli-vq2eg24x.js} +2 -2
  82. package/dist/{cli-pwsax0vp.js → cli-vsw91x06.js} +23 -22
  83. package/dist/{cli-7fx9jyfs.js → cli-w1q68d8x.js} +67 -11
  84. package/dist/{cli-c5cspahx.js → cli-wafmk3fn.js} +45 -20
  85. package/dist/{cli-ymct0ycy.js → cli-wwp1bd3n.js} +5495 -5095
  86. package/dist/{cli-me4maa4j.js → cli-y4ccxtz5.js} +45 -9
  87. package/dist/{cli-m1fbz2wj.js → cli-y8p78ekx.js} +178 -19
  88. package/dist/{cli-nr46j5pw.js → cli-z0m452jr.js} +1 -1
  89. package/dist/{cli-gddgcnav.js → cli-zeh2mhkg.js} +1 -1
  90. package/dist/{cli-e9973bf0.js → cli-zk7v5s89.js} +2 -2
  91. package/dist/cli.js +24 -23
  92. package/dist/{cloudflare-workers-ai-system-one-9y1zx3pt.js → cloudflare-workers-ai-system-one-4aysy6rh.js} +2 -2
  93. package/dist/{codex-adapter-44yq2fkn.js → codex-adapter-exfdbj73.js} +6 -6
  94. package/dist/{codex-hook-h1zb7cfk.js → codex-hook-59atdwd8.js} +1 -1
  95. package/dist/{codex-login-cdyrr5y1.js → codex-login-a239g1ah.js} +1 -1
  96. package/dist/{codex-session-runner-zbh26gbw.js → codex-session-runner-xhznc4g3.js} +6 -6
  97. package/dist/{commands-54f02v5b.js → commands-d8g349v4.js} +3 -3
  98. package/dist/{controller-9gpwcdek.js → controller-mwgdmb8y.js} +6 -3
  99. package/dist/{controllers-connect-61re6k1n.js → controllers-connect-5v7qx04j.js} +22 -20
  100. package/dist/core-sxy4epp2.js +38 -0
  101. package/dist/{cursor-adapter-7e4g81vd.js → cursor-adapter-p2q5h35d.js} +1 -1
  102. package/dist/{db-wnh0qjy1.js → db-qpganbeb.js} +3 -3
  103. package/dist/{db-dg2gc7fd.js → db-wcw0b2j8.js} +8 -2
  104. package/dist/{dispatcher-jrm24r43.js → dispatcher-8d8s49yz.js} +20 -18
  105. package/dist/{docker-9aq30pp2.js → docker-09tkkg0n.js} +42 -3
  106. package/dist/{dsh-adapter-1yqk267c.js → dsh-adapter-me0twn13.js} +1 -1
  107. package/dist/{easter-egg-3d-r4h9cs9m.js → easter-egg-3d-wv7w5ty6.js} +1 -1
  108. package/dist/{embedding-space-bafjr5f7.js → embedding-space-e48xchqa.js} +6 -6
  109. package/dist/{embeddings-7xmgqe0e.js → embeddings-tgq2afbq.js} +1 -1
  110. package/dist/{execute-d6jg5ns0.js → execute-8rhwrk7f.js} +1 -1
  111. package/dist/{external-channel-frq1xvq2.js → external-channel-8bt3j2pm.js} +2 -2
  112. package/dist/fx-adapter-adtdb3jb.js +19 -0
  113. package/dist/{google-generative-ai-hh7strj3.js → google-generative-ai-bh0djqjp.js} +5 -5
  114. package/dist/{google-vertex-fy5bw2pm.js → google-vertex-prjbw8dj.js} +9 -9
  115. package/dist/grok-adapter-accnn9km.js +19 -0
  116. package/dist/handlers-1x77561e.js +35 -0
  117. package/dist/{heartbeat-6bpa611t.js → heartbeat-x0056ra5.js} +23 -21
  118. package/dist/{hook-hvm5nf46.js → hook-a7vmn2st.js} +5 -5
  119. package/dist/{hook-w12k146y.js → hook-mrd2ayxv.js} +6 -6
  120. package/dist/{http-43tthdvs.js → http-ym9c5svp.js} +1335 -363
  121. package/dist/{index-fn054vsf.js → index-01ns1pkw.js} +1 -1
  122. package/dist/{index-1f0vypbg.js → index-0h6qd4p1.js} +34 -24
  123. package/dist/index-48qzcqzj.js +35 -0
  124. package/dist/{index-4b1q8kan.js → index-4k7m5dgj.js} +629 -354
  125. package/dist/index-620y7jzq.js +15 -0
  126. package/dist/{index-cret47a5.js → index-8p0j4h4j.js} +506 -43
  127. package/dist/{index-m5gx1xd6.js → index-9myfj74s.js} +40 -40
  128. package/dist/{index-bs7gw5fd.js → index-b5wgnm78.js} +44 -44
  129. package/dist/{index-ftywhyr0.js → index-ny60jcat.js} +394 -66
  130. package/dist/{index-tx9mc2ap.js → index-p46tvwtx.js} +24 -22
  131. package/dist/{index-585gyczt.js → index-pe3d8jfy.js} +3 -3
  132. package/dist/index-rkvaambe.js +36 -0
  133. package/dist/{index-mhq4sh5w.js → index-x6azjwm8.js} +1 -1
  134. package/dist/index-xj1mq27m.js +40 -0
  135. package/dist/k8s-m56sw868.js +217 -0
  136. package/dist/{keepalive-rk0j0jvh.js → keepalive-7yxg8z4c.js} +3 -3
  137. package/dist/lead-enzn86bz.js +74 -0
  138. package/dist/{maintenance-g6z6kaxw.js → maintenance-6tefxmk1.js} +1 -1
  139. package/dist/{node-jftbyawr.js → node-2wfcey7d.js} +1 -1
  140. package/dist/{oauth-refresh-sweep-2k3g2q4w.js → oauth-refresh-sweep-70cavc3a.js} +2 -2
  141. package/dist/{onboard-6fdbvh3v.js → onboard-fja65z08.js} +5 -5
  142. package/dist/{openai-decisions-q3hh60wr.js → openai-decisions-ytp6w6xh.js} +1 -1
  143. package/dist/{opencode-adapter-fdbsvts7.js → opencode-adapter-hakkm7yh.js} +6 -6
  144. package/dist/{otel-impl-rvwtc09q.js → otel-impl-7zhnt6gj.js} +1 -1
  145. package/dist/{pending-sqkrb836.js → pending-h01yzpx4.js} +21 -19
  146. package/dist/{pi-mono-adapter-asqayqcg.js → pi-mono-adapter-f52hz743.js} +40 -13
  147. package/dist/{pricing-refresh-f5tkgmw2.js → pricing-refresh-fzxvk2zf.js} +2 -2
  148. package/dist/{rbac-roles-06s555fa.js → rbac-roles-9v6vhgbs.js} +3 -3
  149. package/dist/{rbac-roles-szxsg8t1.js → rbac-roles-hfgh8sba.js} +2 -2
  150. package/dist/{render-v2-103p266q.js → render-v2-1rgspxzf.js} +6 -3
  151. package/dist/{resume-v7kjewt9.js → resume-tqy61x24.js} +10 -7
  152. package/dist/{runtime-f1gmk0b7.js → runtime-exkxyx5f.js} +1 -1
  153. package/dist/{session-access-6shev8ts.js → session-access-3act7vt4.js} +4 -4
  154. package/dist/{session-source-backfill-bd7spzjd.js → session-source-backfill-82qe7fqq.js} +3 -3
  155. package/dist/{setup-kmxmztdb.js → setup-ry1vfdef.js} +1 -1
  156. package/dist/thread-buffer-3x93yexa.js +38 -0
  157. package/dist/{typesafe-system-one-f2en2knd.js → typesafe-system-one-vcfj2ak8.js} +2 -2
  158. package/dist/user-merge-jobs-bx6bf7db.js +22 -0
  159. package/dist/{virtual-modules-57eje5wy.js → virtual-modules-s0rjzcqq.js} +3 -3
  160. package/dist/{work-objects-zr47ygmf.js → work-objects-z2e5tv03.js} +29 -23
  161. package/dist/{worker-follow-up-grrr3fda.js → worker-follow-up-y3xeg89w.js} +20 -18
  162. package/dist/worker-zfcv2wbf.js +74 -0
  163. package/openapi.json +2763 -147
  164. package/package.json +9 -8
  165. package/src/apps/catalog.generated.json +43 -3
  166. package/src/apps/page-validator.ts +27 -0
  167. package/src/be/boot-seeds.ts +7 -1
  168. package/src/be/db/model-groups.ts +238 -0
  169. package/src/be/db/model-profiles.ts +28 -7
  170. package/src/be/db/session-costs.ts +225 -0
  171. package/src/be/db/session-log-reasoning.ts +36 -0
  172. package/src/be/db/tasks/read.ts +8 -3
  173. package/src/be/db/tasks/write.ts +34 -1
  174. package/src/be/db/user-references.ts +75 -0
  175. package/src/be/db/users/references.ts +185 -0
  176. package/src/be/db-client.ts +70 -19
  177. package/src/be/db.ts +232 -361
  178. package/src/be/key-window-usage.ts +386 -0
  179. package/src/be/memory/demotion-evidence.ts +34 -0
  180. package/src/be/memory/reranker.ts +34 -12
  181. package/src/be/memory/review-recall-filter.ts +83 -0
  182. package/src/be/memory/search-candidates.ts +19 -6
  183. package/src/be/memory/types.ts +11 -0
  184. package/src/be/migrations/303_task_ui_specs.sql +28 -0
  185. package/src/be/migrations/306_provider_account_telemetry.sql +1 -0
  186. package/src/be/migrations/307_session_cost_credential_attribution.sql +23 -0
  187. package/src/be/migrations/310_session_logs_reasoning.sql +12 -0
  188. package/src/be/migrations/312_task_ui_action_runs_repeatable.sql +6 -0
  189. package/src/be/migrations/314_model_groups.sql +85 -0
  190. package/src/be/migrations/318_superseded_workflow_cut_backfill.sql +22 -0
  191. package/src/be/migrations/319_user_fk_indexes.sql +153 -0
  192. package/src/be/migrations/320_session_costs_kind.sql +4 -0
  193. package/src/be/migrations/321_user_merge_jobs.sql +52 -0
  194. package/src/be/pricing-normalize.ts +2 -0
  195. package/src/be/rbac-roles.ts +6 -4
  196. package/src/be/runtime-pools/db.ts +23 -5
  197. package/src/be/runtime-pools/supervisor.ts +15 -1
  198. package/src/be/scripts/db.ts +11 -0
  199. package/src/be/scripts/typecheck.ts +2 -0
  200. package/src/be/seed-model-groups.ts +86 -0
  201. package/src/be/seed-model-profiles.ts +20 -13
  202. package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -0
  203. package/src/be/seed-scripts/catalog/boot-triage.ts +1 -0
  204. package/src/be/seed-scripts/catalog/dreaming-gather.ts +165 -1
  205. package/src/be/seed-scripts/catalog/wait-for-task.ts +5 -1
  206. package/src/be/seed-skills/index.ts +3 -0
  207. package/src/be/swarm-config-guard.ts +58 -1
  208. package/src/be/task-ui-spec.ts +259 -0
  209. package/src/be/user-merge-jobs.ts +564 -0
  210. package/src/be/users.ts +41 -23
  211. package/src/commands/controller.ts +3 -0
  212. package/src/commands/credential-outcome-report.ts +13 -3
  213. package/src/commands/onboard/agent-fs-version.ts +1 -1
  214. package/src/commands/onboard/compose-generator.ts +1 -1
  215. package/src/commands/onboard/env-generator.ts +1 -1
  216. package/src/commands/provider-credentials.ts +1 -1
  217. package/src/commands/rate-limit-outcome.ts +6 -0
  218. package/src/commands/runner.ts +34 -53
  219. package/src/extensions/catalog.generated.json +3 -3
  220. package/src/extensions/contract-types.generated.ts +1 -1
  221. package/src/extensions/contract.ts +15 -0
  222. package/src/extensions/dispatcher.ts +14 -4
  223. package/src/github/handlers.ts +57 -0
  224. package/src/github/types.ts +4 -0
  225. package/src/http/all-routes.ts +2 -0
  226. package/src/http/api-keys.ts +258 -30
  227. package/src/http/approval-requests.ts +5 -1
  228. package/src/http/auth.ts +3 -1
  229. package/src/http/config.ts +34 -1
  230. package/src/http/index.ts +13 -0
  231. package/src/http/memory.ts +19 -6
  232. package/src/http/model-groups.ts +277 -0
  233. package/src/http/model-profiles.ts +30 -13
  234. package/src/http/session-data.ts +74 -23
  235. package/src/http/sessions.ts +6 -2
  236. package/src/http/tasks.ts +140 -5
  237. package/src/http/tool-hooks.ts +140 -0
  238. package/src/http/users.ts +142 -19
  239. package/src/http/workflows.ts +19 -1
  240. package/src/integrations/chat-sdk/inbound.ts +8 -2
  241. package/src/integrations/chat-sdk/limits.ts +8 -3
  242. package/src/integrations/chat-sdk/relay.ts +87 -0
  243. package/src/jira/outbound.ts +5 -3
  244. package/src/linear/outbound.ts +5 -1
  245. package/src/prompts/base-prompt.ts +8 -0
  246. package/src/prompts/session-templates.ts +19 -2
  247. package/src/providers/acp-targets.ts +2 -2
  248. package/src/providers/amp-adapter.ts +1 -1
  249. package/src/providers/claude-adapter.ts +27 -4
  250. package/src/providers/claude-flag-settings.ts +39 -1
  251. package/src/providers/codex-adapter.ts +85 -3
  252. package/src/providers/codex-app-server.ts +9 -5
  253. package/src/providers/codex-oauth/auth-json.ts +1 -0
  254. package/src/providers/pi-mono-adapter.ts +35 -2
  255. package/src/providers/pricing-sources.md +41 -0
  256. package/src/providers/types.ts +11 -0
  257. package/src/rbac/legacy-policy.ts +1 -0
  258. package/src/rbac/permissions.ts +5 -0
  259. package/src/runtime-providers/docker.ts +65 -1
  260. package/src/runtime-providers/index.ts +7 -5
  261. package/src/runtime-providers/k8s.ts +250 -0
  262. package/src/scheduler/deferred-task-waits.ts +18 -5
  263. package/src/scripts-runtime/types/stdlib.d.ts +2 -0
  264. package/src/scripts-runtime/types/swarm-extension.d.ts +24 -9
  265. package/src/scripts-runtime/types/swarm-sdk.d.ts +2 -0
  266. package/src/slack/actions.ts +79 -0
  267. package/src/slack/app.ts +22 -15
  268. package/src/slack/blocks.ts +23 -2
  269. package/src/slack/inbound-files.ts +2 -0
  270. package/src/slack/render-v2.ts +154 -23
  271. package/src/slack/responses.ts +3 -2
  272. package/src/slack/work-objects.ts +4 -1
  273. package/src/tasks/errors.ts +5 -0
  274. package/src/tests/acp-adapter.test.ts +30 -6
  275. package/src/tests/api-key-tracking.test.ts +0 -72
  276. package/src/tests/api-keys-status-model-limits.test.ts +93 -1
  277. package/src/tests/api-keys-validation.test.ts +42 -0
  278. package/src/tests/approval-card-resolution.test.ts +7 -1
  279. package/src/tests/approval-requests-notifications.test.ts +11 -1
  280. package/src/tests/apps-catalog-page-frame.test.ts +49 -0
  281. package/src/tests/apps-session-thread.test.ts +79 -0
  282. package/src/tests/base-prompt.test.ts +111 -5
  283. package/src/tests/chat-sdk-relay.test.ts +170 -2
  284. package/src/tests/check-pr-body.test.ts +43 -0
  285. package/src/tests/claude-adapter-binary.test.ts +67 -6
  286. package/src/tests/claude-flag-settings.test.ts +29 -0
  287. package/src/tests/claude-sdk-lifecycle.test.ts +5 -0
  288. package/src/tests/codex-adapter.test.ts +340 -2
  289. package/src/tests/codex-app-server.test.ts +16 -0
  290. package/src/tests/codex-oauth.test.ts +3 -1
  291. package/src/tests/codex-rate-limits.test.ts +384 -0
  292. package/src/tests/credential-check.test.ts +14 -6
  293. package/src/tests/credential-outcome-report.test.ts +20 -0
  294. package/src/tests/db-client.test.ts +146 -0
  295. package/src/tests/db-task-read-contract.test.ts +3 -0
  296. package/src/tests/db-task-write-contract.test.ts +4 -0
  297. package/src/tests/deferred-task-wake.test.ts +63 -1
  298. package/src/tests/deploy-guard.test.ts +7 -7
  299. package/src/tests/deploy-select.test.ts +83 -0
  300. package/src/tests/docker-isolation-config-guard.test.ts +29 -0
  301. package/src/tests/docs-index-footprint.test.js +11 -3
  302. package/src/tests/dreaming-gather-corrections.test.ts +467 -0
  303. package/src/tests/e2e-visuals-comment.test.ts +82 -0
  304. package/src/tests/e2e-visuals-verify-pr.test.ts +138 -0
  305. package/src/tests/event-loop-lag.test.ts +9 -7
  306. package/src/tests/extensions-example-sql-admin-only.test.ts +7 -4
  307. package/src/tests/fixtures/extensions/native-tool-recorder/hooks.ts +26 -0
  308. package/src/tests/fixtures/extensions/native-tool-recorder/manifest.json +10 -0
  309. package/src/tests/fixtures/onboard/content.compose.yml.txt +1 -1
  310. package/src/tests/fixtures/onboard/content.env.txt +1 -1
  311. package/src/tests/fixtures/onboard/dev.compose.yml.txt +1 -1
  312. package/src/tests/fixtures/onboard/dev.env.txt +1 -1
  313. package/src/tests/fixtures/onboard/full-all.compose.yml.txt +1 -1
  314. package/src/tests/fixtures/onboard/full-all.env.txt +1 -1
  315. package/src/tests/fixtures/onboard/full.compose.yml.txt +1 -1
  316. package/src/tests/fixtures/onboard/full.env.txt +1 -1
  317. package/src/tests/fixtures/onboard/research.compose.yml.txt +1 -1
  318. package/src/tests/fixtures/onboard/research.env.txt +1 -1
  319. package/src/tests/fixtures/onboard/solo.compose.yml.txt +1 -1
  320. package/src/tests/fixtures/onboard/solo.env.txt +1 -1
  321. package/src/tests/fixtures/ui-spec-slack/deploys.json +121 -0
  322. package/src/tests/fixtures/ui-spec-slack/incident.json +183 -0
  323. package/src/tests/fixtures/ui-spec-slack/three-charts-stale.json +196 -0
  324. package/src/tests/fixtures/ui-spec-slack/video-rejected-by-slack.json +183 -0
  325. package/src/tests/fixtures/ui-spec-slack/video.json +446 -0
  326. package/src/tests/github-event-filter.test.ts +8 -0
  327. package/src/tests/github-handlers-inline-comments.test.ts +2 -0
  328. package/src/tests/github-handlers-reactions.test.ts +4 -0
  329. package/src/tests/github-handlers.test.ts +3 -0
  330. package/src/tests/github-sender-trust.test.ts +223 -0
  331. package/src/tests/gitleaks-download-retry.test.ts +85 -0
  332. package/src/tests/http-users.test.ts +142 -41
  333. package/src/tests/human-thread-routing.test.ts +187 -0
  334. package/src/tests/jira-outbound-sync.test.ts +33 -1
  335. package/src/tests/k8s-pool-smoke.test.ts +190 -0
  336. package/src/tests/key-window-usage.test.ts +846 -0
  337. package/src/tests/linear-outbound-sync.test.ts +30 -1
  338. package/src/tests/memory-rater-store.test.ts +35 -1
  339. package/src/tests/memory-reranker.test.ts +39 -4
  340. package/src/tests/memory-review-recall-filter.test.ts +205 -0
  341. package/src/tests/migration-318-superseded-workflow-cut-backfill.test.ts +74 -0
  342. package/src/tests/model-groups-api.test.ts +415 -0
  343. package/src/tests/model-profiles-api.test.ts +1 -0
  344. package/src/tests/operator-granted-credentials.test.ts +7 -2
  345. package/src/tests/operator-granted-role-wire.test.ts +2 -1
  346. package/src/tests/pi-mono-adapter.test.ts +79 -0
  347. package/src/tests/preload-env.test.ts +2 -0
  348. package/src/tests/preload.ts +3 -1
  349. package/src/tests/prompt-template-session.test.ts +4 -3
  350. package/src/tests/provider-quota-persistence.test.ts +362 -0
  351. package/src/tests/rate-limit-event.test.ts +22 -0
  352. package/src/tests/rbac-engine.test.ts +1 -0
  353. package/src/tests/reasoning-events.test.ts +164 -0
  354. package/src/tests/routing-affinity-inventory.test.ts +22 -0
  355. package/src/tests/runtime-k8s-pools.test.ts +142 -0
  356. package/src/tests/runtime-pools-db.test.ts +42 -2
  357. package/src/tests/runtime-pools-http.test.ts +47 -2
  358. package/src/tests/runtime-provider-registration.test.ts +5 -14
  359. package/src/tests/runtime-providers-docker.test.ts +91 -0
  360. package/src/tests/runtime-providers-k8s.test.ts +303 -0
  361. package/src/tests/script-connections.test.ts +18 -1
  362. package/src/tests/secret-canary-sweep.test.ts +41 -5
  363. package/src/tests/seed-scripts.test.ts +23 -0
  364. package/src/tests/session-cost-attribution.test.ts +748 -0
  365. package/src/tests/session-costs.test.ts +14 -15
  366. package/src/tests/session-logs.test.ts +83 -0
  367. package/src/tests/sessions-detail-batch.test.ts +7 -0
  368. package/src/tests/short-id.test.ts +23 -0
  369. package/src/tests/slack-blocks.test.ts +69 -0
  370. package/src/tests/slack-render-v2.test.ts +411 -0
  371. package/src/tests/slack-start-reload-race.test.ts +67 -0
  372. package/src/tests/spec-base-url.test.ts +13 -1
  373. package/src/tests/subscription-plans.test.ts +20 -1
  374. package/src/tests/system-one-decide-session-cost.test.ts +196 -0
  375. package/src/tests/task-ui-action-route.test.ts +249 -0
  376. package/src/tests/task-ui-actions.test.ts +195 -0
  377. package/src/tests/task-ui-script-actions.test.ts +517 -0
  378. package/src/tests/task-ui-spec-fallback.test.ts +65 -0
  379. package/src/tests/task-ui-spec.test.ts +368 -0
  380. package/src/tests/tool-hooks-http.test.ts +187 -0
  381. package/src/tests/ui-spec-script-actions-config.test.ts +196 -0
  382. package/src/tests/user-delete-perf.test.ts +321 -0
  383. package/src/tests/user-merge-jobs.test.ts +680 -0
  384. package/src/tests/vcs-provider.test.ts +25 -5
  385. package/src/tests/vendored-openapi.test.ts +13 -1
  386. package/src/tests/workflow-agent-task-retry.test.ts +96 -1
  387. package/src/tests/workflow-foreach-supersede-retry.test.ts +10 -0
  388. package/src/tests/workflow-http-v2.test.ts +27 -0
  389. package/src/tests/workflow-replay.test.ts +10 -1
  390. package/src/tests/workflow-triggers-v2.test.ts +128 -0
  391. package/src/tests/workflow-wait-event.test.ts +109 -1
  392. package/src/tools/defer-task.ts +1 -1
  393. package/src/tools/memory-search.ts +14 -3
  394. package/src/tools/store-progress.ts +69 -3
  395. package/src/tools/swarm-config/delete-config.ts +12 -1
  396. package/src/tools/swarm-config/set-config.ts +8 -0
  397. package/src/tools/system-one-decide.ts +113 -3
  398. package/src/tools/utils.ts +4 -1
  399. package/src/tools/workflows/create-workflow.ts +2 -0
  400. package/src/tools/workflows/update-workflow.ts +3 -1
  401. package/src/types.ts +93 -4
  402. package/src/ui-spec/actions.ts +112 -0
  403. package/src/ui-spec/fallback.ts +19 -0
  404. package/src/ui-spec/schema.ts +38 -0
  405. package/src/ui-spec/script-actions.ts +340 -0
  406. package/src/ui-spec/script-allowlist.ts +48 -0
  407. package/src/ui-spec/slack.ts +17 -0
  408. package/src/ui-spec/validate.ts +169 -0
  409. package/src/utils/codex-rate-limits.ts +159 -0
  410. package/src/utils/credentials.ts +2 -0
  411. package/src/utils/error-tracker.ts +19 -0
  412. package/src/utils/provider-account-telemetry.ts +331 -0
  413. package/src/utils/reasoning-events.ts +107 -0
  414. package/src/utils/short-id.ts +20 -14
  415. package/src/utils/subscription-plans.ts +11 -59
  416. package/src/utils/task-ui-spec.ts +79 -0
  417. package/src/vcs/index.ts +12 -2
  418. package/src/workflows/executors/system-one-decision.ts +2 -2
  419. package/src/workflows/resume.ts +3 -2
  420. package/src/workflows/task-step-routing.ts +38 -13
  421. package/src/workflows/triggers.ts +35 -3
  422. package/templates/extensions/manifest.schema.json +13 -0
  423. package/templates/extensions/sql-admin-only/README.md +2 -1
  424. package/templates/extensions/sql-admin-only/hooks.ts +7 -3
  425. package/templates/extensions/sql-admin-only/manifest.json +1 -1
  426. package/templates/skills/apps/SKILL.md +32 -5
  427. package/templates/skills/apps/content.md +32 -5
  428. package/templates/skills/swarm-docs/content.md +2 -0
  429. package/templates/skills/ui-spec/config.json +14 -0
  430. package/templates/skills/ui-spec/content.md +133 -0
  431. package/templates/workflows/dreaming/content.md +1 -1
  432. package/dist/acp-adapter-jqn86aam.js +0 -16
  433. package/dist/cli-7831nhaw.js +0 -93
  434. package/dist/cli-srtkr1h2.js +0 -12078
  435. package/dist/fx-adapter-0zrkfbkd.js +0 -19
  436. package/dist/grok-adapter-3db1c538.js +0 -19
  437. package/dist/handlers-k22n8mnn.js +0 -33
  438. package/dist/index-8xcyd3mc.js +0 -33
  439. package/dist/index-9sy2bh6n.js +0 -38
  440. package/dist/index-b24j7t2m.js +0 -12797
  441. package/dist/index-wjd56k1v.js +0 -34
  442. package/dist/lead-atxf3q6e.js +0 -72
  443. package/dist/thread-buffer-4yz236d0.js +0 -36
  444. package/dist/worker-p4hbtcy3.js +0 -72
  445. package/dist/{azure-openai-responses-590s1eea.js → azure-openai-responses-b3y7fz36.js} +8 -8
  446. package/dist/{cli-j49yqpvh.js → cli-7evph51z.js} +3 -3
  447. package/dist/{cli-g0vv9dg4.js → cli-8y43jx2r.js} +8 -8
  448. package/dist/{cli-m0cy2vyf.js → cli-k6nejceb.js} +4 -4
  449. package/dist/{mistral-conversations-0c30em7t.js → mistral-conversations-tm2vd4gc.js} +8 -8
  450. package/dist/{openai-codex-responses-bkcd8pjj.js → openai-codex-responses-sxjv60xx.js} +4 -4
  451. package/dist/{openai-completions-f3n69rep.js → openai-completions-0c7qnhsx.js} +20 -20
  452. package/dist/{openai-responses-gbh0wfqe.js → openai-responses-a7h29chp.js} +15 -15
  453. package/dist/{pi-messages-zebyt7gb.js → pi-messages-2j0fpqwq.js} +5 -5
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@desplega.ai/agent-swarm",
3
- "version": "2.9.0",
3
+ "version": "2.10.0",
4
4
  "description": "agent-swarm.dev — an open-source operating system for AI work: a lead agent breaks goals into tasks, routes them to specialized workers such as Claude Code or Codex, runs each worker in an isolated container, and preserves shared memory, tools, schedules, and review gates so delegated work compounds across sessions.",
5
5
  "keywords": [
6
6
  "agent-swarm.dev",
@@ -204,19 +204,19 @@
204
204
  "bun": ">=1.3.12"
205
205
  },
206
206
  "dependencies": {
207
- "@agentclientprotocol/sdk": "2.4.0",
207
+ "@agentclientprotocol/sdk": "2.5.0",
208
208
  "@ai-sdk/openai": "^3.0.41",
209
209
  "@anthropic-ai/claude-agent-sdk": "0.3.319",
210
210
  "@anthropic-ai/sdk": "^1.6.0",
211
211
  "@asteasolutions/zod-to-openapi": "^8.0.0",
212
212
  "@aws-sdk/client-bedrock": "3.1048.0",
213
213
  "@boxd-sh/sdk": "0.2.20",
214
- "@chat-adapter/discord": "4.41.1",
215
- "@chat-adapter/slack": "4.41.1",
216
- "@chat-adapter/teams": "4.41.1",
217
- "@chat-adapter/telegram": "4.41.1",
214
+ "@chat-adapter/discord": "4.44.0",
215
+ "@chat-adapter/slack": "4.44.0",
216
+ "@chat-adapter/teams": "4.44.0",
217
+ "@chat-adapter/telegram": "4.44.0",
218
218
  "@cursor/sdk": "1.3.1",
219
- "@desplega.ai/agent-fs-just-bash": "0.18.23",
219
+ "@desplega.ai/agent-fs-just-bash": "0.18.24",
220
220
  "@desplega.ai/business-use": "^0.4.2",
221
221
  "@earendil-works/pi-agent-core": "^1.5.0",
222
222
  "@earendil-works/pi-ai": "^1.5.0",
@@ -224,6 +224,7 @@
224
224
  "@inkjs/ui": "^2.0.0",
225
225
  "@jitl/quickjs-singlefile-mjs-release-sync": "0.32.0",
226
226
  "@json-render/chat": "0.22.0",
227
+ "@json-render/core": "0.22.0",
227
228
  "@linear/sdk": "^77.0.0",
228
229
  "@modelcontextprotocol/sdk": "1.32.1",
229
230
  "@openai/codex": "0.167.0",
@@ -243,7 +244,7 @@
243
244
  "@x402/evm": "^2.5.0",
244
245
  "@x402/fetch": "^2.5.0",
245
246
  "ai": "^6.0.116",
246
- "chat": "4.41.1",
247
+ "chat": "4.44.0",
247
248
  "cron-parser": "^5.4.0",
248
249
  "date-fns": "^4.1.0",
249
250
  "e2b": "2.26.0",
@@ -47,6 +47,7 @@
47
47
  "Timeline",
48
48
  "SchemaForm",
49
49
  "SessionThread",
50
+ "PageFrame",
50
51
  "ElementRef",
51
52
  "ElementSlot"
52
53
  ],
@@ -2212,7 +2213,7 @@
2212
2213
  }
2213
2214
  },
2214
2215
  "Form": {
2215
- "description": "Field form. Values live in state under `/forms/<id>/<field>`; `onSubmit` chains receive `$form` (all collected values) and `$form: \"<field>\"` for one. `app.mutate` failures in the chain surface inline under the fields (not the page banner), and the submit button shows a pending spinner while the chain runs. `kind: \"file\"` attaches agent-fs files with the VIEWER's own agent-fs key (swarm default drive): `source: \"upload\"` (default) picks local files and uploads them on submit, before the chain, to `<dir>/<timestamp>-<id>-<n>-<name>` (unique per file, across fields and submits); `\"pick\"` opens a browser of `dir` (or `/`) to attach a file that already exists; `\"both\"` offers both. `$form.<name>` is the path, or an array of paths with `multiple: true`. `accept` filters the file picker. An upload failure stops the chain and keeps the values. Without an agent-fs connection the field shows a \"Connect agent-fs\" card, and a required file field disables submit.",
2216
+ "description": "Field form. Values live in state under `/forms/<id>/<field>`; `onSubmit` chains receive `$form` (all collected values) and `$form: \"<field>\"` for one. `app.mutate` failures in the chain surface inline under the fields (not the page banner), and the submit button shows a pending spinner while the chain runs. `kind: \"file\"` attaches agent-fs files with the VIEWER's own agent-fs key (swarm default drive): `source: \"upload\"` (default) picks local files and uploads them on submit, before the chain, to `<dir>/<timestamp>-<id>-<n>-<name>` (unique per file, across fields and submits); `\"pick\"` opens a browser of `dir` (or `/`) to attach a file that already exists; `\"both\"` offers both. `$form.<name>` is the path, or an array of paths with `multiple: true`. `accept` filters the file picker. An upload failure stops the chain and keeps the values. After an `app.mutate` create step, later steps read the new row's id as `{ \"$chain\": \"createdRowId\" }` (to open it, or as an `app.action` session key); before one runs the key is null and its param is dropped. Use it, not `$state`: the renderer resolves a chain's `$state` reads when the form renders. Without an agent-fs connection the field shows a \"Connect agent-fs\" card, and a required file field disables submit.",
2216
2217
  "props": {
2217
2218
  "$schema": "http://json-schema.org/draft-07/schema#",
2218
2219
  "type": "object",
@@ -3440,7 +3441,7 @@
3440
3441
  }
3441
3442
  },
3442
3443
  "SessionThread": {
3443
- "description": "A chat on an app page, rendered as the dashboard's session conversation (the same turn timeline and composer as the \"Session about this page\" panel). The session is found by key, not stored in a row: the server keys each task an `app.action` step creates as `task:app:<appId>:<sessionKey>:user:<viewer>`, and the thread shows the viewer's newest session with that key. The viewer must have an identity: with none picked the composer is disabled. `scope: \"shared\"` (one session for everyone) comes in a follow-up PR and is rejected today. A person bubble shows the `message` of an app-action input (cut at 4,000 characters), not the whole agent prompt. Sending routes three ways: no session yet → run `onDispatch`, whose `app.action` creates the session's root task; a task in the session not finished → the shared composer steers the newest unfinished task on any agent (steering source `app-page`; Queue, or Interrupt where the harness supports it); every task finished → run `onDispatch` again, chaining off the newest task via `\"parentTaskId\": { \"$chain\": \"leafTaskId\" }`. `$chain.leafTaskId` is `null` when there is no session, and a null `$chain` key drops the param, so one `onDispatch` covers the first message and follow-ups. Each `app.action` step is sent with the session and `followUp: false` (unless it sets `followUp` itself), so the Lead adds no review task. Messages are text only (no attachments or mic). After each send the composer stays busy until the new task shows up (at most 30 s). \"New session\" starts over: the next message creates a new root, and the older session is no longer shown. The composer draft is mirrored to `/ui/<id>/value` (namespaced per instance inside an element). The thread is 420 px tall; `fill: true` fills a `fill`-aware parent instead, with the timeline scrolling inside it and the composer pinned to the bottom.",
3444
+ "description": "A chat on an app page, rendered as the dashboard's session conversation (the same turn timeline and composer as the \"Session about this page\" panel). The session is found by key, not stored in a row: the server keys each task an `app.action` step creates as `task:app:<appId>:<sessionKey>:user:<viewer>`, and the thread shows the viewer's newest session with that key. The viewer must have an identity: with none picked the composer is disabled. `scope: \"shared\"` (one session for everyone) comes in a follow-up PR and is rejected today. A person bubble shows the `message` of an app-action input (cut at 4,000 characters), not the whole agent prompt. Sending routes three ways: no session yet → run `onDispatch`, whose `app.action` creates the session's root task; a task in the session not finished → the shared composer steers the newest unfinished task on any agent (steering source `app-page`; Queue, or Interrupt where the harness supports it); every task finished → run `onDispatch` again, chaining off the newest task via `\"parentTaskId\": { \"$chain\": \"leafTaskId\" }`. `$chain.leafTaskId` is `null` when there is no session, and a null `$chain` key drops the param, so one `onDispatch` covers the first message and follow-ups. Each `app.action` step is sent with the session and `followUp: false` (unless it sets `followUp` itself), so the Lead adds no review task. A chain elsewhere can start the session for the viewer before the thread mounts: an `app.action` step with `session: { key: <this sessionKey> }` (e.g. a create form that sends the idea, then navigates here) creates the root, and the thread shows it as its first message with no second send. Messages are text only (no attachments or mic). After each send the composer stays busy until the new task shows up (at most 30 s). \"New session\" starts over: the next message creates a new root, and the older session is no longer shown. The composer draft is mirrored to `/ui/<id>/value` (namespaced per instance inside an element). The thread is 420 px tall; `fill: true` fills a `fill`-aware parent instead, with the timeline scrolling inside it and the composer pinned to the bottom.",
3444
3445
  "props": {
3445
3446
  "$schema": "http://json-schema.org/draft-07/schema#",
3446
3447
  "type": "object",
@@ -3489,6 +3490,30 @@
3489
3490
  "additionalProperties": false
3490
3491
  }
3491
3492
  },
3493
+ "PageFrame": {
3494
+ "description": "A live swarm Page: the same body `/pages/<pageId>` shows, clickable. An HTML page runs in a sandboxed iframe (scripts, forms and popups, never top navigation); a JSON page renders inline. It checks the page every 3 s and reloads by itself when the page changes (a new version, a restore, a theme switch), with no viewer action; a reload resets scroll and any state inside the page. Bind `pageId` to a row or route param (`{ \"$state\": \"/queries/<name>/data/0/pageId\" }`). The viewer needs read access to the page: an authed page launches a page session for them, a password page asks for the password. `device: \"mobile\"` narrows the frame to 390 px, so the page's own media queries see a phone (a JSON page follows the dashboard viewport instead). 640 px tall by default; `height` sets it, `fill: true` grows inside a `fill`-aware parent. An empty `pageId` shows \"No page selected\".",
3495
+ "props": {
3496
+ "$schema": "http://json-schema.org/draft-07/schema#",
3497
+ "type": "object",
3498
+ "properties": {
3499
+ "pageId": {
3500
+ "type": "string"
3501
+ },
3502
+ "device": {
3503
+ "type": "string",
3504
+ "enum": ["desktop", "mobile"]
3505
+ },
3506
+ "height": {
3507
+ "type": "string"
3508
+ },
3509
+ "fill": {
3510
+ "type": "boolean"
3511
+ }
3512
+ },
3513
+ "required": ["pageId"],
3514
+ "additionalProperties": false
3515
+ }
3516
+ },
3492
3517
  "ElementRef": {
3493
3518
  "description": "Reference a reusable element from this app or an exported element from another app. Consumer children are inserted at the target's ElementSlot.",
3494
3519
  "slots": ["default"],
@@ -3705,7 +3730,7 @@
3705
3730
  }
3706
3731
  },
3707
3732
  "app.action": {
3708
- "description": "Invoke a named custom action from the app definition's `actions` map (script- or task-backed). Result lands in state at `/actions/<name>`.",
3733
+ "description": "Invoke a named custom action from the app definition's `actions` map (script- or task-backed). Result lands in state at `/actions/<name>`. `session: { key, scope? }` files a task-kind action's task under a SessionThread session for the viewer (see that param), so a Form chain like create row → `app.action` with `session: { key: { $chain: \"createdRowId\" } }` → `app.navigate` to the page whose SessionThread uses that id starts the chat in one click.",
3709
3734
  "params": {
3710
3735
  "$schema": "http://json-schema.org/draft-07/schema#",
3711
3736
  "type": "object",
@@ -3722,6 +3747,21 @@
3722
3747
  },
3723
3748
  "parentTaskId": {
3724
3749
  "type": "string"
3750
+ },
3751
+ "session": {
3752
+ "description": "Task-kind actions only — start or join the viewer's SessionThread session from any chain, e.g. a create form that sends the idea as the chat's first message. `key` is the SessionThread `sessionKey` to file the task under: a plain token (^[A-Za-z0-9_-]{1,128}$) or a binding such as { \"$chain\": \"createdRowId\" } (in a Form chain, the row an earlier create step just made). The server keys the task as task:app:<appId>:<key>:user:<viewer>, the exact key a SessionThread with that `sessionKey` reads, so the thread shows it as its first message. `scope` \"user\" (default); \"shared\" is rejected today. A session step defaults to `followUp: false`. Inside a SessionThread `onDispatch` the thread's own session replaces this param.",
3753
+ "type": "object",
3754
+ "properties": {
3755
+ "key": {
3756
+ "type": "string"
3757
+ },
3758
+ "scope": {
3759
+ "type": "string",
3760
+ "enum": ["user", "shared"]
3761
+ }
3762
+ },
3763
+ "required": ["key"],
3764
+ "additionalProperties": false
3725
3765
  }
3726
3766
  },
3727
3767
  "required": ["name"],
@@ -576,6 +576,22 @@ function actionParams(
576
576
  issue(appendPath(paramsPath, "name"), `unknown app action "${String(params.name)}"`),
577
577
  );
578
578
  }
579
+ // Same rules as `SessionThread.sessionKey` / `scope`: the key lands in a
580
+ // server-built context key; a bound key is checked at send time.
581
+ const session = params.session;
582
+ if (isPlainObject(session)) {
583
+ const sessionPath = appendPath(paramsPath, "session");
584
+ if (typeof session.key === "string" && !SESSION_KEY.test(session.key)) {
585
+ result.issues.push(
586
+ issue(appendPath(sessionPath, "key"), "session key must match ^[A-Za-z0-9_-]{1,128}$"),
587
+ );
588
+ }
589
+ if (session.scope === "shared") {
590
+ result.issues.push(
591
+ issue(appendPath(sessionPath, "scope"), 'scope "shared" is not supported yet'),
592
+ );
593
+ }
594
+ }
579
595
  } else if (step.action === "ui.toast") {
580
596
  // The Undo chain runs through the same handlers as any other chain, so
581
597
  // its steps get the same per-action checks (models, queries, actions).
@@ -1597,6 +1613,9 @@ function agentFsPropIssues(
1597
1613
  return issues;
1598
1614
  }
1599
1615
 
1616
+ /** `PageFrame.pageId` literal: a page id as the `/pages/:id` route takes it (no slugs). */
1617
+ const PAGE_FRAME_ID = /^[a-f0-9]{32}$/i;
1618
+
1600
1619
  function isAgentFsPath(value: string): boolean {
1601
1620
  return value.startsWith("/") && !value.split("/").includes("..");
1602
1621
  }
@@ -1830,6 +1849,14 @@ export function validatePage(
1830
1849
  if (type === "File" || type === "Files") {
1831
1850
  issues.push(...agentFsPropIssues(type, rawElement.props, elementPath));
1832
1851
  }
1852
+ if (
1853
+ type === "PageFrame" &&
1854
+ typeof rawElement.props.pageId === "string" &&
1855
+ rawElement.props.pageId !== "" &&
1856
+ !PAGE_FRAME_ID.test(rawElement.props.pageId)
1857
+ ) {
1858
+ issues.push(issue(`${elementPath}.props.pageId`, "must be a page id (32 hex characters)"));
1859
+ }
1833
1860
  if (type === "Form") issues.push(...formFileFieldIssues(rawElement.props, elementPath));
1834
1861
  if (type === "DateRange") issues.push(...dateRangePropIssues(rawElement.props, elementPath));
1835
1862
  if (type === "Table") {
@@ -18,6 +18,7 @@
18
18
  import type { Database } from "bun:sqlite";
19
19
  import { getDb } from "./db";
20
20
  import { ensureRbacSeedsSynced } from "./rbac-roles";
21
+ import { seedModelGroups } from "./seed-model-groups";
21
22
  import { seedModelProfiles } from "./seed-model-profiles";
22
23
  import { seedPricingFromModelsDev } from "./seed-pricing";
23
24
 
@@ -41,11 +42,16 @@ export function ensureRbacSeeded(): void {
41
42
  rbacSyncedDbs.add(db);
42
43
  }
43
44
 
44
- /** Seed the shipped `<harness>-<tier>` model profiles (src/be/seed-model-profiles.ts). */
45
+ /**
46
+ * Seed the shipped `<harness>-<tier>` model profiles (src/be/seed-model-profiles.ts),
47
+ * then the four tier groups that list them (src/be/seed-model-groups.ts).
48
+ */
45
49
  export async function ensureModelProfilesSeeded(): Promise<void> {
46
50
  const db = getDb();
47
51
  if (modelProfilesSeededDbs.has(db)) return;
48
52
  const inserted = await seedModelProfiles();
49
53
  if (inserted > 0) console.log(`[startup] Seeded ${inserted} model profiles`);
54
+ const groups = await seedModelGroups();
55
+ if (groups > 0) console.log(`[startup] Seeded ${groups} model groups`);
50
56
  modelProfilesSeededDbs.add(db);
51
57
  }
@@ -0,0 +1,238 @@
1
+ /**
2
+ * Model groups: a named, ordered list of model profiles that may span
3
+ * harnesses (runbooks/model-tiers.md § Model groups). Members live in
4
+ * `model_group_members` (migration 308), one row per position. Groups and
5
+ * profiles share one name space (enforced by migration 308's triggers).
6
+ */
7
+ import type { ModelGroup } from "../../types";
8
+ import { repairWindowStart, TASK_HOLDS_PROFILE_SQL } from "./model-profiles";
9
+ import { getDbClient } from "./runtime";
10
+
11
+ /** Most members a group may list. */
12
+ export const MAX_MODEL_GROUP_MEMBERS = 20;
13
+
14
+ type ModelGroupRow = {
15
+ id: string;
16
+ name: string;
17
+ description: string | null;
18
+ seededFrom: string | null;
19
+ createdAt: string;
20
+ lastUpdatedAt: string;
21
+ };
22
+
23
+ function rowToModelGroup(row: ModelGroupRow, members: string[]): ModelGroup {
24
+ return {
25
+ id: row.id,
26
+ name: row.name,
27
+ description: row.description,
28
+ seededFrom: row.seededFrom,
29
+ members,
30
+ createdAt: row.createdAt,
31
+ lastUpdatedAt: row.lastUpdatedAt,
32
+ };
33
+ }
34
+
35
+ async function membersByGroup(groupId?: string): Promise<Map<string, string[]>> {
36
+ const rows = await getDbClient().query<{ groupId: string; profileName: string }>(
37
+ `SELECT groupId, profileName FROM model_group_members
38
+ ${groupId ? "WHERE groupId = ?" : ""}
39
+ ORDER BY groupId, position`,
40
+ groupId ? [groupId] : [],
41
+ );
42
+ const byGroup = new Map<string, string[]>();
43
+ for (const row of rows) {
44
+ const list = byGroup.get(row.groupId) ?? [];
45
+ list.push(row.profileName);
46
+ byGroup.set(row.groupId, list);
47
+ }
48
+ return byGroup;
49
+ }
50
+
51
+ /** Every group with its members in order, by name. */
52
+ export async function listModelGroups(): Promise<ModelGroup[]> {
53
+ const rows = await getDbClient().query<ModelGroupRow>("SELECT * FROM model_groups ORDER BY name");
54
+ const members = await membersByGroup();
55
+ return rows.map((row) => rowToModelGroup(row, members.get(row.id) ?? []));
56
+ }
57
+
58
+ export async function getModelGroupByName(name: string): Promise<ModelGroup | null> {
59
+ const row = await getDbClient().get<ModelGroupRow>("SELECT * FROM model_groups WHERE name = ?", [
60
+ name.trim(),
61
+ ]);
62
+ if (!row) return null;
63
+ return rowToModelGroup(row, (await membersByGroup(row.id)).get(row.id) ?? []);
64
+ }
65
+
66
+ /**
67
+ * Why `members` cannot be a group's member list, or null: at least one, at
68
+ * most `MAX_MODEL_GROUP_MEMBERS`, no repeats, and every one an existing
69
+ * profile. Members may run on any harness. Run it in the write's transaction.
70
+ */
71
+ export async function modelGroupMembersError(members: string[]): Promise<string | null> {
72
+ if (members.length === 0) return "A group lists at least one member profile.";
73
+ if (members.length > MAX_MODEL_GROUP_MEMBERS) {
74
+ return `A group lists at most ${MAX_MODEL_GROUP_MEMBERS} members.`;
75
+ }
76
+ const seen = new Set<string>();
77
+ for (const member of members) {
78
+ if (seen.has(member)) return `Member "${member}" is listed twice.`;
79
+ seen.add(member);
80
+ }
81
+ const rows = await getDbClient().query<{ name: string }>(
82
+ `SELECT name FROM model_profiles WHERE name IN (${members.map(() => "?").join(", ")})`,
83
+ members,
84
+ );
85
+ const known = new Set(rows.map((row) => row.name));
86
+ const unknown = members.filter((member) => !known.has(member));
87
+ if (unknown.length > 0) {
88
+ return `Unknown model profile${unknown.length > 1 ? "s" : ""}: ${unknown.join(", ")}. List profiles with list-model-profiles.`;
89
+ }
90
+ return null;
91
+ }
92
+
93
+ async function writeMembers(groupId: string, members: string[]): Promise<void> {
94
+ await getDbClient().run("DELETE FROM model_group_members WHERE groupId = ?", [groupId]);
95
+ for (const [position, profileName] of members.entries()) {
96
+ await getDbClient().run(
97
+ "INSERT INTO model_group_members (groupId, position, profileName) VALUES (?, ?, ?)",
98
+ [groupId, position, profileName],
99
+ );
100
+ }
101
+ }
102
+
103
+ export interface ModelGroupInput {
104
+ name: string;
105
+ description?: string | null;
106
+ seededFrom?: string | null;
107
+ members: string[];
108
+ }
109
+
110
+ export type ModelGroupWriteResult =
111
+ | { ok: true; group: ModelGroup }
112
+ | { ok: false; reason: "invalid" | "exists" | "name-taken" | "missing"; error: string };
113
+
114
+ /**
115
+ * Insert a group and its members in one transaction. Refused when the name is
116
+ * a group already (`exists`) or a profile (`name-taken`), or the member list
117
+ * is invalid (`modelGroupMembersError`).
118
+ */
119
+ export async function createModelGroup(
120
+ input: ModelGroupInput,
121
+ audit: { userId?: string | null } = {},
122
+ ): Promise<ModelGroupWriteResult> {
123
+ return await getDbClient().transaction(async (tx) => {
124
+ const profile = await tx.get<{ id: string }>("SELECT id FROM model_profiles WHERE name = ?", [
125
+ input.name,
126
+ ]);
127
+ if (profile) {
128
+ return {
129
+ ok: false,
130
+ reason: "name-taken",
131
+ error: `"${input.name}" is a model profile; groups and profiles share one name space.`,
132
+ };
133
+ }
134
+ const membersError = await modelGroupMembersError(input.members);
135
+ if (membersError) return { ok: false, reason: "invalid", error: membersError };
136
+ const now = new Date().toISOString();
137
+ const row = await tx.get<ModelGroupRow>(
138
+ `INSERT INTO model_groups
139
+ (id, name, description, seededFrom, createdAt, lastUpdatedAt, created_by, updated_by)
140
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)
141
+ ON CONFLICT(name) DO NOTHING
142
+ RETURNING *`,
143
+ [
144
+ crypto.randomUUID(),
145
+ input.name,
146
+ input.description ?? null,
147
+ input.seededFrom ?? null,
148
+ now,
149
+ now,
150
+ audit.userId ?? null,
151
+ audit.userId ?? null,
152
+ ],
153
+ );
154
+ if (!row) {
155
+ return {
156
+ ok: false,
157
+ reason: "exists",
158
+ error: `Model group "${input.name}" already exists`,
159
+ };
160
+ }
161
+ await writeMembers(row.id, input.members);
162
+ return { ok: true, group: rowToModelGroup(row, [...input.members]) };
163
+ });
164
+ }
165
+
166
+ /**
167
+ * Change a group's description and/or replace its member list (positions are
168
+ * rewritten in one transaction, so a reader never sees a half-written order).
169
+ * The name is fixed.
170
+ */
171
+ export async function updateModelGroup(
172
+ name: string,
173
+ patch: { description?: string | null; members?: string[] },
174
+ audit: { userId?: string | null } = {},
175
+ ): Promise<ModelGroupWriteResult> {
176
+ return await getDbClient().transaction(async (tx) => {
177
+ const current = await tx.get<ModelGroupRow>("SELECT * FROM model_groups WHERE name = ?", [
178
+ name,
179
+ ]);
180
+ if (!current) return { ok: false, reason: "missing", error: "Model group not found" };
181
+ if (patch.members !== undefined) {
182
+ const membersError = await modelGroupMembersError(patch.members);
183
+ if (membersError) return { ok: false, reason: "invalid", error: membersError };
184
+ await writeMembers(current.id, patch.members);
185
+ }
186
+ const sets = ["lastUpdatedAt = ?", "updated_by = ?"];
187
+ const params: (string | null)[] = [new Date().toISOString(), audit.userId ?? null];
188
+ if (patch.description !== undefined) {
189
+ sets.push("description = ?");
190
+ params.push(patch.description);
191
+ }
192
+ const row = await tx.get<ModelGroupRow>(
193
+ `UPDATE model_groups SET ${sets.join(", ")} WHERE id = ? RETURNING *`,
194
+ [...params, current.id],
195
+ );
196
+ if (!row) return { ok: false, reason: "missing", error: "Model group not found" };
197
+ const members = (await membersByGroup(row.id)).get(row.id) ?? [];
198
+ return { ok: true, group: rowToModelGroup(row, members) };
199
+ });
200
+ }
201
+
202
+ /** Tasks that still hold a group (same rule as profiles) and schedules that name it. */
203
+ export async function modelGroupReferences(name: string): Promise<{
204
+ openTaskCount: number;
205
+ scheduleIds: string[];
206
+ }> {
207
+ const tasks = await getDbClient().get<{ n: number }>(
208
+ `SELECT COUNT(*) AS n FROM agent_tasks t WHERE t.modelGroup = ? AND ${TASK_HOLDS_PROFILE_SQL}`,
209
+ [name, repairWindowStart()],
210
+ );
211
+ const schedules = await getDbClient().query<{ id: string }>(
212
+ "SELECT id FROM scheduled_tasks WHERE modelGroup = ? ORDER BY id",
213
+ [name],
214
+ );
215
+ return { openTaskCount: tasks?.n ?? 0, scheduleIds: schedules.map((s) => s.id) };
216
+ }
217
+
218
+ /**
219
+ * Delete a group (its members cascade) unless a task still holds it or a
220
+ * schedule names it. The check is part of the DELETE statement, so a reference
221
+ * written after the caller's own count still makes it `in-use`; migration
222
+ * 308's triggers refuse the opposite order.
223
+ */
224
+ export async function deleteModelGroup(name: string): Promise<"deleted" | "missing" | "in-use"> {
225
+ const row = await getDbClient().get<{ id: string }>(
226
+ `DELETE FROM model_groups
227
+ WHERE name = ?
228
+ AND NOT EXISTS (
229
+ SELECT 1 FROM agent_tasks t
230
+ WHERE t.modelGroup = model_groups.name AND ${TASK_HOLDS_PROFILE_SQL})
231
+ AND NOT EXISTS (
232
+ SELECT 1 FROM scheduled_tasks s WHERE s.modelGroup = model_groups.name)
233
+ RETURNING id`,
234
+ [name, repairWindowStart()],
235
+ );
236
+ if (row) return "deleted";
237
+ return (await getModelGroupByName(name)) ? "in-use" : "missing";
238
+ }
@@ -12,6 +12,7 @@ import {
12
12
  ProviderNameSchema,
13
13
  type ReasoningEffort,
14
14
  ReasoningEffortSchema,
15
+ SUPERSEDED_WORKFLOW_TASK_REASON,
15
16
  } from "../../types";
16
17
  import {
17
18
  checkProfileForAgent,
@@ -236,17 +237,19 @@ export async function updateModelProfile(
236
237
  * later write than the supersede (HTTP supersede, heartbeat remediation), and
237
238
  * after a restart the heartbeat's orphan repair makes it, inside the same
238
239
  * window (`SUPERSEDED_RESUME_REPAIR_WINDOW_MS`). Binds one parameter: the
239
- * oldest `finishedAt` the repair still covers.
240
+ * oldest `finishedAt` the repair still covers. A superseded workflow-step cut
241
+ * gets no resume, so it never holds its profile.
240
242
  */
241
- const TASK_HOLDS_PROFILE_SQL = `(
243
+ export const TASK_HOLDS_PROFILE_SQL = `(
242
244
  t.status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped')
243
245
  OR (t.status = 'superseded'
244
246
  AND t.workflowRunStepId IS NULL
247
+ AND t.failureReason IS NOT '${SUPERSEDED_WORKFLOW_TASK_REASON}'
245
248
  AND (t.finishedAt IS NULL OR t.finishedAt > ?)
246
249
  AND NOT EXISTS (
247
250
  SELECT 1 FROM agent_tasks c WHERE c.parentTaskId = t.id AND c.taskType = 'resume')))`;
248
251
 
249
- function repairWindowStart(): string {
252
+ export function repairWindowStart(): string {
250
253
  return new Date(Date.now() - SUPERSEDED_RESUME_REPAIR_WINDOW_MS).toISOString();
251
254
  }
252
255
 
@@ -257,14 +260,15 @@ const LISTED_AS_FALLBACK_SQL = `EXISTS (
257
260
 
258
261
  /**
259
262
  * Who still points at a profile: agents with it as default, tasks that still
260
- * hold it, schedules that fire tasks with it, and profiles that list it as a
261
- * fallback.
263
+ * hold it, schedules that fire tasks with it, profiles that list it as a
264
+ * fallback, and model groups that list it as a member.
262
265
  */
263
266
  export async function modelProfileReferences(name: string): Promise<{
264
267
  agentIds: string[];
265
268
  openTaskCount: number;
266
269
  scheduleIds: string[];
267
270
  fallbackOf: string[];
271
+ groups: string[];
268
272
  }> {
269
273
  const agents = await getDbClient().query<{ scopeId: string }>(
270
274
  "SELECT scopeId FROM swarm_config WHERE scope = 'agent' AND key = ? AND value = ?",
@@ -285,11 +289,17 @@ export async function modelProfileReferences(name: string): Promise<{
285
289
  WHERE j.value = ? AND o.name <> ? ORDER BY o.name`,
286
290
  [name, name],
287
291
  );
292
+ const groups = await getDbClient().query<{ name: string }>(
293
+ `SELECT g.name FROM model_group_members m JOIN model_groups g ON g.id = m.groupId
294
+ WHERE m.profileName = ? ORDER BY g.name`,
295
+ [name],
296
+ );
288
297
  return {
289
298
  agentIds: agents.map((a) => a.scopeId),
290
299
  openTaskCount: tasks?.n ?? 0,
291
300
  scheduleIds: schedules.map((s) => s.id),
292
301
  fallbackOf: [...new Set(fallbackOf.map((p) => p.name))],
302
+ groups: groups.map((g) => g.name),
293
303
  };
294
304
  }
295
305
 
@@ -302,12 +312,21 @@ export function modelProfileRefError(error: unknown): "missing" | null {
302
312
  return message.includes("model-profile-missing:") ? "missing" : null;
303
313
  }
304
314
 
315
+ /**
316
+ * Whether migration 308's name-space trigger refused an insert: profiles and
317
+ * model groups share one name space.
318
+ */
319
+ export function isModelNameTakenError(error: unknown): boolean {
320
+ const message = error instanceof Error ? error.message : "";
321
+ return message.includes("model-name-taken:");
322
+ }
323
+
305
324
  /**
306
325
  * Delete a profile unless a task still holds it (`TASK_HOLDS_PROFILE_SQL`) as
307
326
  * its ask or as the profile claim applied (`resolvedProfile`, which a paused
308
327
  * task's resume re-reads for its credential allowlist), an
309
- * agent default names it, a schedule names it, or another profile lists it
310
- * as a fallback. The check is part of the
328
+ * agent default names it, a schedule names it, another profile lists it
329
+ * as a fallback, or a model group lists it as a member. The check is part of the
311
330
  * DELETE statement, so a reference written after the caller's own count still
312
331
  * makes it `in-use`; the triggers in migrations 220 and 240 refuse the
313
332
  * opposite order (a reference written after this delete).
@@ -326,6 +345,8 @@ export async function deleteModelProfile(name: string): Promise<"deleted" | "mis
326
345
  AND NOT EXISTS (
327
346
  SELECT 1 FROM scheduled_tasks s WHERE s.profile = model_profiles.name)
328
347
  AND NOT ${LISTED_AS_FALLBACK_SQL}
348
+ AND NOT EXISTS (
349
+ SELECT 1 FROM model_group_members m WHERE m.profileName = model_profiles.name)
329
350
  RETURNING id`,
330
351
  [name, repairWindowStart(), MODEL_PROFILE_CONFIG_KEY],
331
352
  );