@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
@@ -28,6 +28,7 @@ import {
28
28
  MAX_TASK_CITATIONS,
29
29
  upsertTaskCitations,
30
30
  } from "@/be/task-citations";
31
+ import { hasTaskUiSpecCheckRefusal, upsertTaskUiSpec } from "@/be/task-ui-spec";
31
32
  import { AgentFsProvider } from "@/fs/agent-fs-provider";
32
33
  import { can } from "@/rbac";
33
34
  import { finalizeSkippedTaskReaction, skipReasonFrom } from "@/tasks/task-skip";
@@ -38,6 +39,10 @@ import {
38
39
  } from "@/tasks/terminal-result-guard";
39
40
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
40
41
  import { AgentTaskStatusSchema, AttachmentInputSchema, isTerminalTaskStatus } from "@/types";
42
+ import { TaskUiSpecInputSchema } from "@/ui-spec/schema";
43
+ import { scriptActionIssues, scriptActionPinIssues } from "@/ui-spec/script-actions";
44
+ import { validateTaskUiSpec } from "@/ui-spec/validate";
45
+ import { isEnvFlagEnabled } from "@/utils/env-flag";
41
46
  import { scrubSecrets } from "@/utils/secret-scrubber";
42
47
  import { taskCitationIssues, taskCitationWarnings } from "@/utils/task-citations";
43
48
  import { ensure } from "../utils/business-use";
@@ -199,6 +204,9 @@ export const registerStoreProgressTool = (server: McpServer) => {
199
204
  .describe(
200
205
  'Claim sources, upserted by index across calls. Use only for factual claims the reader cannot already see in the thread or task tree, 1-2 sources; none on delegation, routing, acks, or status replies. Reference each one in output with [citation:N], or set general: true for a source that backs the whole answer (it renders under "General sources"). ref per kind: task = task UUID; memory = memory UUID (optional quote must appear verbatim in it); github = owner/repo#N, owner/repo@<sha>, or a github.com pull, issues, or commit URL; slack = permalink or channel/ts; agent-fs = file path; page = page id; script-run = script run id; url = http(s) URL. The first completing call is refused, and the task stays in progress, if a marker has no entry, a citation fails validation, or a non-general citation is unreferenced; the response lists each problem. After one refusal, completion proceeds and those markers and sources are dropped from rendered output. At most 50 citations per call/task, refs up to 2048 characters, labels up to 200. Invalid or oversized batches are ignored; existing indices can still be updated at capacity.',
201
206
  ),
207
+ uiSpec: TaskUiSpecInputSchema.optional().describe(
208
+ "Optional rich card for this result, rendered in the Slack outcome card, the session view and Chat SDK channels. `output` stays the prose answer. A Slack card shows only the spec of its own task. See the ui-spec skill.",
209
+ ),
202
210
  learning: z
203
211
  .union([
204
212
  z.string(),
@@ -246,6 +254,7 @@ export const registerStoreProgressTool = (server: McpServer) => {
246
254
  failureReason,
247
255
  attachments,
248
256
  citations,
257
+ uiSpec,
249
258
  learning,
250
259
  persistMemory,
251
260
  chainedTaskId,
@@ -398,6 +407,17 @@ export const registerStoreProgressTool = (server: McpServer) => {
398
407
  }
399
408
 
400
409
  let learningWrite: Promise<TaskLearningResult> | undefined;
410
+ // The full script-action checks (allowlist, scripts, args schemas) run
411
+ // here, before the BEGIN IMMEDIATE below, so they never hold the write
412
+ // lock. The transaction re-checks only the pins, with bounded work, so a
413
+ // pin removed in between refuses the card instead of storing it.
414
+ const uiSpecScriptIssues =
415
+ uiSpec && status === "completed" && isEnvFlagEnabled("UI_SPEC_ENABLED", false)
416
+ ? await scriptActionIssues(uiSpec.actions)
417
+ : [];
418
+
419
+ // A sentence about the uiSpec, appended to a successful result message.
420
+ let uiSpecNote: string | undefined;
401
421
  const result = await getDbClient().transaction(async () => {
402
422
  const agent = await getAgentById(requestInfo.agentId ?? "");
403
423
 
@@ -606,9 +626,53 @@ export const registerStoreProgressTool = (server: McpServer) => {
606
626
  }
607
627
  }
608
628
 
629
+ // uiSpec: stored only with a completion, and only when the flag is on.
630
+ // An invalid spec refuses the first completion, like citations above.
631
+ let uiSpecToStore: Parameters<typeof upsertTaskUiSpec>[1] | undefined;
632
+ if (uiSpec && !isEnvFlagEnabled("UI_SPEC_ENABLED", false)) {
633
+ uiSpecNote = "uiSpec ignored: UI_SPEC_ENABLED is off.";
634
+ } else if (uiSpec && status !== "completed") {
635
+ uiSpecNote = 'uiSpec is stored only with status "completed".';
636
+ } else if (uiSpec) {
637
+ // Script actions are checked first, so a bad one uses the same single refusal.
638
+ const scriptIssues =
639
+ uiSpecScriptIssues.length > 0
640
+ ? uiSpecScriptIssues
641
+ : await scriptActionPinIssues(uiSpec.actions);
642
+ const validation =
643
+ scriptIssues.length > 0
644
+ ? { ok: false as const, issues: scriptIssues }
645
+ : validateTaskUiSpec(uiSpec, {
646
+ taskId,
647
+ actionsEnabled: isEnvFlagEnabled("UI_SPEC_ACTIONS_ENABLED", false),
648
+ });
649
+ if (validation.ok) {
650
+ uiSpecToStore = {
651
+ spec: validation.spec,
652
+ ...(validation.actions ? { actions: validation.actions } : {}),
653
+ fallbackText: validation.fallbackText,
654
+ };
655
+ } else if (!(await hasTaskUiSpecCheckRefusal(taskId))) {
656
+ await createLogEntry({
657
+ eventType: "task_ui_spec_check_refused",
658
+ agentId: agent.id,
659
+ taskId,
660
+ newValue: validation.issues.join("\n"),
661
+ });
662
+ return {
663
+ success: false,
664
+ task: existingTask,
665
+ message: `Completion refused: uiSpec is not valid. The task stays ${existingTask.status}. Fix these, then call store-progress again:\n- ${validation.issues.join("\n- ")}\nThis check refuses once per task; the next completion is accepted without the spec.`,
666
+ };
667
+ } else {
668
+ uiSpecNote = `uiSpec dropped: ${validation.issues[0]}`;
669
+ }
670
+ }
671
+
609
672
  // Handle status change
610
673
  if (status === "completed") {
611
674
  const result = await completeTask(taskId, output);
675
+ if (result && uiSpecToStore) await upsertTaskUiSpec(taskId, uiSpecToStore);
612
676
  if (result) {
613
677
  updatedTask = result;
614
678
 
@@ -737,9 +801,11 @@ export const registerStoreProgressTool = (server: McpServer) => {
737
801
 
738
802
  const learningResult = await learningWrite;
739
803
  const { success } = result;
740
- const message = learningResult
741
- ? `${result.message} ${learningSentence(learningResult)}`
742
- : result.message;
804
+ const message = [
805
+ result.message,
806
+ ...(learningResult ? [learningSentence(learningResult)] : []),
807
+ ...(success && uiSpecNote ? [uiSpecNote] : []),
808
+ ].join(" ");
743
809
  const task = result.task
744
810
  ? {
745
811
  id: result.task.id,
@@ -2,7 +2,12 @@ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
3
  import { deleteSwarmConfig, getAgentById, getSwarmConfigLookupById } from "@/be/db";
4
4
  import { AGENT_MAX_TASKS_CONFIG_KEY, resetAgentMaxTasksMirror } from "@/be/multi-runtime";
5
- import { internalConfigKeyError, isInternalConfigKey } from "@/be/swarm-config-guard";
5
+ import {
6
+ humanOnlyConfigKeyError,
7
+ internalConfigKeyError,
8
+ isHumanOnlyConfigKey,
9
+ isInternalConfigKey,
10
+ } from "@/be/swarm-config-guard";
6
11
  import { scheduleIntegrationsReload } from "@/http/core";
7
12
  import { can } from "@/rbac";
8
13
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
@@ -56,6 +61,12 @@ export const registerDeleteConfigTool = (server: McpServer) => {
56
61
  data: { yourAgentId: requestInfo.agentId },
57
62
  });
58
63
  }
64
+ if (isHumanOnlyConfigKey(existing.key)) {
65
+ return toolErr(humanOnlyConfigKeyError(existing.key), {
66
+ data: { yourAgentId: requestInfo.agentId },
67
+ });
68
+ }
69
+
59
70
  if (isInternalConfigKey(existing.key)) {
60
71
  return toolErr(internalConfigKeyError(existing.key).message, {
61
72
  data: { yourAgentId: requestInfo.agentId },
@@ -3,7 +3,9 @@ import * as z from "zod";
3
3
  import { getAgentById, maskSecrets } from "@/be/db";
4
4
  import { upsertSwarmConfigWithPolicyMirror } from "@/be/multi-runtime";
5
5
  import {
6
+ humanOnlyConfigKeyError,
6
7
  internalConfigKeyError,
8
+ isHumanOnlyConfigKey,
7
9
  isInternalConfigKey,
8
10
  isReservedConfigKey,
9
11
  reservedKeyError,
@@ -98,6 +100,12 @@ export const registerSetConfigTool = (server: McpServer) => {
98
100
  return toolErr(message, { data: { yourAgentId: requestInfo.agentId } });
99
101
  }
100
102
 
103
+ if (isHumanOnlyConfigKey(key)) {
104
+ return toolErr(humanOnlyConfigKeyError(key), {
105
+ data: { yourAgentId: requestInfo.agentId },
106
+ });
107
+ }
108
+
101
109
  if (isInternalConfigKey(key)) {
102
110
  return toolErr(internalConfigKeyError(key).message, {
103
111
  data: { yourAgentId: requestInfo.agentId },
@@ -1,13 +1,88 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
- import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
3
+ import { getActivePricingRow, getTaskById, insertSessionCost } from "@/be/db";
4
+ import { recomputeSessionCost } from "@/http/session-cost-recompute";
5
+ import {
6
+ createToolRegistrar,
7
+ type RequestInfo,
8
+ swarmToolOutputSchema,
9
+ toolErr,
10
+ toolOk,
11
+ } from "@/tools/utils";
12
+ import type { AgentTask } from "@/types";
4
13
  import { getExecutorRegistry } from "@/workflows";
5
14
  import {
6
15
  SYSTEM_ONE_DECISION_NODE_TYPE,
7
16
  SystemOneDecisionConfigSchema,
8
17
  SystemOneDecisionExecutor,
9
18
  } from "@/workflows/executors/system-one-decision";
10
- import { SYSTEM_ONE_PROVIDER_IDS } from "@/workflows/executors/system-one-providers";
19
+ import {
20
+ SYSTEM_ONE_PROVIDER_IDS,
21
+ type SystemOneProviderId,
22
+ } from "@/workflows/executors/system-one-providers";
23
+
24
+ /**
25
+ * The task a decision's cost lands on: the explicit `taskId`, else the caller's
26
+ * X-Source-Task-Id. A caller may charge only its own task; an extension (its
27
+ * origin is token-verified) may charge the task whose event it is handling.
28
+ */
29
+ async function costTask(
30
+ taskId: string | undefined,
31
+ requestInfo: RequestInfo,
32
+ ): Promise<{ task?: AgentTask; error?: string }> {
33
+ const id = taskId ?? requestInfo.sourceTaskId;
34
+ if (!id) return {};
35
+ const task = await getTaskById(id);
36
+ const allowed =
37
+ !!task && (requestInfo.callOrigin === "extension" || task.agentId === requestInfo.agentId);
38
+ if (allowed) return { task };
39
+ // A header-derived id with no matching task (a taskless trigger) records nothing.
40
+ return taskId ? { error: `taskId ${taskId} is not a task this caller can charge` } : {};
41
+ }
42
+
43
+ /**
44
+ * One `session_costs` row of kind `system-one` on the task, priced from the
45
+ * `pricing` table under provider `system-one`, model `<host>/<model>`. With no
46
+ * rate row it is recorded `unpriced` at $0, tokens kept.
47
+ */
48
+ async function recordDecisionCost(
49
+ task: AgentTask,
50
+ callerAgentId: string,
51
+ provider: SystemOneProviderId,
52
+ output: { model: string; usage: { input_tokens: number; output_tokens: number } },
53
+ durationMs: number,
54
+ ) {
55
+ const model = `${provider}/${output.model}`;
56
+ const priced = await recomputeSessionCost(
57
+ {
58
+ provider: "system-one",
59
+ model,
60
+ harnessCostUsd: 0,
61
+ inputTokens: output.usage.input_tokens,
62
+ outputTokens: output.usage.output_tokens,
63
+ cacheReadTokens: 0,
64
+ cacheWriteTokens: 0,
65
+ atEpochMs: Date.now(),
66
+ },
67
+ async (pricingProvider, lookupModel, tokenClass, atEpochMs) =>
68
+ (await getActivePricingRow(pricingProvider, lookupModel, tokenClass, atEpochMs))
69
+ ?.pricePerMillionUsd ?? null,
70
+ );
71
+ const { cost } = await insertSessionCost({
72
+ sessionId: `system-one:${crypto.randomUUID()}`,
73
+ taskId: task.id,
74
+ agentId: task.agentId ?? callerAgentId,
75
+ totalCostUsd: priced.totalCostUsd,
76
+ inputTokens: output.usage.input_tokens,
77
+ outputTokens: output.usage.output_tokens,
78
+ durationMs,
79
+ numTurns: null,
80
+ model,
81
+ costSource: priced.costSource,
82
+ kind: "system-one",
83
+ });
84
+ return { taskId: task.id, costUsd: cost.totalCostUsd, costSource: cost.costSource };
85
+ }
11
86
 
12
87
  /**
13
88
  * One typed decision (Jev, Clef and the other SystemOne hosts) made in the API
@@ -51,12 +126,26 @@ export const registerSystemOneDecideTool = (server: McpServer) => {
51
126
  .int()
52
127
  .optional()
53
128
  .describe("Retries on transient failures inside the time budget (default 2)"),
129
+ taskId: z
130
+ .uuid()
131
+ .optional()
132
+ .describe(
133
+ "Task this decision serves; its cost is recorded on that task's session costs (default: the caller's X-Source-Task-Id). Must be the caller's own task, or, from an extension, the task of the event it handles",
134
+ ),
54
135
  }),
55
136
  outputSchema: swarmToolOutputSchema({
56
137
  model: z.string().optional(),
57
138
  answers: z.record(z.string(), z.unknown()).optional(),
58
139
  usage: z.record(z.string(), z.unknown()).optional(),
59
140
  requestId: z.string().optional(),
141
+ cost: z
142
+ .looseObject({
143
+ taskId: z.string().optional(),
144
+ costUsd: z.number().optional(),
145
+ costSource: z.string().optional(),
146
+ })
147
+ .optional()
148
+ .describe("The session-cost row recorded on the task, when a task was in scope"),
60
149
  providerUnavailable: z
61
150
  .boolean()
62
151
  .optional()
@@ -65,10 +154,12 @@ export const registerSystemOneDecideTool = (server: McpServer) => {
65
154
  ),
66
155
  }),
67
156
  },
68
- async ({ provider, model, state, questions, timeoutMs, maxRetries }, requestInfo) => {
157
+ async ({ provider, model, state, questions, timeoutMs, maxRetries, taskId }, requestInfo) => {
69
158
  if (!requestInfo.agentId) {
70
159
  return toolErr('Agent ID not found. The MCP client should define the "X-Agent-ID" header.');
71
160
  }
161
+ const scope = await costTask(taskId, requestInfo);
162
+ if (scope.error) return toolErr(scope.error);
72
163
 
73
164
  // `returns` mirrors the questions: the caller reads answers directly, so
74
165
  // there is no downstream port to declare.
@@ -95,6 +186,7 @@ export const registerSystemOneDecideTool = (server: McpServer) => {
95
186
  if (!(executor instanceof SystemOneDecisionExecutor)) {
96
187
  return toolErr("The system-one-decision executor is not available");
97
188
  }
189
+ const startedAt = Date.now();
98
190
  const decided = await executor.decide(parsed.data);
99
191
  if (!decided.ok) {
100
192
  return toolErr(
@@ -104,12 +196,30 @@ export const registerSystemOneDecideTool = (server: McpServer) => {
104
196
  }
105
197
 
106
198
  const { output } = decided;
199
+ let cost: Awaited<ReturnType<typeof recordDecisionCost>> | undefined;
200
+ if (scope.task) {
201
+ try {
202
+ cost = await recordDecisionCost(
203
+ scope.task,
204
+ requestInfo.agentId,
205
+ decided.provider,
206
+ output,
207
+ Date.now() - startedAt,
208
+ );
209
+ } catch (err) {
210
+ // The decision was made and paid for; a failed cost write must not hide it.
211
+ console.warn(
212
+ `[system-one-decide] cost not recorded on task ${scope.task.id}: ${err instanceof Error ? err.message : String(err)}`,
213
+ );
214
+ }
215
+ }
107
216
  return toolOk(`Decision from ${output.model}`, {
108
217
  data: {
109
218
  model: output.model,
110
219
  answers: output.answers,
111
220
  usage: output.usage,
112
221
  requestId: output.requestId,
222
+ ...(cost ? { cost } : {}),
113
223
  },
114
224
  });
115
225
  },
@@ -51,7 +51,10 @@ export type RequestInfo = {
51
51
  runtimeInstanceId: string | undefined;
52
52
  sourceTaskId: string | undefined;
53
53
  contextKey: string | undefined;
54
- callOrigin: "mcp" | "script-sdk" | "extension";
54
+ /** `native`: a harness built-in tool call reported through `POST /api/tool-hooks`. */
55
+ callOrigin: "mcp" | "script-sdk" | "extension" | "native";
56
+ /** The worker harness (`claude`, `codex`, `opencode`, `pi`); set on native calls. */
57
+ harness?: string;
55
58
  };
56
59
 
57
60
  export const getRequestInfo = (req: Meta): RequestInfo => {
@@ -57,6 +57,8 @@ export const registerCreateWorkflowTool = (server: McpServer) => {
57
57
  "{ format: 'token-equality', header }, or { format: 'standard-webhooks', toleranceSeconds? } " +
58
58
  "(standardwebhooks.com: webhook-id/webhook-timestamp/webhook-signature headers, hmacSecret is the whsec_ signing secret). Example: { type: 'webhook', hmacSecret: 'secret.SUPERAGENT_WEBHOOK_SECRET', " +
59
59
  "verification: { format: 'timestamped-hmac-sha256', header: 'X-Superagent-Signature', toleranceSeconds: 300 } }.\n" +
60
+ "- WEBHOOK EVENT FILTER: optional events: ['pull_request'] on a webhook trigger drops other deliveries after signature verification, " +
61
+ "before any run is saved (2xx skipped reply). The event is read from eventHeader (default X-GitHub-Event).\n" +
60
62
  "- WAIT NODE: type 'wait' pauses a workflow for a duration or until a named workflowEventBus event arrives. " +
61
63
  "See runbooks/workflows.md#wait-nodes for config shapes, ordering caveats, and built-in event names.",
62
64
  inputSchema: z.object({
@@ -39,7 +39,9 @@ export const registerUpdateWorkflowTool = (server: McpServer) => {
39
39
  "Omit verification for legacy HMAC-SHA256 over the raw body with fallback header scanning; " +
40
40
  "or set verification to { format: 'hmac-sha256', header }, { format: 'timestamped-hmac-sha256', header, toleranceSeconds? }, " +
41
41
  "{ format: 'token-equality', header }, or { format: 'standard-webhooks', toleranceSeconds? } " +
42
- "(standardwebhooks.com: webhook-id/webhook-timestamp/webhook-signature headers, hmacSecret is the whsec_ signing secret).",
42
+ "(standardwebhooks.com: webhook-id/webhook-timestamp/webhook-signature headers, hmacSecret is the whsec_ signing secret). " +
43
+ "WEBHOOK EVENT FILTER: optional events: ['pull_request'] on a webhook trigger drops other deliveries after signature verification, " +
44
+ "before any run is saved (2xx skipped reply). The event is read from eventHeader (default X-GitHub-Event).",
43
45
  inputSchema: z.object({
44
46
  id: z.string().uuid().describe("Workflow ID to update"),
45
47
  key: AssetKeySchema.optional().describe("Move to a logical namespace."),
package/src/types.ts CHANGED
@@ -499,6 +499,24 @@ export const ModelProfileSchema = z.object({
499
499
  });
500
500
  export type ModelProfile = z.infer<typeof ModelProfileSchema>;
501
501
 
502
+ /**
503
+ * A model group: a named, ordered list of profiles that may span harnesses
504
+ * (runbooks/model-tiers.md § Model groups). Groups and profiles share one name
505
+ * space.
506
+ */
507
+ export const ModelGroupSchema = z.object({
508
+ id: z.string(),
509
+ name: z.string(),
510
+ description: z.string().nullable(),
511
+ /** `tier:<tier>` for a boot seed, null otherwise. */
512
+ seededFrom: z.string().nullable(),
513
+ /** Profile names, first preferred. */
514
+ members: z.array(z.string()),
515
+ createdAt: z.string(),
516
+ lastUpdatedAt: z.string(),
517
+ });
518
+ export type ModelGroup = z.infer<typeof ModelGroupSchema>;
519
+
502
520
  /**
503
521
  * Why a provider session ended in a way another profile may survive. Set by
504
522
  * the worker's classifier (`src/commands/provider-error-class.ts`); never a
@@ -1231,6 +1249,10 @@ export const UserSchema = z
1231
1249
  dailyBudgetUsd: z.number().nullable().optional(),
1232
1250
  // Lifecycle (Phase 064). CHECK constraint enforces these three values.
1233
1251
  status: z.enum(["invited", "active", "suspended"]).default("active"),
1252
+ // Set while a merge job (POST /api/users/{id}/merge) still rewrites this
1253
+ // user's rows into the target. Such a user cannot authenticate, and
1254
+ // identity lookups resolve to the target. Absent once the job deletes it.
1255
+ mergedIntoUserId: z.string().nullable().optional(),
1234
1256
  createdAt: z.iso.datetime(),
1235
1257
  lastUpdatedAt: z.iso.datetime(),
1236
1258
  })
@@ -1238,6 +1260,37 @@ export const UserSchema = z
1238
1260
 
1239
1261
  export type User = z.infer<typeof UserSchema>;
1240
1262
 
1263
+ export const UserMergeJobStatusSchema = z.enum(["pending", "running", "done", "failed"]);
1264
+ export type UserMergeJobStatus = z.infer<typeof UserMergeJobStatusSchema>;
1265
+
1266
+ /**
1267
+ * Background merge of one user into another (`user_merge_jobs`). The route
1268
+ * moves identities and aliases synchronously and queues the attribution
1269
+ * rewrite; `src/be/user-merge-jobs.ts` runs it in batches and deletes the
1270
+ * source when done. `progress` counts rewritten rows per step, keyed like
1271
+ * `phase` (`workflow-context`, `<table>.<column>`, `delete-user`). A failed
1272
+ * attempt keeps the job `pending` with `error` set and `nextAttemptAt` in the
1273
+ * future until the attempt cap, then the job is `failed`.
1274
+ */
1275
+ export const UserMergeJobSchema = z
1276
+ .object({
1277
+ id: z.string(),
1278
+ sourceUserId: z.string(),
1279
+ targetUserId: z.string(),
1280
+ status: UserMergeJobStatusSchema,
1281
+ phase: z.string().nullable(),
1282
+ progress: z.record(z.string(), z.number()),
1283
+ error: z.string().nullable(),
1284
+ attempts: z.number(),
1285
+ nextAttemptAt: z.string().nullable(),
1286
+ createdAt: z.string(),
1287
+ startedAt: z.string().nullable(),
1288
+ finishedAt: z.string().nullable(),
1289
+ })
1290
+ .openapi("UserMergeJob");
1291
+
1292
+ export type UserMergeJob = z.infer<typeof UserMergeJobSchema>;
1293
+
1241
1294
  export const RbacRoleSchema = z
1242
1295
  .object({
1243
1296
  id: z.string(),
@@ -1916,6 +1969,10 @@ export const AgentLogEventTypeSchema = z.enum([
1916
1969
  "task_follow_up_gate_shadow",
1917
1970
  // store-progress refused a completion once because its citations were inaccurate
1918
1971
  "task_citation_check_refused",
1972
+ // store-progress refused a completion once because its uiSpec was invalid
1973
+ "task_ui_spec_check_refused",
1974
+ // A card `script` action ran and failed; the old card stays
1975
+ "task_ui_script_action_failed",
1919
1976
  "channel_message",
1920
1977
  // Service registry events
1921
1978
  "service_registered",
@@ -1987,6 +2044,11 @@ export const SessionCostSourceSchema = z.enum([
1987
2044
  ]);
1988
2045
  export type SessionCostSource = z.infer<typeof SessionCostSourceSchema>;
1989
2046
 
2047
+ // Migration 320: what incurred the row. 'harness' is a worker session;
2048
+ // 'system-one' is one SystemOne decision (Jev, Clef) made for the task.
2049
+ export const SessionCostKindSchema = z.enum(["harness", "system-one"]);
2050
+ export type SessionCostKind = z.infer<typeof SessionCostKindSchema>;
2051
+
1990
2052
  export const SessionCostModelBreakdownSchema = z
1991
2053
  .object({
1992
2054
  model: z.string(),
@@ -2007,11 +2069,14 @@ export const SessionCostSchema = z
2007
2069
  sessionId: z.string(),
2008
2070
  taskId: z.uuid().optional(),
2009
2071
  agentId: z.string(),
2072
+ credentialKeyType: z.string().nullable().optional(),
2073
+ credentialKeySuffix: z.string().nullable().optional(),
2074
+ harness: ProviderNameSchema.nullable().optional(),
2010
2075
  totalCostUsd: z.number().min(0),
2011
2076
  inputTokens: z.number().int().min(0).default(0),
2012
2077
  outputTokens: z.number().int().min(0).default(0),
2013
- cacheReadTokens: z.number().int().min(0).default(0),
2014
- cacheWriteTokens: z.number().int().min(0).default(0),
2078
+ cacheReadTokens: z.number().int().min(0).nullable().default(null),
2079
+ cacheWriteTokens: z.number().int().min(0).nullable().default(null),
2015
2080
  // Migration 063: reasoning_output_tokens from codex turn.completed events.
2016
2081
  reasoningOutputTokens: z.number().int().min(0).default(0),
2017
2082
  // Migration 063: thinking_input_tokens from claude extended-thinking flows.
@@ -2031,6 +2096,7 @@ export const SessionCostSchema = z
2031
2096
  // 'estimated' — the API priced fallback token counts at an assumed
2032
2097
  // model (amp with a failed thread export).
2033
2098
  costSource: SessionCostSourceSchema.default("harness"),
2099
+ kind: SessionCostKindSchema.default("harness"),
2034
2100
  // Migration 128: adapter-reported amount retained for reconciliation only.
2035
2101
  harnessCostUsd: z.number().nullable().optional(),
2036
2102
  cacheWrite5mTokens: z.number().int().nullable().optional(),
@@ -2390,8 +2456,7 @@ export type WorkerNudge = z.infer<typeof WorkerNudgeSchema>;
2390
2456
  export const RuntimeInstanceStatusSchema = z.enum(["active", "offline", "provisioning"]);
2391
2457
 
2392
2458
  /**
2393
- * Infrastructure kind a runtime pool provisions on. `k8s` is reserved: write
2394
- * paths reject it until its adapter exists.
2459
+ * Infrastructure kind a runtime pool provisions on.
2395
2460
  */
2396
2461
  export const RuntimeProviderKindSchema = z.enum(["static", "docker", "e2b", "boxd", "k8s"]);
2397
2462
  export type RuntimeProviderKind = z.infer<typeof RuntimeProviderKindSchema>;
@@ -2847,6 +2912,19 @@ export const TriggerConfigSchema = z
2847
2912
  verification: WebhookVerificationSchema.optional().describe(
2848
2913
  "Optional webhook verification format. Omit to keep legacy HMAC-SHA256 behavior with fallback header scanning.",
2849
2914
  ),
2915
+ events: z
2916
+ .array(z.string().min(1))
2917
+ .optional()
2918
+ .describe(
2919
+ "Optional event allowlist, matched exactly against the eventHeader value after signature verification. A delivery whose event is not listed (or that has no event header) gets a 2xx `skipped` reply and creates no run. Omit or leave empty to accept every event.",
2920
+ ),
2921
+ eventHeader: z
2922
+ .string()
2923
+ .min(1)
2924
+ .optional()
2925
+ .describe(
2926
+ "Request header holding the event name for `events` (case-insensitive lookup). Defaults to X-GitHub-Event.",
2927
+ ),
2850
2928
  }),
2851
2929
  z.object({
2852
2930
  type: z.literal("schedule"),
@@ -3725,6 +3803,14 @@ export const ExtensionManifestSchema = z
3725
3803
  .strict(),
3726
3804
  homepage: z.string().url().optional(),
3727
3805
  author: z.string().min(1).optional(),
3806
+ toolSources: z
3807
+ .array(z.enum(["mcp", "native"]))
3808
+ .min(1)
3809
+ .readonly()
3810
+ .optional()
3811
+ .describe(
3812
+ 'Which tool calls reach this extension\'s `pre.tool.call` and `post.tool.call` handlers: `"mcp"` for swarm MCP tools, `"native"` for harness built-ins (bash, read, write, edit) reported through `POST /api/tool-hooks`. Default `["mcp"]`.',
3813
+ ),
3728
3814
  })
3729
3815
  .strict()
3730
3816
  .superRefine((manifest, ctx) => {
@@ -4160,6 +4246,9 @@ export const PricingProviderSchema = z.enum([
4160
4246
  "cursor",
4161
4247
  "grok",
4162
4248
  "fx",
4249
+ // SystemOne decisions recorded on a task; model keys are `<host>/<model>`
4250
+ // (e.g. `cloudflare/clef`). No seeded rows: unpriced until an operator adds one.
4251
+ "system-one",
4163
4252
  ]);
4164
4253
  export type PricingProvider = z.infer<typeof PricingProviderSchema>;
4165
4254
 
@@ -0,0 +1,112 @@
1
+ import { getLeadAgent, getTaskById } from "../be/db";
2
+ import {
3
+ getTaskUiSpec,
4
+ releaseTaskUiActionRun,
5
+ reserveTaskUiActionRun,
6
+ setTaskUiActionResult,
7
+ type TaskUiActionSurface,
8
+ } from "../be/task-ui-spec";
9
+ import { slackContextKey } from "../tasks/context-key";
10
+ import { createTaskWithSiblingAwareness } from "../tasks/sibling-awareness";
11
+ import { isEnvFlagEnabled } from "../utils/env-flag";
12
+ import type { TaskUiSpec } from "../utils/task-ui-spec";
13
+ import { runTaskUiScriptAction } from "./script-actions";
14
+
15
+ export type TaskUiActionResult =
16
+ | { status: "started"; taskId: string }
17
+ | { status: "refreshed"; uiSpec: TaskUiSpec }
18
+ | { status: "running" | "rate_limited"; retryAfterSec: number }
19
+ | { status: "script_failed" | "invalid_output"; error: string }
20
+ | {
21
+ status:
22
+ | "already_done"
23
+ | "disabled"
24
+ | "unknown_action"
25
+ | "forbidden"
26
+ | "not_allowlisted"
27
+ | "script_changed";
28
+ };
29
+
30
+ /**
31
+ * Runs the action a spec Button names. The Slack click and the web route both
32
+ * call it. Only the task requester may run it. A `follow_up` runs once per
33
+ * task and action; a `script` action can run again after its cooldown.
34
+ */
35
+ export async function runTaskUiAction({
36
+ taskId,
37
+ actionId,
38
+ surface,
39
+ actorUserId,
40
+ slackUserId,
41
+ }: {
42
+ taskId: string;
43
+ actionId: string;
44
+ surface: TaskUiActionSurface;
45
+ actorUserId: string | undefined;
46
+ slackUserId?: string;
47
+ }): Promise<TaskUiActionResult> {
48
+ if (!isEnvFlagEnabled("UI_SPEC_ACTIONS_ENABLED", false)) return { status: "disabled" };
49
+
50
+ const task = await getTaskById(taskId);
51
+ const stored = task ? await getTaskUiSpec(taskId) : null;
52
+ const action =
53
+ stored?.actions && Object.hasOwn(stored.actions, actionId)
54
+ ? stored.actions[actionId]
55
+ : undefined;
56
+ if (!task || !stored || !action) return { status: "unknown_action" };
57
+
58
+ if (!actorUserId || actorUserId !== task.requestedByUserId) return { status: "forbidden" };
59
+
60
+ if (action.kind === "script") {
61
+ return await runTaskUiScriptAction({
62
+ task,
63
+ actionId,
64
+ action,
65
+ stored,
66
+ surface,
67
+ actorUserId,
68
+ slackUserId,
69
+ });
70
+ }
71
+
72
+ const reserved = await reserveTaskUiActionRun({
73
+ taskId,
74
+ actionId,
75
+ surface,
76
+ slackUserId,
77
+ userId: actorUserId,
78
+ });
79
+ if (reserved === "exists") return { status: "already_done" };
80
+
81
+ // The same task the Slack follow-up modal creates. A failed create releases
82
+ // the reservation, so a later click can retry.
83
+ let followUp: Awaited<ReturnType<typeof createTaskWithSiblingAwareness>>;
84
+ try {
85
+ const lead = await getLeadAgent();
86
+ followUp = await createTaskWithSiblingAwareness(
87
+ action.prompt,
88
+ {
89
+ agentId: lead?.id,
90
+ routingReason: lead ? "skill" : undefined,
91
+ routingSource: lead ? "engine_default" : undefined,
92
+ source: surface === "slack" ? "slack" : "ui",
93
+ parentTaskId: taskId,
94
+ inheritParentOutputSchema: false,
95
+ slackChannelId: task.slackChannelId,
96
+ slackThreadTs: task.slackThreadTs,
97
+ slackUserId,
98
+ requestedByUserId: actorUserId,
99
+ contextKey:
100
+ task.slackChannelId && task.slackThreadTs
101
+ ? slackContextKey({ channelId: task.slackChannelId, threadTs: task.slackThreadTs })
102
+ : undefined,
103
+ },
104
+ { origin: surface === "slack" ? "slack" : "rest" },
105
+ );
106
+ } catch (error) {
107
+ await releaseTaskUiActionRun(taskId, actionId);
108
+ throw error;
109
+ }
110
+ await setTaskUiActionResult(taskId, actionId, followUp.id);
111
+ return { status: "started", taskId: followUp.id };
112
+ }