@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,150 @@
1
+ import { z } from "zod";
2
+
3
+ export const argsSchema = z.object({
4
+ dryRun: z
5
+ .boolean()
6
+ .optional()
7
+ .describe("Compute the verdict but do not notify the lead when an update is available"),
8
+ });
9
+
10
+ const RELEASES_URL = "https://api.github.com/repos/desplega-ai/agent-swarm/releases/latest";
11
+
12
+ /** Parse `major.minor.patch` (a leading `v` and a pre-release/build suffix are ignored). */
13
+ export function parseVersion(value: unknown): [number, number, number] | null {
14
+ if (typeof value !== "string") return null;
15
+ const m = value
16
+ .trim()
17
+ .replace(/^v/i, "")
18
+ .match(/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/);
19
+ if (!m) return null;
20
+ return [Number(m[1]), Number(m[2]), Number(m[3])];
21
+ }
22
+
23
+ /** Numeric compare of two parsed versions: negative, zero or positive. Never a string compare. */
24
+ export function compareVersions(a: [number, number, number], b: [number, number, number]): number {
25
+ for (let i = 0; i < 3; i++) {
26
+ const diff = (a[i] as number) - (b[i] as number);
27
+ if (diff !== 0) return diff;
28
+ }
29
+ return 0;
30
+ }
31
+
32
+ function errorText(error: unknown): string {
33
+ return String((error as any)?.message ?? error).slice(0, 200);
34
+ }
35
+
36
+ /** The version the API server is running, from its own unauthenticated `/health` route. */
37
+ async function runningVersion(ctx: any): Promise<string | null> {
38
+ try {
39
+ const base = ctx.stdlib.Redacted.value(ctx.swarm.config.mcpBaseUrl).replace(/\/+$/, "");
40
+ const res: any = await ctx.stdlib.fetch(base + "/health", { retries: 1, timeoutMs: 10_000 });
41
+ if (!res.ok) return null;
42
+ const body: any = await res.json();
43
+ return typeof body?.version === "string" && body.version.trim() ? body.version.trim() : null;
44
+ } catch {
45
+ return null;
46
+ }
47
+ }
48
+
49
+ async function resolveLeadId(ctx: any): Promise<string | null> {
50
+ const res: any = await ctx.swarm.swarm_get({});
51
+ const data = res?.data ?? res;
52
+ const agents: any[] = Array.isArray(data?.agents) ? data.agents : Array.isArray(data) ? data : [];
53
+ const lead = agents.find((agent) => agent?.isLead === true || agent?.isLead === 1);
54
+ return typeof lead?.id === "string" ? lead.id : null;
55
+ }
56
+
57
+ /**
58
+ * Compare the running agent-swarm version with the latest published GitHub
59
+ * release and, only when a newer release exists, hand the lead one task to
60
+ * tell the operator through its admin delivery channel.
61
+ */
62
+ export default async function swarmUpdateCheck(args: any, ctx: any) {
63
+ const parsed = argsSchema.safeParse(args ?? {});
64
+ if (!parsed.success) return { error: "invalid args: " + parsed.error.message };
65
+ const dryRun = parsed.data.dryRun === true;
66
+
67
+ const running = await runningVersion(ctx);
68
+ const runningParsed = parseVersion(running);
69
+ if (!running || !runningParsed) {
70
+ // Unknown is not "up to date": say so and stop, never guess a version.
71
+ return {
72
+ checked: false,
73
+ status: "unknown",
74
+ running,
75
+ message: `Unable to determine running version: ${running ? `unparseable "${running}"` : "not reported by /health"}.`,
76
+ };
77
+ }
78
+
79
+ let release: any;
80
+ try {
81
+ // One attempt: a failed GitHub call is reported, never retried in a loop.
82
+ const res: any = await ctx.stdlib.fetch(RELEASES_URL, {
83
+ retries: 1,
84
+ timeoutMs: 15_000,
85
+ headers: { Accept: "application/vnd.github+json", "User-Agent": "agent-swarm-update-check" },
86
+ });
87
+ if (!res.ok) throw new Error(`HTTP ${res.status}`);
88
+ release = await res.json();
89
+ } catch (error) {
90
+ return {
91
+ checked: false,
92
+ status: "github-unreachable",
93
+ running,
94
+ message: `Could not reach GitHub releases API: ${errorText(error)}`,
95
+ };
96
+ }
97
+
98
+ const latest = typeof release?.tag_name === "string" ? release.tag_name.replace(/^v/i, "") : null;
99
+ const latestParsed = parseVersion(latest);
100
+ if (!latest || !latestParsed) {
101
+ return {
102
+ checked: false,
103
+ status: "github-unreachable",
104
+ running,
105
+ message: `Could not read a version from the latest release tag: ${JSON.stringify(release?.tag_name ?? null)}.`,
106
+ };
107
+ }
108
+ const releaseUrl =
109
+ typeof release?.html_url === "string"
110
+ ? release.html_url
111
+ : `https://github.com/desplega-ai/agent-swarm/releases/tag/v${latest}`;
112
+
113
+ if (compareVersions(latestParsed, runningParsed) <= 0) {
114
+ return {
115
+ checked: true,
116
+ status: "up-to-date",
117
+ running,
118
+ latest,
119
+ message: `Up to date: running ${running}, latest published ${latest}.`,
120
+ };
121
+ }
122
+
123
+ const message = `Update available: running ${running}, latest ${latest} (${releaseUrl})`;
124
+ if (dryRun) {
125
+ return { checked: true, status: "update-available", running, latest, releaseUrl, notified: false, message };
126
+ }
127
+
128
+ const leadId = await resolveLeadId(ctx);
129
+ // A detected update that reaches nobody is a failed run, not a quiet success.
130
+ if (!leadId) throw new Error(`${message}, but the swarm has no lead to notify.`);
131
+ const sent: any = await ctx.swarm.task_send({
132
+ agentId: leadId,
133
+ routingReason: "skill",
134
+ routingNote: "Lead owns the operator's admin delivery channel for release notices.",
135
+ tags: ["swarm-update-check"],
136
+ task: [
137
+ `A newer agent-swarm release is published: running ${running}, latest ${latest}.`,
138
+ `Release: ${releaseUrl}`,
139
+ "",
140
+ "Post one short message to your configured admin delivery channel (the in-app fallback if none is configured) naming the running version, the new version and the release URL. Then complete with that message as the output.",
141
+ "Do not attempt the upgrade yourself: this notice only detects and reports.",
142
+ ].join("\n"),
143
+ });
144
+ const taskId = sent?.data?.task?.id ?? null;
145
+ if (sent?.success === false || sent?.data?.success === false || !taskId) {
146
+ const reason = sent?.data?.message ?? sent?.data?.error ?? `status ${sent?.status}`;
147
+ throw new Error(`${message}, but notifying the lead failed: ${errorText(reason)}`);
148
+ }
149
+ return { checked: true, status: "update-available", running, latest, releaseUrl, notified: true, leadTaskId: taskId, message };
150
+ }
@@ -23,7 +23,7 @@ export default async function waitForTask(args: any, ctx: any) {
23
23
  const t: any = await ctx.swarm.task_get({ taskId });
24
24
  const d = t?.data ?? t ?? {};
25
25
  last = { status: d.status ?? null, output: d.output ?? null };
26
- if (["completed", "failed", "cancelled"].includes(String(last.status))) {
26
+ if (["completed", "failed", "cancelled", "skipped"].includes(String(last.status))) {
27
27
  return { done: true, ...last };
28
28
  }
29
29
  await new Promise((r) => setTimeout(r, 2000));
@@ -60,6 +60,7 @@ import starHistoryRefreshSrc from "./catalog/star-history-refresh.ts" with { typ
60
60
  // @ts-expect-error Bun text imports synthesize a default string for this helper.
61
61
  import starHistoryRendererSrc from "./catalog/star-history-renderer.ts" with { type: "text" };
62
62
  import swarmOverviewSrc from "./catalog/swarm-overview.ts" with { type: "text" };
63
+ import swarmUpdateCheckSrc from "./catalog/swarm-update-check.ts" with { type: "text" };
63
64
  import taskContextGatheringSrc from "./catalog/task-context-gathering.ts" with { type: "text" };
64
65
  import taskFailureAuditSrc from "./catalog/task-failure-audit.ts" with { type: "text" };
65
66
  import textDiffSrc from "./catalog/text-diff.ts" with { type: "text" };
@@ -217,6 +218,14 @@ export const SEED_SCRIPTS: SeedScript[] = [
217
218
  "Task onboarding: one call instead of task_get plus multiple memory_search calls. Pass the task description split into 2-4 natural-language queries.",
218
219
  source: asText(taskContextGatheringSrc),
219
220
  },
221
+ {
222
+ name: "swarm-update-check",
223
+ description:
224
+ "Compare the running agent-swarm version (API /health) with the latest GitHub release of desplega-ai/agent-swarm as numeric major.minor.patch, and hand the lead one notify task only when a newer release exists.",
225
+ intent:
226
+ "Daily zero-config upgrade watchdog behind the daily-swarm-update-check schedule; dryRun reports the verdict without notifying.",
227
+ source: asText(swarmUpdateCheckSrc),
228
+ },
220
229
  {
221
230
  name: "schedule-health",
222
231
  description:
@@ -36,15 +36,15 @@
36
36
  "pages": [
37
37
  {
38
38
  "path": "examples/annotated-pr.html",
39
- "content": "<!doctype html>\n<!--\n Annotated-PR page using the auto-injected <swarm-diff> web component.\n\n No <script> import and no bundling: <swarm-diff>, <swarm-diff-jumps> and\n window.swarmUi.renderDiff are injected into every HTML page automatically.\n Each hunk gets id=\"swarm-diff-<file-slug>-<old_start>\" so <swarm-diff-jumps>\n can build the jump list and external links can deep-link a specific hunk.\n-->\n<html lang=\"en\">\n<head>\n <meta charset=\"utf-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n <title>PR #1234 — console.log cleanup</title>\n</head>\n<body>\n <h1>PR #1234 — cleanup raw <code>console.log</code> calls</h1>\n <p>Replaces ad-hoc logging with the project logger.</p>\n\n <swarm-diff-jumps></swarm-diff-jumps>\n\n <swarm-diff file=\"src/foo.ts\" base-sha=\"abc123\" head-sha=\"def456\">\n { \"hunks\": [\n { \"old_start\": 10, \"old_lines\": 3, \"new_start\": 10, \"new_lines\": 4,\n \"lines\": [\n { \"type\": \"context\", \"text\": \" const x = 1;\" },\n { \"type\": \"del\", \"text\": \"- console.log(x);\" },\n { \"type\": \"add\", \"text\": \"+ logger.info({ x });\" },\n { \"type\": \"add\", \"text\": \"+ return x;\" }\n ],\n \"annotations\": [\n { \"line\": 12, \"severity\": \"warn\", \"text\": \"Avoid raw console.log\" }\n ]\n }\n ] }\n </swarm-diff>\n\n <swarm-diff file=\"src/bar.ts\" base-sha=\"abc123\" head-sha=\"def456\">\n { \"hunks\": [\n { \"old_start\": 5, \"old_lines\": 1, \"new_start\": 5, \"new_lines\": 1,\n \"lines\": [\n { \"type\": \"del\", \"text\": \"- console.error('boom');\" },\n { \"type\": \"add\", \"text\": \"+ logger.error('boom');\" }\n ]\n }\n ] }\n </swarm-diff>\n</body>\n</html>\n"
39
+ "content": "<!doctype html>\n<!--\n Annotated-PR page using the auto-injected <swarm-diff> web component.\n\n No <script> import and no bundling: <swarm-diff>, <swarm-diff-jumps> and\n window.swarmUi.renderDiff are injected into every HTML page automatically.\n\n Each \"text\" is the code line WITHOUT its +, - or space marker: the\n component draws the marker in its own column. old_lines counts the context\n and deleted lines, and new_lines counts the context and added lines. Inside\n the JSON, write < as \\u003c and & as \\u0026.\n\n Each hunk gets id=\"swarm-diff-<slug>\". The slug is <file>-<old_start> in\n lowercase, with each run of characters other than a-z and 0-9 changed to\n one \"-\". So src/foo.ts at old_start 10 gets id=\"swarm-diff-src-foo-ts-10\".\n <swarm-diff-jumps> builds its jump list from these ids, and external links\n can deep-link a specific hunk.\n-->\n<html lang=\"en\">\n<head>\n <meta charset=\"utf-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n <title>PR #1234: console.log cleanup</title>\n</head>\n<body>\n <h1>PR #1234: cleanup raw <code>console.log</code> calls</h1>\n <p>Replaces ad-hoc logging with the project logger.</p>\n\n <swarm-diff-jumps></swarm-diff-jumps>\n\n <swarm-diff file=\"src/foo.ts\" base-sha=\"abc123\" head-sha=\"def456\">\n { \"hunks\": [\n { \"old_start\": 10, \"old_lines\": 2, \"new_start\": 10, \"new_lines\": 3,\n \"lines\": [\n { \"type\": \"context\", \"text\": \"export function load(id) {\" },\n { \"type\": \"del\", \"text\": \" console.log(id);\" },\n { \"type\": \"add\", \"text\": \" logger.info({ id });\" },\n { \"type\": \"add\", \"text\": \" return cache.get(id);\" }\n ],\n \"annotations\": [\n { \"line\": 12, \"severity\": \"warn\", \"text\": \"Returns undefined on a cache miss\" }\n ]\n }\n ] }\n </swarm-diff>\n\n <swarm-diff file=\"src/bar.ts\" base-sha=\"abc123\" head-sha=\"def456\">\n { \"hunks\": [\n { \"old_start\": 5, \"old_lines\": 1, \"new_start\": 5, \"new_lines\": 1,\n \"lines\": [\n { \"type\": \"del\", \"text\": \"console.error('boom');\" },\n { \"type\": \"add\", \"text\": \"logger.error('boom');\" }\n ]\n }\n ] }\n </swarm-diff>\n</body>\n</html>\n"
40
40
  },
41
41
  {
42
42
  "path": "examples/multiplayer-board.html",
43
- "content": "<!doctype html>\n<html lang=\"en\">\n <head>\n <meta charset=\"utf-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n <title>Shared board</title>\n <style>\n :root {\n color: #252522;\n background: #f7f6f3;\n font-family: \"SF Pro Display\", \"Helvetica Neue\", ui-sans-serif, system-ui, sans-serif;\n font-synthesis: none;\n }\n\n * { box-sizing: border-box; }\n\n body {\n margin: 0;\n min-width: 320px;\n padding: 0;\n background: #f7f6f3;\n color: #252522;\n font-family: \"SF Pro Display\", \"Helvetica Neue\", ui-sans-serif, system-ui, sans-serif;\n }\n\n button, input, textarea { font: inherit; }\n\n button {\n border: 1px solid #252522;\n border-radius: 8px;\n background: #252522;\n color: #fff;\n cursor: pointer;\n padding: 10px 14px;\n }\n\n button:hover { background: #3c3c37; }\n button:focus-visible, input:focus-visible, textarea:focus-visible { outline: 3px solid #e1a52c; outline-offset: 2px; }\n button:disabled { cursor: not-allowed; opacity: .5; }\n\n .page { max-width: 1120px; margin: 0 auto; padding: 32px 24px 56px; }\n\n header {\n display: flex;\n align-items: flex-start;\n justify-content: space-between;\n gap: 24px;\n border-bottom: 1px solid #d9d7d0;\n padding-bottom: 24px;\n }\n\n h1, h2, p { margin-top: 0; }\n h1 { font-size: clamp(2rem, 5vw, 3rem); letter-spacing: -.04em; margin-bottom: 8px; }\n h2 { font-size: 1.15rem; letter-spacing: -.02em; margin-bottom: 16px; }\n .lede, .muted { color: #67665f; }\n .lede { max-width: 46rem; margin-bottom: 0; }\n\n .viewer {\n min-width: 170px;\n border: 1px solid #d9d7d0;\n border-radius: 8px;\n background: #fff;\n padding: 12px;\n }\n\n .eyebrow {\n color: #67665f;\n display: block;\n font-size: .72rem;\n font-weight: 700;\n letter-spacing: .08em;\n margin-bottom: 4px;\n text-transform: uppercase;\n }\n\n .viewer-name { font-weight: 700; overflow-wrap: anywhere; }\n\n .notice {\n border: 1px solid #d9d7d0;\n border-left: 4px solid #e1a52c;\n border-radius: 8px;\n background: #fffdf8;\n margin: 24px 0;\n min-height: 47px;\n padding: 12px 14px;\n }\n\n .notice[data-tone=\"error\"] { border-left-color: #a34736; background: #fff9f7; }\n .notice[data-tone=\"stale\"] { border-left-color: #e1a52c; background: #fffdf8; }\n .notice:empty { display: none; }\n\n .grid { display: grid; gap: 24px; grid-template-columns: minmax(0, 1.65fr) minmax(260px, .85fr); }\n .panel { border: 1px solid #d9d7d0; border-radius: 12px; background: #fff; padding: 20px; }\n .panel + .panel { margin-top: 24px; }\n\n .add-row { display: grid; gap: 8px; grid-template-columns: minmax(0, 1fr) auto; margin-bottom: 16px; }\n input, textarea {\n border: 1px solid #bdbbb4;\n border-radius: 8px;\n background: #fff;\n color: inherit;\n padding: 10px 12px;\n width: 100%;\n }\n\n textarea { min-height: 94px; resize: vertical; }\n label { display: block; font-size: .88rem; font-weight: 650; margin-bottom: 8px; }\n\n .cards, .peers { list-style: none; margin: 0; padding: 0; }\n .cards { border-top: 1px solid #e7e5df; }\n .card {\n align-items: center;\n border-bottom: 1px solid #e7e5df;\n display: flex;\n gap: 12px;\n justify-content: space-between;\n padding: 13px 0;\n }\n\n .card-title { font-weight: 650; overflow-wrap: anywhere; }\n .card-status {\n background: #fff;\n border-color: #bdbbb4;\n color: #252522;\n flex: 0 0 auto;\n font-size: .82rem;\n padding: 7px 10px;\n }\n\n .card-status[data-done=\"true\"] { background: #f6efd9; border-color: #c89429; }\n .empty { color: #67665f; padding: 16px 0 4px; }\n .agent-note { background: #f7f6f3; border-radius: 8px; min-height: 46px; padding: 12px; white-space: pre-wrap; overflow-wrap: anywhere; }\n .agent-note:empty::before { color: #67665f; content: \"No note yet. A server-side agent can write one here.\"; }\n\n .peers { display: grid; gap: 8px; }\n .peer {\n border: 1px solid #e7e5df;\n border-radius: 8px;\n display: grid;\n gap: 3px;\n padding: 10px;\n }\n\n .peer-name { font-weight: 650; overflow-wrap: anywhere; }\n .room-meta { color: #67665f; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: .75rem; margin: 0 0 16px; }\n .save-state { color: #67665f; font-size: .82rem; margin: 8px 0 0; min-height: 1.2em; }\n\n @media (max-width: 720px) {\n .page { padding: 24px 16px 40px; }\n header { align-items: stretch; flex-direction: column; }\n .viewer { min-width: 0; }\n .grid { grid-template-columns: 1fr; }\n .add-row { grid-template-columns: 1fr; }\n }\n </style>\n </head>\n <body>\n <swarm-cursors room=\"match-42\"></swarm-cursors>\n <main class=\"page\">\n <header>\n <div>\n <h1>Shared board</h1>\n <p class=\"lede\">A small board shared by everyone in match-42. Changes appear as peers make them.</p>\n </div>\n <section class=\"viewer\" aria-label=\"Current viewer\">\n <span class=\"eyebrow\">Connected as</span>\n <div class=\"viewer-name\" id=\"viewer-name\">Connecting…</div>\n </section>\n </header>\n\n <div id=\"notice\" class=\"notice\" role=\"status\" aria-live=\"polite\"></div>\n\n <div class=\"grid\">\n <section class=\"panel\" aria-labelledby=\"board-heading\">\n <h2 id=\"board-heading\">Match board</h2>\n <p class=\"room-meta\">Room: match-42 · Schema: 1</p>\n <form id=\"add-card-form\" class=\"add-row\">\n <label for=\"card-title\" class=\"sr-only\" hidden>New card title</label>\n <input id=\"card-title\" name=\"title\" maxlength=\"120\" placeholder=\"Write a card title\" required>\n <button type=\"submit\">Add card</button>\n </form>\n <ul id=\"cards\" class=\"cards\" aria-live=\"polite\"></ul>\n </section>\n\n <aside>\n <section class=\"panel\" aria-labelledby=\"peers-heading\">\n <h2 id=\"peers-heading\">Live peers</h2>\n <p class=\"muted\">Pointers use document-normalized coordinates and line up across viewports.</p>\n <ul id=\"peers\" class=\"peers\" aria-live=\"polite\"></ul>\n </section>\n\n <section class=\"panel\" aria-labelledby=\"agent-note-heading\">\n <h2 id=\"agent-note-heading\">Agent note</h2>\n <div id=\"agent-note\" class=\"agent-note\" aria-live=\"polite\"></div>\n </section>\n </aside>\n </div>\n\n <section class=\"panel\" aria-labelledby=\"lobby-heading\">\n <h2 id=\"lobby-heading\">Lobby</h2>\n <p class=\"room-meta\">Room: lobby · Schema: 1</p>\n <form id=\"lobby-form\">\n <label for=\"lobby-message\">Shared lobby message</label>\n <textarea id=\"lobby-message\" maxlength=\"1000\" placeholder=\"Leave a message for everyone in the lobby\"></textarea>\n <button type=\"submit\">Save lobby message</button>\n <p id=\"lobby-save-state\" class=\"save-state\" aria-live=\"polite\"></p>\n </form>\n </section>\n </main>\n\n <script>\n (() => {\n const ui = {\n viewerName: document.querySelector('#viewer-name'),\n notice: document.querySelector('#notice'),\n cards: document.querySelector('#cards'),\n peers: document.querySelector('#peers'),\n agentNote: document.querySelector('#agent-note'),\n addCardForm: document.querySelector('#add-card-form'),\n cardTitle: document.querySelector('#card-title'),\n lobbyForm: document.querySelector('#lobby-form'),\n lobbyMessage: document.querySelector('#lobby-message'),\n lobbySaveState: document.querySelector('#lobby-save-state')\n };\n\n let board;\n let lobby;\n let peers = [];\n let lobbyDirty = false;\n\n function message(error) {\n return error && error.message ? error.message : String(error);\n }\n\n function showNotice(text, tone) {\n ui.notice.textContent = text || '';\n ui.notice.dataset.tone = tone || '';\n }\n\n function markStale(room, roomName) {\n if (!room.stale) return false;\n showNotice(`${roomName} uses a different schema version. Its saved state remains visible, but this page cannot write changes.`, 'stale');\n return true;\n }\n\n function renderBoard(state) {\n const cards = state && state.cards && typeof state.cards === 'object' ? state.cards : {};\n ui.cards.replaceChildren();\n const entries = Object.entries(cards);\n\n if (!entries.length) {\n const empty = document.createElement('li');\n empty.className = 'empty';\n empty.textContent = 'No cards yet. Add the first card.';\n ui.cards.append(empty);\n }\n\n for (const [id, card] of entries) {\n const item = document.createElement('li');\n item.className = 'card';\n const title = document.createElement('span');\n title.className = 'card-title';\n title.textContent = card && typeof card.title === 'string' ? card.title : 'Untitled card';\n const toggle = document.createElement('button');\n const done = Boolean(card && card.done);\n toggle.className = 'card-status';\n toggle.dataset.done = String(done);\n toggle.type = 'button';\n toggle.textContent = done ? 'Done' : 'Open';\n toggle.setAttribute('aria-label', `Mark ${title.textContent} as ${done ? 'open' : 'done'}`);\n toggle.addEventListener('click', () => toggleCard(id));\n item.append(title, toggle);\n ui.cards.append(item);\n }\n\n ui.agentNote.textContent = state && typeof state.agentNote === 'string' ? state.agentNote : '';\n }\n\n function renderPeers(nextPeers) {\n peers = Array.isArray(nextPeers) ? nextPeers : [];\n ui.peers.replaceChildren();\n\n if (!peers.length) {\n const empty = document.createElement('li');\n empty.className = 'empty';\n empty.textContent = 'No other peers are connected.';\n ui.peers.append(empty);\n return;\n }\n\n for (const peer of peers) {\n const item = document.createElement('li');\n item.className = 'peer';\n const name = document.createElement('span');\n name.className = 'peer-name';\n name.textContent = peer.name || 'Guest';\n item.append(name);\n ui.peers.append(item);\n }\n }\n\n function renderLobby(state) {\n if (lobbyDirty) return;\n ui.lobbyMessage.value = state && typeof state.message === 'string' ? state.message : '';\n }\n\n async function addCard(title) {\n if (markStale(board, 'match-42')) return;\n try {\n await board.change(state => {\n state.cards ??= {};\n state.cards[crypto.randomUUID()] = { title, done: false };\n });\n ui.cardTitle.value = '';\n showNotice('Card added.', 'success');\n } catch (error) {\n showNotice(`Could not add the card: ${message(error)}`, 'error');\n }\n }\n\n async function toggleCard(id) {\n if (markStale(board, 'match-42')) return;\n try {\n await board.change(state => {\n const card = state.cards && state.cards[id];\n if (card) card.done = !card.done;\n });\n } catch (error) {\n showNotice(`Could not update the card: ${message(error)}`, 'error');\n }\n }\n\n async function saveLobbyMessage() {\n if (markStale(lobby, 'lobby')) return;\n try {\n const value = ui.lobbyMessage.value;\n await lobby.change(state => {\n state.message = value;\n });\n lobbyDirty = false;\n ui.lobbySaveState.textContent = 'Saved to the lobby room.';\n } catch (error) {\n ui.lobbySaveState.textContent = `Could not save: ${message(error)}`;\n showNotice(`Could not save the lobby message: ${message(error)}`, 'error');\n }\n }\n\n async function initialize() {\n try {\n board = await window.swarmSdk.room('match-42', { schemaVersion: 1 });\n lobby = await window.swarmSdk.room('lobby', { schemaVersion: 1 });\n\n const viewer = board.me || lobby.me || {};\n ui.viewerName.textContent = viewer.name || 'Guest';\n\n board.on('change', renderBoard);\n board.on('presence', renderPeers);\n board.on('error', error => showNotice(`match-42 error: ${message(error)}`, 'error'));\n board.on('reset', () => showNotice('match-42 was reset by another participant. The board has resynchronized.', 'stale'));\n lobby.on('change', renderLobby);\n lobby.on('error', error => showNotice(`lobby error: ${message(error)}`, 'error'));\n lobby.on('reset', () => showNotice('lobby was reset by another participant. The lobby has resynchronized.', 'stale'));\n\n renderBoard(board.state);\n renderPeers(board.presence.peers);\n renderLobby(lobby.state);\n markStale(board, 'match-42');\n markStale(lobby, 'lobby');\n\n if (!board.stale) {\n await board.change(state => {\n state.cards ??= {};\n state.agentNote ??= '';\n });\n }\n if (!lobby.stale) {\n await lobby.change(state => {\n state.message ??= '';\n state.activeMatch ??= 'match-42';\n });\n }\n } catch (error) {\n showNotice(`Could not connect to the shared rooms: ${message(error)}`, 'error');\n ui.viewerName.textContent = 'Unavailable';\n }\n }\n\n ui.addCardForm.addEventListener('submit', event => {\n event.preventDefault();\n const title = ui.cardTitle.value.trim();\n if (title) addCard(title);\n });\n ui.lobbyMessage.addEventListener('input', () => { lobbyDirty = true; });\n ui.lobbyForm.addEventListener('submit', event => {\n event.preventDefault();\n saveLobbyMessage();\n });\n window.addEventListener('pagehide', () => {\n if (board) board.close();\n if (lobby) lobby.close();\n });\n\n initialize();\n })();\n </script>\n </body>\n</html>\n"
43
+ "content": "<!doctype html>\n<html lang=\"en\">\n <head>\n <meta charset=\"utf-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n <title>Shared board</title>\n <style>\n :root {\n color: var(--color-foreground);\n background: var(--color-background);\n font-family: var(--font-sans);\n font-synthesis: none;\n }\n\n * { box-sizing: border-box; }\n\n body {\n margin: 0;\n min-width: 320px;\n padding: 0;\n background: var(--color-background);\n color: var(--color-foreground);\n font-family: var(--font-sans);\n }\n\n button, input, textarea { font: inherit; }\n\n button {\n border: 1px solid var(--color-primary);\n border-radius: var(--radius-md);\n background: var(--color-primary);\n color: var(--color-primary-foreground);\n cursor: pointer;\n padding: 10px 14px;\n }\n\n button:hover { background: color-mix(in oklab, var(--color-primary) 90%, transparent); }\n button:focus-visible, input:focus-visible, textarea:focus-visible { outline: 3px solid var(--color-ring); outline-offset: 2px; }\n button:disabled { cursor: not-allowed; opacity: .5; }\n\n .page { max-width: 1120px; margin: 0 auto; padding: 32px 24px 56px; }\n\n header {\n display: flex;\n align-items: flex-start;\n justify-content: space-between;\n gap: 24px;\n border-bottom: 1px solid var(--color-border);\n padding-bottom: 24px;\n }\n\n h1, h2, p { margin-top: 0; }\n h1 { font-size: clamp(2rem, 5vw, 3rem); letter-spacing: -.04em; margin-bottom: 8px; }\n h2 { font-size: 1.15rem; letter-spacing: -.02em; margin-bottom: 16px; }\n .lede, .muted { color: var(--color-muted-foreground); }\n .lede { max-width: 46rem; margin-bottom: 0; }\n\n .viewer {\n min-width: 170px;\n border: 1px solid var(--color-border);\n border-radius: var(--radius-md);\n background: var(--color-card);\n padding: 12px;\n }\n\n .eyebrow {\n color: var(--color-muted-foreground);\n display: block;\n font-size: .72rem;\n font-weight: 700;\n letter-spacing: .08em;\n margin-bottom: 4px;\n text-transform: uppercase;\n }\n\n .viewer-name { font-weight: 700; overflow-wrap: anywhere; }\n\n .notice {\n border: 1px solid var(--color-border);\n border-left: 4px solid var(--color-primary);\n border-radius: var(--radius-md);\n background: var(--color-card);\n margin: 24px 0;\n min-height: 47px;\n padding: 12px 14px;\n }\n\n .notice[data-tone=\"error\"] { border-left-color: var(--color-status-error); background: color-mix(in oklab, var(--color-status-error) 10%, var(--color-card)); }\n .notice[data-tone=\"stale\"] { border-left-color: var(--color-status-warning); background: color-mix(in oklab, var(--color-status-warning) 10%, var(--color-card)); }\n .notice:empty { display: none; }\n\n .grid { display: grid; gap: 24px; grid-template-columns: minmax(0, 1.65fr) minmax(260px, .85fr); }\n .panel { border: 1px solid var(--color-border); border-radius: var(--radius-xl); background: var(--color-card); padding: 20px; }\n .panel + .panel { margin-top: 24px; }\n\n .add-row { display: grid; gap: 8px; grid-template-columns: minmax(0, 1fr) auto; margin-bottom: 16px; }\n input, textarea {\n border: 1px solid var(--color-input);\n border-radius: var(--radius-md);\n background: var(--color-card);\n color: inherit;\n padding: 10px 12px;\n width: 100%;\n }\n\n textarea { min-height: 94px; resize: vertical; }\n label { display: block; font-size: .88rem; font-weight: 650; margin-bottom: 8px; }\n\n .cards, .peers { list-style: none; margin: 0; padding: 0; }\n .cards { border-top: 1px solid var(--color-border-subtle); }\n .card {\n align-items: center;\n border-bottom: 1px solid var(--color-border-subtle);\n display: flex;\n gap: 12px;\n justify-content: space-between;\n padding: 13px 0;\n }\n\n .card-title { font-weight: 650; overflow-wrap: anywhere; }\n .card-status {\n background: var(--color-card);\n border-color: var(--color-input);\n color: var(--color-foreground);\n flex: 0 0 auto;\n font-size: .82rem;\n padding: 7px 10px;\n }\n\n .card-status[data-done=\"true\"] { background: var(--color-status-success); border-color: var(--color-status-success-strong); color: var(--color-status-success-foreground); }\n .empty { color: var(--color-muted-foreground); padding: 16px 0 4px; }\n .agent-note { background: var(--color-muted); border-radius: var(--radius-md); min-height: 46px; padding: 12px; white-space: pre-wrap; overflow-wrap: anywhere; }\n .agent-note:empty::before { color: var(--color-muted-foreground); content: \"No note yet. A server-side agent can write one here.\"; }\n\n .peers { display: grid; gap: 8px; }\n .peer {\n border: 1px solid var(--color-border-subtle);\n border-radius: var(--radius-md);\n display: grid;\n gap: 3px;\n padding: 10px;\n }\n\n .peer-name { font-weight: 650; overflow-wrap: anywhere; }\n .room-meta { color: var(--color-muted-foreground); font-family: var(--font-mono); font-size: .75rem; margin: 0 0 16px; }\n .save-state { color: var(--color-muted-foreground); font-size: .82rem; margin: 8px 0 0; min-height: 1.2em; }\n\n @media (max-width: 720px) {\n .page { padding: 24px 16px 40px; }\n header { align-items: stretch; flex-direction: column; }\n .viewer { min-width: 0; }\n .grid { grid-template-columns: 1fr; }\n .add-row { grid-template-columns: 1fr; }\n }\n </style>\n </head>\n <body>\n <swarm-cursors room=\"match-42\"></swarm-cursors>\n <main class=\"page\">\n <header>\n <div>\n <h1>Shared board</h1>\n <p class=\"lede\">A small board shared by everyone in match-42. Changes appear as peers make them.</p>\n </div>\n <section class=\"viewer\" aria-label=\"Current viewer\">\n <span class=\"eyebrow\">Connected as</span>\n <div class=\"viewer-name\" id=\"viewer-name\">Connecting…</div>\n </section>\n </header>\n\n <div id=\"notice\" class=\"notice\" role=\"status\" aria-live=\"polite\"></div>\n\n <div class=\"grid\">\n <section class=\"panel\" aria-labelledby=\"board-heading\">\n <h2 id=\"board-heading\">Match board</h2>\n <p class=\"room-meta\">Room: match-42 · Schema: 1</p>\n <form id=\"add-card-form\" class=\"add-row\">\n <label for=\"card-title\" class=\"sr-only\" hidden>New card title</label>\n <input id=\"card-title\" name=\"title\" maxlength=\"120\" placeholder=\"Write a card title\" required>\n <button type=\"submit\">Add card</button>\n </form>\n <ul id=\"cards\" class=\"cards\" aria-live=\"polite\"></ul>\n </section>\n\n <aside>\n <section class=\"panel\" aria-labelledby=\"peers-heading\">\n <h2 id=\"peers-heading\">Live peers</h2>\n <p class=\"muted\">Pointers use document-normalized coordinates and line up across viewports.</p>\n <ul id=\"peers\" class=\"peers\" aria-live=\"polite\"></ul>\n </section>\n\n <section class=\"panel\" aria-labelledby=\"agent-note-heading\">\n <h2 id=\"agent-note-heading\">Agent note</h2>\n <div id=\"agent-note\" class=\"agent-note\" aria-live=\"polite\"></div>\n </section>\n </aside>\n </div>\n\n <section class=\"panel\" aria-labelledby=\"lobby-heading\">\n <h2 id=\"lobby-heading\">Lobby</h2>\n <p class=\"room-meta\">Room: lobby · Schema: 1</p>\n <form id=\"lobby-form\">\n <label for=\"lobby-message\">Shared lobby message</label>\n <textarea id=\"lobby-message\" maxlength=\"1000\" placeholder=\"Leave a message for everyone in the lobby\"></textarea>\n <button type=\"submit\">Save lobby message</button>\n <p id=\"lobby-save-state\" class=\"save-state\" aria-live=\"polite\"></p>\n </form>\n </section>\n </main>\n\n <script>\n (() => {\n const ui = {\n viewerName: document.querySelector('#viewer-name'),\n notice: document.querySelector('#notice'),\n cards: document.querySelector('#cards'),\n peers: document.querySelector('#peers'),\n agentNote: document.querySelector('#agent-note'),\n addCardForm: document.querySelector('#add-card-form'),\n cardTitle: document.querySelector('#card-title'),\n lobbyForm: document.querySelector('#lobby-form'),\n lobbyMessage: document.querySelector('#lobby-message'),\n lobbySaveState: document.querySelector('#lobby-save-state')\n };\n\n let board;\n let lobby;\n let peers = [];\n let lobbyDirty = false;\n\n function message(error) {\n return error && error.message ? error.message : String(error);\n }\n\n function showNotice(text, tone) {\n ui.notice.textContent = text || '';\n ui.notice.dataset.tone = tone || '';\n }\n\n function markStale(room, roomName) {\n if (!room.stale) return false;\n showNotice(`${roomName} uses a different schema version. Its saved state remains visible, but this page cannot write changes.`, 'stale');\n return true;\n }\n\n function renderBoard(state) {\n const cards = state && state.cards && typeof state.cards === 'object' ? state.cards : {};\n ui.cards.replaceChildren();\n const entries = Object.entries(cards);\n\n if (!entries.length) {\n const empty = document.createElement('li');\n empty.className = 'empty';\n empty.textContent = 'No cards yet. Add the first card.';\n ui.cards.append(empty);\n }\n\n for (const [id, card] of entries) {\n const item = document.createElement('li');\n item.className = 'card';\n const title = document.createElement('span');\n title.className = 'card-title';\n title.textContent = card && typeof card.title === 'string' ? card.title : 'Untitled card';\n const toggle = document.createElement('button');\n const done = Boolean(card && card.done);\n toggle.className = 'card-status';\n toggle.dataset.done = String(done);\n toggle.type = 'button';\n toggle.textContent = done ? 'Done' : 'Open';\n toggle.setAttribute('aria-label', `Mark ${title.textContent} as ${done ? 'open' : 'done'}`);\n toggle.addEventListener('click', () => toggleCard(id));\n item.append(title, toggle);\n ui.cards.append(item);\n }\n\n ui.agentNote.textContent = state && typeof state.agentNote === 'string' ? state.agentNote : '';\n }\n\n function renderPeers(nextPeers) {\n peers = Array.isArray(nextPeers) ? nextPeers : [];\n ui.peers.replaceChildren();\n\n if (!peers.length) {\n const empty = document.createElement('li');\n empty.className = 'empty';\n empty.textContent = 'No other peers are connected.';\n ui.peers.append(empty);\n return;\n }\n\n for (const peer of peers) {\n const item = document.createElement('li');\n item.className = 'peer';\n const name = document.createElement('span');\n name.className = 'peer-name';\n name.textContent = peer.name || 'Guest';\n item.append(name);\n ui.peers.append(item);\n }\n }\n\n function renderLobby(state) {\n if (lobbyDirty) return;\n ui.lobbyMessage.value = state && typeof state.message === 'string' ? state.message : '';\n }\n\n async function addCard(title) {\n if (markStale(board, 'match-42')) return;\n try {\n await board.change(state => {\n state.cards ??= {};\n state.cards[crypto.randomUUID()] = { title, done: false };\n });\n ui.cardTitle.value = '';\n showNotice('Card added.', 'success');\n } catch (error) {\n showNotice(`Could not add the card: ${message(error)}`, 'error');\n }\n }\n\n async function toggleCard(id) {\n if (markStale(board, 'match-42')) return;\n try {\n await board.change(state => {\n const card = state.cards && state.cards[id];\n if (card) card.done = !card.done;\n });\n } catch (error) {\n showNotice(`Could not update the card: ${message(error)}`, 'error');\n }\n }\n\n async function saveLobbyMessage() {\n if (markStale(lobby, 'lobby')) return;\n try {\n const value = ui.lobbyMessage.value;\n await lobby.change(state => {\n state.message = value;\n });\n lobbyDirty = false;\n ui.lobbySaveState.textContent = 'Saved to the lobby room.';\n } catch (error) {\n ui.lobbySaveState.textContent = `Could not save: ${message(error)}`;\n showNotice(`Could not save the lobby message: ${message(error)}`, 'error');\n }\n }\n\n async function initialize() {\n try {\n board = await window.swarmSdk.room('match-42', { schemaVersion: 1 });\n lobby = await window.swarmSdk.room('lobby', { schemaVersion: 1 });\n\n const viewer = board.me || lobby.me || {};\n ui.viewerName.textContent = viewer.name || 'Guest';\n\n board.on('change', renderBoard);\n board.on('presence', renderPeers);\n board.on('error', error => showNotice(`match-42 error: ${message(error)}`, 'error'));\n board.on('reset', () => showNotice('match-42 was reset by another participant. The board has resynchronized.', 'stale'));\n lobby.on('change', renderLobby);\n lobby.on('error', error => showNotice(`lobby error: ${message(error)}`, 'error'));\n lobby.on('reset', () => showNotice('lobby was reset by another participant. The lobby has resynchronized.', 'stale'));\n\n renderBoard(board.state);\n renderPeers(board.presence.peers);\n renderLobby(lobby.state);\n markStale(board, 'match-42');\n markStale(lobby, 'lobby');\n\n if (!board.stale) {\n await board.change(state => {\n state.cards ??= {};\n state.agentNote ??= '';\n });\n }\n if (!lobby.stale) {\n await lobby.change(state => {\n state.message ??= '';\n state.activeMatch ??= 'match-42';\n });\n }\n } catch (error) {\n showNotice(`Could not connect to the shared rooms: ${message(error)}`, 'error');\n ui.viewerName.textContent = 'Unavailable';\n }\n }\n\n ui.addCardForm.addEventListener('submit', event => {\n event.preventDefault();\n const title = ui.cardTitle.value.trim();\n if (title) addCard(title);\n });\n ui.lobbyMessage.addEventListener('input', () => { lobbyDirty = true; });\n ui.lobbyForm.addEventListener('submit', event => {\n event.preventDefault();\n saveLobbyMessage();\n });\n window.addEventListener('pagehide', () => {\n if (board) board.close();\n if (lobby) lobby.close();\n });\n\n initialize();\n })();\n </script>\n </body>\n</html>\n"
44
44
  },
45
45
  {
46
46
  "path": "examples/report-page.html",
47
- "content": "<!doctype html>\n<!--\n Reference report page — minimalist taste baseline + report density layer.\n\n Copy this as the starting point for any dense report/dashboard page, then\n replace the content. The CSS already encodes the baseline documented in the\n `pages` skill: warm monochrome canvas, single-column 1120px spine, 8/12/16/\n 24/32/48/72 spacing scale, tabular numerals, flat bordered cards, table\n horizontal scroll on mobile, and no decorative gradients or nested cards.\n\n Publish with:\n create_page({\n title: \"Q2 SEO Performance\",\n slug: \"q2-seo-performance\",\n description: \"Human-readable SEO performance report.\",\n contentType: \"text/html\",\n authMode: \"authed\",\n body: <this file's contents>,\n })\n-->\n<html lang=\"en\">\n<head>\n <meta charset=\"utf-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n <title>Q2 SEO Performance</title>\n <style>\n :root {\n color-scheme: light;\n --bg: #f6f4f0;\n --panel: #ffffff;\n --ink: #18181b;\n --muted: #62646a;\n --line: #dedbd2;\n --accent: #2563eb;\n --danger: #b42318;\n --warn: #b54708;\n --ok: #067647;\n --radius: 8px;\n --shadow: 0 1px 2px rgba(24, 24, 27, 0.04);\n }\n * { box-sizing: border-box; }\n body {\n margin: 0;\n background: var(--bg);\n color: var(--ink);\n font-family: \"SF Pro Display\", \"Geist Sans\", \"Helvetica Neue\", ui-sans-serif, system-ui, sans-serif;\n font-size: 16px;\n line-height: 1.55;\n }\n main {\n width: min(1120px, calc(100% - 32px));\n margin: 0 auto;\n padding: 48px 0 72px;\n }\n header { margin-bottom: 32px; }\n .eyebrow {\n margin: 0 0 8px;\n color: var(--muted);\n font-size: 13px;\n font-weight: 700;\n letter-spacing: 0.08em;\n text-transform: uppercase;\n }\n h1 {\n margin: 0;\n max-width: 780px;\n font-size: clamp(2rem, 4vw, 3rem);\n line-height: 1.05;\n letter-spacing: 0;\n }\n .lede {\n max-width: 760px;\n margin: 16px 0 0;\n color: var(--muted);\n font-size: 18px;\n }\n .metrics {\n display: grid;\n grid-template-columns: repeat(4, minmax(0, 1fr));\n gap: 12px;\n margin: 32px 0;\n }\n .metric, .section {\n background: var(--panel);\n border: 1px solid var(--line);\n border-radius: var(--radius);\n box-shadow: var(--shadow);\n }\n .metric { padding: 18px; }\n .metric strong {\n display: block;\n font-size: 32px;\n line-height: 1;\n font-variant-numeric: tabular-nums;\n }\n .metric span {\n display: block;\n margin-top: 8px;\n color: var(--muted);\n font-size: 13px;\n font-weight: 650;\n }\n .section {\n margin-top: 18px;\n padding: 24px;\n }\n h2 { margin: 0 0 12px; font-size: 24px; line-height: 1.2; }\n h3 { margin: 0 0 8px; font-size: 17px; line-height: 1.3; }\n p { margin: 0 0 12px; }\n .table-wrap { overflow-x: auto; border: 1px solid var(--line); border-radius: var(--radius); }\n table { width: 100%; border-collapse: collapse; min-width: 640px; }\n th, td { padding: 10px 12px; border-bottom: 1px solid var(--line); text-align: left; vertical-align: top; }\n th { color: var(--muted); font-size: 12px; text-transform: uppercase; letter-spacing: 0.06em; }\n td { font-size: 14px; font-variant-numeric: tabular-nums; }\n code, pre { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }\n details { margin-top: 24px; }\n summary { cursor: pointer; font-weight: 700; }\n pre { overflow: auto; padding: 16px; background: #111827; color: #f9fafb; border-radius: var(--radius); }\n @media (max-width: 760px) {\n main { width: min(100% - 24px, 1120px); padding-top: 32px; }\n .metrics { grid-template-columns: repeat(2, minmax(0, 1fr)); }\n .section { padding: 18px; }\n }\n @media (max-width: 520px) {\n .metrics { grid-template-columns: 1fr; }\n .lede { font-size: 16px; }\n }\n </style>\n</head>\n<body>\n <main>\n <header>\n <p class=\"eyebrow\">Generated 2026-06-04</p>\n <h1>Q2 SEO Performance</h1>\n <p class=\"lede\">Organic traffic grew sharply, but the next gains depend on fixing thin page metadata and publishing three high-intent pillar pages.</p>\n </header>\n\n <section class=\"metrics\" aria-label=\"Key metrics\">\n <div class=\"metric\"><strong>18.6k</strong><span>Organic clicks</span></div>\n <div class=\"metric\"><strong>+50%</strong><span>Quarter over quarter</span></div>\n <div class=\"metric\"><strong>23</strong><span>Metadata fixes</span></div>\n <div class=\"metric\"><strong>3</strong><span>Priority pages</span></div>\n </section>\n\n <section class=\"section\">\n <h2>Summary</h2>\n <p>Start with the conclusion. Add tables only after the reader understands what changed and what to do next.</p>\n <div class=\"table-wrap\">\n <table>\n <thead><tr><th>Metric</th><th>Q1</th><th>Q2</th><th>Change</th></tr></thead>\n <tbody><tr><td>Organic clicks</td><td>12,400</td><td>18,600</td><td>+50%</td></tr></tbody>\n </table>\n </div>\n </section>\n\n <details>\n <summary>Raw evidence</summary>\n <pre>{ \"source\": \"search-console\", \"range\": \"2026-04-01/2026-06-30\" }</pre>\n </details>\n </main>\n</body>\n</html>\n"
47
+ "content": "<!doctype html>\n<!--\n Reference report page for the swarm design system (designVersion 2).\n\n Copy this as the starting point for a dense report or dashboard page, then\n replace the content. It uses only the swarm-* primitives, the theme tokens,\n and a few Tailwind layout utilities. It has zero color literals, so it\n follows the viewer's theme and dark mode inside the dashboard.\n\n Publish with:\n create_page({\n title: \"Q2 SEO Performance\",\n slug: \"q2-seo-performance\",\n description: \"Human-readable SEO performance report.\",\n contentType: \"text/html\",\n authMode: \"authed\",\n body: <this file's contents>,\n })\n-->\n<html lang=\"en\">\n<head>\n <meta charset=\"utf-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n <title>Q2 SEO Performance</title>\n</head>\n<body>\n <main class=\"swarm-page\">\n <header>\n <p class=\"swarm-eyebrow\">Search Console · Generated 2026-06-04</p>\n <h1>Q2 SEO Performance</h1>\n <p class=\"swarm-lede\">Organic clicks grew 50% this quarter. The next gains depend on fixing thin page metadata and on three high-intent pillar pages.</p>\n <span class=\"swarm-badge\" data-tone=\"success\" data-dot>On track</span>\n </header>\n\n <section class=\"swarm-metrics\" aria-label=\"Key metrics\">\n <div class=\"swarm-metric\">\n <div class=\"swarm-metric-value\">18.6k</div>\n <div class=\"swarm-metric-label\">Organic clicks</div>\n </div>\n <div class=\"swarm-metric\" data-tone=\"success\">\n <div class=\"swarm-metric-value\">+50%</div>\n <div class=\"swarm-metric-label\">Quarter over quarter</div>\n </div>\n <div class=\"swarm-metric\" data-tone=\"warning\">\n <div class=\"swarm-metric-value\">23</div>\n <div class=\"swarm-metric-label\">Metadata fixes</div>\n </div>\n <div class=\"swarm-metric\">\n <div class=\"swarm-metric-value\">3</div>\n <div class=\"swarm-metric-label\">Priority pages</div>\n </div>\n </section>\n\n <section class=\"swarm-section\" aria-labelledby=\"findings-heading\">\n <h2 id=\"findings-heading\">Findings</h2>\n <div class=\"swarm-callout\" data-tone=\"warning\">\n <strong>Thin metadata caps growth.</strong> 23 ranking pages share a generic title and description. Fix them before new content ships.\n </div>\n <div class=\"swarm-callout\">\n <strong>One post drives the growth.</strong> The agent swarms post brought about a quarter of the new clicks.\n </div>\n </section>\n\n <section class=\"swarm-section\" aria-labelledby=\"pages-heading\">\n <h2 id=\"pages-heading\">Top pages</h2>\n <div class=\"swarm-toolbar\">\n <input class=\"swarm-input\" id=\"page-filter\" type=\"search\" placeholder=\"Filter pages\" aria-label=\"Filter pages\">\n <div class=\"swarm-segmented\" role=\"group\" aria-label=\"Status\">\n <button type=\"button\" data-status-filter=\"all\" aria-pressed=\"true\">All</button>\n <button type=\"button\" data-status-filter=\"fix\" aria-pressed=\"false\">Needs fix</button>\n </div>\n <button class=\"swarm-button\" id=\"filter-reset\" type=\"button\">Reset</button>\n </div>\n <div class=\"swarm-table-wrap\">\n <table class=\"swarm-table\" id=\"pages-table\">\n <thead>\n <tr><th>Page</th><th>Status</th><th class=\"num\">Q1 clicks</th><th class=\"num\">Q2 clicks</th><th class=\"num\">Change</th></tr>\n </thead>\n <tbody>\n <tr data-status=\"ok\"><td class=\"nowrap\">/pricing</td><td><span class=\"swarm-badge\" data-tone=\"success\">Healthy</span></td><td class=\"num\">4,100</td><td class=\"num\">6,900</td><td class=\"num\">+68%</td></tr>\n <tr data-status=\"fix\"><td class=\"nowrap\">/docs/install</td><td><span class=\"swarm-badge\" data-tone=\"warning\">Thin title</span></td><td class=\"num\">3,200</td><td class=\"num\">3,350</td><td class=\"num\">+5%</td></tr>\n <tr data-status=\"ok\"><td class=\"nowrap\">/blog/agent-swarms</td><td><span class=\"swarm-badge\" data-tone=\"success\">Healthy</span></td><td class=\"num\">1,500</td><td class=\"num\">3,100</td><td class=\"num\">+107%</td></tr>\n <tr data-status=\"fix\"><td class=\"nowrap\">/integrations/slack</td><td><span class=\"swarm-badge\" data-tone=\"error\">No description</span></td><td class=\"num\">1,900</td><td class=\"num\">1,700</td><td class=\"num text-status-error-strong\">-11%</td></tr>\n <tr data-status=\"review\"><td class=\"nowrap\">/changelog</td><td><span class=\"swarm-badge\">Not reviewed</span></td><td class=\"num\">400</td><td class=\"num\">1,150</td><td class=\"num\">+188%</td></tr>\n </tbody>\n </table>\n </div>\n <p class=\"text-muted-foreground\" id=\"filter-empty\" hidden>No pages match the filter.</p>\n </section>\n\n <section class=\"swarm-section\" aria-labelledby=\"actions-heading\">\n <h2 id=\"actions-heading\">Next actions</h2>\n <div class=\"grid gap-4 md:grid-cols-2\">\n <article class=\"swarm-panel\">\n <h3>Fix thin metadata</h3>\n <dl class=\"swarm-kv\">\n <dt>Owner</dt><dd>Content team</dd>\n <dt>Pages</dt><dd>23</dd>\n <dt>Due</dt><dd>2026-07-15</dd>\n </dl>\n </article>\n <article class=\"swarm-panel\">\n <h3>Publish three pillar pages</h3>\n <dl class=\"swarm-kv\">\n <dt>Owner</dt><dd>Growth team</dd>\n <dt>Topics</dt><dd>Agent orchestration, task routing, swarm costs</dd>\n <dt>Due</dt><dd>2026-08-01</dd>\n </dl>\n </article>\n </div>\n <div class=\"mt-4\">\n <a class=\"swarm-button\" data-variant=\"primary\" href=\"https://search.google.com/search-console\">Open Search Console</a>\n </div>\n </section>\n\n <details>\n <summary>Raw evidence</summary>\n <pre>{ \"source\": \"search-console\", \"range\": \"2026-04-01/2026-06-30\" }</pre>\n </details>\n </main>\n\n <script>\n (() => {\n const filter = document.getElementById(\"page-filter\");\n const reset = document.getElementById(\"filter-reset\");\n const empty = document.getElementById(\"filter-empty\");\n const statusButtons = document.querySelectorAll(\"[data-status-filter]\");\n const rows = document.querySelectorAll(\"#pages-table tbody tr\");\n let status = \"all\";\n\n function applyFilter() {\n const query = filter.value.trim().toLowerCase();\n let shown = 0;\n for (const row of rows) {\n const visible =\n row.textContent.toLowerCase().includes(query) &&\n (status === \"all\" || row.dataset.status === status);\n row.style.display = visible ? \"\" : \"none\";\n if (visible) shown += 1;\n }\n empty.hidden = shown > 0;\n }\n\n function setStatus(next) {\n status = next;\n for (const button of statusButtons) {\n button.setAttribute(\"aria-pressed\", String(button.dataset.statusFilter === next));\n }\n applyFilter();\n }\n\n for (const button of statusButtons) {\n button.addEventListener(\"click\", () => setStatus(button.dataset.statusFilter));\n }\n filter.addEventListener(\"input\", applyFilter);\n reset.addEventListener(\"click\", () => {\n filter.value = \"\";\n setStatus(\"all\");\n });\n })();\n </script>\n</body>\n</html>\n"
48
48
  }
49
49
  ],
50
50
  "planning": [
@@ -12,6 +12,11 @@ import {
12
12
  import { envExportRestrictedError, isEnvExportRestrictedKey } from "../utils/config-env-export";
13
13
  import { validateEgressAllowlist } from "../utils/egress-guard";
14
14
  import { parseEnabledTools } from "../utils/enabled-tools";
15
+ import {
16
+ isFollowUpGateScheduleId,
17
+ parseFollowUpGateScheduleIds,
18
+ } from "../utils/follow-up-gate-schedule-ids";
19
+ import { kindForModelString } from "../utils/internal-ai/models";
15
20
  import { normalizeOrgWebsite } from "../utils/org-website";
16
21
  import { parseTaskToolManifest } from "../utils/task-tool-manifest";
17
22
  import { isTierConfigKey, validateTierConfigValue } from "./model-tier-keys";
@@ -61,6 +66,12 @@ const RESERVED_KEYS = new Set([
61
66
  "CORS_ALLOW_ANY_ORIGIN",
62
67
  "EXTENSION_ALLOW_LEAD_ACTIVATION",
63
68
  "CHAT_SDK_API_URL_OVERRIDES",
69
+ // Test knobs that redirect credential or telemetry traffic. Deployment env only: a
70
+ // config writer must not be able to point the Codex device login or the telemetry
71
+ // relay at a host of their choosing.
72
+ "CODEX_OAUTH_DEVICE_BASE_URL",
73
+ "DESPLEGA_TELEMETRY_ENDPOINT",
74
+ "CLOUDFLARE_API_BASE_URL",
64
75
  ]);
65
76
 
66
77
  // Config keys the API server owns for its own use and must NEVER hand out over
@@ -306,6 +317,24 @@ export function validateRuntimeTokenTtlHours(value: unknown): string | null {
306
317
  : "Invalid RUNTIME_TOKEN_TTL_HOURS (must be greater than zero and at most 168)";
307
318
  }
308
319
 
320
+ /**
321
+ * `TASK_AUTO_TITLE_MODEL` pins the task-title model: `provider/model-id` for a
322
+ * provider the internal-ai layer can call, or a bare `claude -p` alias. Empty
323
+ * clears the pin. The model id itself is checked at call time (an unknown id
324
+ * logs and falls through to the next candidate).
325
+ */
326
+ export function validateTaskAutoTitleModel(value: unknown): string | null {
327
+ if (typeof value !== "string") return "Invalid TASK_AUTO_TITLE_MODEL (must be a string)";
328
+ const model = value.trim();
329
+ if (!model) return null;
330
+ if (/\s/.test(model) || model.endsWith("/")) {
331
+ return "Invalid TASK_AUTO_TITLE_MODEL (use provider/model-id or a claude -p alias)";
332
+ }
333
+ return kindForModelString(model)
334
+ ? null
335
+ : "Invalid TASK_AUTO_TITLE_MODEL (provider must be openrouter, anthropic, openai, or openai-codex)";
336
+ }
337
+
309
338
  export const validateControllerTokenTtlDays = boundedIntegerValidators(
310
339
  ["RUNTIME_CONTROLLER_TOKEN_TTL_DAYS"],
311
340
  1,
@@ -428,6 +457,13 @@ const VALIDATED_KEYS: Record<string, ConfigValidator> = {
428
457
  // model's weekly window (Fable/Opus/Sonnet). fallback: legacy random pick.
429
458
  ...enumValidator("MODEL_WINDOW_EXHAUSTED_POLICY", ["fail", "fallback"]),
430
459
  ...enumValidator("HEARTBEAT_CHECKLIST_GATE_MODE", ["shadow", "enforce"]),
460
+ // `enforce` is deliberately absent: the follow-up gate only records decisions.
461
+ ...enumValidator("FOLLOW_UP_GATE_MODE", ["off", "shadow"]),
462
+ FOLLOW_UP_GATE_SCHEDULE_IDS: (value: unknown) => {
463
+ const message = "Invalid FOLLOW_UP_GATE_SCHEDULE_IDS (must be comma-separated schedule UUIDs)";
464
+ if (typeof value !== "string") return message;
465
+ return parseFollowUpGateScheduleIds(value).every(isFollowUpGateScheduleId) ? null : message;
466
+ },
431
467
  ...enumValidator("SYSTEM_ONE_DEFAULT_PROVIDER", [...SYSTEM_ONE_DEFAULT_PROVIDER_OPTIONS]),
432
468
  // Codex credits-exhausted cooldown (ms). Permissive on range here (positive
433
469
  // integer) — the worker clamps to [5m, 7d] via resolveCodexCreditsExhaustedCooldownMs.
@@ -525,7 +561,9 @@ const VALIDATED_KEYS: Record<string, ConfigValidator> = {
525
561
  "MODEL_AUTO_UPGRADE",
526
562
  "COMB_ENABLED",
527
563
  "AGENT_FS_PROXY",
564
+ "TASK_AUTO_TITLE_ENABLED",
528
565
  ]),
566
+ TASK_AUTO_TITLE_MODEL: validateTaskAutoTitleModel,
529
567
  ...enumValidator("SLACK_MODE", ["socket", "http"]),
530
568
  ...enumValidator("SLACK_THREAD_STEERING", ["off", "lead", "all"]),
531
569
  ...enumValidator("SLACK_THREAD_STEERING_MODE", ["steer", "queue"]),
@@ -536,6 +574,7 @@ const VALIDATED_KEYS: Record<string, ConfigValidator> = {
536
574
  "SLACK_REACTION_STEERED",
537
575
  "SLACK_REACTION_COMPLETED",
538
576
  "SLACK_REACTION_FAILED",
577
+ "SLACK_REACTION_SKIPPED",
539
578
  "SLACK_STATUS_ICON_COMPLETED",
540
579
  ]),
541
580
  // Counts, minutes, and intervals: positive integers. Deliberately permissive
@@ -0,0 +1,127 @@
1
+ /**
2
+ * Automatic task titles.
3
+ *
4
+ * Listens for `task.created` (emitted after commit by `createTaskExtended`),
5
+ * asks the cheapest configured model for a short title, and stores it on the
6
+ * task when nobody set one first. The sessions sidebar and task lists read
7
+ * `title` and fall back to the prompt, so a failed or skipped generation
8
+ * changes nothing visible.
9
+ *
10
+ * `TASK_AUTO_TITLE_ENABLED=false` turns the listener off at the next event;
11
+ * `TASK_AUTO_TITLE_MODEL` pins one model (see `buildTaskTitlePlan`).
12
+ */
13
+
14
+ import { getApiKey } from "../utils/api-key";
15
+ import { getMcpBaseUrl } from "../utils/constants";
16
+ import { parseEnvFlag } from "../utils/env-flag";
17
+ import { generateTaskTitle, TASK_TITLE_TIMEOUT_MS } from "../utils/internal-ai/task-title";
18
+ import { scrubSecrets } from "../utils/secret-scrubber";
19
+ import { workflowEventBus } from "../workflows/event-bus";
20
+ import { getTaskById } from "./db/tasks/read";
21
+ import { setTaskTitleIfUnset } from "./db/tasks/write";
22
+
23
+ /** Titles generated at once. Bursts (a workflow fan-out) queue behind this. */
24
+ export const TASK_AUTO_TITLE_CONCURRENCY = 3;
25
+
26
+ export function isTaskAutoTitleEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
27
+ return parseEnvFlag(env.TASK_AUTO_TITLE_ENABLED, true);
28
+ }
29
+
30
+ export interface TaskAutoTitleListenerOptions {
31
+ /** Defaults to `process.env`; read on every event so a config reload applies. */
32
+ env?: NodeJS.ProcessEnv;
33
+ /** Test injection: replaces the model call. */
34
+ generate?: typeof generateTaskTitle;
35
+ }
36
+
37
+ export interface TaskAutoTitleListener {
38
+ stop(): void;
39
+ /** Resolves once every queued task has been processed. */
40
+ idle(): Promise<void>;
41
+ }
42
+
43
+ export function startTaskAutoTitleListener(
44
+ options: TaskAutoTitleListenerOptions = {},
45
+ ): TaskAutoTitleListener {
46
+ const env = options.env ?? process.env;
47
+ const generate = options.generate ?? generateTaskTitle;
48
+ const queue: string[] = [];
49
+ let active = 0;
50
+ let idleWaiters: Array<() => void> = [];
51
+
52
+ const settleIdle = () => {
53
+ if (active > 0 || queue.length > 0) return;
54
+ const waiters = idleWaiters;
55
+ idleWaiters = [];
56
+ for (const resolve of waiters) resolve();
57
+ };
58
+
59
+ const pump = () => {
60
+ while (active < TASK_AUTO_TITLE_CONCURRENCY) {
61
+ const taskId = queue.shift();
62
+ if (!taskId) break;
63
+ active++;
64
+ void titleTask(taskId, env, generate)
65
+ .catch((error) => console.error("[task-title] Failed:", scrubSecrets(String(error))))
66
+ .finally(() => {
67
+ active--;
68
+ pump();
69
+ settleIdle();
70
+ });
71
+ }
72
+ };
73
+
74
+ const onTaskCreated = (data: unknown) => {
75
+ if (!isTaskAutoTitleEnabled(env)) return;
76
+ const taskId = (data as { taskId?: unknown }).taskId;
77
+ if (typeof taskId !== "string" || !taskId) return;
78
+ queue.push(taskId);
79
+ pump();
80
+ };
81
+
82
+ workflowEventBus.on("task.created", onTaskCreated);
83
+ return {
84
+ stop: () => workflowEventBus.off("task.created", onTaskCreated),
85
+ idle: () =>
86
+ new Promise<void>((resolve) => {
87
+ idleWaiters.push(resolve);
88
+ settleIdle();
89
+ }),
90
+ };
91
+ }
92
+
93
+ async function titleTask(
94
+ taskId: string,
95
+ env: NodeJS.ProcessEnv,
96
+ generate: typeof generateTaskTitle,
97
+ ): Promise<void> {
98
+ const task = await getTaskById(taskId);
99
+ if (!task || task.title) return;
100
+ const shortId = taskId.slice(0, 8);
101
+ const startedAt = Date.now();
102
+ const result = await generate({
103
+ task: task.task,
104
+ env,
105
+ // Loopback context for the codex OAuth probe; only used when no API key is set.
106
+ apiUrl: getMcpBaseUrl(),
107
+ apiKey: getApiKey(),
108
+ callerTag: `task-title:${task.source}`,
109
+ signal: AbortSignal.timeout(TASK_TITLE_TIMEOUT_MS),
110
+ });
111
+ if (!result.ok) {
112
+ if (result.reason !== "short-task") {
113
+ console.log(`[task-title] ${shortId}: no title (${result.reason})`);
114
+ }
115
+ return;
116
+ }
117
+ const updated = await setTaskTitleIfUnset(taskId, result.title);
118
+ const elapsed = Date.now() - startedAt;
119
+ // The title derives from task text, so a pasted token could reach the log.
120
+ console.log(
121
+ scrubSecrets(
122
+ `[task-title] ${shortId}: "${result.title}" via ${result.model} in ${elapsed}ms${
123
+ updated ? "" : " (kept the existing title)"
124
+ }`,
125
+ ),
126
+ );
127
+ }
package/src/be/users.ts CHANGED
@@ -213,15 +213,17 @@ function rowToEvent(row: IdentityEventRow): IdentityEvent {
213
213
  }
214
214
 
215
215
  /**
216
- * Paginated event timeline for a user. `limit` is hard-capped at 200; `before`
217
- * is a cursor on `createdAt` (ISO string) so the caller can keep paging by
218
- * passing back the last event's `createdAt`.
216
+ * Paginated event timeline for a user. `limit` is hard-capped at 200 and a
217
+ * limit of 0 returns no events (negatives clamp to 0); `before` is a cursor on
218
+ * `createdAt` (ISO string) so the caller can keep paging by passing back the
219
+ * last event's `createdAt`.
219
220
  */
220
221
  export async function listUserEvents(
221
222
  userId: string,
222
223
  opts: { limit?: number; before?: string } = {},
223
224
  ): Promise<IdentityEvent[]> {
224
- const limit = Math.max(1, Math.min(opts.limit ?? 50, 200));
225
+ const limit = Math.max(0, Math.min(opts.limit ?? 50, 200));
226
+ if (limit === 0) return [];
225
227
  const before = opts.before;
226
228
  const client = getDbClient();
227
229
  if (before) {
@@ -125,7 +125,7 @@ Usage:
125
125
 
126
126
  Options:
127
127
  --api-url <url> Swarm API URL (default: MCP_BASE_URL or http://localhost:3013)
128
- --api-key <key> Swarm API key (default: API_KEY or 123123)
128
+ --api-key <key> Swarm API key (default: AGENT_SWARM_API_KEY or API_KEY, falling back to 123123)
129
129
  --force Recreate agent + environment even if already configured
130
130
  -h, --help Show this help
131
131
 
@@ -2,4 +2,4 @@
2
2
  * agent-fs image tag bundled by `agent-swarm onboard --yes`.
3
3
  * `bun run bump:agent-fs` rewrites it together with the other pins.
4
4
  */
5
- export const AGENT_FS_VERSION = "0.18.13";
5
+ export const AGENT_FS_VERSION = "0.18.14";