@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
@@ -446,11 +446,12 @@ export const AppElementsSchema = z.record(AppNameSchema, AppElementSchema);
446
446
 
447
447
  /**
448
448
  * Preset theme id applied to the app's rendered surface. The catalog of
449
- * presets lives in the dashboard (`apps/ui/src/lib/themes.ts`) — the server
450
- * validates shape only, and the renderer resolves unknown ids to its default
451
- * theme, so definitions stay portable across dashboard versions whose preset
452
- * catalogs differ. Viewers can override it per-user via the reserved
453
- * `$theme` user-config key (see `user-config.ts`).
449
+ * presets lives in `src/themes/presets.ts` (the dashboard re-exports it from
450
+ * `apps/ui/src/lib/themes.ts`). App definitions are validated by shape only,
451
+ * and the renderer resolves unknown ids to its default theme, so definitions
452
+ * stay portable across dashboard versions whose preset catalogs differ.
453
+ * Viewers can override it per-user via the reserved `$theme` user-config key
454
+ * (see `user-config.ts`).
454
455
  */
455
456
  export const AppThemeIdSchema = z.string().regex(/^[a-z][a-z0-9-]{0,39}$/, {
456
457
  message: "must be a lowercase slug (letters, digits, dashes)",
@@ -156,7 +156,7 @@ export async function updateModelProfile(
156
156
  * oldest `finishedAt` the repair still covers.
157
157
  */
158
158
  const TASK_HOLDS_PROFILE_SQL = `(
159
- t.status NOT IN ('completed', 'failed', 'cancelled', 'superseded')
159
+ t.status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped')
160
160
  OR (t.status = 'superseded'
161
161
  AND t.workflowRunStepId IS NULL
162
162
  AND (t.finishedAt IS NULL OR t.finishedAt > ?)
@@ -0,0 +1,12 @@
1
+ import { type Page, PageThemeTokensSchema } from "../../types";
2
+
3
+ /** Stored `theme_tokens` JSON, or null when the column is empty, is not JSON, or has the wrong shape. */
4
+ export function parsePageThemeTokens(raw: string | null): Page["themeTokens"] {
5
+ if (!raw) return null;
6
+ try {
7
+ const parsed = PageThemeTokensSchema.safeParse(JSON.parse(raw));
8
+ return parsed.success ? parsed.data : null;
9
+ } catch {
10
+ return null;
11
+ }
12
+ }
@@ -305,7 +305,7 @@ export function sessionRootFilter(opts: SessionFilters = {}): SqlFragment {
305
305
  add(sessionViewerCondition(opts.viewer));
306
306
  // Unary +: a full pass over the narrow summaries beats the partial thread index here.
307
307
  if (opts.tree) conditions.push("+r.requestedByUserId IS NOT NULL");
308
- if (opts.mine) add(sessionMineCondition(opts.viewer.userId));
308
+ if (opts.mine) add(sessionMineCondition(opts.viewer.userId, opts.viewer.readAll));
309
309
  }
310
310
  if (opts.keyPrefix) {
311
311
  const { lo, hi } = keyPrefixRange(opts.keyPrefix);
@@ -504,8 +504,9 @@ export async function getSessionReadState(
504
504
  rootId: string,
505
505
  userId: string,
506
506
  now?: string,
507
+ readAll?: boolean,
507
508
  ): Promise<{ readState: SessionReadState; lastActivityAt: string } | null> {
508
- const query = sessionSummaryQuery({ rootId, viewer: { userId, scope: "all" }, now });
509
+ const query = sessionSummaryQuery({ rootId, viewer: { userId, scope: "all", readAll }, now });
509
510
  const row = await getDbClient().get<{ readState: SessionReadState; lastActivityAt: string }>(
510
511
  `SELECT readState, lastActivityAt FROM (${query.sql})`,
511
512
  query.params,
@@ -662,14 +663,16 @@ function threadPromptPreview(prompt: string): string {
662
663
  }
663
664
 
664
665
  export async function getSessionTree(
665
- actor: { kind: "bypass" } | { kind: "user"; userId: string | null },
666
+ actor: { kind: "bypass" } | { kind: "user"; userId: string | null; readAll?: boolean },
666
667
  now?: string,
667
668
  opts: { mine?: boolean; hideSource?: string[]; showSource?: string[] } = {},
668
669
  ): Promise<SessionTree> {
669
670
  // No source filter in SQL: the source counts must include hidden sources,
670
671
  // so the filter menu can offer them back. The loop skips them instead.
671
672
  const query = sessionSummaryQuery({
672
- ...(actor.kind === "user" ? { viewer: { userId: actor.userId, scope: "all" } as const } : {}),
673
+ ...(actor.kind === "user"
674
+ ? { viewer: { userId: actor.userId, scope: "all", readAll: actor.readAll } as const }
675
+ : {}),
673
676
  now,
674
677
  tree: true,
675
678
  mine: opts.mine,
@@ -795,12 +798,13 @@ export async function triageSessionList(
795
798
  "triage" | "noGroup" | "groupKey" | "mine" | "hideSource" | "showSource" | "now"
796
799
  >,
797
800
  action: SessionListTriage,
801
+ readAll?: boolean,
798
802
  ): Promise<number> {
799
803
  const now = filters.now ?? new Date().toISOString();
800
804
  const query = sessionSummaryQuery({
801
805
  ...filters,
802
806
  now,
803
- viewer: { userId, scope: "all" },
807
+ viewer: { userId, scope: "all", readAll },
804
808
  tree: true,
805
809
  });
806
810
  const status = action === "done" ? "done" : "open";
@@ -5,8 +5,13 @@
5
5
  * or everyone.
6
6
  * `mine`: owned by the viewer. `shared`: owned by someone else and shared with
7
7
  * the viewer or everyone. A null `userId` (a guest page session) owns nothing.
8
+ * `readAll` (the all-users read scope) lifts the `all` filter: every root.
8
9
  */
9
- export type SessionViewer = { userId: string | null; scope: "all" | "mine" | "shared" };
10
+ export type SessionViewer = {
11
+ userId: string | null;
12
+ scope: "all" | "mine" | "shared";
13
+ readAll?: boolean;
14
+ };
10
15
 
11
16
  /** SQL condition + params restricting root tasks (alias `r`) to what `viewer` may open. */
12
17
  export function sessionViewerCondition(viewer: SessionViewer): {
@@ -16,6 +21,7 @@ export function sessionViewerCondition(viewer: SessionViewer): {
16
21
  // Uncorrelated, so SQLite builds the shared set once instead of probing per root.
17
22
  const shared = `r.id IN (SELECT s.rootTaskId FROM session_shares s
18
23
  WHERE s.revokedAt IS NULL AND (s.userId IS NULL OR s.userId = ?))`;
24
+ if (viewer.scope === "all" && viewer.readAll) return { sql: "1", params: [] };
19
25
  if (viewer.scope === "mine") {
20
26
  return { sql: "r.requestedByUserId = ?", params: [viewer.userId] };
21
27
  }
@@ -47,17 +53,27 @@ const HUMAN_SYSTEM_TASK_TYPES = ["kapso-inbound"] as const;
47
53
  * sessions shared with this user or everyone. A list filter only: it narrows
48
54
  * what a list shows and never changes who can open a session.
49
55
  */
50
- export function sessionMineCondition(userId: string | null): {
56
+ export function sessionMineCondition(
57
+ userId: string | null,
58
+ readAll?: boolean,
59
+ ): {
51
60
  sql: string;
52
61
  params: (string | null)[];
53
62
  } {
54
63
  const machine = MACHINE_SESSION_SOURCES.map(() => "?").join(",");
55
64
  const humanSystem = HUMAN_SYSTEM_TASK_TYPES.map(() => "?").join(",");
56
- return {
57
- sql: `((r.requestedByUserId = ? AND (r.source NOT IN (${machine})
58
- OR (r.source = 'system' AND r.taskType IN (${humanSystem}))))
59
- OR r.id IN (SELECT s.rootTaskId FROM session_shares s
60
- WHERE s.revokedAt IS NULL AND (s.userId IS NULL OR s.userId = ?)))`,
61
- params: [userId, ...MACHINE_SESSION_SOURCES, ...HUMAN_SYSTEM_TASK_TYPES, userId],
62
- };
65
+ const humanStarted = `(r.source NOT IN (${machine})
66
+ OR (r.source = 'system' AND r.taskType IN (${humanSystem})))`;
67
+ const humanParams = [...MACHINE_SESSION_SOURCES, ...HUMAN_SYSTEM_TASK_TYPES];
68
+ const shared = `r.id IN (SELECT s.rootTaskId FROM session_shares s
69
+ WHERE s.revokedAt IS NULL AND (s.userId IS NULL OR s.userId = ?))`;
70
+ // The all-users read scope widens the owner check to every user's
71
+ // human-started roots. Sessions shared with the viewer stay in Mine, so a
72
+ // shared machine-started root never drops out when the scope turns on.
73
+ return readAll
74
+ ? { sql: `(${humanStarted} OR ${shared})`, params: [...humanParams, userId] }
75
+ : {
76
+ sql: `((r.requestedByUserId = ? AND ${humanStarted}) OR ${shared})`,
77
+ params: [userId, ...humanParams, userId],
78
+ };
63
79
  }
@@ -20,6 +20,7 @@ import {
20
20
  RoutingAffinitySchema,
21
21
  TERMINAL_TASK_STATUSES,
22
22
  } from "../../../types";
23
+ import { normalizeOutputSchema } from "../../../utils/output-schema";
23
24
  import { parseProviderMeta } from "../../../utils/provider-metadata";
24
25
  import { scrubSecrets } from "../../../utils/secret-scrubber";
25
26
  import { getAgentById } from "../agents";
@@ -359,7 +360,11 @@ export function rowToAgentTask(row: AgentTaskRow): AgentTask {
359
360
  scheduleId: row.scheduleId ?? undefined,
360
361
  workflowRunId: row.workflowRunId ?? undefined,
361
362
  workflowRunStepId: row.workflowRunStepId ?? undefined,
362
- outputSchema: row.outputSchema ? JSON.parse(row.outputSchema) : undefined,
363
+ // A stored '{}' (legacy rows, defer-task resumes that copied it) means no
364
+ // schema: expose it as absent so no harness or validator treats it as one.
365
+ outputSchema: row.outputSchema
366
+ ? normalizeOutputSchema(JSON.parse(row.outputSchema))
367
+ : undefined,
363
368
  followUpConfig,
364
369
  contextKey: row.contextKey ?? undefined,
365
370
  compactionCount: row.compactionCount ?? undefined,
@@ -595,7 +600,7 @@ export async function hasNonTerminalResumeChild(parentId: string): Promise<boole
595
600
  `SELECT 1 FROM agent_tasks
596
601
  WHERE parentTaskId = ?
597
602
  AND taskType = 'resume'
598
- AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded')
603
+ AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped')
599
604
  LIMIT 1`,
600
605
  [parentId],
601
606
  );
@@ -691,7 +696,7 @@ export async function hasNonTerminalRerouteDecisionChild(parentId: string): Prom
691
696
  `SELECT 1 FROM agent_tasks
692
697
  WHERE parentTaskId = ?
693
698
  AND taskType = 'reroute-decision'
694
- AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded')
699
+ AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped')
695
700
  LIMIT 1`,
696
701
  [parentId],
697
702
  );
@@ -759,7 +764,7 @@ export async function findTaskByVcs(
759
764
  const row = await getDbClient().get<AgentTaskRow>(
760
765
  `SELECT * FROM agent_tasks
761
766
  WHERE vcsRepo = ? AND vcsNumber = ? AND ${providerClause}
762
- AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded')
767
+ AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped')
763
768
  ORDER BY createdAt DESC
764
769
  LIMIT 1`,
765
770
  [vcsRepo, vcsNumber, vcsProvider],
@@ -782,7 +787,7 @@ export async function findActiveTasksByVcs(
782
787
  const rows = await getDbClient().query<AgentTaskRow>(
783
788
  `SELECT * FROM agent_tasks
784
789
  WHERE vcsRepo = ? AND vcsNumber = ? AND ${providerClause}
785
- AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded')
790
+ AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped')
786
791
  ORDER BY createdAt DESC`,
787
792
  [vcsRepo, vcsNumber, vcsProvider],
788
793
  );
@@ -1023,6 +1028,14 @@ export async function getAllTasks(
1023
1028
  params.push(filters.requestedByUserId);
1024
1029
  }
1025
1030
 
1031
+ // Without selective filters, tiny LIMITs can make SQLite choose a full
1032
+ // scan and sort when ANALYZE statistics are absent. Keep filtered pages
1033
+ // planner-controlled so they can use their selective indexes.
1034
+ const pageIndex =
1035
+ conditions.length === 0 && !filters?.readableBy && filters?.orderBy !== "createdAt"
1036
+ ? "INDEXED BY idx_agent_tasks_last_updated"
1037
+ : "";
1038
+
1026
1039
  // Exclude system/heartbeat tasks by default. The flag is still called
1027
1040
  // `includeHeartbeat` for backward compat with existing API callers, but we
1028
1041
  // also gate boot-triage + heartbeat-checklist behind it since those are
@@ -1056,7 +1069,7 @@ export async function getAllTasks(
1056
1069
  // lastUpdatedAt index for a full scan. The outer sort adds it only to fix
1057
1070
  // the order of exact ties inside the page.
1058
1071
  const query = `WITH page AS (
1059
- SELECT rowid AS rid FROM agent_tasks ${whereClause}
1072
+ SELECT rowid AS rid FROM agent_tasks ${pageIndex} ${whereClause}
1060
1073
  ORDER BY ${orderColumns.join(", ")} LIMIT ${limit} OFFSET ${offset}
1061
1074
  )
1062
1075
  SELECT ${LIST_COLUMNS[fields]},
@@ -1675,7 +1688,7 @@ export async function findExistingLinearTrackerContextWork(
1675
1688
  SELECT * FROM agent_tasks
1676
1689
  WHERE contextKey = ?
1677
1690
  AND id NOT IN (SELECT id FROM lineage)
1678
- AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded')
1691
+ AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped')
1679
1692
  ORDER BY lastUpdatedAt DESC
1680
1693
  LIMIT 1`,
1681
1694
  [...lineageParams, contextKey],
@@ -290,7 +290,7 @@ export async function startTask(taskId: string): Promise<AgentTask | null> {
290
290
 
291
291
  const row = await getDbClient().get<AgentTaskRow>(
292
292
  `UPDATE agent_tasks SET status = 'in_progress', lastUpdatedAt = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
293
- WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded') RETURNING *`,
293
+ WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped') RETURNING *`,
294
294
  [taskId],
295
295
  );
296
296
  if (row && oldTask) {
@@ -394,6 +394,25 @@ export async function updateTaskTitle(
394
394
  return row ? rowToAgentTask(row) : null;
395
395
  }
396
396
 
397
+ /**
398
+ * Sets a generated display title only while the task has none. A rename that
399
+ * landed first (a person, or another API replica) wins: the row is left alone
400
+ * and `null` comes back. Like `updateTaskTitle`, it does not bump
401
+ * `lastUpdatedAt`.
402
+ */
403
+ export async function setTaskTitleIfUnset(
404
+ taskId: string,
405
+ title: string,
406
+ ): Promise<AgentTask | null> {
407
+ const normalized = title.trim();
408
+ if (!normalized) return null;
409
+ const row = await getDbClient().get<AgentTaskRow>(
410
+ "UPDATE agent_tasks SET title = ? WHERE id = ? AND title IS NULL RETURNING *",
411
+ [normalized, taskId],
412
+ );
413
+ return row ? rowToAgentTask(row) : null;
414
+ }
415
+
397
416
  export async function completeTask(
398
417
  id: string,
399
418
  output?: string,
@@ -418,7 +437,7 @@ export async function completeTask(
418
437
  // terminal transition (e.g. heartbeat failTask) land first.
419
438
  let completed = await getDbClient().get<AgentTaskRow>(
420
439
  `UPDATE agent_tasks SET status = ?, finishedAt = ?, lastUpdatedAt = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
421
- WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded') RETURNING *`,
440
+ WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped') RETURNING *`,
422
441
  ["completed", finishedAt, id],
423
442
  );
424
443
  if (!completed) return null;
@@ -550,7 +569,7 @@ export async function failTask(
550
569
  // terminal transition can land during the await above).
551
570
  const row = await getDbClient().get<AgentTaskRow>(
552
571
  `UPDATE agent_tasks SET status = 'failed', failureReason = ?, finishedAt = ?, lastUpdatedAt = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
553
- WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded')
572
+ WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped')
554
573
  AND (? IS NULL OR lastUpdatedAt = ?) RETURNING *`,
555
574
  [
556
575
  scrubbedReason,
@@ -647,7 +666,7 @@ export async function overwriteTerminalTaskResultText(
647
666
  const updated =
648
667
  (await getDbClient().get<AgentTaskRow>(
649
668
  `UPDATE agent_tasks SET output = ?, failureReason = ?
650
- WHERE id = ? AND status IN ('completed', 'failed', 'cancelled', 'superseded')
669
+ WHERE id = ? AND status IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped')
651
670
  RETURNING *`,
652
671
  [output, failureReason, id],
653
672
  )) ?? null;
@@ -686,7 +705,7 @@ export async function cancelTask(
686
705
  // terminal transition can land during the await above).
687
706
  const row = await getDbClient().get<AgentTaskRow>(
688
707
  `UPDATE agent_tasks SET status = 'cancelled', failureReason = ?, finishedAt = ?, lastUpdatedAt = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
689
- WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded') RETURNING *`,
708
+ WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped') RETURNING *`,
690
709
  [cancelReason, finishedAt, id],
691
710
  );
692
711
 
@@ -781,6 +800,76 @@ export async function cancelTask(
781
800
  return row ? rowToAgentTask(row) : null;
782
801
  }
783
802
 
803
+ /**
804
+ * Skip a task: the agent decided the work is not its to handle (for example a
805
+ * Slack thread message addressed to someone else). `skipped` is terminal. The
806
+ * one-line reason lands in `failureReason`, like a cancel's, so `output` stays
807
+ * empty and nothing that publishes a task's output has text to post.
808
+ *
809
+ * Unlike `cancelTask` it does not cascade-fail dependents: a skipped
810
+ * dependency satisfies `dependsOn` (see `checkDependencies`). It emits
811
+ * `task.skipped`, which defer-task waits and workflow resume listen for; the
812
+ * Slack, chat, Jira and Linear outbound paths do not, so a skip notifies no one.
813
+ */
814
+ export async function skipTask(id: string, reason: string): Promise<AgentTask | null> {
815
+ const oldTask = await getTaskById(id);
816
+ if (!oldTask) return null;
817
+ if (isTerminalTaskStatus(oldTask.status)) return null;
818
+
819
+ const finishedAt = new Date().toISOString();
820
+ const skipReason = scrubSecrets(reason);
821
+ // Status predicate re-checks the idempotency guard atomically (a racing
822
+ // terminal transition can land during the await above).
823
+ const row = await getDbClient().get<AgentTaskRow>(
824
+ `UPDATE agent_tasks SET status = 'skipped', failureReason = ?, finishedAt = ?, lastUpdatedAt = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
825
+ WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped') RETURNING *`,
826
+ [skipReason, finishedAt, id],
827
+ );
828
+ if (!row) return null;
829
+
830
+ try {
831
+ await dependencies.createLogEntry({
832
+ eventType: "task_status_change",
833
+ taskId: id,
834
+ agentId: row.agentId ?? undefined,
835
+ oldValue: oldTask.status,
836
+ newValue: "skipped",
837
+ metadata: { reason: skipReason },
838
+ });
839
+ } catch {}
840
+ getDbClient().afterCommit(() => {
841
+ import("../../../workflows/event-bus")
842
+ .then(({ workflowEventBus }) => {
843
+ workflowEventBus.emit("task.skipped", {
844
+ taskId: id,
845
+ failureReason: skipReason,
846
+ agentId: row.agentId,
847
+ workflowRunId: row.workflowRunId,
848
+ workflowRunStepId: row.workflowRunStepId,
849
+ });
850
+ })
851
+ .catch((err) =>
852
+ console.error(
853
+ "[db] task.skipped event not emitted:",
854
+ scrubSecrets(err instanceof Error ? err.message : String(err)),
855
+ ),
856
+ );
857
+ });
858
+ try {
859
+ await dependencies.promotePendingSteeringForTask(
860
+ id,
861
+ "Task was skipped before steering was delivered",
862
+ );
863
+ } catch (error) {
864
+ console.error(
865
+ "[skipTask] pending steering promotion error:",
866
+ scrubSecrets(error instanceof Error ? error.message : String(error)),
867
+ );
868
+ }
869
+
870
+ return rowToAgentTask(row);
871
+ }
872
+
784
873
  /**
785
874
  * Supersede a task: mark it as `superseded` (terminal) so a fresh "resume"
786
875
  * follow-up task can pick up where it left off. Used by the graceful-shutdown
@@ -815,7 +904,7 @@ export async function supersedeTask(
815
904
  SET status = 'superseded',
816
905
  finishedAt = ?,
817
906
  lastUpdatedAt = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
818
- WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded')
907
+ WHERE id = ? AND status NOT IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped')
819
908
  AND (? IS NULL OR lastUpdatedAt = ?)
820
909
  RETURNING *`,
821
910
  [finishedAt, id, args.expectedLastUpdatedAt ?? null, args.expectedLastUpdatedAt ?? null],
@@ -1170,7 +1259,7 @@ export async function updateTaskProgress(id: string, progress: string): Promise<
1170
1259
  const scrubbedProgress = scrubSecrets(progress);
1171
1260
  const row = await getDbClient().get<AgentTaskRow>(
1172
1261
  `UPDATE agent_tasks SET progress = ?,
1173
- status = CASE WHEN status IN ('completed', 'failed', 'cancelled', 'superseded') THEN status ELSE 'in_progress' END,
1262
+ status = CASE WHEN status IN ('completed', 'failed', 'cancelled', 'superseded', 'skipped') THEN status ELSE 'in_progress' END,
1174
1263
  lastUpdatedAt = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
1175
1264
  WHERE id = ? RETURNING *`,
1176
1265
  [scrubbedProgress, id],
@@ -177,6 +177,11 @@ export type BusyRetryOptions = {
177
177
  * Defaults to `DEFAULT_FINAL_ATTEMPT_SPIN_MS`.
178
178
  */
179
179
  finalAttemptSpinMs?: number;
180
+ /**
181
+ * Longest gap between spinning probes while an external holder is
182
+ * detected (see `BusyGate`). Defaults to `DEFAULT_MAX_GATE_MS`.
183
+ */
184
+ maxGateMs?: number;
180
185
  };
181
186
 
182
187
  /**
@@ -247,8 +252,81 @@ function isSqliteBusy(err: unknown): boolean {
247
252
  return typeof code === "string" && code.startsWith("SQLITE_BUSY");
248
253
  }
249
254
 
255
+ /** Ceiling on the gap between spinning probes while a holder is detected. */
256
+ const DEFAULT_MAX_GATE_MS = 1_000;
257
+ /** A quiet stretch this long ends a BUSY episode even without a proven write. */
258
+ const GATE_DECAY_MS = 5_000;
259
+
260
+ /**
261
+ * Process-wide memory of a cross-process write-lock holder.
262
+ *
263
+ * Every retrying writer used to spin `attemptSpinMs` (100ms, or 250ms for the
264
+ * last attempt) SYNCHRONOUSLY inside the FIFO lock on every attempt. With N
265
+ * writers queued behind a holder that lasts minutes, one round of attempts
266
+ * costs N x 100ms of blocked event loop, and each attempt waits for that
267
+ * whole round before its own turn. A 5-minute Litestream snapshot turned
268
+ * the nominal 11s retry budget into 90-105s request hangs, 3s /health and
269
+ * 3s page loads, although only writes were contending.
270
+ *
271
+ * The gate records a BUSY seen by a spinning probe. For the next interval
272
+ * (doubling from `attemptSpinMs` up to `maxGateMs`) every attempt runs with
273
+ * a ZERO busy_timeout: it still tries, so recovery is immediate, but it
274
+ * fails in microseconds instead of blocking the loop, and the async backoff
275
+ * sleeps do the waiting. Once the interval lapses, the next attempt is the
276
+ * lone spinning probe again.
277
+ */
278
+ class BusyGate {
279
+ private openUntil = 0;
280
+ private streak = 0;
281
+ private lastBusyAt = 0;
282
+ private episodeStartedAt = 0;
283
+ private episodeProbes = 0;
284
+
285
+ constructor(
286
+ private readonly baseMs: number,
287
+ private readonly maxMs: number,
288
+ ) {}
289
+
290
+ /** True while attempts must not spin. */
291
+ isOpen(now = performance.now()): boolean {
292
+ return now < this.openUntil;
293
+ }
294
+
295
+ /** A spinning probe hit BUSY: a holder exists. Open the gate and widen it. */
296
+ recordBusy(now = performance.now()): void {
297
+ if (this.streak > 0 && now - this.lastBusyAt > GATE_DECAY_MS) this.endEpisode(now, "decayed");
298
+ if (this.streak === 0) {
299
+ this.episodeStartedAt = now;
300
+ this.episodeProbes = 0;
301
+ console.warn(
302
+ "[db-client] SQLITE_BUSY: another process holds the write lock; spinning at most one probe per gate interval until it releases",
303
+ );
304
+ }
305
+ this.streak += 1;
306
+ this.episodeProbes += 1;
307
+ this.lastBusyAt = now;
308
+ const interval = Math.min(this.maxMs, this.baseMs * 2 ** Math.min(this.streak - 1, 20));
309
+ this.openUntil = now + interval;
310
+ }
311
+
312
+ /** A write got through after BUSY: the holder is gone. */
313
+ recordRecovered(now = performance.now()): void {
314
+ if (this.streak === 0) return;
315
+ this.endEpisode(now, "released");
316
+ }
317
+
318
+ private endEpisode(now: number, how: "released" | "decayed"): void {
319
+ console.warn(
320
+ `[db-client] write lock ${how} after ${Math.round(now - this.episodeStartedAt)}ms (${this.episodeProbes} spinning probes)`,
321
+ );
322
+ this.streak = 0;
323
+ this.openUntil = 0;
324
+ }
325
+ }
326
+
250
327
  class BunSqliteClient implements DbClient {
251
328
  private readonly lock = new FifoLock();
329
+ private readonly gate: BusyGate;
252
330
  private savepointSeq = 0;
253
331
  /** Lazily captured ambient busy_timeout, restored after each short-spin attempt. */
254
332
  private restoreBusyTimeoutMs: number | null = null;
@@ -256,7 +334,12 @@ class BunSqliteClient implements DbClient {
256
334
  constructor(
257
335
  private readonly getDatabase: () => Database,
258
336
  private readonly busyRetry: BusyRetryOptions = DEFAULT_BUSY_RETRY,
259
- ) {}
337
+ ) {
338
+ this.gate = new BusyGate(
339
+ busyRetry.attemptSpinMs,
340
+ Math.max(busyRetry.attemptSpinMs, busyRetry.maxGateMs ?? DEFAULT_MAX_GATE_MS),
341
+ );
342
+ }
260
343
 
261
344
  query<T>(sql: string, params: DbParam[] = []): Promise<T[]> {
262
345
  return this.execute(sql, (db) => db.query<T, DbParam[]>(sql).all(...params));
@@ -352,6 +435,7 @@ class BunSqliteClient implements DbClient {
352
435
  // not. The short spin keeps the driver's synchronous busy wait off
353
436
  // the event loop; the real waiting is the caller's async backoff.
354
437
  this.shortSpin(db, () => db.run("BEGIN IMMEDIATE"), finalAttempt);
438
+ this.gate.recordRecovered();
355
439
  } catch (err) {
356
440
  if (isSqliteBusy(err)) return { ok: false, busyBegin: err };
357
441
  throw err;
@@ -366,7 +450,7 @@ class BunSqliteClient implements DbClient {
366
450
  // is exact. The open transaction pins the connection, so these
367
451
  // retries hold the FIFO lock and their sleeps block queued work;
368
452
  // WAL-mode COMMIT BUSY is rare enough for that to be acceptable.
369
- await this.retryHoldingLock(() => this.shortSpin(db, () => db.run("COMMIT")));
453
+ await this.retryHoldingLock(() => this.shortSpin(db, () => db.run("COMMIT"), false, false));
370
454
  }
371
455
  for (const hook of ctx.afterCommit) this.scheduleHook(hook);
372
456
  return { ok: true, value: result };
@@ -478,6 +562,7 @@ class BunSqliteClient implements DbClient {
478
562
  return timed(() => op(db));
479
563
  }
480
564
  let sleptMs = 0;
565
+ let sawBusy = false;
481
566
  for (let attemptIndex = 0; ; attemptIndex++) {
482
567
  const next = this.busyRetry.backoffMs[attemptIndex];
483
568
  const canRetryAfter = next !== undefined && sleptMs + next <= this.busyRetry.maxWaitMs;
@@ -488,9 +573,14 @@ class BunSqliteClient implements DbClient {
488
573
  // exact. The final attempt spins `finalAttemptSpinMs` (see
489
574
  // transaction()).
490
575
  const db = this.getDatabase();
491
- return timed(() => this.shortSpin(db, () => op(db), !canRetryAfter), canRetryAfter);
576
+ const result = timed(() => this.shortSpin(db, () => op(db), !canRetryAfter), canRetryAfter);
577
+ // A statement that was BUSY earlier in this call and now landed is a
578
+ // write that got through: the external holder is gone.
579
+ if (sawBusy) this.gate.recordRecovered();
580
+ return result;
492
581
  } catch (err) {
493
582
  if (!isSqliteBusy(err) || !canRetryAfter || next === undefined) throw err;
583
+ sawBusy = true;
494
584
  backoff = next;
495
585
  sleptMs += next;
496
586
  } finally {
@@ -509,17 +599,27 @@ class BunSqliteClient implements DbClient {
509
599
  * lock is held, so the set/attempt/restore sequence cannot interleave with
510
600
  * other client work.
511
601
  */
512
- private shortSpin<T>(db: Database, attempt: () => T, finalAttempt = false): T {
602
+ private shortSpin<T>(db: Database, attempt: () => T, finalAttempt = false, gateable = true): T {
513
603
  if (this.restoreBusyTimeoutMs === null) {
514
604
  const row = db.query<{ timeout: number }, []>("PRAGMA busy_timeout").get();
515
605
  this.restoreBusyTimeoutMs = row?.timeout ?? 5000;
516
606
  }
517
- const spinMs = finalAttempt
518
- ? (this.busyRetry.finalAttemptSpinMs ?? DEFAULT_FINAL_ATTEMPT_SPIN_MS)
519
- : this.busyRetry.attemptSpinMs;
607
+ // While a holder is known (BusyGate) the attempt runs without a spin: it
608
+ // still tries, so a released lock is taken at once, but a held one costs
609
+ // microseconds of event loop instead of a full spin per queued writer.
610
+ // Only the spinning probe that follows a lapsed gate reports BUSY back.
611
+ const gated = gateable && this.gate.isOpen();
612
+ const spinMs = gated
613
+ ? 0
614
+ : finalAttempt
615
+ ? (this.busyRetry.finalAttemptSpinMs ?? DEFAULT_FINAL_ATTEMPT_SPIN_MS)
616
+ : this.busyRetry.attemptSpinMs;
520
617
  db.exec(`PRAGMA busy_timeout = ${spinMs}`);
521
618
  try {
522
619
  return attempt();
620
+ } catch (err) {
621
+ if (gateable && !gated && isSqliteBusy(err)) this.gate.recordBusy();
622
+ throw err;
523
623
  } finally {
524
624
  db.exec(`PRAGMA busy_timeout = ${this.restoreBusyTimeoutMs}`);
525
625
  }
@@ -220,8 +220,10 @@ export async function updateTrackerSync(
220
220
  await getDbClient().run(`UPDATE tracker_sync SET ${sets.join(", ")} WHERE id = ?`, values);
221
221
  }
222
222
 
223
- export async function deleteTrackerSync(id: string): Promise<void> {
224
- await getDbClient().run("DELETE FROM tracker_sync WHERE id = ?", [id]);
223
+ /** Whether a mapping with `id` existed and was removed. */
224
+ export async function deleteTrackerSync(id: string): Promise<boolean> {
225
+ const result = await getDbClient().run("DELETE FROM tracker_sync WHERE id = ?", [id]);
226
+ return result.changes > 0;
225
227
  }
226
228
 
227
229
  /**