@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
@@ -1,7 +1,6 @@
1
1
  import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
3
  import {
4
- createSessionCost,
5
4
  createSessionLogs,
6
5
  getActivePricingRow,
7
6
  getAllSessionCosts,
@@ -13,17 +12,23 @@ import {
13
12
  getSessionCostsFiltered,
14
13
  getSessionLogsByTaskId,
15
14
  getTaskById,
15
+ insertSessionCost,
16
16
  refreshActiveSessionOnActivity,
17
+ SessionCostConflictError,
17
18
  } from "../be/db";
19
+ import { isScriptRunToken } from "../be/users";
18
20
  import { recordSessionCost } from "../otel";
19
21
  import { incrementServerSessionsProcessed } from "../server-runtime-counters";
20
22
  import type { SessionCost } from "../types";
21
23
  import {
22
24
  PricingProviderSchema,
25
+ ProviderNameSchema,
23
26
  SessionCostModelBreakdownSchema,
24
27
  SessionCostSchema,
25
28
  SessionLogSchema,
26
29
  } from "../types";
30
+ import { getRequestAuth } from "../utils/request-auth-context";
31
+ import { scrubSecrets } from "../utils/secret-scrubber";
27
32
  import { bodyTask, route } from "./route-def";
28
33
  import { canReadSession, SESSION_READ_DENIED } from "./session-access";
29
34
  import { recomputeSessionCost } from "./session-cost-recompute";
@@ -47,6 +52,8 @@ const SessionCostSummaryTotalsSchema = z.object({
47
52
  excludedCostUsd: z.number(),
48
53
  excludedTaskCount: z.number().int(),
49
54
  subscriptionCostUsd: z.number(),
55
+ credentialUnattributedCostUsd: z.number(),
56
+ credentialUnattributedSessions: z.number().int(),
50
57
  });
51
58
 
52
59
  /** Mirrors `SessionCostDailyRow` in src/be/db.ts. */
@@ -57,6 +64,8 @@ const SessionCostDailyRowSchema = z.object({
57
64
  outputTokens: z.number().int(),
58
65
  sessions: z.number().int(),
59
66
  subscriptionCostUsd: z.number(),
67
+ credentialUnattributedCostUsd: z.number(),
68
+ credentialUnattributedSessions: z.number().int(),
60
69
  });
61
70
 
62
71
  /** Mirrors `SessionCostByAgentRow` in src/be/db.ts. */
@@ -182,6 +191,13 @@ const createSessionCostRoute = route({
182
191
  id: z.string().uuid().optional(),
183
192
  sessionId: z.string().min(1),
184
193
  agentId: z.string().min(1),
194
+ credentialKeyType: z
195
+ .string()
196
+ .regex(/^[A-Z][A-Z0-9_]{0,79}$/)
197
+ .nullable()
198
+ .optional(),
199
+ credentialKeySuffix: z.string().min(1).max(10).nullable().optional(),
200
+ harness: ProviderNameSchema.nullable().optional(),
185
201
  totalCostUsd: z.number(),
186
202
  // The adapter's totalCostUsd is the provider's bill (e.g. OpenRouter's
187
203
  // `usage.cost`), so it wins over the pricing table.
@@ -191,7 +207,7 @@ const createSessionCostRoute = route({
191
207
  // token counts must be rejected at the wire instead of pricing below $0.
192
208
  inputTokens: z.number().int().nonnegative().optional(),
193
209
  outputTokens: z.number().int().nonnegative().optional(),
194
- cacheReadTokens: z.number().int().nonnegative().optional(),
210
+ cacheReadTokens: z.number().int().nonnegative().nullable().optional(),
195
211
  // Migration 063: nullable — adapters that can't honestly report cache writes
196
212
  // (e.g. Codex SDK) prefer null over a faked 0.
197
213
  cacheWriteTokens: z.number().int().nonnegative().nullable().optional(),
@@ -234,6 +250,8 @@ const createSessionCostRoute = route({
234
250
  schema: z.object({ success: z.literal(true), cost: SessionCostSchema }),
235
251
  },
236
252
  400: { description: "Validation error" },
253
+ 403: { description: "Untrusted session attribution" },
254
+ 409: { description: "Session identity conflict" },
237
255
  },
238
256
  });
239
257
 
@@ -370,6 +388,30 @@ export async function handleSessionData(
370
388
  const parsed = await createSessionCostRoute.parse(req, res, pathSegments, queryParams);
371
389
  if (!parsed) return true;
372
390
 
391
+ const auth = getRequestAuth(req);
392
+ const trustedWorker =
393
+ !auth?.page &&
394
+ (auth?.kind === "operator" ||
395
+ (auth?.kind === "agent" &&
396
+ (auth.tokenKind === "runtime" ||
397
+ (auth.tokenKind === "agent" && !(await isScriptRunToken(auth.tokenId)))) &&
398
+ auth.agentId === parsed.body.agentId));
399
+ const hasAttribution =
400
+ parsed.body.credentialKeyType != null ||
401
+ parsed.body.credentialKeySuffix != null ||
402
+ parsed.body.harness != null;
403
+ if (hasAttribution && !trustedWorker) {
404
+ jsonError(res, "Session attribution requires a worker or operator credential.", 403);
405
+ return true;
406
+ }
407
+ if (auth?.kind === "agent" && auth.agentId !== parsed.body.agentId) {
408
+ jsonError(res, "Session cost agent does not match the authenticated agent.", 403);
409
+ return true;
410
+ }
411
+ if ((parsed.body.credentialKeyType != null) !== (parsed.body.credentialKeySuffix != null)) {
412
+ jsonError(res, "Session credential type and suffix must be supplied together.", 400);
413
+ return true;
414
+ }
373
415
  try {
374
416
  const inputTokens = parsed.body.inputTokens ?? 0;
375
417
  const cachedInputTokens = parsed.body.cacheReadTokens ?? 0;
@@ -393,10 +435,10 @@ export async function handleSessionData(
393
435
  : outputTokens;
394
436
  const rowCacheReadTokens = bodyModels
395
437
  ? bodyModels.reduce((sum, m) => sum + m.cacheReadTokens, 0)
396
- : cachedInputTokens;
438
+ : (parsed.body.cacheReadTokens ?? null);
397
439
  const rowCacheWriteTokens = bodyModels
398
440
  ? bodyModels.reduce((sum, m) => sum + m.cacheWriteTokens, 0)
399
- : (parsed.body.cacheWriteTokens ?? 0);
441
+ : (parsed.body.cacheWriteTokens ?? null);
400
442
 
401
443
  // Keep the adapter's report even when the pricing-table branch replaces
402
444
  // totalCostUsd with the server's canonical recomputation. Harnesses that
@@ -425,7 +467,10 @@ export async function handleSessionData(
425
467
  );
426
468
  const { totalCostUsd, costSource } = recomputed;
427
469
 
428
- const cost = await createSessionCost({
470
+ const { cost, created } = await insertSessionCost({
471
+ credentialKeyType: parsed.body.credentialKeyType,
472
+ credentialKeySuffix: parsed.body.credentialKeySuffix,
473
+ harness: parsed.body.harness,
429
474
  id: parsed.body.id,
430
475
  sessionId: parsed.body.sessionId,
431
476
  taskId: parsed.body.taskId || undefined,
@@ -448,26 +493,32 @@ export async function handleSessionData(
448
493
  cacheWrite1hTokens: parsed.body.cacheWrite1hTokens,
449
494
  modelBreakdown: recomputed.modelBreakdown,
450
495
  });
451
- recordSessionCost({
452
- totalCostUsd,
453
- harnessCostUsd: harnessCostUsd ?? undefined,
454
- harness: parsed.body.provider ?? "unknown",
455
- model,
456
- costSource,
457
- isError: parsed.body.isError ?? false,
458
- tokens: {
459
- input: rowInputTokens,
460
- output: rowOutputTokens,
461
- cacheRead: rowCacheReadTokens,
462
- cacheWrite: rowCacheWriteTokens,
463
- reasoning: parsed.body.reasoningOutputTokens ?? 0,
464
- thinking: parsed.body.thinkingTokens ?? 0,
465
- },
466
- });
467
- incrementServerSessionsProcessed();
496
+ if (created) {
497
+ recordSessionCost({
498
+ totalCostUsd,
499
+ harnessCostUsd: harnessCostUsd ?? undefined,
500
+ harness: parsed.body.provider ?? "unknown",
501
+ model,
502
+ costSource,
503
+ isError: parsed.body.isError ?? false,
504
+ tokens: {
505
+ input: rowInputTokens,
506
+ output: rowOutputTokens,
507
+ cacheRead: rowCacheReadTokens ?? 0,
508
+ cacheWrite: rowCacheWriteTokens ?? 0,
509
+ reasoning: parsed.body.reasoningOutputTokens ?? 0,
510
+ thinking: parsed.body.thinkingTokens ?? 0,
511
+ },
512
+ });
513
+ incrementServerSessionsProcessed();
514
+ }
468
515
  createSessionCostRoute.respond(res, 201, { success: true, cost });
469
516
  } catch (error) {
470
- console.error("[HTTP] Failed to create session cost:", error);
517
+ if (error instanceof SessionCostConflictError) {
518
+ jsonError(res, error.message, 409);
519
+ return true;
520
+ }
521
+ console.error("[HTTP] Failed to create session cost:", scrubSecrets(String(error)));
471
522
  jsonError(res, "Failed to store session cost", 500);
472
523
  }
473
524
  return true;
@@ -52,6 +52,7 @@ import {
52
52
  } from "../be/session-shares";
53
53
  import { getTaskSteeringFieldsForTasks } from "../be/steering";
54
54
  import { getTaskCitationsForTasks, TaskCitationSchema } from "../be/task-citations";
55
+ import { getTaskUiSpecsForTasks, TaskUiSpecSchema } from "../be/task-ui-spec";
55
56
  import {
56
57
  AgentTokenExistsError,
57
58
  findUserById,
@@ -211,6 +212,7 @@ const SessionKeyFilterSchema = z.string().transform((value, ctx) => {
211
212
  */
212
213
  const TaskWithSteeringSchema = AgentTaskSchema.extend({
213
214
  citations: z.array(TaskCitationSchema),
215
+ uiSpec: TaskUiSpecSchema.nullable(),
214
216
  isLeadTask: z.boolean(),
215
217
  supportedSteerModes: z.array(SteerModeSchema),
216
218
  });
@@ -1298,11 +1300,12 @@ export async function handleSessions(
1298
1300
  sessionRoot.id,
1299
1301
  actor,
1300
1302
  );
1301
- // Load steering, citations and pending approvals for the already loaded chain.
1303
+ // Load steering, citations, UI specs and pending approvals for the already loaded chain.
1302
1304
  const tasks = [root, ...chain];
1303
- const [steering, citations, approvals, read, groupKey] = await Promise.all([
1305
+ const [steering, citations, uiSpecs, approvals, read, groupKey] = await Promise.all([
1304
1306
  getTaskSteeringFieldsForTasks(tasks),
1305
1307
  getTaskCitationsForTasks(tasks.map((task) => task.id)),
1308
+ getTaskUiSpecsForTasks(tasks.map((task) => task.id)),
1306
1309
  getPendingApprovalsForTasks(tasks.map((task) => task.id)),
1307
1310
  // The viewer's read state, so a client marks a session read on open
1308
1311
  // without the list row (the same rule as `GET /api/sessions`).
@@ -1315,6 +1318,7 @@ export async function handleSessions(
1315
1318
  ...task,
1316
1319
  ...steering.get(task.id)!,
1317
1320
  citations: citations.get(task.id)!,
1321
+ uiSpec: uiSpecs.get(task.id) ?? null,
1318
1322
  });
1319
1323
  getSession.respond(res, 200, {
1320
1324
  root: decorate(root),
package/src/http/tasks.ts CHANGED
@@ -58,10 +58,11 @@ import {
58
58
  SteeringRequestError,
59
59
  } from "../be/steering";
60
60
  import { getTaskCitations, TaskCitationSchema } from "../be/task-citations";
61
+ import { getTaskUiSpec, TaskUiSpecSchema } from "../be/task-ui-spec";
61
62
  import { findUserById } from "../be/users";
62
63
  import { can, isRbacEnabled, type RbacPrincipal, type RbacResource } from "../rbac";
63
64
  import { chatThreadOfContextKey } from "../tasks/context-key";
64
- import { TaskCreationBlockedError } from "../tasks/errors";
65
+ import { TaskCreationBlockedError, TaskRoutingAuthorizationError } from "../tasks/errors";
65
66
  import { createTaskWithSiblingAwareness } from "../tasks/sibling-awareness";
66
67
  import { finalizeSkippedTaskReaction, skipReasonFrom } from "../tasks/task-skip";
67
68
  import { guardTerminalTaskResultWrite } from "../tasks/terminal-result-guard";
@@ -97,6 +98,7 @@ import {
97
98
  splitLegacyModelAlias,
98
99
  TaskAttachmentSchema,
99
100
  } from "../types";
101
+ import { runTaskUiAction } from "../ui-spec/actions";
100
102
  import { ensure } from "../utils/business-use";
101
103
  import { getRequestAuth } from "../utils/request-auth-context";
102
104
  import { scrubSecrets } from "../utils/secret-scrubber";
@@ -221,6 +223,7 @@ const GetTaskResponseSchema = AgentTaskSchema.extend({
221
223
  logs: z.array(AgentLogSchema),
222
224
  attachments: z.array(TaskAttachmentSchema),
223
225
  citations: z.array(TaskCitationSchema),
226
+ uiSpec: TaskUiSpecSchema.nullable(),
224
227
  });
225
228
 
226
229
  const FinishTaskSuccessSchema = z.object({
@@ -402,7 +405,7 @@ const createTask = route({
402
405
  },
403
406
  403: {
404
407
  description:
405
- "An agent caller names a parentTaskId it neither owns nor created, or a non-lead agent binds the task to a chat thread",
408
+ "Parent/session access denied, unauthorized chat-thread binding, or routing requirements reject the assignment",
406
409
  },
407
410
  422: {
408
411
  description: "Task creation blocked by an extension",
@@ -785,6 +788,43 @@ const resumeTaskRoute = route({
785
788
  },
786
789
  });
787
790
 
791
+ const runTaskUiActionRoute = route({
792
+ method: "post",
793
+ path: "/api/tasks/{id}/ui-actions/{actionId}",
794
+ pattern: ["api", "tasks", null, "ui-actions", null],
795
+ session: { taskParam: "id" },
796
+ rbac: { permission: "task.action.own" },
797
+ summary: "Run the action a task card Button declares",
798
+ description:
799
+ "Runs a task card action. Only the task requester may run it: a user token, or the operator key with the requester in `X-Swarm-User-Id`. Agent callers, and operator calls with no picked user, get 403. Needs UI_SPEC_ACTIONS_ENABLED=true. A `follow_up` action runs once per task and action. A `script` action re-runs its allowlisted script (UI_SPEC_SCRIPT_ACTIONS) and returns the new card; it can run again after a 30 s cooldown.",
800
+ tags: ["Tasks"],
801
+ params: z.object({ id: z.string(), actionId: z.string() }),
802
+ responses: {
803
+ 200: {
804
+ description:
805
+ "The follow-up started or already ran, or the script action replaced the card (`refreshed`, with the new `uiSpec`)",
806
+ schema: z.object({
807
+ status: z.enum(["started", "already_done", "refreshed"]),
808
+ taskId: z.string().optional(),
809
+ uiSpec: TaskUiSpecSchema.optional(),
810
+ }),
811
+ },
812
+ 403: {
813
+ description:
814
+ "Only the task requester may run the action, or the action's script is not allowlisted or changed since it was allowlisted",
815
+ },
816
+ 404: { description: "Task or action not found" },
817
+ 409: {
818
+ description:
819
+ "Card actions are turned off (UI_SPEC_ACTIONS_ENABLED), or the script action is already running (with `Retry-After`)",
820
+ },
821
+ 422: { description: "The script failed or returned an invalid card; the old card stays" },
822
+ 429: {
823
+ description: "The script action ran recently; `Retry-After` says when it can run again",
824
+ },
825
+ },
826
+ });
827
+
788
828
  const supersedeTaskRoute = route({
789
829
  method: "post",
790
830
  path: "/api/tasks/{id}/supersede",
@@ -792,7 +832,7 @@ const supersedeTaskRoute = route({
792
832
  session: { taskParam: "id" },
793
833
  summary: "Supersede an in-progress task (terminate + spawn resume follow-up)",
794
834
  description:
795
- 'Marks the original task `superseded` (terminal) and creates a fresh `taskType="resume"` follow-up so a worker can pick up the work in a new provider session. Workflow-step tasks (those with `workflowRunStepId`) are carved out: the original is marked `failed` with reason `superseded_workflow_task` and no follow-up is created — the workflow engine\'s retry/failure policy applies. With `reason: provider_fallback` (and its `errorClass`), the resume runs on the same agent with the next fallback profile that passes the profile check; when none is left, or the task is a workflow step, nothing changes and `kind: noFallback` tells the worker to fail the task itself, led by `failureReason` when set.',
835
+ "Marks the original task `superseded` (terminal) and creates a fresh `taskType=\"resume\"` follow-up so a worker can pick up the work in a new provider session. Workflow-step tasks (those with `workflowRunStepId`) are carved out: the original is marked `failed` with reason `superseded_workflow_task` and no follow-up is created — the workflow engine's retry/failure policy applies, and the task moves to `superseded` once the engine queues the step's retry or the step ends without failing. With `reason: provider_fallback` (and its `errorClass`), the resume runs on the same agent with the next fallback profile that passes the profile check; when none is left, or the task is a workflow step, nothing changes and `kind: noFallback` tells the worker to fail the task itself, led by `failureReason` when set.",
796
836
  tags: ["Tasks"],
797
837
  params: z.object({ id: z.string() }),
798
838
  body: z
@@ -1240,6 +1280,12 @@ export async function handleTasks(
1240
1280
  parentTaskId: parsed.body.parentTaskId || undefined,
1241
1281
  // Human chat starts a new output contract; agent children keep inheriting.
1242
1282
  inheritParentOutputSchema: principal.kind === "agent",
1283
+ // Un mensaje humano abre trabajo nuevo; el padre conserva contexto, no requisitos del worker.
1284
+ // Solo en respuestas a un hilo: sin padre no hay requisitos que heredar.
1285
+ routingAffinity:
1286
+ parsed.body.parentTaskId && (principal.kind === "user" || principal.kind === "operator")
1287
+ ? { capabilities: [] }
1288
+ : undefined,
1243
1289
  source: parsed.body.source || "api",
1244
1290
  outputSchema: parsed.body.outputSchema || undefined,
1245
1291
  contextKey: parsed.body.contextKey || undefined,
@@ -1273,6 +1319,21 @@ export async function handleTasks(
1273
1319
 
1274
1320
  createTask.respond(res, 201, task);
1275
1321
  } catch (error) {
1322
+ if (error instanceof TaskRoutingAuthorizationError) {
1323
+ console.warn(
1324
+ "[HTTP] Task assignment rejected:",
1325
+ scrubSecrets(
1326
+ JSON.stringify({
1327
+ parentTaskId: parsed.body.parentTaskId,
1328
+ source: parsed.body.source ?? "api",
1329
+ contextKey: parsed.body.contextKey ?? parentTask?.contextKey,
1330
+ reason: error.message,
1331
+ }),
1332
+ ),
1333
+ );
1334
+ jsonError(res, error.message, 403);
1335
+ return true;
1336
+ }
1276
1337
  if (error instanceof TaskCreationBlockedError) {
1277
1338
  createTask.respond(res, 422, { error: error.reason, extension: error.extension });
1278
1339
  return true;
@@ -1731,6 +1792,7 @@ export async function handleTasks(
1731
1792
  logs,
1732
1793
  attachments,
1733
1794
  citations: await getTaskCitations(task.id),
1795
+ uiSpec: await getTaskUiSpec(task.id),
1734
1796
  });
1735
1797
  return true;
1736
1798
  }
@@ -2141,6 +2203,78 @@ export async function handleTasks(
2141
2203
  return true;
2142
2204
  }
2143
2205
 
2206
+ if (runTaskUiActionRoute.match(req.method, pathSegments)) {
2207
+ const parsed = await runTaskUiActionRoute.parse(req, res, pathSegments, queryParams);
2208
+ if (!parsed) return true;
2209
+ const task = await getTaskById(parsed.params.id);
2210
+ if (!task) {
2211
+ jsonError(res, "Task not found", 404);
2212
+ return true;
2213
+ }
2214
+ if (!(await canActOnOwnTask(req, myAgentId, task))) {
2215
+ jsonError(res, "Not authorized to act on this task", 403);
2216
+ return true;
2217
+ }
2218
+ // Only a user clicks a card button: a user token, or a dashboard tab on the
2219
+ // operator key that names its user. An agent, or an operator call with no
2220
+ // picked user, resolves to no user, so the requester check refuses it.
2221
+ // TRUST_BODY_REQUESTED_BY_USER_ID=false stops trusting a caller-named user
2222
+ // on the shared key, so then only a user token can click.
2223
+ const actor = await resolveSessionActor(req, myAgentId);
2224
+ const tokenUserId = authUserId(getRequestAuth(req));
2225
+ const trustsPickedUser = process.env.TRUST_BODY_REQUESTED_BY_USER_ID !== "false";
2226
+ const actorUserId =
2227
+ actor.kind === "user" && (tokenUserId || trustsPickedUser)
2228
+ ? (actor.userId ?? undefined)
2229
+ : undefined;
2230
+ const result = await runTaskUiAction({
2231
+ taskId: task.id,
2232
+ actionId: parsed.params.actionId,
2233
+ surface: "web",
2234
+ actorUserId,
2235
+ });
2236
+ switch (result.status) {
2237
+ case "forbidden":
2238
+ jsonError(res, "Only the task requester may run this action", 403);
2239
+ return true;
2240
+ case "unknown_action":
2241
+ jsonError(res, "This task declares no such action", 404);
2242
+ return true;
2243
+ case "disabled":
2244
+ jsonError(res, "Card actions are turned off (UI_SPEC_ACTIONS_ENABLED)", 409);
2245
+ return true;
2246
+ case "already_done":
2247
+ runTaskUiActionRoute.respond(res, 200, { status: "already_done" });
2248
+ return true;
2249
+ case "started":
2250
+ case "refreshed":
2251
+ runTaskUiActionRoute.respond(res, 200, result);
2252
+ return true;
2253
+ case "not_allowlisted":
2254
+ jsonError(res, "This action's script is not allowlisted (UI_SPEC_SCRIPT_ACTIONS)", 403);
2255
+ return true;
2256
+ case "script_changed":
2257
+ jsonError(
2258
+ res,
2259
+ "This action's script changed since it was allowlisted; an admin must re-pin it in UI_SPEC_SCRIPT_ACTIONS",
2260
+ 403,
2261
+ );
2262
+ return true;
2263
+ case "running":
2264
+ res.setHeader("Retry-After", String(result.retryAfterSec));
2265
+ jsonError(res, "This action is already running", 409);
2266
+ return true;
2267
+ case "rate_limited":
2268
+ res.setHeader("Retry-After", String(result.retryAfterSec));
2269
+ jsonError(res, `This action ran recently; try again in ${result.retryAfterSec}s`, 429);
2270
+ return true;
2271
+ case "script_failed":
2272
+ case "invalid_output":
2273
+ jsonError(res, `Refresh failed: ${result.error}`, 422);
2274
+ return true;
2275
+ }
2276
+ }
2277
+
2144
2278
  if (resumeTaskRoute.match(req.method, pathSegments)) {
2145
2279
  const parsed = await resumeTaskRoute.parse(req, res, pathSegments, queryParams);
2146
2280
  if (!parsed) return true;
@@ -2253,8 +2387,9 @@ export async function handleTasks(
2253
2387
  }
2254
2388
 
2255
2389
  // Workflow-step tasks: fail back to the engine instead of superseding.
2256
- // Check this BEFORE the supersede UPDATE so we don't leave a workflow
2257
- // step in `superseded` if the engine expects `failed`.
2390
+ // Check this BEFORE the supersede UPDATE: the engine's retry path runs off
2391
+ // `task.failed`. Once it queues the step's retry it moves the task to
2392
+ // `superseded` itself (`scheduleTaskStepRetry`).
2258
2393
  if (task.workflowRunStepId != null) {
2259
2394
  const failed = await failTask(parsed.params.id, SUPERSEDED_WORKFLOW_TASK_REASON);
2260
2395
  if (task.agentId) {
@@ -0,0 +1,140 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ import { z } from "zod";
3
+ import type { ToolCallEvent } from "../extensions/contract";
4
+ import { dispatchPost, dispatchPre } from "../extensions/dispatcher";
5
+ import type { RequestInfo } from "../tools/utils";
6
+ import { scrubObject } from "../utils/secret-scrubber";
7
+ import { route } from "./route-def";
8
+ import { jsonError } from "./utils";
9
+
10
+ const REDACTION_MARKER = "[REDACTED:";
11
+
12
+ const toolCallFields = {
13
+ harness: z.string().min(1).max(64).describe("Worker harness, such as `claude` or `pi`."),
14
+ tool: z.string().min(1).max(256).describe("Canonical tool name, such as `bash` or `edit`."),
15
+ nativeTool: z.string().min(1).max(256).optional().describe("The harness's own tool name."),
16
+ args: z.unknown().describe("Canonical tool arguments."),
17
+ rawArgs: z.unknown().optional().describe("The harness's own argument shape."),
18
+ toolCallId: z.string().max(256).optional(),
19
+ parentToolCallId: z.string().max(256).optional(),
20
+ };
21
+
22
+ const toolHookBody = z.discriminatedUnion("phase", [
23
+ z.object({ phase: z.literal("pre"), ...toolCallFields }),
24
+ z.object({
25
+ phase: z.literal("post"),
26
+ ...toolCallFields,
27
+ result: z.unknown(),
28
+ isError: z.boolean().optional(),
29
+ durationMs: z.number().nonnegative(),
30
+ }),
31
+ ]);
32
+
33
+ const toolHookDecision = z.discriminatedUnion("action", [
34
+ z.object({ action: z.literal("continue") }),
35
+ z.object({ action: z.literal("modify"), args: z.unknown() }),
36
+ z.object({ action: z.literal("block"), reason: z.string() }),
37
+ ]);
38
+
39
+ const toolHookRoute = route({
40
+ method: "post",
41
+ path: "/api/tool-hooks",
42
+ pattern: ["api", "tool-hooks"],
43
+ summary: "Run extension tool hooks for a harness-native tool call",
44
+ description:
45
+ "A worker shim reports a harness built-in tool call (bash, read, write, edit). `phase: pre` " +
46
+ "runs `pre.tool.call` with `callOrigin: native` and returns the decision. `phase: post` runs " +
47
+ "`post.tool.call` observe-only and returns 202 at once. Only extensions whose manifest " +
48
+ '`toolSources` includes `"native"` receive these calls. The server runs the secret scrubber ' +
49
+ "over the body before any handler sees it, so handlers read `[REDACTED:<name>]` in place of " +
50
+ "a secret. A `modify` whose args still carry that marker is rejected and the call continues " +
51
+ "unchanged. Shims must also scrub worker-side before sending.",
52
+ tags: ["Extensions"],
53
+ auth: { apiKey: true, agentId: true },
54
+ body: toolHookBody,
55
+ maxBodyBytes: 2 * 1024 * 1024,
56
+ rbac: { ungated: "self-scoped: an agent reports its own harness tool calls" },
57
+ responses: {
58
+ 200: { description: "Pre-call decision", schema: toolHookDecision },
59
+ 202: {
60
+ description: "Post-call event accepted",
61
+ schema: z.object({ accepted: z.literal(true) }),
62
+ },
63
+ 400: { description: "Invalid body or missing X-Agent-ID header" },
64
+ },
65
+ });
66
+
67
+ function header(req: IncomingMessage, name: string): string | undefined {
68
+ const raw = req.headers[name];
69
+ return Array.isArray(raw) ? raw[0] : raw;
70
+ }
71
+
72
+ export async function handleToolHooks(
73
+ req: IncomingMessage,
74
+ res: ServerResponse,
75
+ pathSegments: string[],
76
+ queryParams: URLSearchParams,
77
+ myAgentId: string | undefined,
78
+ ): Promise<boolean> {
79
+ if (!toolHookRoute.match(req.method, pathSegments)) return false;
80
+ if (!myAgentId) {
81
+ jsonError(res, "Missing X-Agent-ID header", 400);
82
+ return true;
83
+ }
84
+ const parsed = await toolHookRoute.parse(req, res, pathSegments, queryParams);
85
+ if (!parsed) return true;
86
+
87
+ // Scrub at entry: handlers, extension_runs rows and logs only ever see the scrubbed body.
88
+ const body = scrubObject(parsed.body);
89
+ const requestInfo: RequestInfo = {
90
+ sessionId: undefined,
91
+ agentId: myAgentId,
92
+ runtimeInstanceId: header(req, "x-runtime-instance-id"),
93
+ sourceTaskId: header(req, "x-source-task-id"),
94
+ contextKey: header(req, "x-context-key"),
95
+ callOrigin: "native",
96
+ harness: body.harness,
97
+ };
98
+ const event: ToolCallEvent = {
99
+ tool: body.tool,
100
+ args: body.args,
101
+ requestInfo,
102
+ nativeTool: body.nativeTool,
103
+ rawArgs: body.rawArgs,
104
+ toolCallId: body.toolCallId,
105
+ parentToolCallId: body.parentToolCallId,
106
+ };
107
+
108
+ if (body.phase === "post") {
109
+ toolHookRoute.respond(res, 202, { accepted: true });
110
+ void dispatchPost("post.tool.call", {
111
+ ...event,
112
+ result: body.result,
113
+ isError: body.isError,
114
+ durationMs: body.durationMs,
115
+ });
116
+ return true;
117
+ }
118
+
119
+ const result = await dispatchPre("pre.tool.call", event, {
120
+ // A marker in rewritten args is a placeholder, not the secret: executing it would break
121
+ // the call, so the rewrite is refused (an extension_runs error row) and the call continues.
122
+ validateModify: (data) =>
123
+ JSON.stringify(data.args ?? null).includes(REDACTION_MARKER)
124
+ ? {
125
+ success: false,
126
+ error: new Error(
127
+ `Modified arguments for native tool "${body.tool}" contain a redaction marker`,
128
+ ),
129
+ }
130
+ : { success: true, data },
131
+ });
132
+ if (result.action === "block") {
133
+ toolHookRoute.respond(res, 200, { action: "block", reason: result.reason });
134
+ } else if (result.action === "modify") {
135
+ toolHookRoute.respond(res, 200, { action: "modify", args: result.data.args });
136
+ } else {
137
+ toolHookRoute.respond(res, 200, { action: "continue" });
138
+ }
139
+ return true;
140
+ }