@desplega.ai/agent-swarm 2.7.6 → 2.7.8

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 (361) hide show
  1. package/dist/{acp-adapter-bp91d37f.js → acp-adapter-vg5hqkvj.js} +6 -5
  2. package/dist/{actions-yj0eeaqh.js → actions-4m1ct4nh.js} +18 -18
  3. package/dist/{amp-adapter-4pg9h34q.js → amp-adapter-txqh7eqj.js} +2 -2
  4. package/dist/{anthropic-messages-x4q6rfq5.js → anthropic-messages-xey2skwx.js} +7 -7
  5. package/dist/{app-909e97cr.js → app-e00m45gn.js} +3 -3
  6. package/dist/{assistant-qdyb5fyy.js → assistant-gd08kr9e.js} +20 -20
  7. package/dist/{azure-openai-responses-s1w5n70z.js → azure-openai-responses-26t7j9ra.js} +5 -5
  8. package/dist/boot-args-schema-tjrkpbvm.js +89 -0
  9. package/dist/{boot-reembed-fk0s9z18.js → boot-reembed-21hbck22.js} +1 -1
  10. package/dist/{boot-reembed-gs1rzrnh.js → boot-reembed-mdxd3wgp.js} +1 -1
  11. package/dist/{boot-scrub-sweep-4qfd4kfx.js → boot-scrub-sweep-qy0zr9t2.js} +3 -3
  12. package/dist/{boot-seeds-yr00k13d.js → boot-seeds-n46eaxdv.js} +4 -4
  13. package/dist/{boxd-vdmfssd9.js → boxd-nv507va8.js} +1 -1
  14. package/dist/{claude-adapter-qta1f1xn.js → claude-adapter-j37w2eds.js} +6 -5
  15. package/dist/{claude-managed-adapter-dvs2xw5n.js → claude-managed-adapter-8jvcma9a.js} +3 -3
  16. package/dist/{claude-managed-setup-sc6j4dm0.js → claude-managed-setup-rzkjmgc1.js} +3 -3
  17. package/dist/{claude-sdk-session-zgrz6yvc.js → claude-sdk-session-4k7w73t0.js} +8290 -8226
  18. package/dist/{cli-w6dt9ged.js → cli-0ykgn1h5.js} +1 -1
  19. package/dist/{cli-89knwags.js → cli-1cxrbkk6.js} +2 -2
  20. package/dist/{cli-drr5v6av.js → cli-269q28a1.js} +4 -2
  21. package/dist/{cli-es6va8jk.js → cli-32m9eda8.js} +60 -53
  22. package/dist/{cli-q0k1w5zd.js → cli-3e4snnzf.js} +1 -1
  23. package/dist/{cli-dxae2yg7.js → cli-4t50yq3j.js} +2 -2
  24. package/dist/{cli-nhrvpaj7.js → cli-5j0m12ns.js} +520 -7
  25. package/dist/{cli-dhar9qay.js → cli-5ja3b75e.js} +2 -2
  26. package/dist/{cli-gdhpcbhf.js → cli-66ww7fer.js} +1 -1
  27. package/dist/{cli-bsn8nhrq.js → cli-6vcp76qk.js} +3 -3
  28. package/dist/{cli-8bc1w0tw.js → cli-7axf41jq.js} +29 -16
  29. package/dist/cli-82j36f2m.js +45 -0
  30. package/dist/{cli-svj5090z.js → cli-84rj785g.js} +5 -5
  31. package/dist/{cli-pd7vagab.js → cli-85gzce7b.js} +5 -5
  32. package/dist/{cli-xnrwazav.js → cli-8h0ayw8c.js} +1 -1
  33. package/dist/cli-8rpcng8j.js +67 -0
  34. package/dist/{cli-shpbx5ee.js → cli-8sdejs1f.js} +1728 -72
  35. package/dist/{cli-yx4kfngt.js → cli-9m8hdawy.js} +30 -17
  36. package/dist/{cli-436532ck.js → cli-ae0dnfee.js} +166 -154
  37. package/dist/{cli-bqt1mptt.js → cli-az48n0nr.js} +4 -4
  38. package/dist/{cli-386tyxxg.js → cli-bb0mmdk8.js} +2 -2
  39. package/dist/{cli-yy3rhsdw.js → cli-bbw9wj9m.js} +8 -8
  40. package/dist/{cli-xds5f77d.js → cli-bshb7jas.js} +2 -2
  41. package/dist/{cli-wp9sp1qb.js → cli-btfsp3mv.js} +3 -3
  42. package/dist/{cli-4zsenjhy.js → cli-c0kqky8y.js} +16 -3
  43. package/dist/{cli-a7v854rf.js → cli-dq8x79v8.js} +264 -13
  44. package/dist/{cli-ftyxyspd.js → cli-eqtfgfr6.js} +1 -1
  45. package/dist/{cli-yn4kxs06.js → cli-eyg1pa00.js} +4 -4
  46. package/dist/{cli-71ptav7x.js → cli-ferkkrg9.js} +1 -1
  47. package/dist/{cli-vpf89f34.js → cli-fmjd0t1y.js} +3 -3
  48. package/dist/{cli-4necwtsv.js → cli-fyhr5h4s.js} +38 -16
  49. package/dist/{cli-xnqgpshy.js → cli-fzachfnf.js} +1 -1
  50. package/dist/{cli-ehq736cn.js → cli-g7s47cc5.js} +4 -4
  51. package/dist/{cli-0qatpy8q.js → cli-ga786dzg.js} +34 -11
  52. package/dist/{cli-bjb3z51z.js → cli-gazw7kpa.js} +2 -2
  53. package/dist/{cli-54t00gt8.js → cli-gvx71kqv.js} +2 -2
  54. package/dist/{cli-c60vetmm.js → cli-jdv6ypxs.js} +1 -1
  55. package/dist/{cli-611a1294.js → cli-k0wwfqbg.js} +18 -1
  56. package/dist/{cli-cm5yqn35.js → cli-kf3pxxdg.js} +1 -0
  57. package/dist/{cli-0at8w34w.js → cli-kyr67fgx.js} +8 -8
  58. package/dist/{cli-vvpx3gsx.js → cli-m0hmeqma.js} +2 -2
  59. package/dist/{cli-he9wchme.js → cli-mkk9rnzz.js} +4 -4
  60. package/dist/{cli-e3r2neck.js → cli-msg9m2ny.js} +7 -5
  61. package/dist/{cli-m48g6p95.js → cli-nbsf8yvn.js} +15 -3
  62. package/dist/{cli-tfyyvzx6.js → cli-njwac61j.js} +5 -0
  63. package/dist/{cli-faxe6thg.js → cli-nn3ysbqk.js} +186 -54
  64. package/dist/{cli-decfb6v8.js → cli-p3vsj0d3.js} +24 -10
  65. package/dist/{cli-ekwks2vs.js → cli-ppjxh6ah.js} +3 -3
  66. package/dist/{cli-aa6yxc7m.js → cli-pz4rk021.js} +1 -1
  67. package/dist/{cli-nwj0ee2w.js → cli-q4ebh7h7.js} +4 -4
  68. package/dist/{cli-75gkpjvw.js → cli-qd57hhhh.js} +2 -2
  69. package/dist/{cli-zbbwez0r.js → cli-rjknb2ae.js} +4 -4
  70. package/dist/{cli-hgaazk69.js → cli-s4ss5g59.js} +5 -5
  71. package/dist/{cli-1h3wcpbw.js → cli-snpj5zbj.js} +2 -2
  72. package/dist/{cli-3ypk9vk1.js → cli-sq4n7af4.js} +1 -1
  73. package/dist/{cli-vfym7wmz.js → cli-ssnjfg5p.js} +5 -5
  74. package/dist/{cli-8snvgs5r.js → cli-t60ajbbp.js} +10 -10
  75. package/dist/{cli-hr2e2fft.js → cli-tpksw2nr.js} +22 -18
  76. package/dist/{cli-k2gzwsj2.js → cli-w4xnbm46.js} +300 -74
  77. package/dist/{cli-p5gp8pcx.js → cli-wemma3jd.js} +8 -7
  78. package/dist/{cli-70r77n04.js → cli-xae4g51r.js} +1 -1
  79. package/dist/{cli-waqbxg08.js → cli-xq9r2wtt.js} +50 -26
  80. package/dist/{cli-zm72anhg.js → cli-xr8908my.js} +11 -11
  81. package/dist/{cli-73jzwksr.js → cli-ycscb2ar.js} +4 -1
  82. package/dist/{cli-kqdg1bsb.js → cli-yndmfxb3.js} +2 -2
  83. package/dist/{cli-0yv5z2pg.js → cli-yqefz277.js} +1 -1
  84. package/dist/{cli-rmmmrjkd.js → cli-z1srzaf6.js} +11 -3
  85. package/dist/{cli-xbbndvjy.js → cli-z75yxkjh.js} +3 -3
  86. package/dist/{cli-jm2vfpfd.js → cli-zkky4t5g.js} +1 -1
  87. package/dist/cli.js +24 -22
  88. package/dist/{cloudflare-workers-ai-system-one-bm60fjm0.js → cloudflare-workers-ai-system-one-ef2a980q.js} +2 -2
  89. package/dist/{codex-adapter-ayd1fb6h.js → codex-adapter-88z6psm4.js} +5 -4
  90. package/dist/{codex-hook-9efm2x1m.js → codex-hook-fac6175r.js} +2 -2
  91. package/dist/{codex-login-y0pmff1c.js → codex-login-74wa4hmq.js} +1 -1
  92. package/dist/{codex-session-runner-jesa32xc.js → codex-session-runner-zwbcwzvx.js} +5 -4
  93. package/dist/{commands-hanewgf2.js → commands-7amxs716.js} +3 -3
  94. package/dist/{controller-dt1n3c1q.js → controller-5rkkc37m.js} +3 -3
  95. package/dist/{controllers-connect-xx8x64n5.js → controllers-connect-m7d4vxxb.js} +19 -19
  96. package/dist/{cursor-adapter-9s4dwwdw.js → cursor-adapter-x1q18693.js} +1 -1
  97. package/dist/{db-9dv0g1ab.js → db-athc68zt.js} +6 -2
  98. package/dist/{db-3vttcbv4.js → db-h2fsfve3.js} +3 -3
  99. package/dist/{dispatcher-tx9hd1sv.js → dispatcher-b1yz2bnn.js} +17 -17
  100. package/dist/{dsh-adapter-007y4ejs.js → dsh-adapter-e33bkxq9.js} +1 -1
  101. package/dist/{e2b-we6hs6q5.js → e2b-fr12yccx.js} +1 -1
  102. package/dist/{e2b-a19d28rz.js → e2b-x6ywzak3.js} +1 -1
  103. package/dist/{easter-egg-3d-rgbrqb8s.js → easter-egg-3d-pv5qnzc8.js} +1 -1
  104. package/dist/{embedding-space-ny1e2940.js → embedding-space-b4txbwrk.js} +6 -6
  105. package/dist/{embeddings-2t386t13.js → embeddings-m6zn6tad.js} +1 -1
  106. package/dist/{execute-pksh0ceh.js → execute-68nwny8m.js} +1 -1
  107. package/dist/{external-channel-phgmhmd7.js → external-channel-gkckmhzh.js} +2 -2
  108. package/dist/{fx-adapter-fy8rr921.js → fx-adapter-m5jbgd5q.js} +7 -6
  109. package/dist/{google-generative-ai-8y3m3k4b.js → google-generative-ai-v94hr7h0.js} +5 -5
  110. package/dist/{google-vertex-w3v98n7b.js → google-vertex-g7vr6cf8.js} +5 -5
  111. package/dist/{grok-adapter-q0abvpaj.js → grok-adapter-csvv7sac.js} +7 -6
  112. package/dist/handlers-8x5gfbzx.js +32 -0
  113. package/dist/{heartbeat-kadyek8p.js → heartbeat-6c2y3267.js} +20 -20
  114. package/dist/{hook-5zs3msf6.js → hook-q5fv0jy2.js} +25 -10
  115. package/dist/{hook-9k551xnj.js → hook-w0q2wcrv.js} +5 -4
  116. package/dist/{http-mhz9vw1f.js → http-bxat8dg3.js} +1242 -250
  117. package/dist/{index-rvr00sg7.js → index-bxrexmfy.js} +1020 -577
  118. package/dist/{index-vdygbq10.js → index-cqhqpgrv.js} +1 -1
  119. package/dist/{index-q361cg2f.js → index-fm0czesf.js} +1 -1
  120. package/dist/index-hpfte8jd.js +33 -0
  121. package/dist/index-ncf7yb5s.js +30 -0
  122. package/dist/index-vte6dyeh.js +37 -0
  123. package/dist/{keepalive-w56f32cg.js → keepalive-qnt21cv0.js} +3 -3
  124. package/dist/lead-4bvftzm6.js +71 -0
  125. package/dist/{maintenance-7mdgxcea.js → maintenance-btdr68y4.js} +1 -1
  126. package/dist/{mistral-conversations-4pmwj1c0.js → mistral-conversations-3gjpdb4b.js} +4 -4
  127. package/dist/{oauth-refresh-sweep-29txy9vk.js → oauth-refresh-sweep-vczabeh4.js} +2 -2
  128. package/dist/{onboard-kpsrkarj.js → onboard-k33ezyq8.js} +3 -3
  129. package/dist/{openai-codex-responses-44j573nm.js → openai-codex-responses-8pbxq9h5.js} +5 -5
  130. package/dist/{openai-completions-a4gee2a8.js → openai-completions-rm00s912.js} +4 -4
  131. package/dist/{openai-decisions-w4qkrcar.js → openai-decisions-8v957r2r.js} +1 -1
  132. package/dist/{openai-responses-rbp6h5kr.js → openai-responses-agxpf96k.js} +5 -5
  133. package/dist/{opencode-adapter-j25vm3rr.js → opencode-adapter-3dst2ka7.js} +5 -4
  134. package/dist/{otel-impl-6kkct7a8.js → otel-impl-13am7a65.js} +4 -4
  135. package/dist/{pi-mono-adapter-exhkzhn2.js → pi-mono-adapter-c53de1gd.js} +16 -9
  136. package/dist/{pricing-refresh-n2x7jh6k.js → pricing-refresh-9fcbnq3f.js} +3 -3
  137. package/dist/{rbac-roles-b5htkjby.js → rbac-roles-66j5h4y5.js} +5 -3
  138. package/dist/{rbac-roles-81ypx6es.js → rbac-roles-gw0p9h3j.js} +2 -2
  139. package/dist/{render-v2-qn6jmpk4.js → render-v2-fg8bmdn4.js} +3 -3
  140. package/dist/{resume-wd30wx23.js → resume-1c8kr3nh.js} +6 -6
  141. package/dist/{runtime-4hsg7h60.js → runtime-tzf9j7tc.js} +1 -1
  142. package/dist/{session-access-5qvfevhk.js → session-access-d0atq10j.js} +7 -5
  143. package/dist/{session-source-backfill-n1czavbr.js → session-source-backfill-0vscqmsa.js} +2 -2
  144. package/dist/{setup-dnb56qy5.js → setup-tvfa7rwe.js} +1 -1
  145. package/dist/{typesafe-system-one-5mavm259.js → typesafe-system-one-0bmqcxfg.js} +2 -2
  146. package/dist/{virtual-modules-76xxv9fs.js → virtual-modules-efxcp740.js} +5 -5
  147. package/dist/{work-objects-4n21tfkm.js → work-objects-ks71xqeb.js} +20 -20
  148. package/dist/worker-e7v2bvm9.js +71 -0
  149. package/dist/{worker-follow-up-77hvzxww.js → worker-follow-up-bfx0h9hg.js} +17 -17
  150. package/openapi.json +300 -27
  151. package/package.json +7 -5
  152. package/src/apps/definition.ts +6 -5
  153. package/src/be/db/model-profiles.ts +1 -1
  154. package/src/be/db/page-theme-tokens.ts +12 -0
  155. package/src/be/db/session-tree.ts +9 -5
  156. package/src/be/db/session-visibility.ts +25 -9
  157. package/src/be/db/tasks/read.ts +20 -7
  158. package/src/be/db/tasks/write.ts +96 -7
  159. package/src/be/db-client.ts +107 -7
  160. package/src/be/db-queries/tracker.ts +4 -2
  161. package/src/be/db.ts +83 -19
  162. package/src/be/migrations/269_pages_design_system.sql +23 -0
  163. package/src/be/migrations/271_subscription_usage_model.sql +30 -0
  164. package/src/be/model-validation.ts +19 -1
  165. package/src/be/rbac-roles.ts +21 -0
  166. package/src/be/runtime-pools/routing.ts +1 -1
  167. package/src/be/scripts/boot-args-schema.ts +95 -0
  168. package/src/be/scripts/extract-schema.ts +15 -10
  169. package/src/be/seed/schedules-seeder.ts +0 -10
  170. package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -1
  171. package/src/be/seed-scripts/catalog/boot-triage.ts +1 -1
  172. package/src/be/seed-scripts/catalog/catalog-report.inline.ts +2 -0
  173. package/src/be/seed-scripts/catalog/catalog-report.ts +2 -0
  174. package/src/be/seed-scripts/catalog/get-child-outputs.ts +1 -1
  175. package/src/be/seed-scripts/catalog/memory-eval.ts +2 -0
  176. package/src/be/seed-scripts/catalog/swarm-update-check.ts +150 -0
  177. package/src/be/seed-scripts/catalog/wait-for-task.ts +1 -1
  178. package/src/be/seed-scripts/index.ts +9 -0
  179. package/src/be/seed-skills/bundled-files.generated.json +3 -3
  180. package/src/be/swarm-config-guard.ts +39 -0
  181. package/src/be/task-auto-title-listener.ts +127 -0
  182. package/src/be/users.ts +6 -4
  183. package/src/commands/claude-managed-setup.ts +1 -1
  184. package/src/commands/onboard/agent-fs-version.ts +1 -1
  185. package/src/commands/profile-sync.ts +151 -16
  186. package/src/commands/runner.ts +41 -16
  187. package/src/extensions/contract-types.generated.ts +1 -1
  188. package/src/hooks/hook.ts +20 -9
  189. package/src/http/agents.ts +7 -1
  190. package/src/http/approval-requests.ts +30 -6
  191. package/src/http/codex-oauth-device.ts +2 -2
  192. package/src/http/index.ts +11 -0
  193. package/src/http/mcp-oauth.ts +6 -0
  194. package/src/http/mcp-servers.ts +8 -0
  195. package/src/http/models-catalog.ts +1 -1
  196. package/src/http/pages-public.ts +131 -130
  197. package/src/http/pages.ts +94 -21
  198. package/src/http/poll.ts +3 -4
  199. package/src/http/prompt-templates.ts +1 -1
  200. package/src/http/schedules.ts +4 -0
  201. package/src/http/script-runs.ts +6 -1
  202. package/src/http/session-access.ts +61 -6
  203. package/src/http/sessions.ts +23 -7
  204. package/src/http/tasks.ts +53 -9
  205. package/src/http/users.ts +30 -1
  206. package/src/http/utils.ts +2 -1
  207. package/src/http/workflows.ts +11 -7
  208. package/src/pages/browser-sdk.ts +48 -21
  209. package/src/pages/color-literals.ts +115 -0
  210. package/src/pages/page-head.ts +766 -0
  211. package/src/pages/version.ts +3 -0
  212. package/src/prompts/session-templates.ts +1 -0
  213. package/src/providers/acp-targets.ts +1 -1
  214. package/src/providers/amp-adapter.ts +1 -1
  215. package/src/providers/codex-adapter.ts +10 -2
  216. package/src/providers/codex-app-server.ts +27 -1
  217. package/src/providers/codex-oauth/device.ts +49 -15
  218. package/src/providers/codex-oauth/flow.ts +2 -1
  219. package/src/providers/pi-mono-adapter.ts +8 -0
  220. package/src/providers/pi-mono-extension.ts +30 -15
  221. package/src/providers/pricing-sources.md +16 -1
  222. package/src/providers/swarm-events-shared.ts +15 -2
  223. package/src/rbac/legacy-policy.ts +1 -0
  224. package/src/rbac/permissions.ts +5 -0
  225. package/src/scheduler/deferred-task-waits.ts +9 -4
  226. package/src/scripts-runtime/extract-args-schema.ts +3 -1
  227. package/src/scripts-runtime/swarm-sdk.ts +1 -1
  228. package/src/scripts-runtime/types/swarm-extension.d.ts +29 -28
  229. package/src/server-user.ts +1 -1
  230. package/src/slack/ack.ts +48 -12
  231. package/src/slack/blocks.ts +1 -0
  232. package/src/slack/reaction-shortcode.ts +8 -2
  233. package/src/slack/render-v2.ts +30 -3
  234. package/src/slack/task-output.ts +4 -1
  235. package/src/slack/thread-buffer.ts +2 -2
  236. package/src/tasks/follow-up-gate.ts +318 -0
  237. package/src/tasks/task-skip.ts +28 -0
  238. package/src/tasks/terminal-result-guard.ts +3 -2
  239. package/src/tasks/worker-follow-up.ts +21 -1
  240. package/src/telemetry.ts +28 -1
  241. package/src/tests/agentmail-inbox-mapping.test.ts +73 -0
  242. package/src/tests/approval-requests.test.ts +58 -0
  243. package/src/tests/claude-managed-setup.test.ts +36 -0
  244. package/src/tests/codex-adapter.test.ts +2 -2
  245. package/src/tests/codex-app-server.test.ts +59 -0
  246. package/src/tests/codex-gateway-route.test.ts +50 -1
  247. package/src/tests/codex-oauth-device.test.ts +60 -0
  248. package/src/tests/codex-swarm-events.test.ts +43 -1
  249. package/src/tests/context-window.test.ts +14 -0
  250. package/src/tests/create-page-tool.test.ts +501 -0
  251. package/src/tests/db-client-busy-retry.test.ts +81 -0
  252. package/src/tests/db-queries-tracker.test.ts +2 -1
  253. package/src/tests/db-task-read-contract.test.ts +2 -0
  254. package/src/tests/db-task-write-contract.test.ts +4 -0
  255. package/src/tests/db-tasks-read.test.ts +21 -0
  256. package/src/tests/deferred-task-wake.test.ts +7 -2
  257. package/src/tests/e2e-coverage-contract.test.ts +235 -0
  258. package/src/tests/empty-output-schema.test.ts +160 -0
  259. package/src/tests/env-flag.test.ts +1 -0
  260. package/src/tests/explicit-model-validation.test.ts +14 -0
  261. package/src/tests/fixtures/pages/head-v1.html +56 -0
  262. package/src/tests/follow-up-gate-shadow.test.ts +513 -0
  263. package/src/tests/http-api-integration.test.ts +2 -2
  264. package/src/tests/http-users.test.ts +63 -0
  265. package/src/tests/identity-field-budget.test.ts +1 -1
  266. package/src/tests/internal-ai/credentials.test.ts +62 -0
  267. package/src/tests/internal-ai/task-title.test.ts +283 -0
  268. package/src/tests/mcp-input-caps.test.ts +4 -3
  269. package/src/tests/merge-gate-detect-changes.test.ts +167 -0
  270. package/src/tests/page-proxy.test.ts +1 -1
  271. package/src/tests/page-session-dev-cookie.test.ts +188 -0
  272. package/src/tests/pages-authed-mode.test.ts +13 -2
  273. package/src/tests/pages-frame-ancestors.test.ts +28 -1
  274. package/src/tests/pages-head-v2.test.ts +534 -0
  275. package/src/tests/pages-http.test.ts +330 -0
  276. package/src/tests/pages-public-html.test.ts +43 -0
  277. package/src/tests/pages-storage.test.ts +182 -0
  278. package/src/tests/pages-versioning.test.ts +72 -0
  279. package/src/tests/pi-mono-adapter.test.ts +39 -4
  280. package/src/tests/profile-sync-stale-writeback.test.ts +334 -0
  281. package/src/tests/profile-sync.test.ts +11 -15
  282. package/src/tests/rbac-engine.test.ts +1 -0
  283. package/src/tests/runner-context-usage.test.ts +119 -0
  284. package/src/tests/scheduled-task-required-params-migration.test.ts +3 -1
  285. package/src/tests/script-connections.test.ts +4 -0
  286. package/src/tests/script-executor-quickjs.test.ts +2 -0
  287. package/src/tests/script-runs-http.test.ts +57 -0
  288. package/src/tests/scripts-boot-args-schema.test.ts +181 -0
  289. package/src/tests/scripts-runtime.test.ts +24 -0
  290. package/src/tests/sdk-store-progress-skipped.test.ts +155 -0
  291. package/src/tests/seed-registry.test.ts +28 -6
  292. package/src/tests/seed-schedules.test.ts +61 -8
  293. package/src/tests/seed-scripts.test.ts +142 -2
  294. package/src/tests/session-costs-model-key-normalize.test.ts +59 -0
  295. package/src/tests/session-sharing.test.ts +212 -2
  296. package/src/tests/slack-reaction-config.test.ts +1 -0
  297. package/src/tests/slack-render-v2.test.ts +73 -0
  298. package/src/tests/slack-skip-reaction.test.ts +203 -0
  299. package/src/tests/store-progress-skipped.test.ts +159 -0
  300. package/src/tests/subscription-usage-migration.test.ts +57 -0
  301. package/src/tests/swarm-config-reserved-keys.test.ts +3 -0
  302. package/src/tests/swarm-diff.test.ts +121 -2
  303. package/src/tests/task-auto-title-config-guard.test.ts +37 -0
  304. package/src/tests/task-auto-title-listener.test.ts +165 -0
  305. package/src/tests/telemetry-endpoint-override.test.ts +27 -0
  306. package/src/tests/theme-import.test.ts +758 -0
  307. package/src/tests/themes-page-theme.test.ts +155 -0
  308. package/src/tests/themes-presets.test.ts +172 -0
  309. package/src/tests/trigger-claiming.test.ts +2 -0
  310. package/src/tests/workflow-script-principal.test.ts +2 -1
  311. package/src/tests/workflow-system-one-extraction.test.ts +29 -0
  312. package/src/themes/classics.ts +949 -0
  313. package/src/themes/import.ts +420 -0
  314. package/src/themes/page-fields.ts +40 -0
  315. package/src/themes/page-theme.ts +102 -0
  316. package/src/themes/presets.ts +561 -0
  317. package/src/themes/tokens.ts +218 -0
  318. package/src/tools/app-upsert.ts +1 -1
  319. package/src/tools/create-channel.ts +1 -1
  320. package/src/tools/create-page.ts +118 -12
  321. package/src/tools/defer-task.ts +1 -1
  322. package/src/tools/register-agentmail-inbox.ts +5 -0
  323. package/src/tools/repos/update-repo.ts +1 -1
  324. package/src/tools/request-human-input.ts +1 -1
  325. package/src/tools/send-task.ts +1 -1
  326. package/src/tools/store-progress.ts +39 -8
  327. package/src/tools/tracker/tracker-unlink.ts +2 -1
  328. package/src/tools/utils.ts +33 -0
  329. package/src/tools/workflows/retry-workflow-run.ts +3 -0
  330. package/src/types.ts +56 -5
  331. package/src/utils/constants.ts +19 -0
  332. package/src/utils/context-window.ts +6 -1
  333. package/src/utils/follow-up-gate-schedule-ids.ts +13 -0
  334. package/src/utils/internal-ai/credentials.ts +146 -93
  335. package/src/utils/internal-ai/index.ts +10 -0
  336. package/src/utils/internal-ai/models.ts +18 -0
  337. package/src/utils/internal-ai/task-title.ts +282 -0
  338. package/src/utils/output-schema.ts +23 -0
  339. package/src/utils/page-session.ts +37 -0
  340. package/src/workflows/executors/system-one-providers.ts +25 -6
  341. package/src/workflows/recovery.ts +8 -4
  342. package/src/workflows/resume.ts +19 -0
  343. package/templates/schedules/daily-status-report/content.md +88 -2
  344. package/templates/schedules/daily-swarm-update-check/content.md +16 -40
  345. package/templates/skills/apps/SKILL.md +1 -1
  346. package/templates/skills/apps/content.md +1 -1
  347. package/templates/skills/heartbeat-runbook/content.md +1 -1
  348. package/templates/skills/pages/config.json +1 -1
  349. package/templates/skills/pages/content.md +539 -86
  350. package/templates/skills/pages/files/examples/annotated-pr.html +21 -12
  351. package/templates/skills/pages/files/examples/multiplayer-board.html +41 -41
  352. package/templates/skills/pages/files/examples/report-page.html +125 -124
  353. package/dist/cli-2pnswgh8.js +0 -189
  354. package/dist/handlers-by3sfxyx.js +0 -32
  355. package/dist/index-4f2pvxae.js +0 -37
  356. package/dist/index-98gz7tmp.js +0 -30
  357. package/dist/index-k08z2cak.js +0 -33
  358. package/dist/lead-enq35nqp.js +0 -70
  359. package/dist/worker-gg1576j3.js +0 -70
  360. package/templates/schedules/daily-workflow-health-audit/config.json +0 -19
  361. package/templates/schedules/daily-workflow-health-audit/content.md +0 -191
@@ -0,0 +1,218 @@
1
+ /**
2
+ * Page theme token contract: the dashboard token names that HTML pages
3
+ * (design version 2) expose.
4
+ *
5
+ * A page's look comes only from these custom properties. Presets, per-page
6
+ * overrides and imported themes all resolve to this set, so one switch
7
+ * restyles the whole page. Sidebar, action, peer, type-scale and easing
8
+ * tokens are dashboard-only and stay out of the contract.
9
+ */
10
+
11
+ /** Color tokens: one value per mode. */
12
+ export const PAGE_THEME_COLOR_TOKENS = [
13
+ "--color-background",
14
+ "--color-foreground",
15
+ "--color-card",
16
+ "--color-card-foreground",
17
+ "--color-surface",
18
+ "--color-popover",
19
+ "--color-popover-foreground",
20
+ "--color-primary",
21
+ "--color-primary-foreground",
22
+ "--color-secondary",
23
+ "--color-secondary-foreground",
24
+ "--color-muted",
25
+ "--color-muted-foreground",
26
+ "--color-accent",
27
+ "--color-accent-foreground",
28
+ "--color-destructive",
29
+ "--color-destructive-foreground",
30
+ "--color-border",
31
+ "--color-border-subtle",
32
+ "--color-input",
33
+ "--color-ring",
34
+ "--color-chart-1",
35
+ "--color-chart-2",
36
+ "--color-chart-3",
37
+ "--color-chart-4",
38
+ "--color-chart-5",
39
+ "--color-status-success",
40
+ "--color-status-success-strong",
41
+ "--color-status-success-foreground",
42
+ "--color-status-active",
43
+ "--color-status-active-strong",
44
+ "--color-status-active-foreground",
45
+ "--color-status-error",
46
+ "--color-status-error-strong",
47
+ "--color-status-error-foreground",
48
+ "--color-status-info",
49
+ "--color-status-info-strong",
50
+ "--color-status-info-foreground",
51
+ "--color-status-pending",
52
+ "--color-status-pending-strong",
53
+ "--color-status-pending-foreground",
54
+ "--color-status-warning",
55
+ "--color-status-warning-strong",
56
+ "--color-status-warning-foreground",
57
+ "--color-status-paused",
58
+ "--color-status-paused-strong",
59
+ "--color-status-paused-foreground",
60
+ "--color-status-neutral",
61
+ "--color-status-neutral-strong",
62
+ "--color-status-neutral-foreground",
63
+ "--color-status-success-solid",
64
+ "--color-status-active-solid",
65
+ ] as const;
66
+
67
+ /** Font and radius tokens: one value for both modes. */
68
+ export const PAGE_THEME_SHARED_TOKENS = [
69
+ "--font-sans",
70
+ "--font-mono",
71
+ "--radius-sm",
72
+ "--radius-md",
73
+ "--radius-lg",
74
+ "--radius-xl",
75
+ ] as const;
76
+
77
+ export const PAGE_THEME_TOKENS = [...PAGE_THEME_COLOR_TOKENS, ...PAGE_THEME_SHARED_TOKENS] as const;
78
+
79
+ export type PageThemeToken = (typeof PAGE_THEME_TOKENS)[number];
80
+ export type PageThemeTokenValues = Partial<Record<PageThemeToken, string>>;
81
+ export type PageThemeTokens = { light: PageThemeTokenValues; dark: PageThemeTokenValues };
82
+
83
+ type PageThemeColorToken = (typeof PAGE_THEME_COLOR_TOKENS)[number];
84
+ type PageThemeSharedToken = (typeof PAGE_THEME_SHARED_TOKENS)[number];
85
+
86
+ /** Hive values from the light `@theme` block of `apps/ui/src/styles/globals.css`. */
87
+ const HIVE_SHARED_TOKENS: Record<PageThemeSharedToken, string> = {
88
+ "--font-sans": '"Space Grotesk", sans-serif',
89
+ "--font-mono": '"Space Mono", monospace',
90
+ "--radius-sm": "0.375rem",
91
+ "--radius-md": "0.5rem",
92
+ "--radius-lg": "0.625rem",
93
+ "--radius-xl": "0.625rem",
94
+ };
95
+
96
+ const HIVE_LIGHT_COLORS: Record<PageThemeColorToken, string> = {
97
+ "--color-background": "oklch(1 0 0)",
98
+ "--color-foreground": "oklch(0.141 0.005 285.823)",
99
+ "--color-card": "oklch(1 0 0)",
100
+ "--color-card-foreground": "oklch(0.141 0.005 285.823)",
101
+ "--color-surface": "oklch(0.985 0.0015 286)",
102
+ "--color-popover": "oklch(1 0 0)",
103
+ "--color-popover-foreground": "oklch(0.141 0.005 285.823)",
104
+ "--color-primary": "oklch(0.555 0.163 48.998)",
105
+ "--color-primary-foreground": "oklch(0.985 0 0)",
106
+ "--color-secondary": "oklch(0.967 0.001 286.375)",
107
+ "--color-secondary-foreground": "oklch(0.21 0.006 285.885)",
108
+ "--color-muted": "oklch(0.967 0.001 286.375)",
109
+ "--color-muted-foreground": "oklch(0.552 0.016 285.938)",
110
+ "--color-accent": "oklch(0.943 0.003 286.375)",
111
+ "--color-accent-foreground": "oklch(0.21 0.006 285.885)",
112
+ "--color-destructive": "oklch(0.577 0.245 27.325)",
113
+ "--color-destructive-foreground": "oklch(0.985 0 0)",
114
+ "--color-border": "oklch(0.92 0.004 286.32)",
115
+ "--color-border-subtle": "oklch(0.945 0.003 286)",
116
+ "--color-input": "oklch(0.92 0.004 286.32)",
117
+ "--color-ring": "oklch(0.555 0.163 48.998)",
118
+ "--color-chart-1": "oklch(0.646 0.222 41.116)",
119
+ "--color-chart-2": "oklch(0.6 0.118 184.704)",
120
+ "--color-chart-3": "oklch(0.398 0.07 227.392)",
121
+ "--color-chart-4": "oklch(0.828 0.189 84.429)",
122
+ "--color-chart-5": "oklch(0.769 0.188 70.08)",
123
+ "--color-status-success": "oklch(0.74 0.1 163)",
124
+ "--color-status-success-strong": "oklch(0.5 0.09 163)",
125
+ "--color-status-success-foreground": "oklch(0.21 0.006 285.885)",
126
+ "--color-status-active": "oklch(0.81 0.11 75)",
127
+ "--color-status-active-strong": "oklch(0.55 0.1 68)",
128
+ "--color-status-active-foreground": "oklch(0.21 0.006 285.885)",
129
+ "--color-status-error": "oklch(0.72 0.12 25)",
130
+ "--color-status-error-strong": "oklch(0.51 0.14 25)",
131
+ "--color-status-error-foreground": "oklch(0.21 0.006 285.885)",
132
+ "--color-status-info": "oklch(0.74 0.09 235)",
133
+ "--color-status-info-strong": "oklch(0.5 0.09 240)",
134
+ "--color-status-info-foreground": "oklch(0.21 0.006 285.885)",
135
+ "--color-status-pending": "oklch(0.84 0.1 95)",
136
+ "--color-status-pending-strong": "oklch(0.55 0.09 90)",
137
+ "--color-status-pending-foreground": "oklch(0.21 0.006 285.885)",
138
+ "--color-status-warning": "oklch(0.76 0.11 55)",
139
+ "--color-status-warning-strong": "oklch(0.53 0.11 50)",
140
+ "--color-status-warning-foreground": "oklch(0.21 0.006 285.885)",
141
+ "--color-status-paused": "oklch(0.71 0.1 262)",
142
+ "--color-status-paused-strong": "oklch(0.5 0.1 262)",
143
+ "--color-status-paused-foreground": "oklch(0.21 0.006 285.885)",
144
+ "--color-status-neutral": "oklch(0.62 0.014 286)",
145
+ "--color-status-neutral-strong": "oklch(0.48 0.014 286)",
146
+ "--color-status-neutral-foreground": "oklch(0.21 0.006 285.885)",
147
+ "--color-status-success-solid": "oklch(0.627 0.194 149.2)",
148
+ "--color-status-active-solid": "oklch(0.666 0.179 58.318)",
149
+ };
150
+
151
+ const HIVE_DARK_COLORS: Record<PageThemeColorToken, string> = {
152
+ "--color-background": "oklch(0.141 0.005 285.823)",
153
+ "--color-foreground": "oklch(0.985 0 0)",
154
+ "--color-card": "oklch(0.21 0.006 285.885)",
155
+ "--color-card-foreground": "oklch(0.985 0 0)",
156
+ "--color-surface": "oklch(0.185 0.006 286)",
157
+ "--color-popover": "oklch(0.21 0.006 285.885)",
158
+ "--color-popover-foreground": "oklch(0.985 0 0)",
159
+ "--color-primary": "oklch(0.769 0.188 70.08)",
160
+ "--color-primary-foreground": "oklch(0.21 0.006 285.885)",
161
+ "--color-secondary": "oklch(0.274 0.006 286.033)",
162
+ "--color-secondary-foreground": "oklch(0.985 0 0)",
163
+ "--color-muted": "oklch(0.274 0.006 286.033)",
164
+ "--color-muted-foreground": "oklch(0.705 0.015 286.067)",
165
+ "--color-accent": "oklch(0.274 0.006 286.033)",
166
+ "--color-accent-foreground": "oklch(0.985 0 0)",
167
+ "--color-destructive": "oklch(0.704 0.191 22.216)",
168
+ "--color-destructive-foreground": "oklch(0.985 0 0)",
169
+ "--color-border": "oklch(1 0 0 / 10%)",
170
+ "--color-border-subtle": "oklch(1 0 0 / 8%)",
171
+ "--color-input": "oklch(1 0 0 / 15%)",
172
+ "--color-ring": "oklch(0.769 0.188 70.08)",
173
+ "--color-chart-1": "oklch(0.488 0.243 264.376)",
174
+ "--color-chart-2": "oklch(0.696 0.17 162.48)",
175
+ "--color-chart-3": "oklch(0.769 0.188 70.08)",
176
+ "--color-chart-4": "oklch(0.627 0.265 303.9)",
177
+ "--color-chart-5": "oklch(0.645 0.246 16.439)",
178
+ "--color-status-success": "oklch(0.78 0.1 163)",
179
+ "--color-status-success-strong": "oklch(0.78 0.1 163)",
180
+ "--color-status-success-foreground": "oklch(0.21 0.006 285.885)",
181
+ "--color-status-active": "oklch(0.84 0.1 80)",
182
+ "--color-status-active-strong": "oklch(0.84 0.1 80)",
183
+ "--color-status-active-foreground": "oklch(0.21 0.006 285.885)",
184
+ "--color-status-error": "oklch(0.74 0.11 22)",
185
+ "--color-status-error-strong": "oklch(0.74 0.11 22)",
186
+ "--color-status-error-foreground": "oklch(0.21 0.006 285.885)",
187
+ "--color-status-info": "oklch(0.78 0.09 235)",
188
+ "--color-status-info-strong": "oklch(0.78 0.09 235)",
189
+ "--color-status-info-foreground": "oklch(0.21 0.006 285.885)",
190
+ "--color-status-pending": "oklch(0.86 0.09 95)",
191
+ "--color-status-pending-strong": "oklch(0.86 0.09 95)",
192
+ "--color-status-pending-foreground": "oklch(0.21 0.006 285.885)",
193
+ "--color-status-warning": "oklch(0.79 0.1 55)",
194
+ "--color-status-warning-strong": "oklch(0.79 0.1 55)",
195
+ "--color-status-warning-foreground": "oklch(0.21 0.006 285.885)",
196
+ "--color-status-paused": "oklch(0.74 0.09 260)",
197
+ "--color-status-paused-strong": "oklch(0.74 0.09 260)",
198
+ "--color-status-paused-foreground": "oklch(0.21 0.006 285.885)",
199
+ "--color-status-neutral": "oklch(0.72 0.012 286)",
200
+ "--color-status-neutral-strong": "oklch(0.72 0.012 286)",
201
+ "--color-status-neutral-foreground": "oklch(0.21 0.006 285.885)",
202
+ "--color-status-success-solid": "oklch(0.723 0.219 149.6)",
203
+ "--color-status-active-solid": "oklch(0.769 0.188 70.08)",
204
+ };
205
+
206
+ /**
207
+ * Full Hive values for every contract token, copied from the light `@theme`
208
+ * and `.dark` blocks of `apps/ui/src/styles/globals.css` (keep in sync;
209
+ * `themes-presets.test.ts` fails on drift). The shared font and radius
210
+ * tokens come from the light block and apply to both modes.
211
+ */
212
+ export const HIVE_PAGE_TOKENS: {
213
+ light: Record<PageThemeToken, string>;
214
+ dark: Record<PageThemeToken, string>;
215
+ } = {
216
+ light: { ...HIVE_LIGHT_COLORS, ...HIVE_SHARED_TOKENS },
217
+ dark: { ...HIVE_DARK_COLORS, ...HIVE_SHARED_TOKENS },
218
+ };
@@ -24,7 +24,7 @@ export const registerAppUpsertTool = (server: McpServer) => {
24
24
  {
25
25
  title: "Create or update an app",
26
26
  description:
27
- "Stores a schema-backed app definition with models, queries/actions, pages, reusable elements, optional userConfig fields, and an optional top-level theme (a dashboard preset slug for the app's canvas — hive (stock; omit to inherit the viewer's theme), meadow, iris, rose, cobalt, ember, carbon, plus the classic presets github, vscode, material, solarized, tokyo, monokai, gruvbox, catppuccin; viewers can override it per-user; unknown slugs degrade to the viewer's dashboard theme), then returns its dashboard URL. userConfig is versioned schema only; each user's values are stored separately, survive rollback, and schema changes are always compatible. Pages may bind a declared field read-only at exactly /user/<field>; pure and bound reusable elements must receive that value through a prop. Elements are private by default: pure elements read declared props, allow $item/$index inside repeats, may expose one leaf ElementSlot, and cannot invoke actions; bound elements may use the defining app's queries/actions, while exported bound elements cannot navigate. Prop kinds include enum with a required non-empty enum values array. Pages or elements reuse them with literal ElementRef targets, and cross-app refs require export: true. Zero-model pure-UI apps are valid. Pass appId to update; breaking a referenced export is blocked by the compatibility gate unless forceElementBreak explicitly names it.",
27
+ "Stores a schema-backed app definition with models, queries/actions, pages, reusable elements, optional userConfig fields, and an optional top-level theme (a dashboard preset slug for the app's canvas: hive (stock; omit to inherit the viewer's theme), meadow, iris, rose, cobalt, ember, carbon, paper (the warm editorial paper look), plus the classic presets github, vscode, material, solarized, tokyo, monokai, gruvbox, catppuccin; viewers can override it per-user; unknown slugs degrade to the viewer's dashboard theme), then returns its dashboard URL. userConfig is versioned schema only; each user's values are stored separately, survive rollback, and schema changes are always compatible. Pages may bind a declared field read-only at exactly /user/<field>; pure and bound reusable elements must receive that value through a prop. Elements are private by default: pure elements read declared props, allow $item/$index inside repeats, may expose one leaf ElementSlot, and cannot invoke actions; bound elements may use the defining app's queries/actions, while exported bound elements cannot navigate. Prop kinds include enum with a required non-empty enum values array. Pages or elements reuse them with literal ElementRef targets, and cross-app refs require export: true. Zero-model pure-UI apps are valid. Pass appId to update; breaking a referenced export is blocked by the compatibility gate unless forceElementBreak explicitly names it.",
28
28
  annotations: { destructiveHint: false },
29
29
  inputSchema: z.object({
30
30
  name: z.string().min(1).describe("Human-readable app name."),
@@ -46,7 +46,7 @@ export const registerCreateChannelTool = (server: McpServer) => {
46
46
  }
47
47
 
48
48
  try {
49
- const channel = createChannel(name, {
49
+ const channel = await createChannel(name, {
50
50
  description,
51
51
  type: type ?? "public",
52
52
  createdBy: requestInfo.agentId,
@@ -12,6 +12,10 @@
12
12
  * the title slugifies to empty (e.g. all symbols), fall back to the
13
13
  * generated page id.
14
14
  *
15
+ * Design fields: `theme`, `themeTokens` and `designVersion` set how an HTML
16
+ * page is styled. A new page gets designVersion 2. On an upsert, an omitted
17
+ * field keeps the stored value, and `null` clears `theme` / `themeTokens`.
18
+ *
15
19
  * Architecture note: this tool runs on the API server (per
16
20
  * `src/server.ts:155`+ pattern) and accesses `src/be/db` directly. The
17
21
  * worker-side DB-boundary invariant doesn't apply because `src/tools/*`
@@ -23,9 +27,18 @@ import { authorizeAssetKeyWrite } from "@/be/asset-key-auth";
23
27
  import { resolveTaskAuditUserId } from "@/be/audit-user";
24
28
  import { createPage, getPage, getPageBySlug, updatePage } from "@/be/db";
25
29
  import { getPageEditCounter } from "@/be/db/page-versions";
30
+ import { classAttributeValues, countColorLiterals } from "@/pages/color-literals";
26
31
  import { snapshotPage } from "@/pages/version";
32
+ import { readThemeFields } from "@/themes/page-fields";
33
+ import { PAGE_THEME_COLOR_TOKENS } from "@/themes/tokens";
27
34
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
28
- import { AssetKeySchema, PageAuthModeSchema, PageContentTypeSchema } from "@/types";
35
+ import {
36
+ AssetKeySchema,
37
+ type Page,
38
+ PageAuthModeSchema,
39
+ PageContentTypeSchema,
40
+ PageThemeTokensInputSchema,
41
+ } from "@/types";
29
42
  import { getAppUrl, getPublicMcpBaseUrl } from "@/utils/constants";
30
43
 
31
44
  /** Same slugifier used by the HTTP createPage handler. */
@@ -46,6 +59,26 @@ function getAppBaseUrl(): string {
46
59
  return getAppUrl();
47
60
  }
48
61
 
62
+ /** A `swarm-` primitive class inside one class attribute value. */
63
+ const SWARM_CLASS = /(?:^|\s)swarm-/;
64
+ const COLOR_TOKEN_REFERENCE = /var\(\s*--color-/i;
65
+ const PAGE_COLOR_TOKENS: ReadonlySet<string> = new Set<string>(PAGE_THEME_COLOR_TOKENS);
66
+
67
+ /** The body uses a `swarm-` class or a `var(--color-...)` token, which only design version 2 styles. */
68
+ function bodyUsesDesignSystem(html: string): boolean {
69
+ return (
70
+ COLOR_TOKEN_REFERENCE.test(html) ||
71
+ classAttributeValues(html).some((value) => SWARM_CLASS.test(value))
72
+ );
73
+ }
74
+
75
+ /** The stored overrides set light colors and no dark colors, so dark mode keeps the preset's colors. */
76
+ function hasLightOnlyColors(tokens: Page["themeTokens"]): boolean {
77
+ if (!tokens) return false;
78
+ const isColor = (name: string) => PAGE_COLOR_TOKENS.has(name);
79
+ return Object.keys(tokens.light).some(isColor) && !Object.keys(tokens.dark).some(isColor);
80
+ }
81
+
49
82
  export const registerCreatePageTool = (server: McpServer) => {
50
83
  createToolRegistrar(server)(
51
84
  "create_page",
@@ -56,7 +89,15 @@ export const registerCreatePageTool = (server: McpServer) => {
56
89
  "Calls are upsert-by-(agent, slug): if you previously created a page " +
57
90
  "with the same slug, its prior state is snapshotted and the row is " +
58
91
  "updated. Use this for static reports, dashboards, or JSON action " +
59
- "specs that don't need a long-lived process.",
92
+ "specs that don't need a long-lived process. " +
93
+ "HTML pages use the swarm design system (designVersion 2): theme " +
94
+ "tokens such as var(--color-primary), the swarm-* primitives, and " +
95
+ "Tailwind v4 utilities such as bg-card and text-muted-foreground. " +
96
+ "Set `theme` to a preset id or pass `themeTokens` (a token map, or a " +
97
+ 'CSS variable block with format "css") to restyle the whole page. ' +
98
+ "Do not hardcode colors: inside the dashboard the page follows the " +
99
+ "viewer's theme and dark mode. Pages created before designVersion 2 " +
100
+ "keep the old look; pass designVersion: 2 when you rewrite one.",
60
101
  annotations: { destructiveHint: false },
61
102
  inputSchema: z.object({
62
103
  key: AssetKeySchema.optional().describe(
@@ -99,6 +140,27 @@ export const registerCreatePageTool = (server: McpServer) => {
99
140
  .describe(
100
141
  "Declared credential needs for JSON pages (renderer ignores for v1 — reserved for follow-up).",
101
142
  ),
143
+ theme: z
144
+ .string()
145
+ .nullable()
146
+ .optional()
147
+ .describe(
148
+ "Theme preset id that restyles the whole page, for example paper, github or hive. An unknown id returns an error that lists every preset. Omit to follow the viewer's theme (on update, to keep the stored one). Pass null to clear it.",
149
+ ),
150
+ themeTokens: PageThemeTokensInputSchema.nullable()
151
+ .optional()
152
+ .describe(
153
+ 'Per-page token overrides, applied on top of the preset. Send { light, dark } maps of token name to CSS value (for example { light: { "--color-primary": "oklch(0.55 0.2 260)" } }), or { format: "css", css } with a CSS variable block (:root, .dark, @theme) as shadcn, tweakcn and Tailwind v4 export it. Stored normalized. Names outside the token contract, and values that reference a variable outside it, are ignored and reported in the result. Replaces the stored overrides. Omit to keep them on update. Pass null to clear them.',
154
+ ),
155
+ designVersion: z
156
+ .number()
157
+ .int()
158
+ .min(1)
159
+ .max(2)
160
+ .optional()
161
+ .describe(
162
+ "Design system version. 2 is the swarm design system and the default for new pages. 1 is the original look that older pages keep. Omit on update to keep the stored value.",
163
+ ),
102
164
  }),
103
165
  outputSchema: swarmToolOutputSchema({
104
166
  yourAgentId: z.string().optional(),
@@ -107,6 +169,11 @@ export const registerCreatePageTool = (server: McpServer) => {
107
169
  version: z.number().optional(),
108
170
  app_url: z.string().optional(),
109
171
  api_url: z.string().optional(),
172
+ designVersion: z.number().optional(),
173
+ ignoredTokens: z.array(z.string()).optional(),
174
+ colorLiteralCount: z.number().optional(),
175
+ usesDesignSystem: z.boolean().optional(),
176
+ lightOnlyColors: z.boolean().optional(),
110
177
  }),
111
178
  },
112
179
  async (input, requestInfo, _meta) => {
@@ -115,6 +182,9 @@ export const registerCreatePageTool = (server: McpServer) => {
115
182
  return toolErr(msg);
116
183
  }
117
184
 
185
+ const themeFields = readThemeFields(input);
186
+ if ("error" in themeFields) return toolErr(themeFields.error);
187
+
118
188
  const slug = input.slug ?? slugify(input.title);
119
189
  const finalSlug = slug || "page"; // Fallback if title slugifies to empty.
120
190
 
@@ -167,6 +237,10 @@ export const registerCreatePageTool = (server: McpServer) => {
167
237
  passwordHash: passwordHash ?? null,
168
238
  body: input.body,
169
239
  needsCredentials: needsCredentialsNames ?? null,
240
+ // Omitted design fields keep the stored values.
241
+ theme: themeFields.theme,
242
+ themeTokens: themeFields.themeTokens,
243
+ designVersion: input.designVersion,
170
244
  });
171
245
  if (!updated) {
172
246
  const msg = `Failed to update existing page ${existing.id}.`;
@@ -188,6 +262,9 @@ export const registerCreatePageTool = (server: McpServer) => {
188
262
  passwordHash,
189
263
  body: input.body,
190
264
  needsCredentials: needsCredentialsNames,
265
+ theme: themeFields.theme,
266
+ themeTokens: themeFields.themeTokens,
267
+ designVersion: input.designVersion,
191
268
  });
192
269
  id = created.id;
193
270
  } catch (err) {
@@ -209,17 +286,46 @@ export const registerCreatePageTool = (server: McpServer) => {
209
286
  const appUrl = `${getAppBaseUrl()}/pages/${id}`;
210
287
  const version = await getPageEditCounter(id);
211
288
 
212
- return toolOk(`Page "${input.title}" saved (slug=${finalSlug}, version=${version}).`, {
213
- details: `API: ${apiUrl}\n App: ${appUrl}`,
214
- data: {
215
- yourAgentId: requestInfo.agentId,
216
- id,
217
- key: fresh.key,
218
- version,
219
- app_url: appUrl,
220
- api_url: apiUrl,
289
+ // Judged on the saved page, so an upsert that keeps an older design
290
+ // version is judged by the version it keeps. The NUDGES entry for this
291
+ // tool reads these flags. Only HTML pages get the design system head.
292
+ const designFlags =
293
+ fresh.contentType === "text/html"
294
+ ? {
295
+ usesDesignSystem:
296
+ typeof input.theme === "string" ||
297
+ Boolean(input.themeTokens) ||
298
+ bodyUsesDesignSystem(fresh.body),
299
+ lightOnlyColors: hasLightOnlyColors(fresh.themeTokens),
300
+ ...(fresh.designVersion >= 2
301
+ ? { colorLiteralCount: countColorLiterals(fresh.body) }
302
+ : {}),
303
+ }
304
+ : {};
305
+ const { ignored } = themeFields;
306
+
307
+ return toolOk(
308
+ `Page "${input.title}" saved (slug=${finalSlug}, version=${version}, designVersion=${fresh.designVersion}).` +
309
+ (ignored.length > 0
310
+ ? " Some theme tokens were ignored (outside the page token contract or referencing a variable outside it)."
311
+ : ""),
312
+ {
313
+ details:
314
+ `API: ${apiUrl}\n App: ${appUrl}` +
315
+ (ignored.length > 0 ? `\n Ignored theme tokens: ${ignored.join(", ")}` : ""),
316
+ data: {
317
+ yourAgentId: requestInfo.agentId,
318
+ id,
319
+ key: fresh.key,
320
+ version,
321
+ app_url: appUrl,
322
+ api_url: apiUrl,
323
+ designVersion: fresh.designVersion,
324
+ ...(ignored.length > 0 ? { ignoredTokens: ignored } : {}),
325
+ ...designFlags,
326
+ },
221
327
  },
222
- });
328
+ );
223
329
  },
224
330
  );
225
331
  };
@@ -191,7 +191,7 @@ export const registerDeferTaskTool = (server: McpServer) => {
191
191
  })
192
192
  .optional()
193
193
  .describe(
194
- "Wake early on a task event. Provide taskId or nonempty, unique taskIds. mode defaults to all (every member must match); any wakes on the first match. settled covers completed, failed, or cancelled. Deferred and superseded members follow their continuations; a superseded member without a resume child holds to the ceiling. Any already-terminal member rejects the request; one delayMs/runAt ceiling is still required for the whole set. The member whose settlement wakes you creates no separate lead follow-up for your agent unless its followUpConfig sets onCompleted/onFailed; an all-mode member that settles while others are pending still does.",
194
+ "Wake early on a task event. Provide taskId or nonempty, unique taskIds. mode defaults to all (every member must match); any wakes on the first match. settled covers completed, failed, cancelled, or skipped. Deferred and superseded members follow their continuations; a superseded member without a resume child holds to the ceiling. Any already-terminal member rejects the request; one delayMs/runAt ceiling is still required for the whole set. The member whose settlement wakes you creates no separate lead follow-up for your agent unless its followUpConfig sets onCompleted/onFailed; an all-mode member that settles while others are pending still does.",
195
195
  ),
196
196
  summary: z
197
197
  .string()
@@ -80,6 +80,11 @@ export const registerRegisterAgentmailInboxTool = (server: McpServer) => {
80
80
  requestInfo.agentId,
81
81
  inboxEmail,
82
82
  );
83
+ if (!mapping) {
84
+ return toolErr(`Inbox ${inboxId} is owned by another agent`, {
85
+ data: { yourAgentId: requestInfo.agentId },
86
+ });
87
+ }
83
88
  const text = `Registered inbox ${inboxId} → agent ${agent.name} (${requestInfo.agentId})`;
84
89
  return toolOk(text, {
85
90
  data: { yourAgentId: requestInfo.agentId, mappings: [mapping] },
@@ -46,7 +46,7 @@ export const registerUpdateRepoTool = (server: McpServer) => {
46
46
  hooks: RepoHooksSchema.nullable()
47
47
  .optional()
48
48
  .describe(
49
- "Repository hook install config. Set { enabled: true } to opt into best-effort worker hook installation, or null to disable.",
49
+ "Repository hook install config. Best-effort worker hook installation is enabled by default for new repos. Disable it with { enabled: false } (or null), or turn it back on with { enabled: true }.",
50
50
  ),
51
51
  guidelines: RepoGuidelinesInputSchema.nullable()
52
52
  .optional()
@@ -20,7 +20,7 @@ const QuestionSchema = z.object({
20
20
  .describe(
21
21
  "The question text displayed to the user (required except for config, which defaults to the key)",
22
22
  ),
23
- required: z.boolean().optional().describe("Whether this question is required (default: true)"),
23
+ required: z.boolean().default(true).describe("Whether this question is required (default: true)"),
24
24
  description: z
25
25
  .string()
26
26
  .optional()
@@ -204,7 +204,7 @@ export const sendTaskInputSchema = z
204
204
  .record(z.string(), z.unknown())
205
205
  .optional()
206
206
  .describe(
207
- "Optional JSON Schema the assignee's final output must satisfy. store-progress rejects a completion that does not match. Supported keywords: type, required, properties, enum, const, items.",
207
+ "Optional JSON Schema the assignee's final output must satisfy. store-progress rejects a completion that does not match. Supported keywords: type, required, properties, enum, const, items. When omitted, the child inherits the schema of its parent task (your current task by default). An empty object {} means no schema: the child stores none and inherits none.",
208
208
  ),
209
209
  })
210
210
  .superRefine((data, ctx) => {
@@ -10,6 +10,7 @@ import {
10
10
  getResolvedConfig,
11
11
  getTaskById,
12
12
  insertTaskAttachment,
13
+ skipTask,
13
14
  updateAgentStatusFromCapacity,
14
15
  updateTaskProgress,
15
16
  } from "@/be/db";
@@ -27,6 +28,7 @@ import {
27
28
  } from "@/be/task-citations";
28
29
  import { AgentFsProvider } from "@/fs/agent-fs-provider";
29
30
  import { can } from "@/rbac";
31
+ import { finalizeSkippedTaskReaction, skipReasonFrom } from "@/tasks/task-skip";
30
32
  import { runTaskTerminalEffects } from "@/tasks/task-terminal-effects";
31
33
  import {
32
34
  getTaskOutputValidationError,
@@ -149,7 +151,7 @@ export const registerStoreProgressTool = (server: McpServer) => {
149
151
  {
150
152
  title: "Store task progress",
151
153
  description:
152
- "Stores the progress of a specific task. Can also mark task as completed or failed, which will set the agent back to idle.",
154
+ "Stores the progress of a specific task. Can also mark task as completed, failed, or skipped, which will set the agent back to idle. Use skipped only when the work is not yours to handle, such as a Slack thread message addressed to someone else; never skip an explicit @mention of you or work assigned to you.",
153
155
  annotations: { idempotentHint: true },
154
156
 
155
157
  inputSchema: z.object({
@@ -161,10 +163,10 @@ export const registerStoreProgressTool = (server: McpServer) => {
161
163
  ),
162
164
  progress: z.string().optional().describe("The progress update to store."),
163
165
  status: z
164
- .enum(["completed", "failed", "in_progress", "pending"])
166
+ .enum(["completed", "failed", "skipped", "in_progress", "pending"])
165
167
  .optional()
166
168
  .describe(
167
- "Set to 'completed' or 'failed' to finish the task. 'in_progress' and 'pending' store progress only and do not change task status.",
169
+ "Set to 'completed' or 'failed' to finish the task. Set 'skipped' to end a task that is not yours to handle (a Slack thread message addressed to someone else, or one you have nothing to add to); it posts nothing to the thread, creates no follow-up, and needs a one-line reason in failureReason. Never skip an explicit @mention of you or work assigned to you. 'in_progress' and 'pending' store progress only and do not change task status.",
168
170
  ),
169
171
  output: z
170
172
  .string()
@@ -175,7 +177,9 @@ export const registerStoreProgressTool = (server: McpServer) => {
175
177
  failureReason: z
176
178
  .string()
177
179
  .optional()
178
- .describe("The reason for failure (used when failing)."),
180
+ .describe(
181
+ "The reason for failure (used when failing), or the one-line reason for a skip (required with status 'skipped').",
182
+ ),
179
183
  attachments: z
180
184
  .array(AttachmentInputSchema)
181
185
  .max(20)
@@ -255,9 +259,19 @@ export const registerStoreProgressTool = (server: McpServer) => {
255
259
  }
256
260
  }
257
261
  const status =
258
- requestedStatus === "completed" || requestedStatus === "failed"
262
+ requestedStatus === "completed" ||
263
+ requestedStatus === "failed" ||
264
+ requestedStatus === "skipped"
259
265
  ? requestedStatus
260
266
  : undefined;
267
+ const skipReason = status === "skipped" ? skipReasonFrom(failureReason, output) : undefined;
268
+ if (status === "skipped") {
269
+ if (!skipReason) {
270
+ return toolErr(
271
+ 'Status "skipped" needs a one-line reason in failureReason. The task was not changed.',
272
+ );
273
+ }
274
+ }
261
275
 
262
276
  // Stock Claude occasionally puts the next tool parameter inside output.
263
277
  // Strip the leaked tail before validation/persistence; recovered pointers
@@ -510,8 +524,7 @@ export const registerStoreProgressTool = (server: McpServer) => {
510
524
  // fields untouched.
511
525
  const terminalResultGuard = await guardTerminalTaskResultWrite(existingTask, {
512
526
  status,
513
- output,
514
- failureReason,
527
+ ...(status === "skipped" ? { failureReason: skipReason } : { output, failureReason }),
515
528
  force,
516
529
  });
517
530
  if (terminalResultGuard.handled) {
@@ -646,6 +659,14 @@ export const registerStoreProgressTool = (server: McpServer) => {
646
659
  await updateAgentStatusFromCapacity(existingTask.agentId);
647
660
  }
648
661
  }
662
+ } else if (status === "skipped") {
663
+ const result = await skipTask(taskId, skipReason!);
664
+ if (result) {
665
+ updatedTask = result;
666
+ if (existingTask.agentId) {
667
+ await updateAgentStatusFromCapacity(existingTask.agentId);
668
+ }
669
+ }
649
670
  } else {
650
671
  // Progress update - ensure status reflects current load
651
672
  if (existingTask.agentId) {
@@ -681,7 +702,7 @@ export const registerStoreProgressTool = (server: McpServer) => {
681
702
  // src/tasks/task-terminal-effects.ts. Skipped on no-op (idempotent
682
703
  // re-call on a terminal task) and on forced text-only overwrites, so a
683
704
  // replay never duplicates memories or follow-up tasks.
684
- if (shouldRunTerminalSideEffects && status) {
705
+ if (shouldRunTerminalSideEffects && (status === "completed" || status === "failed")) {
685
706
  await runTaskTerminalEffects({
686
707
  task: result.task!,
687
708
  status,
@@ -692,6 +713,16 @@ export const registerStoreProgressTool = (server: McpServer) => {
692
713
  });
693
714
  }
694
715
 
716
+ // runTaskTerminalEffects above is completed/failed only: a skip posts
717
+ // nothing and only swaps the trigger message's reaction.
718
+ const skipWasFresh =
719
+ status === "skipped" &&
720
+ result.success &&
721
+ result.task?.status === "skipped" &&
722
+ !("wasNoOp" in result && result.wasNoOp) &&
723
+ !("wasForcedOverwrite" in result && result.wasForcedOverwrite);
724
+ if (skipWasFresh && result.task) finalizeSkippedTaskReaction(result.task, "store-progress");
725
+
695
726
  const learningResult = await learningWrite;
696
727
  const { success } = result;
697
728
  const message = learningResult
@@ -18,7 +18,8 @@ export const registerTrackerUnlinkTool = (server: McpServer) => {
18
18
  },
19
19
  async (args, _requestInfo, _meta) => {
20
20
  try {
21
- await deleteTrackerSync(args.syncId);
21
+ const removed = await deleteTrackerSync(args.syncId);
22
+ if (!removed) return toolErr(`No tracker mapping ${args.syncId}`);
22
23
  return toolOk(`Removed tracker sync mapping ${args.syncId}.`);
23
24
  } catch (error) {
24
25
  const message = error instanceof Error ? error.message : "Unknown error";