@desplega.ai/agent-swarm 2.11.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 (521) hide show
  1. package/dist/acp-adapter-cn53011z.js +17 -0
  2. package/dist/{acp-targets-5wyy2b9m.js → acp-targets-86f0sh6g.js} +10 -9
  3. package/dist/{actions-4nxq386s.js → actions-zv8vcxvr.js} +25 -22
  4. package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-jqshb33y.js} +10 -5
  5. package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-gt503ywc.js} +3 -3
  6. package/dist/{app-kyqt8ehw.js → app-6t4k5rh1.js} +7 -5
  7. package/dist/{approval-notifications-a0db0esw.js → approval-notifications-fcfw063h.js} +8 -7
  8. package/dist/{assistant-9g5jzq25.js → assistant-9dzybh12.js} +26 -23
  9. package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-xzfp2feg.js} +1 -1
  10. package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-3jz0p2jk.js} +1 -1
  11. package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-r88wngfg.js} +5 -2
  12. package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-scrqhw48.js} +2 -2
  13. package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-vb2dcrrb.js} +4 -4
  14. package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
  15. package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-h3mp9hgs.js} +9 -8
  16. package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-kpbyj2vb.js} +4 -4
  17. package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-0efr3wkg.js} +7 -7
  18. package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-03dw669q.js} +11 -10
  19. package/dist/{cli-14xdms9a.js → cli-0b655smz.js} +6 -6
  20. package/dist/{cli-wz4e5am2.js → cli-0dg7ytxm.js} +400 -72
  21. package/dist/cli-0jkenasr.js +148 -0
  22. package/dist/{cli-0bgj4rh5.js → cli-0pazkmd4.js} +4 -4
  23. package/dist/{cli-892y3vfp.js → cli-117g15t4.js} +9 -12
  24. package/dist/{cli-v3zcnr8g.js → cli-1dbv9mj9.js} +1 -1
  25. package/dist/{cli-8zmpwe79.js → cli-1v82d2w6.js} +5 -5
  26. package/dist/{cli-6tvh1fwq.js → cli-2jk4s7z1.js} +3 -3
  27. package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
  28. package/dist/{cli-atm0hkes.js → cli-2skf1mdf.js} +11 -11
  29. package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
  30. package/dist/{cli-a02habn6.js → cli-48nvk6sb.js} +3 -3
  31. package/dist/{cli-q71g5q39.js → cli-49f5jyhh.js} +3 -3
  32. package/dist/{cli-2z2c4k6q.js → cli-50w82h6m.js} +21 -0
  33. package/dist/{cli-dd2k2mcd.js → cli-6a40p4kv.js} +1 -1
  34. package/dist/{cli-rwgwen5v.js → cli-6h88mn9q.js} +4 -4
  35. package/dist/cli-7dbhnsj9.js +681 -0
  36. package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
  37. package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
  38. package/dist/{cli-rhsc2zyx.js → cli-9fsagra4.js} +1 -1
  39. package/dist/{cli-f8yhybxr.js → cli-9m9kyw77.js} +3 -3
  40. package/dist/{cli-yzxqwcvq.js → cli-ajjvqhf3.js} +10 -3
  41. package/dist/cli-avqkr20b.js +69 -0
  42. package/dist/{cli-nbakg5xh.js → cli-avxh26pd.js} +46 -15
  43. package/dist/{cli-n6ygvrrm.js → cli-b2jh3dyb.js} +4 -4
  44. package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
  45. package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
  46. package/dist/{cli-czvvnfr9.js → cli-c8v2yvej.js} +2 -2
  47. package/dist/{cli-raqw9fw9.js → cli-ct8sz3np.js} +18 -11
  48. package/dist/{cli-t2s7j5cy.js → cli-dka73bak.js} +2 -2
  49. package/dist/{cli-tb4j757d.js → cli-dkejt425.js} +76 -17
  50. package/dist/{cli-27fat7st.js → cli-dnh64e8e.js} +7 -7
  51. package/dist/{cli-453497a0.js → cli-eb279wn3.js} +2 -2
  52. package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
  53. package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
  54. package/dist/{cli-vy3fn0mz.js → cli-f1952kjy.js} +4 -4
  55. package/dist/{cli-1h4njv9y.js → cli-f8rcvf2x.js} +58 -13
  56. package/dist/{cli-xqbqwpxr.js → cli-fhvk2nvp.js} +26 -13
  57. package/dist/{cli-2jtfm8kh.js → cli-fz9pcjsw.js} +4 -4
  58. package/dist/{cli-bq97k63w.js → cli-g6j6ac3h.js} +2 -2
  59. package/dist/{cli-f7dhm7hh.js → cli-gfcv679k.js} +1 -1
  60. package/dist/cli-hbq0kwxz.js +252 -0
  61. package/dist/{cli-nc39ym5q.js → cli-hc6e4tac.js} +29 -150
  62. package/dist/{cli-m00c47q6.js → cli-hgsxnjyg.js} +58 -25
  63. package/dist/{cli-s9twe4x0.js → cli-hpb9x72z.js} +58 -13
  64. package/dist/{cli-9g12h1aq.js → cli-j53hpbsm.js} +2 -2
  65. package/dist/{cli-zhn4r1rz.js → cli-jj3c5nyb.js} +519 -144
  66. package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
  67. package/dist/{cli-kbm659dk.js → cli-kde4ky90.js} +2 -2
  68. package/dist/{cli-4aswccje.js → cli-kspxjftk.js} +2 -2
  69. package/dist/{cli-p8zqbbt1.js → cli-m4ejz4nj.js} +1 -1
  70. package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
  71. package/dist/{cli-b82a13ga.js → cli-mh7pdxe0.js} +23 -27
  72. package/dist/{cli-rpmw4fsv.js → cli-mz34pxbk.js} +12 -12
  73. package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
  74. package/dist/{cli-cstggwq7.js → cli-nc6a8b5b.js} +7 -4
  75. package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
  76. package/dist/{cli-j2r1apqm.js → cli-prf7kz78.js} +59 -58
  77. package/dist/{cli-2gvdvsxj.js → cli-qec9bynj.js} +63 -60
  78. package/dist/{cli-zb1hff00.js → cli-qhhb30e8.js} +12 -12
  79. package/dist/{cli-h2qtafm4.js → cli-qm3ntjqs.js} +21 -21
  80. package/dist/{cli-5ptj757f.js → cli-rfejbpe1.js} +1 -1
  81. package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
  82. package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
  83. package/dist/{cli-mhrr4d5b.js → cli-sdh61g52.js} +38 -20
  84. package/dist/{cli-7cp6aa1q.js → cli-skd2c4ej.js} +25 -178
  85. package/dist/{cli-ynph3b70.js → cli-sq913bh1.js} +8 -8
  86. package/dist/{cli-hnh8erra.js → cli-t35hx078.js} +2 -2
  87. package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
  88. package/dist/{cli-yvzxbztc.js → cli-tn91wc6e.js} +2 -2
  89. package/dist/{cli-075ccjh6.js → cli-tstj6e8e.js} +3660 -232
  90. package/dist/{cli-4g323fjh.js → cli-w14j2z4k.js} +2 -2
  91. package/dist/{cli-4kzp7r0q.js → cli-wndegmns.js} +3 -3
  92. package/dist/{cli-p1a4khta.js → cli-wrhbym01.js} +10 -10
  93. package/dist/{cli-djt6wmrc.js → cli-wv20kbr3.js} +9 -9
  94. package/dist/{cli-2aacfdcn.js → cli-wxwv3t11.js} +64 -3
  95. package/dist/{cli-rytq7dm2.js → cli-xfjn2kyq.js} +59 -5
  96. package/dist/cli-y260hgep.js +186 -0
  97. package/dist/{cli-9knhkkgr.js → cli-y4a4458j.js} +3 -3
  98. package/dist/{cli-a6q6x15h.js → cli-y518qkjg.js} +10 -5
  99. package/dist/{cli-0b4zam62.js → cli-yfvhvw8m.js} +20 -0
  100. package/dist/cli-yn4kt85g.js +148 -0
  101. package/dist/{cli-k4r5sfaj.js → cli-ytc7fpza.js} +11 -11
  102. package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
  103. package/dist/{cli-6n7y5ypy.js → cli-z64t9pe6.js} +1 -1
  104. package/dist/{cli-6a3j25xd.js → cli-zqmmy073.js} +200 -20
  105. package/dist/cli.js +27 -22
  106. package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-f3yp0kaj.js} +8 -8
  107. package/dist/{codex-hook-aqtj17yr.js → codex-hook-262cekfp.js} +73 -2
  108. package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
  109. package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ns4mv70p.js} +9 -9
  110. package/dist/{commands-ctey7tr5.js → commands-5bzf2tfw.js} +3 -3
  111. package/dist/{controller-rqhbppg9.js → controller-5xt7kvfm.js} +4 -4
  112. package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-0gg13mzp.js} +26 -23
  113. package/dist/core-0fqtbrxa.js +42 -0
  114. package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-p0c5zv6r.js} +2 -2
  115. package/dist/{db-p5drc1d1.js → db-2s68ycq7.js} +3 -3
  116. package/dist/{db-2ah39cyx.js → db-q7q639k5.js} +8 -2
  117. package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
  118. package/dist/{dispatcher-x6w14pde.js → dispatcher-j2y1q7ae.js} +25 -20
  119. package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
  120. package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-pgnkf4st.js} +2 -2
  121. package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
  122. package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
  123. package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-0kea97jf.js} +1 -1
  124. package/dist/{embedding-space-z6ptw3jk.js → embedding-space-3n6mhhmy.js} +6 -6
  125. package/dist/{embeddings-0sxb1d2h.js → embeddings-jfmj6yme.js} +1 -1
  126. package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
  127. package/dist/{execute-6m1ex8ce.js → execute-tjrej979.js} +1 -1
  128. package/dist/{external-channel-ezer7pk0.js → external-channel-jy8w2gg3.js} +2 -2
  129. package/dist/fx-adapter-k6w3jvz9.js +20 -0
  130. package/dist/grok-adapter-4q5tssw0.js +20 -0
  131. package/dist/handlers-qxgfvvsf.js +41 -0
  132. package/dist/{heartbeat-6c4fr49t.js → heartbeat-6tr2w2da.js} +26 -23
  133. package/dist/{hook-02rt5tvq.js → hook-bpnncsec.js} +77 -18
  134. package/dist/{hook-t1c5avbv.js → hook-fv1jwrv7.js} +6 -5
  135. package/dist/{http-qa3h32a1.js → http-bpa26czn.js} +1277 -249
  136. package/dist/index-0mcxjdsa.js +44 -0
  137. package/dist/{index-akbgsdhh.js → index-52tgbhrw.js} +30 -27
  138. package/dist/index-dz4q23ag.js +40 -0
  139. package/dist/{index-kqv9ebfj.js → index-mpj0z9e0.js} +1 -1
  140. package/dist/index-s175jckx.js +39 -0
  141. package/dist/{index-qpjk2hxk.js → index-s8re7mvq.js} +1 -1
  142. package/dist/{index-e42j998x.js → index-w216g9y9.js} +222 -165
  143. package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
  144. package/dist/{keepalive-jmf6pn8c.js → keepalive-d6z12s04.js} +4 -4
  145. package/dist/lead-p3hx7h35.js +79 -0
  146. package/dist/{maintenance-g7v15tj1.js → maintenance-7kac6g2g.js} +1 -1
  147. package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-t1xjetbh.js} +3 -3
  148. package/dist/object-webhooks-6rdagg0r.js +21 -0
  149. package/dist/{onboard-m3fedypq.js → onboard-32y1cfxy.js} +5 -5
  150. package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-enp3v31n.js} +8 -7
  151. package/dist/{otel-impl-3ehm1hgc.js → otel-impl-k0tm5ptj.js} +2 -2
  152. package/dist/{pending-fwj2fatd.js → pending-24zebgvs.js} +24 -21
  153. package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-yj72xxxe.js} +89 -20
  154. package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-cf25x38j.js} +2 -2
  155. package/dist/{rbac-roles-8msjr07m.js → rbac-roles-0wydd22m.js} +3 -3
  156. package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-at6crb3r.js} +7 -4
  157. package/dist/{registry-32b1mft6.js → registry-zv0zvxsx.js} +1 -1
  158. package/dist/{render-v2-j7qggj8h.js → render-v2-nvcw0jd7.js} +9 -5
  159. package/dist/{resume-hj1mn65y.js → resume-y4w0k5v3.js} +10 -9
  160. package/dist/{runtime-z31mdsgv.js → runtime-vpe43hx0.js} +1 -1
  161. package/dist/{session-access-w38fh09a.js → session-access-gkyvnfye.js} +5 -4
  162. package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-3w2st4m2.js} +3 -3
  163. package/dist/{setup-dsqmpfcr.js → setup-axxvqtys.js} +1 -1
  164. package/dist/thread-buffer-rwa7d4dx.js +42 -0
  165. package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-y4fqvab5.js} +2 -2
  166. package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-kcmwvrc6.js} +3 -3
  167. package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-7d92dct1.js} +3 -3
  168. package/dist/{work-objects-4ahy5es5.js → work-objects-f708e069.js} +28 -24
  169. package/dist/worker-8rg9gz74.js +79 -0
  170. package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-0by8wztc.js} +23 -20
  171. package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
  172. package/dist/xlsx-9acfmxr1.js +31534 -0
  173. package/openapi.json +5227 -3511
  174. package/package.json +10 -5
  175. package/src/agentmail/handlers.ts +26 -19
  176. package/src/apps/catalog.generated.json +31 -0
  177. package/src/apps/row-store.ts +37 -14
  178. package/src/azure-devops/auth.ts +2 -3
  179. package/src/azure-devops/handlers.ts +2 -0
  180. package/src/be/agent-fs-identity.ts +46 -0
  181. package/src/be/agent-history.ts +215 -0
  182. package/src/be/audit-user.ts +46 -6
  183. package/src/be/db/agents.ts +34 -12
  184. package/src/be/db/kv-windows.ts +22 -0
  185. package/src/be/db/session-moves.ts +3 -3
  186. package/src/be/db/session-tree.ts +52 -5
  187. package/src/be/db/skill-audit.ts +17 -0
  188. package/src/be/db/tasks/write.ts +20 -5
  189. package/src/be/db.ts +116 -23
  190. package/src/be/extensions/assets.ts +11 -7
  191. package/src/be/memory/demotion-evidence.ts +2 -2
  192. package/src/be/memory/providers/sqlite-store.ts +151 -18
  193. package/src/be/memory/search-read-worker.ts +60 -0
  194. package/src/be/memory/search-reader.ts +223 -0
  195. package/src/be/migrations/332_primitive_objects.sql +31 -0
  196. package/src/be/migrations/334_agent_history.sql +23 -0
  197. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  198. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  199. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  200. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  201. package/src/be/model-tier-resolution.ts +18 -1
  202. package/src/be/multi-runtime.ts +17 -0
  203. package/src/be/primitives/boards/elements.ts +717 -0
  204. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  205. package/src/be/primitives/boards/service.ts +121 -0
  206. package/src/be/primitives/object-embed.ts +250 -0
  207. package/src/be/primitives/object-webhooks.ts +348 -0
  208. package/src/be/primitives/objects.ts +706 -0
  209. package/src/be/primitives/sheets/a1.ts +136 -0
  210. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  211. package/src/be/primitives/sheets/engine.ts +199 -0
  212. package/src/be/primitives/sheets/format.ts +106 -0
  213. package/src/be/primitives/sheets/service.ts +547 -0
  214. package/src/be/primitives/sheets/xlsx.ts +367 -0
  215. package/src/be/primitives/write-object.ts +83 -0
  216. package/src/be/rbac-roles.ts +3 -0
  217. package/src/be/repo-checked-update.ts +4 -4
  218. package/src/be/repo-merge-policy.ts +26 -9
  219. package/src/be/script-credential-broker.ts +8 -27
  220. package/src/be/scripts/boot-reembed.ts +6 -0
  221. package/src/be/scripts/db.ts +17 -5
  222. package/src/be/scripts/embeddings.ts +6 -0
  223. package/src/be/scripts/typecheck.ts +257 -0
  224. package/src/be/seed/agent-fs-provision.ts +18 -0
  225. package/src/be/seed/schedules-seeder.ts +9 -1
  226. package/src/be/seed/workflows-seeder.ts +9 -1
  227. package/src/be/seed-scripts/index.ts +2 -0
  228. package/src/be/seed-skills/index.ts +12 -0
  229. package/src/be/swarm-config-guard.ts +1 -0
  230. package/src/be/unmapped-identities.ts +95 -1
  231. package/src/be/users.ts +19 -0
  232. package/src/bitbucket/handlers.ts +2 -0
  233. package/src/commands/onboard/agent-fs-version.ts +1 -1
  234. package/src/commands/onboard/steps/harness.tsx +1 -1
  235. package/src/commands/provider-credentials.ts +1 -0
  236. package/src/e2b/env.ts +3 -1
  237. package/src/event-waits/github.ts +43 -0
  238. package/src/event-waits/index.ts +29 -0
  239. package/src/event-waits/types.ts +51 -0
  240. package/src/extensions/contract-types.generated.ts +1 -1
  241. package/src/extensions/dispatcher.ts +9 -0
  242. package/src/fs/agent-fs-provider.ts +37 -3
  243. package/src/github/handlers.ts +3 -1
  244. package/src/github/pull-request-state.ts +34 -0
  245. package/src/gitlab/auth.ts +3 -4
  246. package/src/gitlab/handlers.ts +12 -7
  247. package/src/heartbeat/heartbeat.ts +11 -11
  248. package/src/hooks/codex-hook.ts +99 -1
  249. package/src/hooks/hook.ts +85 -11
  250. package/src/hooks/native-tool-hooks.ts +245 -0
  251. package/src/http/agent-lifecycle.ts +152 -0
  252. package/src/http/agents.ts +12 -0
  253. package/src/http/all-routes.ts +3 -0
  254. package/src/http/assets.ts +4 -3
  255. package/src/http/auth.ts +2 -1
  256. package/src/http/comb.ts +2 -2
  257. package/src/http/favorite-owner.ts +2 -2
  258. package/src/http/favorites.ts +3 -2
  259. package/src/http/fs.ts +13 -4
  260. package/src/http/index.ts +17 -0
  261. package/src/http/mcp-bridge.ts +4 -0
  262. package/src/http/object-webhooks.ts +101 -0
  263. package/src/http/objects.ts +265 -0
  264. package/src/http/operator-actor.ts +2 -1
  265. package/src/http/pages.ts +3 -3
  266. package/src/http/poll.ts +43 -12
  267. package/src/http/repos.ts +7 -6
  268. package/src/http/schedules.ts +10 -6
  269. package/src/http/script-connections.ts +2 -2
  270. package/src/http/scripts.ts +9 -0
  271. package/src/http/sessions.ts +37 -12
  272. package/src/http/skills.ts +17 -0
  273. package/src/http/task-requester.ts +2 -2
  274. package/src/http/tasks.ts +13 -3
  275. package/src/http/tool-hooks.ts +24 -2
  276. package/src/http/trackers/authorize-gate.ts +2 -2
  277. package/src/http/users.ts +136 -1
  278. package/src/http/workflow-events.ts +13 -0
  279. package/src/http/workflows.ts +47 -5
  280. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  281. package/src/linear/sync.ts +3 -1
  282. package/src/prompts/base-prompt.ts +35 -13
  283. package/src/prompts/session-templates.ts +25 -0
  284. package/src/providers/acp-targets.ts +2 -2
  285. package/src/providers/amp-adapter.ts +1 -1
  286. package/src/providers/dsh-adapter.ts +1 -1
  287. package/src/providers/opencode-adapter.ts +5 -1
  288. package/src/providers/opencode-swarm-plugin.ts +50 -1
  289. package/src/providers/pi-mono-adapter.ts +139 -9
  290. package/src/providers/pi-mono-extension.ts +69 -0
  291. package/src/providers/runtime-dependencies.ts +1 -1
  292. package/src/rbac/legacy-policy.ts +5 -0
  293. package/src/rbac/permissions.ts +16 -1
  294. package/src/scheduler/deferred-task-waits.ts +170 -13
  295. package/src/script-workflows/guest-ctx.ts +32 -0
  296. package/src/script-workflows/workflow-ctx.ts +2 -0
  297. package/src/scripts-runtime/ctx.ts +9 -1
  298. package/src/scripts-runtime/executors/native.ts +106 -21
  299. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  300. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  301. package/src/scripts-runtime/executors/types.ts +5 -0
  302. package/src/scripts-runtime/loader.ts +8 -0
  303. package/src/scripts-runtime/mcp-client.ts +4 -0
  304. package/src/scripts-runtime/sdk-allowlist.ts +101 -0
  305. package/src/scripts-runtime/swarm-config.ts +8 -0
  306. package/src/scripts-runtime/swarm-sdk.ts +55 -3
  307. package/src/scripts-runtime/types/stdlib.d.ts +310 -0
  308. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  309. package/src/scripts-runtime/types/swarm-sdk.d.ts +310 -0
  310. package/src/server.ts +52 -0
  311. package/src/slack/enrich.ts +81 -21
  312. package/src/slack/handlers.test.ts +55 -2
  313. package/src/slack/handlers.ts +38 -3
  314. package/src/slack/render-v2.ts +19 -0
  315. package/src/slack/session-mirror.ts +208 -0
  316. package/src/slack/thread-participants.ts +0 -5
  317. package/src/slack/watcher.ts +3 -0
  318. package/src/slack/work-objects.test.ts +2 -1
  319. package/src/slack/work-objects.ts +7 -2
  320. package/src/tests/agent-history.test.ts +313 -0
  321. package/src/tests/agentmail-filters.test.ts +4 -3
  322. package/src/tests/audit-agent-person.test.ts +825 -0
  323. package/src/tests/audit-updated-by.test.ts +19 -12
  324. package/src/tests/azure-devops-auth.test.ts +6 -0
  325. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  326. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  327. package/src/tests/claude-hook-output.test.ts +107 -2
  328. package/src/tests/claude-managed-setup.test.ts +1 -1
  329. package/src/tests/codex-adapter.test.ts +6 -6
  330. package/src/tests/codex-gpt6-release.test.ts +4 -4
  331. package/src/tests/credential-check.test.ts +12 -0
  332. package/src/tests/db-task-read-contract.test.ts +3 -0
  333. package/src/tests/db-task-write-contract.test.ts +3 -0
  334. package/src/tests/dsh-adapter.test.ts +1 -1
  335. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  336. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  337. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  338. package/src/tests/e2e-shards.test.ts +137 -0
  339. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  340. package/src/tests/extensions-catalog.test.ts +33 -25
  341. package/src/tests/extensions-heartbeat.test.ts +34 -0
  342. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  343. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  344. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  345. package/src/tests/gitlab-auth.test.ts +10 -0
  346. package/src/tests/heartbeat.test.ts +38 -0
  347. package/src/tests/http-api-integration.test.ts +0 -6
  348. package/src/tests/kv-storage.test.ts +3 -0
  349. package/src/tests/memory-search-reader.test.ts +258 -0
  350. package/src/tests/memory-search-stall.test.ts +197 -20
  351. package/src/tests/model-control.test.ts +4 -4
  352. package/src/tests/model-tier-resolution.test.ts +2 -2
  353. package/src/tests/multi-runtime-registration.test.ts +8 -2
  354. package/src/tests/native-tool-hooks.test.ts +188 -0
  355. package/src/tests/opencode-adapter.test.ts +11 -0
  356. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  357. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  358. package/src/tests/poll-probe-readonly.test.ts +108 -0
  359. package/src/tests/primitives-boards.test.ts +686 -0
  360. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  361. package/src/tests/primitives-objects.test.ts +248 -0
  362. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  363. package/src/tests/prompt-template-session.test.ts +3 -2
  364. package/src/tests/rbac-roles.test.ts +3 -0
  365. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  366. package/src/tests/script-connections.test.ts +4 -0
  367. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  368. package/src/tests/scripts-namespaces.test.ts +211 -0
  369. package/src/tests/secret-scrub-gate.test.ts +1 -0
  370. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  371. package/src/tests/secret-scrubber.test.ts +1 -1
  372. package/src/tests/seed-model-profiles.test.ts +1 -1
  373. package/src/tests/session-tokens.test.ts +27 -0
  374. package/src/tests/sessions-tree.test.ts +10 -2
  375. package/src/tests/sheet-engine.test.ts +58 -0
  376. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  377. package/src/tests/slack-read-boundaries.test.ts +4 -2
  378. package/src/tests/slack-thread-participants.test.ts +66 -4
  379. package/src/tests/task-start-after-commit.test.ts +82 -0
  380. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  381. package/src/tests/ui-logs-parser.test.ts +67 -0
  382. package/src/tests/workflow-retry-v2.test.ts +101 -0
  383. package/src/tests/workflow-tla-races.test.ts +29 -0
  384. package/src/tools/boards.ts +260 -0
  385. package/src/tools/defer-task.ts +154 -12
  386. package/src/tools/objects.ts +196 -0
  387. package/src/tools/repos/update-repo.ts +6 -6
  388. package/src/tools/schedules/create-schedule.ts +1 -0
  389. package/src/tools/schedules/list-schedules.ts +3 -0
  390. package/src/tools/schedules/patch-schedule.ts +12 -3
  391. package/src/tools/schedules/update-schedule.ts +12 -3
  392. package/src/tools/sheets.ts +378 -0
  393. package/src/tools/skills/skill-create.ts +6 -0
  394. package/src/tools/skills/skill-install-remote.ts +6 -0
  395. package/src/tools/skills/skill-sync-remote.ts +9 -0
  396. package/src/tools/skills/skill-update.ts +9 -1
  397. package/src/tools/slack-read.ts +10 -3
  398. package/src/tools/tool-config.ts +25 -0
  399. package/src/tools/utils.ts +15 -0
  400. package/src/tools/workflows/create-workflow.ts +20 -5
  401. package/src/tools/workflows/patch-workflow-node.ts +5 -1
  402. package/src/tools/workflows/patch-workflow.ts +9 -2
  403. package/src/tools/workflows/update-workflow.ts +27 -4
  404. package/src/types.ts +112 -12
  405. package/src/utils/sandboxed-process.ts +47 -2
  406. package/src/utils/secret-scrubber.ts +61 -6
  407. package/src/workflows/engine.ts +35 -21
  408. package/src/workflows/input.ts +36 -1
  409. package/src/workflows/patch-definition.ts +24 -2
  410. package/src/workflows/retry-poller.ts +15 -2
  411. package/src/workflows/triggers.ts +11 -6
  412. package/src/workflows/validation.ts +10 -0
  413. package/src/workflows/version.ts +7 -1
  414. package/templates/ai-toolbox.manifest.json +1 -1
  415. package/templates/skills/agent-browser/SKILL.md +1 -0
  416. package/templates/skills/agent-browser/content.md +1 -0
  417. package/templates/skills/boards-and-sheets/config.json +14 -0
  418. package/templates/skills/boards-and-sheets/content.md +163 -0
  419. package/templates/skills/pages/content.md +5 -0
  420. package/templates/skills/swarm-docs/content.md +15 -1
  421. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  422. package/templates/skills/swarm-scripts/content.md +1 -0
  423. package/templates/skills/tdd-planning/content.md +5 -2
  424. package/dist/acp-adapter-weaaxey3.js +0 -16
  425. package/dist/core-df1n049h.js +0 -39
  426. package/dist/fx-adapter-zwmps9re.js +0 -19
  427. package/dist/grok-adapter-q0avf919.js +0 -19
  428. package/dist/handlers-g5jq0e4q.js +0 -36
  429. package/dist/index-1f6m47mq.js +0 -37
  430. package/dist/index-1p1mpqda.js +0 -36
  431. package/dist/index-tnkd410q.js +0 -41
  432. package/dist/lead-m5e7xt93.js +0 -75
  433. package/dist/thread-buffer-nf55vwx3.js +0 -39
  434. package/dist/worker-ews1nyhw.js +0 -75
  435. package/src/slack/socket-mode-guard.test.ts +0 -25
  436. package/src/tests/agent-activity.test.ts +0 -247
  437. package/src/tests/agent-fs-live-url.test.ts +0 -55
  438. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  439. package/src/tests/approval-sweeps-config.test.ts +0 -47
  440. package/src/tests/cards.test.ts +0 -169
  441. package/src/tests/chat-sdk-facts.test.ts +0 -23
  442. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  443. package/src/tests/core-auth.test.ts +0 -156
  444. package/src/tests/date-utils.test.ts +0 -48
  445. package/src/tests/db-context-versions.test.ts +0 -37
  446. package/src/tests/db-runtime.test.ts +0 -132
  447. package/src/tests/enabled-capabilities.test.ts +0 -20
  448. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  449. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  450. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  451. package/src/tests/github-event-labels.test.ts +0 -24
  452. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  453. package/src/tests/http-log-scrubbing.test.ts +0 -123
  454. package/src/tests/http-semconv-attributes.test.ts +0 -92
  455. package/src/tests/identity.test.ts +0 -117
  456. package/src/tests/inbox-state.test.ts +0 -167
  457. package/src/tests/internal-ai/models.test.ts +0 -54
  458. package/src/tests/launch-password-rejection.test.ts +0 -140
  459. package/src/tests/list-total-cache.test.ts +0 -88
  460. package/src/tests/match-route.test.ts +0 -187
  461. package/src/tests/memory-feature-flags.test.ts +0 -45
  462. package/src/tests/memory-get-tool.test.ts +0 -269
  463. package/src/tests/memory-health-endpoint.test.ts +0 -78
  464. package/src/tests/memory-http-access.test.ts +0 -221
  465. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  466. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  467. package/src/tests/openai-embedding-provider.test.ts +0 -159
  468. package/src/tests/org-identity.test.ts +0 -44
  469. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  470. package/src/tests/pages-browser-sdk.test.ts +0 -76
  471. package/src/tests/pages-feedback-keys.test.ts +0 -121
  472. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  473. package/src/tests/pages-list-endpoint.test.ts +0 -148
  474. package/src/tests/pages-password-mode.test.ts +0 -266
  475. package/src/tests/pages-public-authed-401.test.ts +0 -103
  476. package/src/tests/pages-public-html.test.ts +0 -297
  477. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  478. package/src/tests/pages-view-count.test.ts +0 -245
  479. package/src/tests/prompt-templates-db.test.ts +0 -616
  480. package/src/tests/rbac-engine.test.ts +0 -742
  481. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  482. package/src/tests/route-def-find-route.test.ts +0 -192
  483. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  484. package/src/tests/schedule-validation-helper.test.ts +0 -51
  485. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  486. package/src/tests/scheduler-backoff.test.ts +0 -166
  487. package/src/tests/script-run-token.test.ts +0 -75
  488. package/src/tests/scripts-extract-signature.test.ts +0 -47
  489. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  490. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  491. package/src/tests/short-id.test.ts +0 -23
  492. package/src/tests/skill-files-http.test.ts +0 -222
  493. package/src/tests/skill-get-file-tool.test.ts +0 -110
  494. package/src/tests/skill-script-refs.test.ts +0 -63
  495. package/src/tests/skill-update-scope.test.ts +0 -252
  496. package/src/tests/skills-bundle.test.ts +0 -99
  497. package/src/tests/slack-app-icon.test.ts +0 -94
  498. package/src/tests/slack-assistant-comention.test.ts +0 -139
  499. package/src/tests/slack-delete.test.ts +0 -157
  500. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  501. package/src/tests/slack-manifest.test.ts +0 -23
  502. package/src/tests/slack-task-output.test.ts +0 -90
  503. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  504. package/src/tests/swarm-diff.test.ts +0 -728
  505. package/src/tests/task-lifecycle-events.test.ts +0 -53
  506. package/src/tests/template-asset-config.test.ts +0 -18
  507. package/src/tests/template-fetch.test.ts +0 -490
  508. package/src/tests/themes-page-theme.test.ts +0 -155
  509. package/src/tests/tool-annotations.test.ts +0 -442
  510. package/src/tests/tool-output-agent-id.test.ts +0 -202
  511. package/src/tests/update-profile-agentid.test.ts +0 -248
  512. package/src/tests/whoami-route.test.ts +0 -162
  513. package/src/tests/workflow-definition-telemetry.test.ts +0 -144
  514. package/src/tests/workflow-patch.test.ts +0 -169
  515. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  516. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  517. package/src/tests/workflow-step-claims.test.ts +0 -152
  518. package/src/tests/workflow-step-order.test.ts +0 -92
  519. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  520. package/src/tests/workflow-versions.test.ts +0 -240
  521. package/src/tests/workflow-wait.test.ts +0 -26
@@ -63,6 +63,11 @@ export type RunScriptInput = {
63
63
  apiKey?: string;
64
64
  /** Per-boot runtime identity of the invoking worker; system context, never script input. */
65
65
  runtimeInstanceId?: string;
66
+ /**
67
+ * Task the run acts for, sent as `X-Audit-Source-Task-Id` on its `ctx.swarm`
68
+ * calls so their writes get the same audit person. The api re-checks ownership.
69
+ */
70
+ sourceTaskId?: string;
66
71
  signal?: AbortSignal;
67
72
  timeoutMs?: number;
68
73
  mcpBaseUrl?: string;
@@ -109,6 +114,9 @@ async function buildConfigPayload(input: RunScriptInput): Promise<SwarmConfigPay
109
114
  ...(input.runtimeInstanceId
110
115
  ? { runtimeInstanceId: { value: input.runtimeInstanceId, isSecret: false as const } }
111
116
  : {}),
117
+ ...(input.sourceTaskId
118
+ ? { auditSourceTaskId: { value: input.sourceTaskId, isSecret: false as const } }
119
+ : {}),
112
120
  },
113
121
  user: input.userConfig ?? {},
114
122
  egressSecrets: input.egressSecrets ?? (await buildEgressSecrets()),
@@ -36,6 +36,10 @@ function headers(config: SwarmConfig): Record<string, string> {
36
36
  return {
37
37
  Authorization: `Bearer ${Redacted.value(config.apiKey)}`,
38
38
  "X-Agent-ID": Redacted.value(config.agentId),
39
+ // Audit-only header: X-Source-Task-Id would also rescope kv, parent send-task, etc.
40
+ ...(config.auditSourceTaskId
41
+ ? { "X-Audit-Source-Task-Id": Redacted.value(config.auditSourceTaskId) }
42
+ : {}),
39
43
  "Content-Type": "application/json",
40
44
  };
41
45
  }
@@ -34,6 +34,31 @@ export const SDK_TOOL_NAME_MAP = {
34
34
  room_reset: "room-reset",
35
35
  room_decode: "room-decode",
36
36
 
37
+ // ── primitive objects (also ctx.objects, see SDK_NAMESPACES) ──
38
+ objects_create: "object-create",
39
+ objects_get: "object-get",
40
+ objects_list: "object-list",
41
+ objects_reindex: "object-reindex",
42
+
43
+ // ── sheets (also ctx.sheets, see SDK_NAMESPACES) ──
44
+ sheets_create: "sheet-create",
45
+ sheets_get: "sheet-get",
46
+ sheets_list: "sheet-list",
47
+ sheets_getRange: "sheet-get-range",
48
+ sheets_setRange: "sheet-set-range",
49
+ sheets_appendRows: "sheet-append-rows",
50
+ sheets_clearRange: "sheet-clear-range",
51
+ sheets_addTab: "sheet-add-tab",
52
+ sheets_importXlsx: "sheet-import-xlsx",
53
+ sheets_exportXlsx: "sheet-export-xlsx",
54
+ // ── boards (also ctx.boards, see SDK_NAMESPACES) ──
55
+ boards_create: "board-create",
56
+ boards_get: "board-get",
57
+ boards_list: "board-list",
58
+ boards_addElements: "board-add-elements",
59
+ boards_updateElements: "board-update-elements",
60
+ boards_removeElements: "board-remove-elements",
61
+
37
62
  // ── repos ──
38
63
  repo_list: "get-repos",
39
64
  repo_update: "update-repo",
@@ -233,3 +258,79 @@ export function isMcpToolAllowedForScripts(mcpToolName: string): boolean {
233
258
  export function mcpToolNameForSdkMethod(name: string): string {
234
259
  return SDK_TOOL_NAME_MAP[name as keyof typeof SDK_TOOL_NAME_MAP] ?? name;
235
260
  }
261
+
262
+ /** `{ ns: methods }`: `ctx.<ns>.<m>(args)` calls SDK method `<ns>_<m>` and returns its unwrapped result. */
263
+ export type SdkNamespaceRegistry = Readonly<Record<string, readonly string[]>>;
264
+
265
+ /**
266
+ * Tool groups exposed as top-level `ctx.<ns>` namespaces in native and QuickJS
267
+ * scripts and in script workflows. A new entry also needs its `<ns>_<m>`
268
+ * methods in SDK_TOOL_NAME_MAP and a typed key on `ScriptContext` in
269
+ * `src/be/scripts/typecheck.ts`.
270
+ */
271
+ export const SDK_NAMESPACES: SdkNamespaceRegistry = Object.freeze({
272
+ objects: ["create", "get", "list", "reindex"],
273
+ sheets: [
274
+ "create",
275
+ "get",
276
+ "list",
277
+ "getRange",
278
+ "setRange",
279
+ "appendRows",
280
+ "clearRange",
281
+ "addTab",
282
+ "importXlsx",
283
+ "exportXlsx",
284
+ ],
285
+ boards: ["create", "get", "list", "addElements", "updateElements", "removeElements"],
286
+ });
287
+
288
+ /** ctx keys a namespace may never shadow. */
289
+ export const RESERVED_CTX_KEYS: readonly string[] = [
290
+ "swarm",
291
+ "api",
292
+ "mcp",
293
+ "fs",
294
+ "sh",
295
+ "stdlib",
296
+ "logger",
297
+ "run",
298
+ "step",
299
+ "config",
300
+ ];
301
+
302
+ const NAMESPACE_NAME = /^[a-z][a-zA-Z]*$/;
303
+
304
+ export function sdkMethodForNamespace(ns: string, method: string): string {
305
+ return `${ns}_${method}`;
306
+ }
307
+
308
+ /** Throws unless every namespace is unreserved, well-named and maps to allowlisted SDK methods. */
309
+ export function assertNamespaces(registry: SdkNamespaceRegistry): void {
310
+ for (const [ns, methods] of Object.entries(registry)) {
311
+ if (!NAMESPACE_NAME.test(ns)) throw new Error(`SDK namespace '${ns}' has an invalid name`);
312
+ if (RESERVED_CTX_KEYS.includes(ns)) throw new Error(`SDK namespace '${ns}' is reserved`);
313
+ for (const method of methods) {
314
+ if (!NAMESPACE_NAME.test(method)) {
315
+ throw new Error(`SDK namespace method '${ns}.${method}' has an invalid name`);
316
+ }
317
+ const sdkMethod = sdkMethodForNamespace(ns, method);
318
+ if (!Object.hasOwn(SDK_TOOL_NAME_MAP, sdkMethod)) {
319
+ throw new Error(
320
+ `SDK namespace method '${ns}.${method}' needs '${sdkMethod}' in SDK_TOOL_NAME_MAP`,
321
+ );
322
+ }
323
+ }
324
+ }
325
+ }
326
+
327
+ /** A tool's structured payload as a namespace returns it: throws on a refusal, else drops `success`. */
328
+ export function unwrapToolPayload(label: string, payload: unknown): unknown {
329
+ if (payload === null || typeof payload !== "object" || Array.isArray(payload)) return payload;
330
+ const { success, ...rest } = payload as Record<string, unknown>;
331
+ if (success === false) {
332
+ const reason = typeof rest.message === "string" ? rest.message : "tool refused the call";
333
+ throw new Error(`${label} failed: ${reason}`);
334
+ }
335
+ return rest;
336
+ }
@@ -7,6 +7,8 @@ export class SwarmConfig {
7
7
  readonly mcpBaseUrl: RedactedValue<string>;
8
8
  /** Per-boot runtime identity of the invoking worker; system context, never script input. */
9
9
  readonly runtimeInstanceId: RedactedValue<string> | undefined;
10
+ /** Task the run acts for; system context, sent as `X-Audit-Source-Task-Id`. */
11
+ readonly auditSourceTaskId: RedactedValue<string> | undefined;
10
12
  /** Per-process extension bridge secret; present only for in-process extension SDKs. */
11
13
  readonly extensionToken: RedactedValue<string> | undefined;
12
14
 
@@ -31,6 +33,12 @@ export class SwarmConfig {
31
33
  isSecret: payload.system.runtimeInstanceId.isSecret,
32
34
  })
33
35
  : undefined;
36
+ this.auditSourceTaskId = payload.system.auditSourceTaskId
37
+ ? Redacted.make(payload.system.auditSourceTaskId.value, {
38
+ type: "system",
39
+ isSecret: payload.system.auditSourceTaskId.isSecret,
40
+ })
41
+ : undefined;
34
42
  this.extensionToken = payload.system.extensionToken
35
43
  ? Redacted.make(payload.system.extensionToken.value, {
36
44
  type: "system",
@@ -1,7 +1,15 @@
1
1
  import { scrubObject } from "../utils/secret-scrubber";
2
2
  import { Redacted } from "./redacted";
3
3
  import { readScriptSdkJsonResponse } from "./response-limit";
4
- import { isSdkToolAllowed, mcpToolNameForSdkMethod } from "./sdk-allowlist";
4
+ import {
5
+ assertNamespaces,
6
+ isSdkToolAllowed,
7
+ mcpToolNameForSdkMethod,
8
+ SDK_NAMESPACES,
9
+ type SdkNamespaceRegistry,
10
+ sdkMethodForNamespace,
11
+ unwrapToolPayload,
12
+ } from "./sdk-allowlist";
5
13
  import { backoffMs, retryAfterMs } from "./stdlib/retry";
6
14
  import type { SwarmConfig } from "./swarm-config";
7
15
 
@@ -22,6 +30,10 @@ function headers(config: SwarmConfig): Record<string, string> {
22
30
  ...(config.runtimeInstanceId
23
31
  ? { "X-Runtime-Instance-ID": Redacted.value(config.runtimeInstanceId) }
24
32
  : {}),
33
+ // Audit-only header: X-Source-Task-Id would also rescope kv, parent send-task, etc.
34
+ ...(config.auditSourceTaskId
35
+ ? { "X-Audit-Source-Task-Id": Redacted.value(config.auditSourceTaskId) }
36
+ : {}),
25
37
  ...(config.extensionToken
26
38
  ? { "X-Extension-Token": Redacted.value(config.extensionToken) }
27
39
  : {}),
@@ -491,8 +503,8 @@ const READ_RETRY_STATUSES = new Set([502, 503, 504]);
491
503
 
492
504
  // MCP tool names that only read. Prefix/suffix rules cover get-* / list-* /
493
505
  // *-get / *-list / *-search; the set lists the rest. A tool missing here is
494
- // treated as a write, which is the safe default. tool-annotations.test.ts
495
- // fails when a tool annotated `readOnlyHint: true` is missing here.
506
+ // treated as a write, which is the safe default. Nothing checks this list
507
+ // against `readOnlyHint` annotations; add a read-only tool here by hand.
496
508
  // read-messages may mark messages read; repeating that is harmless.
497
509
  const READ_TOOL_PATTERN = /^(get|list)-|-(get|list|search)$/;
498
510
  const READ_TOOLS = new Set([
@@ -517,6 +529,7 @@ const READ_TOOLS = new Set([
517
529
  "app-query",
518
530
  "resolve-user",
519
531
  "room-decode",
532
+ "sheet-get-range",
520
533
  "read-messages",
521
534
  "check-model-profile",
522
535
  "preview-prompt-template",
@@ -766,3 +779,42 @@ export function createSwarmSdk(
766
779
  },
767
780
  }) as RuntimeSwarmSdk;
768
781
  }
782
+
783
+ export type SdkNamespaceClient = Readonly<Record<string, (args?: unknown) => Promise<unknown>>>;
784
+
785
+ /**
786
+ * One frozen client per registered namespace. `ctx.<ns>.<m>(args)` calls SDK
787
+ * method `<ns>_<m>`, throws on a non-2xx or a tool refusal, and returns the
788
+ * tool payload without `success` (flat `ctx.swarm.<ns>_<m>` keeps the envelope).
789
+ */
790
+ export function createNamespaceClients(
791
+ config: SwarmConfig,
792
+ options: { signal?: AbortSignal; registry?: SdkNamespaceRegistry } = {},
793
+ ): Readonly<Record<string, SdkNamespaceClient>> {
794
+ const { signal, registry = SDK_NAMESPACES } = options;
795
+ assertNamespaces(registry);
796
+ const call = (ns: string, method: string) => async (args?: unknown) => {
797
+ const label = `ctx.${ns}.${method}`;
798
+ const result = (await callTool(sdkMethodForNamespace(ns, method), args, config, signal)) as {
799
+ success: boolean;
800
+ status: number;
801
+ data: unknown;
802
+ };
803
+ const data = result.data as { success?: unknown; error?: unknown } | null;
804
+ // A tool refusal is a 200 with `data.success === false`: unwrapToolPayload throws its message.
805
+ if (!result.success && data?.success !== false) {
806
+ const reason =
807
+ data && typeof data === "object" && "error" in data ? String(data.error) : "api failed";
808
+ throw new Error(`${label} failed with ${result.status}: ${reason}`);
809
+ }
810
+ return unwrapToolPayload(label, result.data);
811
+ };
812
+ return Object.freeze(
813
+ Object.fromEntries(
814
+ Object.entries(registry).map(([ns, methods]) => [
815
+ ns,
816
+ Object.freeze(Object.fromEntries(methods.map((method) => [method, call(ns, method)]))),
817
+ ]),
818
+ ),
819
+ );
820
+ }
@@ -216,6 +216,277 @@ declare module "swarm-sdk" {
216
216
  state: unknown;
217
217
  }
218
218
 
219
+ export type PrimitiveObjectKind = "board" | "sheet";
220
+
221
+ export interface PrimitiveObject {
222
+ id: string;
223
+ kind: PrimitiveObjectKind;
224
+ orgId: string;
225
+ driveId: string;
226
+ /** agent-fs path, no leading slash. */
227
+ path: string;
228
+ title: string | null;
229
+ fileVersion: number | null;
230
+ ownerAgentId: string | null;
231
+ /** Set when agent-fs reported the file deleted. */
232
+ deletedAt: string | null;
233
+ createdAt: string;
234
+ updatedAt: string;
235
+ /** Live app link to the file. */
236
+ link: string | null;
237
+ }
238
+
239
+ export interface PrimitiveReindexReport {
240
+ scanned: number;
241
+ /** Files whose version matched the index: checked, not re-read. */
242
+ unchanged: number;
243
+ adopted: string[];
244
+ restored: string[];
245
+ missing: string[];
246
+ conflicts: Array<{ path: string; reason: string }>;
247
+ /** More files remain (at most 50 reads, 16 MiB or 20 s per call): run again. */
248
+ truncated: boolean;
249
+ /** Which limit cut this call short; null when the pass finished. */
250
+ cutBy: "files" | "reads" | "time" | "bytes" | null;
251
+ /** True when nothing was written: `adopted` and `restored` list what a real run would change. */
252
+ dryRun: boolean;
253
+ }
254
+
255
+ /** `prefix`: only paths that start with it (as in `list`); without it every id-less file on the drive gets an id. `dryRun`: report, write nothing. */
256
+ export type PrimitiveReindexArgs = {
257
+ kind?: PrimitiveObjectKind;
258
+ prefix?: string;
259
+ dryRun?: boolean;
260
+ };
261
+
262
+ /**
263
+ * Primitive objects: agent-fs files on your default drive with a stable id.
264
+ * Calls run as your own agent-fs identity. Each method throws on a refusal.
265
+ */
266
+ export interface ObjectsNamespace {
267
+ /** Create-only. `board` writes an empty Excalidraw scene; the path must end in `.excalidraw`. */
268
+ create(args: {
269
+ kind: PrimitiveObjectKind;
270
+ path: string;
271
+ title?: string;
272
+ }): Promise<{ message: string; object: PrimitiveObject }>;
273
+ get(args: {
274
+ id?: string;
275
+ path?: string;
276
+ includeContent?: boolean;
277
+ }): Promise<{ message: string; object: PrimitiveObject; missing: boolean; content?: unknown }>;
278
+ list(args?: {
279
+ kind?: PrimitiveObjectKind;
280
+ prefix?: string;
281
+ limit?: number;
282
+ offset?: number;
283
+ }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
284
+ /** Rebuild the index from the drive. Ids survive; rows whose file is gone are reported, not deleted. */
285
+ reindex(args?: PrimitiveReindexArgs): Promise<{ message: string } & PrimitiveReindexReport>;
286
+ }
287
+
288
+ /** A spreadsheet cell value. A string starting with `=` is a formula; null clears the cell. */
289
+ export type SheetCellInput = number | string | boolean | null;
290
+
291
+ /** Identify the sheet by `id` or `path`. */
292
+ export interface SheetRef {
293
+ id?: string;
294
+ path?: string;
295
+ }
296
+
297
+ export interface SheetRangeArgs extends SheetRef {
298
+ /** A1 range: `Tasks!B2:C3`, `B2`, or a whole column `'My tab'!A:A` (capped to the used range). */
299
+ range: string;
300
+ }
301
+
302
+ export interface SheetCreateArgs {
303
+ /** Create-only; must end in `.sheet.json`. Default is one tab `Sheet1`; `rows` seed a tab from A1. */
304
+ path: string;
305
+ title?: string;
306
+ tabs?: Array<{ name: string; rows?: SheetCellInput[][] }>;
307
+ }
308
+
309
+ export interface SheetTabSummary {
310
+ name: string;
311
+ rows: number;
312
+ cols: number;
313
+ freezeRows: number;
314
+ }
315
+
316
+ export interface SheetImportXlsxArgs {
317
+ /** An `.xlsx` on the drive. */
318
+ sourcePath: string;
319
+ /** The new sheet; must end in `.sheet.json`. */
320
+ path: string;
321
+ title?: string;
322
+ }
323
+
324
+ export interface SheetImportXlsxResult {
325
+ message: string;
326
+ object: PrimitiveObject;
327
+ link: string | null;
328
+ /** What the file had that a sheet cannot hold. */
329
+ dropped: string[];
330
+ }
331
+
332
+ export interface SheetExportXlsxArgs extends SheetRef {
333
+ targetPath: string;
334
+ /** Replace `targetPath` when it exists. */
335
+ overwrite?: boolean;
336
+ }
337
+
338
+ export interface SheetExportXlsxResult {
339
+ message: string;
340
+ path: string;
341
+ link: string | null;
342
+ /** What the sheet had that xlsx cannot carry. */
343
+ dropped: string[];
344
+ }
345
+
346
+ export interface SheetResult {
347
+ message: string;
348
+ /** agent-fs version after the call. */
349
+ version: number;
350
+ }
351
+
352
+ /**
353
+ * Sheets: `swarm-sheet/1` workbooks on your default agent-fs drive, recomputed by a spreadsheet engine.
354
+ * Writes retry on a concurrent edit, then throw. Each method throws on a refusal.
355
+ */
356
+ export interface SheetsNamespace {
357
+ create(
358
+ args: SheetCreateArgs,
359
+ ): Promise<{ message: string; object: PrimitiveObject; link: string | null }>;
360
+ get(
361
+ args: SheetRef,
362
+ ): Promise<SheetResult & { object: PrimitiveObject; tabs: SheetTabSummary[] }>;
363
+ list(args?: {
364
+ prefix?: string;
365
+ limit?: number;
366
+ offset?: number;
367
+ }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
368
+ /** Cached values (at most 10,000 cells). `formulas: true` also returns formula text. */
369
+ getRange(
370
+ args: SheetRangeArgs & { formulas?: boolean },
371
+ ): Promise<
372
+ SheetResult & { range: string; values: SheetCellInput[][]; formulas?: SheetCellInput[][] }
373
+ >;
374
+ /** A single-cell `range` is the top-left corner; a larger one must match `values`. `'=` stores literal text beginning with `=`. */
375
+ setRange(
376
+ args: SheetRangeArgs & { values: SheetCellInput[][] },
377
+ ): Promise<SheetResult & { range: string; changed: number; recalculated: number }>;
378
+ appendRows(
379
+ args: SheetRef & { tab: string; rows: SheetCellInput[][] },
380
+ ): Promise<SheetResult & { range: string }>;
381
+ clearRange(args: SheetRangeArgs): Promise<SheetResult & { range: string; cleared: number }>;
382
+ addTab(
383
+ args: SheetRef & { name: string; after?: string },
384
+ ): Promise<SheetResult & { tabs: string[] }>;
385
+ /** Create-only. Reads an `.xlsx` on the drive. `dropped` names what a sheet cannot hold (styles, charts, comments, frozen panes, ...). Limits: 5 MiB, 20 tabs, 50,000 cells. */
386
+ importXlsx(args: SheetImportXlsxArgs): Promise<SheetImportXlsxResult>;
387
+ /** Create-only unless `overwrite`. `targetPath` must end in `.xlsx`. `dropped` names what xlsx cannot carry (frozen panes, spilled array cells). */
388
+ exportXlsx(args: SheetExportXlsxArgs): Promise<SheetExportXlsxResult>;
389
+ }
390
+
391
+ /** Palette names (Excalidraw's open-color) or a #rrggbb background. */
392
+ export type BoardColor =
393
+ | "blue"
394
+ | "green"
395
+ | "yellow"
396
+ | "red"
397
+ | "violet"
398
+ | "orange"
399
+ | "gray"
400
+ | "teal"
401
+ | (string & {});
402
+
403
+ export interface BoardShape {
404
+ /** Your name for the shape, so arrows in the same call can point at it. */
405
+ key?: string;
406
+ type: "rectangle" | "ellipse" | "diamond" | "text";
407
+ x?: number;
408
+ y?: number;
409
+ /** Minimum size; a shape grows to fit its label. */
410
+ width?: number;
411
+ height?: number;
412
+ /** Text inside the shape; required for `text`. */
413
+ label?: string;
414
+ color?: BoardColor;
415
+ }
416
+
417
+ /** `from` / `to`: a shape key from the same call or an existing element id. */
418
+ export interface BoardArrow {
419
+ from: string;
420
+ to: string;
421
+ label?: string;
422
+ }
423
+
424
+ export interface BoardElementPatch {
425
+ elementId: string;
426
+ /** An empty string removes a shape's label. */
427
+ label?: string;
428
+ x?: number;
429
+ y?: number;
430
+ width?: number;
431
+ height?: number;
432
+ color?: BoardColor;
433
+ }
434
+
435
+ export interface BoardElementSummary {
436
+ id: string;
437
+ type: string;
438
+ /** Free text, or a shape's label; null when it has none. */
439
+ text: string | null;
440
+ x: number;
441
+ y: number;
442
+ width: number;
443
+ height: number;
444
+ /** Arrow: [from, to] element ids (null when unbound). Shape: ids of its bound arrows. */
445
+ boundTo: Array<string | null>;
446
+ }
447
+
448
+ export type BoardLayout = "row" | "column" | "grid";
449
+ export type BoardRef = { id: string; path?: string } | { id?: string; path: string };
450
+
451
+ /** What a board call returns besides its own fields. */
452
+ export interface BoardResult {
453
+ message: string;
454
+ object: PrimitiveObject;
455
+ version: number | null;
456
+ }
457
+ export type BoardAdded = BoardResult & { added: Record<string, string> };
458
+ export type BoardElements<E> = BoardResult & { elements: E[] };
459
+ export interface BoardAddArgs {
460
+ shapes?: BoardShape[];
461
+ arrows?: BoardArrow[];
462
+ /** How shapes without x/y are placed, below existing content. Default `row`. */
463
+ layout?: BoardLayout;
464
+ }
465
+ export type BoardCreateArgs = BoardAddArgs & { path: string; title?: string };
466
+ export type BoardPatchArgs = BoardRef & { patches: BoardElementPatch[] };
467
+ export type BoardRemoveArgs = BoardRef & { elementIds: string[] };
468
+ export type BoardListArgs = { prefix?: string; limit?: number; offset?: number };
469
+ export type BoardList = { message: string; objects: PrimitiveObject[]; total: number };
470
+
471
+ /**
472
+ * Excalidraw boards (`.excalidraw`) on your default agent-fs drive, edited as
473
+ * element JSON. Writes guard on the file version and re-apply on a concurrent
474
+ * change. Each method throws on a refusal.
475
+ */
476
+ export interface BoardsNamespace {
477
+ /** Create-only. `added` maps each shape key (or `shapes[i]`) and `arrows[i]` to its element id. */
478
+ create(args: BoardCreateArgs): Promise<BoardAdded>;
479
+ get(args: BoardRef & { detail?: "summary" }): Promise<BoardElements<BoardElementSummary>>;
480
+ /** Raw Excalidraw elements (live only) instead of summaries. */
481
+ get(args: BoardRef & { detail: "full" }): Promise<BoardElements<Record<string, unknown>>>;
482
+ list(args?: BoardListArgs): Promise<BoardList>;
483
+ /** Arrows bind both ends to shapes. */
484
+ addElements(args: BoardRef & BoardAddArgs): Promise<BoardAdded>;
485
+ updateElements(args: BoardPatchArgs): Promise<BoardResult & { updated: string[] }>;
486
+ /** Sets `isDeleted: true`; a shape takes its label with it and unbinds its arrows. */
487
+ removeElements(args: BoardRemoveArgs): Promise<BoardResult & { removed: string[] }>;
488
+ }
489
+
219
490
  export interface SwarmSdk {
220
491
  // --- memory ---
221
492
  memory_search(args: {
@@ -307,6 +578,38 @@ declare module "swarm-sdk" {
307
578
  state?: unknown;
308
579
  }): Promise<unknown>;
309
580
  room_decode(args: { value: unknown }): Promise<unknown>;
581
+ // --- primitive objects (prefer ctx.objects.*, which unwraps and throws) ---
582
+ objects_create(args: {
583
+ kind: PrimitiveObjectKind;
584
+ path: string;
585
+ title?: string;
586
+ }): Promise<unknown>;
587
+ objects_get(args: { id?: string; path?: string; includeContent?: boolean }): Promise<unknown>;
588
+ objects_list(args?: {
589
+ kind?: PrimitiveObjectKind;
590
+ prefix?: string;
591
+ limit?: number;
592
+ offset?: number;
593
+ }): Promise<unknown>;
594
+ objects_reindex(args?: PrimitiveReindexArgs): Promise<unknown>;
595
+ // --- sheets (prefer ctx.sheets.*, which unwraps and throws) ---
596
+ sheets_create(args: SheetCreateArgs): Promise<unknown>;
597
+ sheets_get(args: SheetRef): Promise<unknown>;
598
+ sheets_list(args?: { prefix?: string; limit?: number; offset?: number }): Promise<unknown>;
599
+ sheets_getRange(args: SheetRangeArgs & { formulas?: boolean }): Promise<unknown>;
600
+ sheets_setRange(args: SheetRangeArgs & { values: SheetCellInput[][] }): Promise<unknown>;
601
+ sheets_appendRows(args: SheetRef & { tab: string; rows: SheetCellInput[][] }): Promise<unknown>;
602
+ sheets_clearRange(args: SheetRangeArgs): Promise<unknown>;
603
+ sheets_addTab(args: SheetRef & { name: string; after?: string }): Promise<unknown>;
604
+ sheets_importXlsx(args: SheetImportXlsxArgs): Promise<unknown>;
605
+ sheets_exportXlsx(args: SheetExportXlsxArgs): Promise<unknown>;
606
+ // --- boards (prefer ctx.boards.*, which unwraps and throws) ---
607
+ boards_create(args: BoardCreateArgs): Promise<unknown>;
608
+ boards_get(args: BoardRef & { detail?: "summary" | "full" }): Promise<unknown>;
609
+ boards_list(args?: BoardListArgs): Promise<unknown>;
610
+ boards_addElements(args: BoardRef & BoardAddArgs): Promise<unknown>;
611
+ boards_updateElements(args: BoardPatchArgs): Promise<unknown>;
612
+ boards_removeElements(args: BoardRemoveArgs): Promise<unknown>;
310
613
  // --- repos ---
311
614
  repo_list(args?: Record<string, unknown>): Promise<unknown>;
312
615
  // --- schedules ---
@@ -955,6 +1258,13 @@ declare module "swarm-sdk" {
955
1258
  sh(command: string, options?: ScriptShOptions): Promise<ScriptShResult>;
956
1259
  stdlib: ScriptStdlib;
957
1260
  logger: ScriptLogger;
1261
+ // Each SDK_NAMESPACES entry (src/scripts-runtime/sdk-allowlist.ts) needs a typed `<ns>` key here.
1262
+ /** Primitive objects on your default agent-fs drive (object-* tools). */
1263
+ objects: ObjectsNamespace;
1264
+ /** Sheets on your default agent-fs drive (sheet-* tools). */
1265
+ sheets: SheetsNamespace;
1266
+ /** Excalidraw boards on your default agent-fs drive (board-* tools). */
1267
+ boards: BoardsNamespace;
958
1268
  }
959
1269
 
960
1270
  /**
@@ -351,6 +351,7 @@ declare module "swarm-extension" {
351
351
  agentId: string | undefined;
352
352
  runtimeInstanceId: string | undefined;
353
353
  sourceTaskId: string | undefined;
354
+ auditSourceTaskId: string | undefined;
354
355
  contextKey: string | undefined;
355
356
  callOrigin: "mcp" | "native" | "extension" | "script-sdk";
356
357
  harness?: string | undefined;