@desplega.ai/agent-swarm 2.12.0 → 2.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (327) hide show
  1. package/dist/acp-adapter-cn53011z.js +17 -0
  2. package/dist/{acp-targets-311gcyvw.js → acp-targets-86f0sh6g.js} +9 -8
  3. package/dist/{actions-c4chgxp6.js → actions-zv8vcxvr.js} +24 -23
  4. package/dist/{agent-fs-provision-0b9awm5n.js → agent-fs-provision-jqshb33y.js} +4 -4
  5. package/dist/{amp-adapter-r0veq6x5.js → amp-adapter-gt503ywc.js} +2 -2
  6. package/dist/{app-hn5fftf5.js → app-6t4k5rh1.js} +6 -4
  7. package/dist/{approval-notifications-3g6yc8nv.js → approval-notifications-fcfw063h.js} +7 -6
  8. package/dist/{assistant-cpjgpjvp.js → assistant-9dzybh12.js} +25 -24
  9. package/dist/{boot-args-schema-hce1av1h.js → boot-args-schema-xzfp2feg.js} +1 -1
  10. package/dist/{boot-reembed-d7xcym0j.js → boot-reembed-3jz0p2jk.js} +1 -1
  11. package/dist/{boot-reembed-bztbxc4z.js → boot-reembed-r88wngfg.js} +5 -2
  12. package/dist/{boot-scrub-sweep-mkmm16gk.js → boot-scrub-sweep-scrqhw48.js} +2 -2
  13. package/dist/{boot-seeds-arrkbe8t.js → boot-seeds-vb2dcrrb.js} +4 -4
  14. package/dist/{claude-adapter-ykpyr5p8.js → claude-adapter-h3mp9hgs.js} +7 -6
  15. package/dist/{claude-managed-adapter-ssg6z4bt.js → claude-managed-adapter-kpbyj2vb.js} +3 -3
  16. package/dist/{claude-managed-setup-trd59v7b.js → claude-managed-setup-0efr3wkg.js} +5 -5
  17. package/dist/{claude-sdk-session-yjcze0j1.js → claude-sdk-session-03dw669q.js} +7 -6
  18. package/dist/{cli-e3ahxq5y.js → cli-0b655smz.js} +4 -4
  19. package/dist/{cli-mcymtvwn.js → cli-0dg7ytxm.js} +89 -11
  20. package/dist/cli-0jkenasr.js +148 -0
  21. package/dist/{cli-c7j31hq9.js → cli-0pazkmd4.js} +3 -3
  22. package/dist/{cli-5tg94mdw.js → cli-117g15t4.js} +8 -11
  23. package/dist/{cli-r14ac1y0.js → cli-1dbv9mj9.js} +1 -1
  24. package/dist/{cli-q8tc22bj.js → cli-1v82d2w6.js} +3 -3
  25. package/dist/{cli-pe3yxedk.js → cli-2jk4s7z1.js} +2 -2
  26. package/dist/{cli-0pp1yjg2.js → cli-2skf1mdf.js} +8 -8
  27. package/dist/{cli-2tw284hj.js → cli-48nvk6sb.js} +1 -1
  28. package/dist/{cli-en6dmkxd.js → cli-49f5jyhh.js} +2 -2
  29. package/dist/{cli-2z2c4k6q.js → cli-50w82h6m.js} +21 -0
  30. package/dist/{cli-dd2k2mcd.js → cli-6a40p4kv.js} +1 -1
  31. package/dist/{cli-yegz2g06.js → cli-6h88mn9q.js} +3 -3
  32. package/dist/{cli-52nfye5j.js → cli-7dbhnsj9.js} +23 -15
  33. package/dist/{cli-04zc3f7b.js → cli-9fsagra4.js} +1 -1
  34. package/dist/{cli-nja15knq.js → cli-9m9kyw77.js} +3 -3
  35. package/dist/{cli-k5jx8jya.js → cli-ajjvqhf3.js} +1 -1
  36. package/dist/{cli-hbvgzjq4.js → cli-avqkr20b.js} +2 -2
  37. package/dist/{cli-yfpc6qy9.js → cli-avxh26pd.js} +46 -15
  38. package/dist/{cli-q2dywc8h.js → cli-b2jh3dyb.js} +4 -4
  39. package/dist/{cli-m5qtmrbc.js → cli-c8v2yvej.js} +2 -2
  40. package/dist/{cli-gfy6hbd9.js → cli-ct8sz3np.js} +17 -10
  41. package/dist/{cli-bz97ff9n.js → cli-dka73bak.js} +1 -1
  42. package/dist/{cli-dkvtfgn4.js → cli-dkejt425.js} +75 -16
  43. package/dist/{cli-sv2r3bw8.js → cli-dnh64e8e.js} +2 -2
  44. package/dist/{cli-kwr5qv5g.js → cli-eb279wn3.js} +2 -2
  45. package/dist/{cli-hhc47ack.js → cli-f1952kjy.js} +2 -2
  46. package/dist/{cli-5z0g0e8v.js → cli-f8rcvf2x.js} +49 -13
  47. package/dist/{cli-eq4kew31.js → cli-fhvk2nvp.js} +24 -11
  48. package/dist/{cli-xf4z5bdn.js → cli-fz9pcjsw.js} +2 -2
  49. package/dist/{cli-fxd1mwtr.js → cli-g6j6ac3h.js} +1 -1
  50. package/dist/{cli-ya3kf4gs.js → cli-gfcv679k.js} +1 -1
  51. package/dist/{cli-55tc8cj4.js → cli-hbq0kwxz.js} +4 -4
  52. package/dist/{cli-39qm0rtm.js → cli-hc6e4tac.js} +28 -149
  53. package/dist/{cli-j5gtytvg.js → cli-hgsxnjyg.js} +13 -10
  54. package/dist/{cli-h70a2mxy.js → cli-hpb9x72z.js} +48 -8
  55. package/dist/{cli-7yn42w6m.js → cli-j53hpbsm.js} +1 -1
  56. package/dist/{cli-12vek61e.js → cli-jj3c5nyb.js} +471 -119
  57. package/dist/{cli-fy4gb74g.js → cli-kde4ky90.js} +1 -1
  58. package/dist/{cli-9qe5y107.js → cli-kspxjftk.js} +1 -1
  59. package/dist/{cli-bp6k9acz.js → cli-mh7pdxe0.js} +16 -16
  60. package/dist/{cli-v9ya390t.js → cli-mz34pxbk.js} +8 -8
  61. package/dist/{cli-ma9ys8rt.js → cli-nc6a8b5b.js} +7 -4
  62. package/dist/{cli-1htmtqc2.js → cli-prf7kz78.js} +49 -49
  63. package/dist/{cli-01tvvtad.js → cli-qec9bynj.js} +3 -3
  64. package/dist/{cli-t75xngj1.js → cli-qhhb30e8.js} +7 -7
  65. package/dist/{cli-73q4g5nx.js → cli-qm3ntjqs.js} +12 -12
  66. package/dist/{cli-tm60vtax.js → cli-rfejbpe1.js} +1 -1
  67. package/dist/{cli-agjbj5x0.js → cli-sdh61g52.js} +37 -19
  68. package/dist/{cli-9y4tgrkf.js → cli-skd2c4ej.js} +2 -1
  69. package/dist/{cli-5x03v6en.js → cli-sq913bh1.js} +8 -8
  70. package/dist/{cli-b93d81yg.js → cli-t35hx078.js} +1 -1
  71. package/dist/{cli-r0mz92by.js → cli-tn91wc6e.js} +1 -1
  72. package/dist/{cli-wvjqaqcp.js → cli-tstj6e8e.js} +1113 -227
  73. package/dist/{cli-xm34qj8m.js → cli-w14j2z4k.js} +2 -2
  74. package/dist/{cli-eqq0hwvx.js → cli-wndegmns.js} +1 -1
  75. package/dist/{cli-0k1a0sde.js → cli-wrhbym01.js} +6 -6
  76. package/dist/{cli-fyaq4zdv.js → cli-wv20kbr3.js} +6 -6
  77. package/dist/{cli-mq2fbgva.js → cli-wxwv3t11.js} +2 -2
  78. package/dist/{cli-krbcr00p.js → cli-xfjn2kyq.js} +58 -4
  79. package/dist/{cli-5r95eqbh.js → cli-y260hgep.js} +1 -1
  80. package/dist/{cli-cjqyse9q.js → cli-y4a4458j.js} +3 -3
  81. package/dist/{cli-2amwhyv2.js → cli-y518qkjg.js} +5 -3
  82. package/dist/{cli-0vcqcwfn.js → cli-yfvhvw8m.js} +2 -0
  83. package/dist/cli-yn4kt85g.js +148 -0
  84. package/dist/{cli-n8f0fs3c.js → cli-ytc7fpza.js} +8 -8
  85. package/dist/{cli-e8n0hdzd.js → cli-z64t9pe6.js} +1 -1
  86. package/dist/{cli-72yms3ey.js → cli-zqmmy073.js} +198 -18
  87. package/dist/cli.js +18 -16
  88. package/dist/{codex-adapter-wc6e4wct.js → codex-adapter-f3yp0kaj.js} +5 -5
  89. package/dist/{codex-hook-aqtj17yr.js → codex-hook-262cekfp.js} +73 -2
  90. package/dist/{codex-session-runner-ppfgjd97.js → codex-session-runner-ns4mv70p.js} +5 -5
  91. package/dist/{commands-tsv2vx5b.js → commands-5bzf2tfw.js} +3 -3
  92. package/dist/{controller-ye4sdwsy.js → controller-5xt7kvfm.js} +2 -2
  93. package/dist/{controllers-connect-zn4dg69h.js → controllers-connect-0gg13mzp.js} +24 -23
  94. package/dist/core-0fqtbrxa.js +42 -0
  95. package/dist/{cursor-adapter-q2g9vwts.js → cursor-adapter-p0c5zv6r.js} +1 -1
  96. package/dist/{db-g111qn9j.js → db-2s68ycq7.js} +3 -3
  97. package/dist/{db-3r1fyr2n.js → db-q7q639k5.js} +4 -2
  98. package/dist/{dispatcher-4q8s0mx8.js → dispatcher-j2y1q7ae.js} +24 -21
  99. package/dist/{dsh-adapter-mmcw1z5s.js → dsh-adapter-pgnkf4st.js} +1 -1
  100. package/dist/{easter-egg-3d-04ke6hcp.js → easter-egg-3d-0kea97jf.js} +1 -1
  101. package/dist/{embedding-space-kcdn52vz.js → embedding-space-3n6mhhmy.js} +6 -6
  102. package/dist/{embeddings-jnzcd91a.js → embeddings-jfmj6yme.js} +1 -1
  103. package/dist/{execute-74amghty.js → execute-tjrej979.js} +1 -1
  104. package/dist/{external-channel-v9zgxnxz.js → external-channel-jy8w2gg3.js} +2 -2
  105. package/dist/fx-adapter-k6w3jvz9.js +20 -0
  106. package/dist/grok-adapter-4q5tssw0.js +20 -0
  107. package/dist/handlers-qxgfvvsf.js +41 -0
  108. package/dist/{heartbeat-p8pk1msj.js → heartbeat-6tr2w2da.js} +25 -24
  109. package/dist/{hook-p5reemds.js → hook-bpnncsec.js} +76 -17
  110. package/dist/{hook-k1h73zd7.js → hook-fv1jwrv7.js} +6 -5
  111. package/dist/{http-ms1z5xxy.js → http-bpa26czn.js} +785 -181
  112. package/dist/index-0mcxjdsa.js +44 -0
  113. package/dist/{index-kn63q1gr.js → index-52tgbhrw.js} +29 -28
  114. package/dist/index-dz4q23ag.js +40 -0
  115. package/dist/{index-76zzxtzf.js → index-mpj0z9e0.js} +1 -1
  116. package/dist/index-s175jckx.js +39 -0
  117. package/dist/{index-gjn6qfgn.js → index-s8re7mvq.js} +1 -1
  118. package/dist/{index-fbkqhvvj.js → index-w216g9y9.js} +198 -160
  119. package/dist/{keepalive-031js8jz.js → keepalive-d6z12s04.js} +3 -3
  120. package/dist/lead-p3hx7h35.js +79 -0
  121. package/dist/{maintenance-sq9v3qx9.js → maintenance-7kac6g2g.js} +1 -1
  122. package/dist/{oauth-refresh-sweep-zqmnyvs8.js → oauth-refresh-sweep-t1xjetbh.js} +2 -2
  123. package/dist/{object-webhooks-r24wwb5y.js → object-webhooks-6rdagg0r.js} +7 -7
  124. package/dist/{onboard-p25yhh7t.js → onboard-32y1cfxy.js} +3 -3
  125. package/dist/{opencode-adapter-wcjc4zdk.js → opencode-adapter-enp3v31n.js} +7 -6
  126. package/dist/{otel-impl-ff1gf20m.js → otel-impl-k0tm5ptj.js} +1 -1
  127. package/dist/{pending-hxj5yatb.js → pending-24zebgvs.js} +23 -22
  128. package/dist/{pi-mono-adapter-vkp4zz7p.js → pi-mono-adapter-yj72xxxe.js} +85 -16
  129. package/dist/{pricing-refresh-9w7gx41w.js → pricing-refresh-cf25x38j.js} +2 -2
  130. package/dist/{rbac-roles-84aw10nz.js → rbac-roles-0wydd22m.js} +3 -3
  131. package/dist/{rbac-roles-hz74vckp.js → rbac-roles-at6crb3r.js} +7 -4
  132. package/dist/{registry-eeyx1201.js → registry-zv0zvxsx.js} +1 -1
  133. package/dist/{render-v2-nrdkg9gf.js → render-v2-nvcw0jd7.js} +8 -4
  134. package/dist/{resume-s6ey36rh.js → resume-y4w0k5v3.js} +9 -8
  135. package/dist/{runtime-x0b4pyam.js → runtime-vpe43hx0.js} +1 -1
  136. package/dist/{session-access-xv49tk14.js → session-access-gkyvnfye.js} +5 -4
  137. package/dist/{session-source-backfill-r5j988ah.js → session-source-backfill-3w2st4m2.js} +2 -2
  138. package/dist/{setup-mj0krk1p.js → setup-axxvqtys.js} +1 -1
  139. package/dist/thread-buffer-rwa7d4dx.js +42 -0
  140. package/dist/{tree-visibility-cbrsfaar.js → tree-visibility-y4fqvab5.js} +2 -2
  141. package/dist/{user-merge-jobs-f9d8nwnw.js → user-merge-jobs-kcmwvrc6.js} +3 -3
  142. package/dist/{virtual-modules-ns0ryw05.js → virtual-modules-7d92dct1.js} +3 -3
  143. package/dist/{work-objects-pydhzast.js → work-objects-f708e069.js} +27 -25
  144. package/dist/worker-8rg9gz74.js +79 -0
  145. package/dist/{worker-follow-up-9z2xec5e.js → worker-follow-up-0by8wztc.js} +22 -21
  146. package/dist/xlsx-9acfmxr1.js +31534 -0
  147. package/openapi.json +1385 -204
  148. package/package.json +5 -3
  149. package/src/agentmail/handlers.ts +26 -19
  150. package/src/apps/catalog.generated.json +31 -0
  151. package/src/apps/row-store.ts +37 -14
  152. package/src/azure-devops/handlers.ts +2 -0
  153. package/src/be/audit-user.ts +46 -6
  154. package/src/be/db/kv-windows.ts +22 -0
  155. package/src/be/db/session-moves.ts +3 -3
  156. package/src/be/db/session-tree.ts +52 -5
  157. package/src/be/db/skill-audit.ts +17 -0
  158. package/src/be/db/tasks/write.ts +18 -3
  159. package/src/be/db.ts +114 -23
  160. package/src/be/extensions/assets.ts +11 -7
  161. package/src/be/memory/demotion-evidence.ts +2 -2
  162. package/src/be/memory/providers/sqlite-store.ts +151 -18
  163. package/src/be/memory/search-read-worker.ts +60 -0
  164. package/src/be/memory/search-reader.ts +223 -0
  165. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  166. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  167. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  168. package/src/be/model-tier-resolution.ts +18 -1
  169. package/src/be/multi-runtime.ts +17 -0
  170. package/src/be/primitives/object-embed.ts +250 -0
  171. package/src/be/primitives/objects.ts +29 -9
  172. package/src/be/primitives/sheets/service.ts +138 -6
  173. package/src/be/primitives/sheets/xlsx.ts +367 -0
  174. package/src/be/rbac-roles.ts +3 -0
  175. package/src/be/repo-checked-update.ts +4 -4
  176. package/src/be/repo-merge-policy.ts +26 -9
  177. package/src/be/scripts/boot-reembed.ts +6 -0
  178. package/src/be/scripts/db.ts +17 -5
  179. package/src/be/scripts/embeddings.ts +6 -0
  180. package/src/be/scripts/typecheck.ts +43 -2
  181. package/src/be/seed/schedules-seeder.ts +9 -1
  182. package/src/be/seed/workflows-seeder.ts +9 -1
  183. package/src/be/seed-scripts/index.ts +2 -0
  184. package/src/be/seed-skills/index.ts +12 -0
  185. package/src/be/swarm-config-guard.ts +1 -0
  186. package/src/be/unmapped-identities.ts +95 -1
  187. package/src/bitbucket/handlers.ts +2 -0
  188. package/src/commands/onboard/agent-fs-version.ts +1 -1
  189. package/src/event-waits/github.ts +43 -0
  190. package/src/event-waits/index.ts +29 -0
  191. package/src/event-waits/types.ts +51 -0
  192. package/src/extensions/contract-types.generated.ts +1 -1
  193. package/src/extensions/dispatcher.ts +9 -0
  194. package/src/fs/agent-fs-provider.ts +4 -1
  195. package/src/github/handlers.ts +3 -1
  196. package/src/github/pull-request-state.ts +34 -0
  197. package/src/gitlab/handlers.ts +12 -7
  198. package/src/hooks/codex-hook.ts +99 -1
  199. package/src/hooks/hook.ts +85 -11
  200. package/src/hooks/native-tool-hooks.ts +245 -0
  201. package/src/http/all-routes.ts +1 -0
  202. package/src/http/assets.ts +4 -3
  203. package/src/http/comb.ts +2 -2
  204. package/src/http/favorite-owner.ts +2 -2
  205. package/src/http/favorites.ts +3 -2
  206. package/src/http/fs.ts +13 -4
  207. package/src/http/index.ts +2 -0
  208. package/src/http/mcp-bridge.ts +4 -0
  209. package/src/http/objects.ts +265 -0
  210. package/src/http/pages.ts +3 -3
  211. package/src/http/poll.ts +43 -12
  212. package/src/http/repos.ts +7 -6
  213. package/src/http/schedules.ts +10 -6
  214. package/src/http/script-connections.ts +2 -2
  215. package/src/http/scripts.ts +9 -0
  216. package/src/http/sessions.ts +30 -12
  217. package/src/http/skills.ts +17 -0
  218. package/src/http/task-requester.ts +2 -2
  219. package/src/http/tasks.ts +13 -3
  220. package/src/http/tool-hooks.ts +24 -2
  221. package/src/http/trackers/authorize-gate.ts +2 -2
  222. package/src/http/users.ts +136 -1
  223. package/src/http/workflow-events.ts +13 -0
  224. package/src/http/workflows.ts +21 -11
  225. package/src/linear/sync.ts +3 -1
  226. package/src/prompts/base-prompt.ts +35 -13
  227. package/src/prompts/session-templates.ts +25 -0
  228. package/src/providers/acp-targets.ts +1 -1
  229. package/src/providers/amp-adapter.ts +1 -1
  230. package/src/providers/dsh-adapter.ts +1 -1
  231. package/src/providers/opencode-adapter.ts +1 -0
  232. package/src/providers/opencode-swarm-plugin.ts +50 -1
  233. package/src/providers/pi-mono-adapter.ts +139 -9
  234. package/src/providers/pi-mono-extension.ts +69 -0
  235. package/src/providers/runtime-dependencies.ts +1 -1
  236. package/src/rbac/legacy-policy.ts +3 -0
  237. package/src/rbac/permissions.ts +11 -1
  238. package/src/scheduler/deferred-task-waits.ts +170 -13
  239. package/src/scripts-runtime/executors/types.ts +5 -0
  240. package/src/scripts-runtime/loader.ts +8 -0
  241. package/src/scripts-runtime/mcp-client.ts +4 -0
  242. package/src/scripts-runtime/sdk-allowlist.ts +14 -1
  243. package/src/scripts-runtime/swarm-config.ts +8 -0
  244. package/src/scripts-runtime/swarm-sdk.ts +4 -0
  245. package/src/scripts-runtime/types/stdlib.d.ts +47 -4
  246. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  247. package/src/scripts-runtime/types/swarm-sdk.d.ts +47 -4
  248. package/src/server.ts +4 -0
  249. package/src/slack/enrich.ts +81 -21
  250. package/src/slack/handlers.test.ts +55 -2
  251. package/src/slack/handlers.ts +38 -3
  252. package/src/slack/render-v2.ts +19 -0
  253. package/src/slack/session-mirror.ts +208 -0
  254. package/src/slack/thread-participants.ts +0 -5
  255. package/src/slack/watcher.ts +3 -0
  256. package/src/slack/work-objects.test.ts +2 -1
  257. package/src/slack/work-objects.ts +7 -2
  258. package/src/tests/agentmail-filters.test.ts +4 -3
  259. package/src/tests/audit-agent-person.test.ts +825 -0
  260. package/src/tests/audit-updated-by.test.ts +19 -12
  261. package/src/tests/claude-hook-output.test.ts +107 -2
  262. package/src/tests/claude-managed-setup.test.ts +1 -1
  263. package/src/tests/codex-adapter.test.ts +6 -6
  264. package/src/tests/codex-gpt6-release.test.ts +4 -4
  265. package/src/tests/db-task-read-contract.test.ts +1 -0
  266. package/src/tests/db-task-write-contract.test.ts +1 -0
  267. package/src/tests/dsh-adapter.test.ts +1 -1
  268. package/src/tests/extensions-catalog.test.ts +33 -25
  269. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  270. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  271. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  272. package/src/tests/kv-storage.test.ts +3 -0
  273. package/src/tests/memory-search-reader.test.ts +258 -0
  274. package/src/tests/memory-search-stall.test.ts +197 -20
  275. package/src/tests/model-control.test.ts +4 -4
  276. package/src/tests/model-tier-resolution.test.ts +2 -2
  277. package/src/tests/multi-runtime-registration.test.ts +8 -2
  278. package/src/tests/native-tool-hooks.test.ts +188 -0
  279. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  280. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  281. package/src/tests/poll-probe-readonly.test.ts +108 -0
  282. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  283. package/src/tests/prompt-template-session.test.ts +3 -2
  284. package/src/tests/rbac-roles.test.ts +3 -0
  285. package/src/tests/script-connections.test.ts +4 -0
  286. package/src/tests/seed-model-profiles.test.ts +1 -1
  287. package/src/tests/sessions-tree.test.ts +10 -2
  288. package/src/tests/slack-thread-participants.test.ts +66 -4
  289. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  290. package/src/tools/defer-task.ts +154 -12
  291. package/src/tools/objects.ts +10 -5
  292. package/src/tools/repos/update-repo.ts +6 -6
  293. package/src/tools/schedules/create-schedule.ts +1 -0
  294. package/src/tools/schedules/list-schedules.ts +3 -0
  295. package/src/tools/schedules/patch-schedule.ts +12 -3
  296. package/src/tools/schedules/update-schedule.ts +12 -3
  297. package/src/tools/sheets.ts +66 -0
  298. package/src/tools/skills/skill-create.ts +6 -0
  299. package/src/tools/skills/skill-install-remote.ts +6 -0
  300. package/src/tools/skills/skill-sync-remote.ts +9 -0
  301. package/src/tools/skills/skill-update.ts +9 -1
  302. package/src/tools/tool-config.ts +3 -1
  303. package/src/tools/utils.ts +15 -0
  304. package/src/tools/workflows/create-workflow.ts +9 -4
  305. package/src/tools/workflows/patch-workflow-node.ts +1 -1
  306. package/src/tools/workflows/patch-workflow.ts +5 -2
  307. package/src/tools/workflows/update-workflow.ts +13 -7
  308. package/src/types.ts +96 -12
  309. package/src/workflows/input.ts +12 -5
  310. package/src/workflows/patch-definition.ts +13 -5
  311. package/src/workflows/triggers.ts +11 -6
  312. package/src/workflows/version.ts +7 -1
  313. package/templates/skills/boards-and-sheets/config.json +14 -0
  314. package/templates/skills/boards-and-sheets/content.md +163 -0
  315. package/templates/skills/swarm-docs/content.md +9 -0
  316. package/dist/acp-adapter-11m13kx4.js +0 -16
  317. package/dist/core-dxcy02sc.js +0 -41
  318. package/dist/fx-adapter-0ar6pqm3.js +0 -19
  319. package/dist/grok-adapter-t6m74fb1.js +0 -19
  320. package/dist/handlers-9kwcrc4k.js +0 -38
  321. package/dist/index-23cdfzr6.js +0 -39
  322. package/dist/index-g7kkjs5b.js +0 -38
  323. package/dist/index-stk36pa5.js +0 -43
  324. package/dist/lead-mfggjtfk.js +0 -77
  325. package/dist/thread-buffer-temgaqsy.js +0 -41
  326. package/dist/worker-efcemc22.js +0 -77
  327. /package/dist/{cli-cah298e5.js → cli-m4ejz4nj.js} +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@desplega.ai/agent-swarm",
3
- "version": "2.12.0",
3
+ "version": "2.13.0",
4
4
  "description": "agent-swarm.dev — an open-source operating system for AI work: a lead agent breaks goals into tasks, routes them to specialized workers such as Claude Code or Codex, runs each worker in an isolated container, and preserves shared memory, tools, schedules, and review gates so delegated work compounds across sessions.",
5
5
  "keywords": [
6
6
  "agent-swarm.dev",
@@ -63,6 +63,7 @@
63
63
  ],
64
64
  "overrides": {
65
65
  "@slack/socket-mode": "^2.0.7",
66
+ "lodash-es": "4.18.1",
66
67
  "react": "19.2.3",
67
68
  "react-dom": "19.2.3"
68
69
  },
@@ -218,7 +219,7 @@
218
219
  "@chat-adapter/teams": "4.44.0",
219
220
  "@chat-adapter/telegram": "4.44.0",
220
221
  "@cursor/sdk": "1.3.1",
221
- "@desplega.ai/agent-fs-just-bash": "0.18.25",
222
+ "@desplega.ai/agent-fs-just-bash": "0.18.26",
222
223
  "@desplega.ai/business-use": "^0.4.2",
223
224
  "@earendil-works/pi-agent-core": "^1.5.2",
224
225
  "@earendil-works/pi-ai": "^1.5.2",
@@ -230,7 +231,7 @@
230
231
  "@json-render/core": "0.22.0",
231
232
  "@linear/sdk": "^77.0.0",
232
233
  "@modelcontextprotocol/sdk": "1.32.1",
233
- "@openai/codex": "0.167.1",
234
+ "@openai/codex": "0.167.2",
234
235
  "@openfort/openfort-node": "^0.9.1",
235
236
  "@opentelemetry/api": "^1.9.1",
236
237
  "@opentelemetry/api-logs": "^0.218.0",
@@ -263,6 +264,7 @@
263
264
  "svix": "^1.62.0",
264
265
  "viem": "^2.46.3",
265
266
  "ws": "8.21.0",
267
+ "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz",
266
268
  "y-protocols": "1.0.7",
267
269
  "yjs": "13.6.32",
268
270
  "zod": "^4.2.1",
@@ -71,11 +71,13 @@ const agentmailBuffer = createIngressBuffer<BufferedAgentMailMessage>({
71
71
  });
72
72
 
73
73
  /**
74
- * Extract bare email address from a from_ field like "Taras Yarema <t@desplega.ai>" or "t@desplega.ai".
74
+ * Extract the mailbox from one from_ entry like "Taras Yarema <t@desplega.ai>" or "t@desplega.ai".
75
+ * The mailbox is the trailing `<...>`; a display name may itself contain an address.
75
76
  */
76
77
  function extractEmailFromField(from: string): string | undefined {
77
- const angleMatch = from.match(/<([^>]+@[^>]+)>/);
78
- if (angleMatch?.[1]) return angleMatch[1].toLowerCase();
78
+ const angleMatch = from.match(/<([^<>]+@[^<>]+)>\s*$/);
79
+ if (angleMatch?.[1]) return angleMatch[1].trim().toLowerCase();
80
+ if (from.includes("<")) return undefined;
79
81
  const bareMatch = from.match(/[\w.+-]+@[\w.-]+\.\w+/);
80
82
  return bareMatch?.[0]?.toLowerCase();
81
83
  }
@@ -116,18 +118,16 @@ export function isInboxAllowed(inboxId: string, filter: string | undefined): boo
116
118
 
117
119
  /**
118
120
  * Check if a sender address is allowed by the filter (full addresses or domains).
119
- * Returns true if no filter is set or at least one sender matches an entry.
121
+ * Returns true if no filter is set or the first From entry matches an entry.
122
+ * Only the first entry counts: handleMessageReceived takes the sender from it.
120
123
  */
121
124
  export function isSenderAllowed(
122
125
  from: AgentMailMessage["from_"],
123
126
  filter: string | undefined,
124
127
  ): boolean {
125
128
  if (!filter) return true;
126
- const fromAddresses = Array.isArray(from) ? from : [from || ""];
127
- return fromAddresses.some((addr) => {
128
- const emailMatch = addr.match(/<([^>]+)>/);
129
- return matchesAddressFilter(emailMatch?.[1] ?? addr, filter);
130
- });
129
+ const email = extractEmailFromField((Array.isArray(from) ? from[0] : from) ?? "");
130
+ return email !== undefined && matchesAddressFilter(email, filter);
131
131
  }
132
132
 
133
133
  // Simple deduplication cache (60 second TTL)
@@ -190,10 +190,15 @@ export async function handleMessageReceived(
190
190
  // primary identifier for inbound email events, so always auto-create when
191
191
  // missing. findOrCreateUserByEmail emits identity_added (new row) or
192
192
  // auto_merge (existing row matched via primary email or emailAliases).
193
- const senderEmail = extractEmailFromField(from);
194
- const senderName = extractNameFromField(from);
193
+ // A sender that failed authentication is never linked to a user.
194
+ const senderEntry = (Array.isArray(message.from_) ? message.from_[0] : message.from_) ?? "";
195
+ const senderEmail = extractEmailFromField(senderEntry);
196
+ const senderName = extractNameFromField(senderEntry);
197
+ const senderAuthenticated =
198
+ payload.event_type !== "message.received.unauthenticated" &&
199
+ !message.labels?.includes("unauthenticated");
195
200
  let requestedByUserId: string | undefined;
196
- if (senderEmail) {
201
+ if (senderEmail && senderAuthenticated) {
197
202
  const { user } = await findOrCreateUserByEmail(
198
203
  senderEmail,
199
204
  { name: senderName ?? undefined },
@@ -203,13 +208,15 @@ export async function handleMessageReceived(
203
208
  }
204
209
  // Render the resolved canonical name (or the UNKNOWN sentinel) for
205
210
  // agent-visible text — never the raw From header. `findOrCreateUserByEmail`
206
- // above auto-creates on a real email, so `senderEmail` present implies
207
- // resolved; a missing/unparseable From header has no machine-carried
208
- // identifier at all, so it renders the same non-name sentinel shape via
209
- // the identity primitive rather than echoing the raw header string.
210
- const senderDisplay = senderEmail
211
- ? renderIdentity(await resolveIdentityByEmail(senderEmail))
212
- : renderIdentity({ status: "unknown", kind: "email", externalId: "unknown" });
211
+ // above auto-creates on a real email, so an authenticated `senderEmail`
212
+ // implies resolved; an unauthenticated sender or a missing/unparseable From
213
+ // header renders the non-name sentinel shape via the identity primitive
214
+ // rather than echoing the raw header string.
215
+ const senderDisplay = renderIdentity(
216
+ senderEmail && senderAuthenticated
217
+ ? await resolveIdentityByEmail(senderEmail)
218
+ : { status: "unknown", kind: "email", externalId: senderEmail ?? "unknown" },
219
+ );
213
220
  const preview = body.length > 500 ? `${body.substring(0, 500)}...` : body;
214
221
 
215
222
  // Emit workflow trigger event
@@ -43,6 +43,7 @@
43
43
  "Tree",
44
44
  "Files",
45
45
  "File",
46
+ "ObjectEmbed",
46
47
  "DateRange",
47
48
  "Timeline",
48
49
  "SchemaForm",
@@ -3234,6 +3235,36 @@
3234
3235
  "additionalProperties": false
3235
3236
  }
3236
3237
  },
3238
+ "ObjectEmbed": {
3239
+ "description": "One board (Excalidraw) or sheet (formula grid) by `objectId`, editable in place by the viewer. Create the object with `ctx.boards.create` / `ctx.sheets.create` (or the board-* / sheet-* tools) on the swarm's shared drive and put its id here. Sheet edits and TSV pastes go to the server, which recalculates formulas; a formula cell shows its result and edits as its formula. A board autosaves 1.5 s after the last edit, and when someone else saved first it offers Keep mine / Take theirs. Both views poll every 4 s, so agent writes show up. `height` 160-1200 px (default 480); `readOnly` disables edits; `tab` opens a sheet tab; `range` (e.g. `Tasks!B2:F20`) shows only that window. A missing object, or one off the shared drive, shows an error with a copy-id button.",
3240
+ "props": {
3241
+ "$schema": "http://json-schema.org/draft-07/schema#",
3242
+ "type": "object",
3243
+ "properties": {
3244
+ "objectId": {
3245
+ "type": "string",
3246
+ "format": "uuid",
3247
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
3248
+ },
3249
+ "height": {
3250
+ "type": "integer",
3251
+ "minimum": 160,
3252
+ "maximum": 1200
3253
+ },
3254
+ "readOnly": {
3255
+ "type": "boolean"
3256
+ },
3257
+ "tab": {
3258
+ "type": "string"
3259
+ },
3260
+ "range": {
3261
+ "type": "string"
3262
+ }
3263
+ },
3264
+ "required": ["objectId"],
3265
+ "additionalProperties": false
3266
+ }
3267
+ },
3237
3268
  "DateRange": {
3238
3269
  "description": "Date range filter: preset buttons (`7d`, `30d`, `90d`, `mtd` month to date, `custom`) that write `/ui/<id>/from` and `/ui/<id>/to` as inclusive `YYYY-MM-DD` dates ending today. Bind query params to them with `{ \"$state\": \"/ui/<id>/from\" }`, so the query refetches when the range changes. `presets` picks and orders the buttons (default all five); `defaultPreset` is written on first load (default the first preset). `custom` opens two date inputs in a popover and applies when from is not after to.",
3239
3270
  "props": {
@@ -1,4 +1,5 @@
1
1
  import { deleteKv, getDbClient, getKv, kvPrefixUpperBound, listKv, upsertKv } from "../be/db";
2
+ import { kvKeyAfter } from "../be/db/kv-windows";
2
3
  import { isInTransaction } from "../be/db-client";
3
4
  import {
4
5
  AppDefinitionSchema,
@@ -353,30 +354,52 @@ export async function getAppRow(
353
354
  return entry.value as AppRow;
354
355
  }
355
356
 
357
+ /** Rows one `listAppRows` statement scans. A full-model scan was one 0.5 s+ sync stall. */
358
+ const LIST_SCAN_WINDOW = 2000;
359
+ const LIST_ROW_CAP = 100000;
360
+
356
361
  /**
357
362
  * `equals` pre-filters rows in SQL on top-level fields so a filtered list
358
363
  * does not decode the whole model. The match is looser than `===` (JSON
359
364
  * `true` equals `1`); callers re-check the returned rows.
365
+ *
366
+ * The scan runs in key windows with a yield between them: one statement over
367
+ * a six-figure model blocks the event loop for every other request.
360
368
  */
361
369
  export async function listAppRows(
362
370
  appId: string,
363
371
  model: string,
364
372
  equals: Array<{ column: string; value: string | number | boolean }> = [],
365
373
  ): Promise<AppRow[]> {
366
- const entries = await listKv(appsNamespace(appId), {
367
- prefix: `${model}/row/`,
368
- limit: 100000,
369
- offset: 0,
370
- jsonFieldEquals: equals
371
- .filter((filter) => !/["\\]/.test(filter.column))
372
- .map((filter) => ({ field: filter.column, value: filter.value })),
373
- });
374
- return entries
375
- .map((entry) => entry.value)
376
- .filter(
377
- (value): value is AppRow =>
378
- typeof value === "object" && value !== null && !Array.isArray(value),
379
- );
374
+ const namespace = appsNamespace(appId);
375
+ const prefix = `${model}/row/`;
376
+ const upper = kvPrefixUpperBound(prefix)!;
377
+ const jsonFieldEquals = equals
378
+ .filter((filter) => !/["\\]/.test(filter.column))
379
+ .map((filter) => ({ field: filter.column, value: filter.value }));
380
+ const rows: AppRow[] = [];
381
+ let afterKey = prefix;
382
+ while (rows.length < LIST_ROW_CAP) {
383
+ const through = await kvKeyAfter(namespace, upper, afterKey, LIST_SCAN_WINDOW - 1);
384
+ const entries = await listKv(namespace, {
385
+ prefix,
386
+ limit: LIST_ROW_CAP - rows.length,
387
+ offset: 0,
388
+ jsonFieldEquals,
389
+ keyAfter: afterKey,
390
+ keyThrough: through ?? undefined,
391
+ });
392
+ for (const { value } of entries) {
393
+ if (typeof value === "object" && value !== null && !Array.isArray(value)) {
394
+ rows.push(value as AppRow);
395
+ }
396
+ }
397
+ if (through === null) break;
398
+ afterKey = through;
399
+ // Inside a transaction a timer would stall every DB caller; only yield outside one.
400
+ if (!isInTransaction()) await yieldToEventLoop();
401
+ }
402
+ return rows;
380
403
  }
381
404
 
382
405
  const MIGRATION_KV_BATCH_SIZE = 1000;
@@ -10,6 +10,7 @@
10
10
 
11
11
  import { findTaskByVcs, getAllAgents, incrKv, upsertKv } from "../be/db";
12
12
  import { renderIdentity, resolveIdentity } from "../be/identity";
13
+ import { isUnmappedIdentityDismissed } from "../be/unmapped-identities";
13
14
  import {
14
15
  findOrCreateUserByEmail,
15
16
  findUserByEmail,
@@ -208,6 +209,7 @@ async function recordUnmappedIdentity(
208
209
  sampleEventType: string,
209
210
  sampleContext: string,
210
211
  ): Promise<void> {
212
+ if (await isUnmappedIdentityDismissed("azure-devops", externalId)) return;
211
213
  await upsertKv({
212
214
  namespace: UNMAPPED_NAMESPACE,
213
215
  key: `${externalId}:meta`,
@@ -68,12 +68,33 @@ export async function resolveTaskAuditUserId(
68
68
  return null;
69
69
  }
70
70
 
71
+ const firstHeader = (h: string | string[] | undefined) => (Array.isArray(h) ? h[0] : h);
72
+
71
73
  /**
72
- * HTTP variant of {@link resolveTaskAuditUserId}.
74
+ * The person an HTTP request acts for, for identity and authorization: a
75
+ * workflow run's or task's requester, asset-key and OAuth ownership, tracker
76
+ * authorization. Trusted request user first, else the ownership-validated
77
+ * `X-Source-Task-Id` task (or the caller's current task).
73
78
  *
74
- * Resolves the audit actor from trusted server-side request context first (an
75
- * authenticated request user is never client-controlled), then falls back to
76
- * the ownership-validated `X-Source-Task-Id` resolution.
79
+ * Never reads `X-Audit-Source-Task-Id`: a script run's task attributes its
80
+ * writes, but must not hand its requester to the workflows, tasks or grants
81
+ * the script creates.
82
+ */
83
+ export async function resolveHttpRequesterUserId(
84
+ req: IncomingMessage,
85
+ callerAgentId: string | undefined,
86
+ ): Promise<string | null> {
87
+ const userId = authUserId(getRequestAuth(req));
88
+ if (userId) return userId;
89
+ return resolveTaskAuditUserId(firstHeader(req.headers["x-source-task-id"]), callerAgentId);
90
+ }
91
+
92
+ /**
93
+ * The person to record in a `created_by` / `updated_by` audit column. Same as
94
+ * {@link resolveHttpRequesterUserId}, plus the audit-only
95
+ * `X-Audit-Source-Task-Id` that script `ctx.swarm` calls send (same ownership
96
+ * gate). Use it for audit attribution only; identity and authorization use
97
+ * {@link resolveHttpRequesterUserId}.
77
98
  */
78
99
  export async function resolveHttpAuditUserId(
79
100
  req: IncomingMessage,
@@ -81,7 +102,26 @@ export async function resolveHttpAuditUserId(
81
102
  ): Promise<string | null> {
82
103
  const userId = authUserId(getRequestAuth(req));
83
104
  if (userId) return userId;
84
- const header = req.headers["x-source-task-id"];
85
- const sourceTaskId = Array.isArray(header) ? header[0] : header;
105
+ const sourceTaskId =
106
+ firstHeader(req.headers["x-source-task-id"]) ??
107
+ firstHeader(req.headers["x-audit-source-task-id"]);
86
108
  return resolveTaskAuditUserId(sourceTaskId, callerAgentId);
87
109
  }
110
+
111
+ /**
112
+ * Who made a write: the calling agent (NULL for a human or system write) and
113
+ * the person behind it. Audited tables store it as `createdByAgentId` /
114
+ * `created_by` on insert and `updatedByAgentId` / `updated_by` on update.
115
+ */
116
+ export type AuditActor = { agentId: string | null; userId: string | null };
117
+
118
+ /** {@link resolveHttpAuditUserId} plus the calling agent, for HTTP routes. */
119
+ export async function resolveHttpAuditActor(
120
+ req: IncomingMessage,
121
+ callerAgentId: string | undefined,
122
+ ): Promise<AuditActor> {
123
+ return {
124
+ agentId: callerAgentId ?? null,
125
+ userId: await resolveHttpAuditUserId(req, callerAgentId),
126
+ };
127
+ }
@@ -0,0 +1,22 @@
1
+ import { getDbClient } from "./runtime";
2
+
3
+ /**
4
+ * The key `offset` rows past `afterKey` inside `[prefix, prefixUpper)`, or
5
+ * null when fewer remain. Reads the primary-key index only, so it is cheap
6
+ * next to a value scan; callers use it to cut a long scan into key windows.
7
+ */
8
+ export async function kvKeyAfter(
9
+ namespace: string,
10
+ prefixUpper: string,
11
+ afterKey: string,
12
+ offset: number,
13
+ ): Promise<string | null> {
14
+ const row = await getDbClient().get<{ key: string }>(
15
+ `SELECT key FROM kv_entries
16
+ WHERE namespace = ? AND key > ? AND key < ?
17
+ ORDER BY key
18
+ LIMIT 1 OFFSET ?`,
19
+ [namespace, afterKey, prefixUpper, offset],
20
+ );
21
+ return row?.key ?? null;
22
+ }
@@ -133,8 +133,8 @@ export async function moveSessionChains(input: {
133
133
  }
134
134
 
135
135
  /**
136
- * Point `key` favorites under `from` at the same path under `to` (a group
137
- * rename). A principal that already starred the new key keeps that row, and
136
+ * Point `key` favorites (stars) and `hidden-key` rows (hidden groups) under
137
+ * `from` at the same path under `to` (a group rename). A principal that already starred the new key keeps that row, and
138
138
  * the old row goes. With `scope`, only that favorite scope's stars move.
139
139
  */
140
140
  export async function moveKeyFavorites(input: {
@@ -144,7 +144,7 @@ export async function moveKeyFavorites(input: {
144
144
  }): Promise<void> {
145
145
  const { lo, hi } = keyPrefixRange(input.from);
146
146
  const scoped = input.scope !== undefined;
147
- const range = `itemType = 'key' AND itemId >= ? AND itemId < ?${scoped ? " AND favoriteScope = ?" : ""}`;
147
+ const range = `itemType IN ('key','hidden-key') AND itemId >= ? AND itemId < ?${scoped ? " AND favoriteScope = ?" : ""}`;
148
148
  const rangeParams = [lo, hi, ...(scoped ? [input.scope as string] : [])];
149
149
  await getDbClient().transaction(async () => {
150
150
  await getDbClient().run(
@@ -58,7 +58,7 @@ export interface SessionFilters {
58
58
  /** Match shared and viewer-personal namespace roots and direct leaves. */
59
59
  noGroup?: boolean;
60
60
  /** Filter by chain-wide read state or the Inbox section. */
61
- triage?: "inbox" | "later" | "done" | "unread";
61
+ triage?: "inbox" | "working" | "later" | "done" | "unread";
62
62
  /** Filter by latest chain status or pending human attention. */
63
63
  status?: "running" | "failed" | "needs";
64
64
  /** Match a requester anywhere in the chain or an active share recipient. */
@@ -78,6 +78,10 @@ export interface SessionFilters {
78
78
  includeScheduleRuns?: boolean;
79
79
  /** Match exactly this root (one session's summary, e.g. its read state). */
80
80
  rootId?: string;
81
+ /** Match any of these roots (the sidebar's starred sessions). */
82
+ rootIds?: string[];
83
+ /** Leave these roots out (a whole-list triage with some rows unchecked). */
84
+ exceptRootIds?: string[];
81
85
  }
82
86
 
83
87
  type SqlFragment = { sql: string; params: (string | number | null)[] };
@@ -322,6 +326,19 @@ export function sessionRootFilter(opts: SessionFilters = {}): SqlFragment {
322
326
  sql: scheduleRuns ? `(${fragment.sql} OR r.scheduleId IS NOT NULL)` : fragment.sql,
323
327
  });
324
328
  if (opts.rootId) add({ sql: "r.id = ?", params: [opts.rootId] });
329
+ if (opts.rootIds) {
330
+ add(
331
+ opts.rootIds.length
332
+ ? { sql: `r.id IN (${opts.rootIds.map(() => "?").join(",")})`, params: opts.rootIds }
333
+ : { sql: "0", params: [] },
334
+ );
335
+ }
336
+ if (opts.exceptRootIds?.length) {
337
+ add({
338
+ sql: `r.id NOT IN (${opts.exceptRootIds.map(() => "?").join(",")})`,
339
+ params: opts.exceptRootIds,
340
+ });
341
+ }
325
342
  const sources = opts.source?.filter(Boolean) ?? [];
326
343
  if (sources.length)
327
344
  add({ sql: `r.source IN (${sources.map(() => "?").join(",")})`, params: sources });
@@ -382,7 +399,9 @@ export function sessionRootFilter(opts: SessionFilters = {}): SqlFragment {
382
399
  }
383
400
  if (opts.groupKey) add(groupCondition(normalizeAssetKey(opts.groupKey)));
384
401
  if (opts.noGroup) add(noGroupCondition(opts.viewer?.userId));
385
- if (opts.triage === "inbox") add(inboxScopeCondition(opts.viewer?.userId));
402
+ if (opts.triage === "inbox" || opts.triage === "working") {
403
+ add(inboxScopeCondition(opts.viewer?.userId));
404
+ }
386
405
  if (opts.triage === "later" || opts.triage === "done") {
387
406
  const marked: SqlFragment = {
388
407
  sql: `r.id IN (SELECT itemId FROM inbox_item_state
@@ -400,7 +419,15 @@ export function sessionRootFilter(opts: SessionFilters = {}): SqlFragment {
400
419
  return { sql: conditions.length ? conditions.join(" AND ") : "1", params };
401
420
  }
402
421
 
422
+ /**
423
+ * A group list leaves out the viewer's Later and Done sessions: they list in
424
+ * Later and Done. A source group (`shared/slack/...`) keeps them. It mirrors
425
+ * an outside conversation, read-only, and most of its sessions are Done, so
426
+ * leaving them out left its rows empty with no way to open them.
427
+ */
403
428
  function excludesTriaged(opts: SessionFilters): boolean {
429
+ // The sidebar lists a source group with its nested threads by `keyPrefix`: same rule.
430
+ if (sourceOfKey(opts.groupKey ?? opts.keyPrefix ?? "")) return false;
404
431
  return !!(
405
432
  opts.viewer?.userId &&
406
433
  (opts.groupKey || opts.keyPrefix || opts.keyPrefixes?.length || opts.noGroup)
@@ -413,6 +440,8 @@ function hasSessionChainFilter(opts: SessionFilters): boolean {
413
440
 
414
441
  const terminalSql = TERMINAL_TASK_STATUSES.map((s) => `'${s}'`).join(",");
415
442
  const runningSql = `latestStatus NOT IN (${terminalSql})`;
443
+ /** Running with nothing for the person to answer: the Working section, not the Inbox. */
444
+ const workingSql = `(${runningSql} AND needsYou = 0)`;
416
445
  const openTaskSql = `chain.status NOT IN (${terminalSql})`;
417
446
 
418
447
  /**
@@ -452,9 +481,13 @@ function summaryRowFilters(opts: SessionFilters): SqlFragment {
452
481
  else if (opts.triage === "later" || opts.triage === "done") {
453
482
  filters.push("readState = ?");
454
483
  params.push(opts.triage);
455
- } else if (opts.triage === "inbox" || excludesTriaged(opts)) {
484
+ } else if (opts.triage === "inbox" || opts.triage === "working" || excludesTriaged(opts)) {
456
485
  filters.push("(readState IS NULL OR readState IN ('read','unread'))");
457
486
  }
487
+ // Working: Inbox sessions with a task still running and nothing for the
488
+ // person to answer. They leave the Inbox until they finish or ask.
489
+ if (opts.triage === "inbox") filters.push(`NOT (${workingSql})`);
490
+ if (opts.triage === "working") filters.push(workingSql);
458
491
  if (opts.status === "running") filters.push(runningSql);
459
492
  if (opts.status === "failed") filters.push("latestStatus = 'failed'");
460
493
  if (opts.status === "needs") filters.push("needsYou = 1");
@@ -690,6 +723,8 @@ export interface SessionTreeGroup extends SessionSectionCounts {
690
723
  export interface SessionTree {
691
724
  groups: SessionTreeGroup[];
692
725
  inbox: SessionSectionCounts;
726
+ /** Inbox sessions with a task running and nothing for the person to answer. */
727
+ working: SessionSectionCounts;
693
728
  later: SessionSectionCounts;
694
729
  done: SessionSectionCounts;
695
730
  noGroup: SessionSectionCounts;
@@ -789,6 +824,7 @@ export async function getSessionTree(
789
824
  const result: SessionTree = {
790
825
  groups: [],
791
826
  inbox: counts(),
827
+ working: counts(),
792
828
  later: counts(),
793
829
  done: counts(),
794
830
  noGroup: counts(),
@@ -848,11 +884,14 @@ export async function getSessionTree(
848
884
  }
849
885
  if (row.readState === "later" || row.readState === "done") {
850
886
  if (sectionVisible) add(result[row.readState], row);
887
+ // A source group lists its Later and Done sessions too (`excludesTriaged`).
888
+ if (group && sourceOfKey(key)) add(group, row);
851
889
  } else {
852
890
  // A session filed into a group shows under it only (`inboxScopeCondition`).
853
891
  const viewer = actor.kind === "user" ? actor.userId : null;
854
892
  const inInbox = noGroup || sourceOfKey(key) || inResourceScope(row.key, viewer);
855
- if (sectionVisible && inInbox) add(result.inbox, row);
893
+ const working = !isTerminalTaskStatus(row.latestStatus) && !row.needsYou;
894
+ if (sectionVisible && inInbox) add(working ? result.working : result.inbox, row);
856
895
  if (noGroup) add(result.noGroup, row);
857
896
  else if (group) add(group, row);
858
897
  }
@@ -898,7 +937,15 @@ export async function triageSessionList(
898
937
  userId: string,
899
938
  filters: Pick<
900
939
  SessionFilters,
901
- "triage" | "noGroup" | "groupKey" | "mine" | "hideSource" | "showSource" | "now"
940
+ | "triage"
941
+ | "noGroup"
942
+ | "groupKey"
943
+ | "keyPrefix"
944
+ | "mine"
945
+ | "hideSource"
946
+ | "showSource"
947
+ | "now"
948
+ | "exceptRootIds"
902
949
  >,
903
950
  action: SessionListTriage,
904
951
  readAll?: boolean,
@@ -0,0 +1,17 @@
1
+ import { getDbClient } from "./runtime";
2
+
3
+ /**
4
+ * Record who last changed a skill when the write went through a path that does
5
+ * not call `updateSkill` (bundled file upsert / delete): the person and the
6
+ * agent of the same write.
7
+ */
8
+ export async function setSkillUpdatedBy(
9
+ skillId: string,
10
+ actor: { agentId: string | null; userId: string | null },
11
+ ): Promise<void> {
12
+ await getDbClient().run("UPDATE skills SET updated_by = ?, updatedByAgentId = ? WHERE id = ?", [
13
+ actor.userId,
14
+ actor.agentId,
15
+ skillId,
16
+ ]);
17
+ }
@@ -132,15 +132,24 @@ export async function createTask(
132
132
  const AFFINITY_DISPATCH_SKIP_LOG_COOLDOWN_MS = 5 * 60 * 1000;
133
133
  const lastAffinityDispatchSkipLoggedAt = new Map<string, number>();
134
134
 
135
+ /** Passed by the read-only poll probe: flags a due skip log instead of writing it. */
136
+ type PendingTaskProbe = { skipLogDue: boolean };
137
+
135
138
  async function logAffinityDispatchSkip(
136
139
  agent: Pick<Agent, "id" | "isLead" | "role">,
137
140
  task: Pick<AgentTask, "id" | "routingAffinity" | "routingAffinityInvalid">,
141
+ probe?: PendingTaskProbe,
138
142
  ): Promise<void> {
139
143
  const now = Date.now();
140
144
  const lastLoggedAt = lastAffinityDispatchSkipLoggedAt.get(task.id);
141
145
  if (lastLoggedAt !== undefined && now - lastLoggedAt < AFFINITY_DISPATCH_SKIP_LOG_COOLDOWN_MS) {
142
146
  return;
143
147
  }
148
+ // No write and no cooldown stamp: the write pass the flag triggers logs it.
149
+ if (probe) {
150
+ probe.skipLogDue = true;
151
+ return;
152
+ }
144
153
  lastAffinityDispatchSkipLoggedAt.set(task.id, now);
145
154
  try {
146
155
  await dependencies.createLogEntry({
@@ -158,7 +167,10 @@ async function logAffinityDispatchSkip(
158
167
  } catch {}
159
168
  }
160
169
 
161
- export async function getPendingTaskForAgent(agentId: string): Promise<AgentTask | null> {
170
+ export async function getPendingTaskForAgent(
171
+ agentId: string,
172
+ probe?: PendingTaskProbe,
173
+ ): Promise<AgentTask | null> {
162
174
  // Get all pending tasks for this agent, ordered by priority (desc) then creation time (asc)
163
175
  const rows = await getDbClient().query<AgentTaskRow>(
164
176
  "SELECT * FROM agent_tasks WHERE agentId = ? AND status = 'pending' ORDER BY priority DESC, createdAt ASC",
@@ -189,11 +201,11 @@ export async function getPendingTaskForAgent(agentId: string): Promise<AgentTask
189
201
  // assignment that was already authorized (or, for provenance, never a
190
202
  // requirement) at creation time.
191
203
  if (task.routingAffinityInvalid) {
192
- await logAffinityDispatchSkip(agent, task);
204
+ await logAffinityDispatchSkip(agent, task, probe);
193
205
  continue;
194
206
  }
195
207
  if (task.routingAffinity?.leadOnly && !isAgentEligibleForTask(agent, task)) {
196
- await logAffinityDispatchSkip(agent, task);
208
+ await logAffinityDispatchSkip(agent, task, probe);
197
209
  continue;
198
210
  }
199
211
  const { ready } = await dependencies.checkDependencies(task.id);
@@ -540,6 +552,7 @@ export async function completeTask(
540
552
  .then(({ workflowEventBus }) => {
541
553
  workflowEventBus.emit("task.completed", {
542
554
  taskId: id,
555
+ previousStatus: oldTask.status,
543
556
  output: scrubbedOutput,
544
557
  agentId: row.agentId,
545
558
  workflowRunId: row.workflowRunId,
@@ -641,6 +654,7 @@ export async function failTask(
641
654
  .then(({ workflowEventBus }) => {
642
655
  workflowEventBus.emit("task.failed", {
643
656
  taskId: id,
657
+ previousStatus: oldTask.status,
644
658
  failureReason: scrubbedReason,
645
659
  agentId: row.agentId,
646
660
  workflowRunId: row.workflowRunId,
@@ -779,6 +793,7 @@ export async function cancelTask(
779
793
  .then(({ workflowEventBus }) => {
780
794
  workflowEventBus.emit("task.cancelled", {
781
795
  taskId: id,
796
+ previousStatus: oldTask.status,
782
797
  agentId: row.agentId,
783
798
  workflowRunId: row.workflowRunId,
784
799
  workflowRunStepId: row.workflowRunStepId,