@desplega.ai/agent-swarm 2.11.0 → 2.12.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 (382) hide show
  1. package/dist/acp-adapter-11m13kx4.js +16 -0
  2. package/dist/{acp-targets-5wyy2b9m.js → acp-targets-311gcyvw.js} +9 -9
  3. package/dist/{actions-4nxq386s.js → actions-c4chgxp6.js} +24 -22
  4. package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-0b9awm5n.js} +10 -5
  5. package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-r0veq6x5.js} +3 -3
  6. package/dist/{app-kyqt8ehw.js → app-hn5fftf5.js} +5 -5
  7. package/dist/{approval-notifications-a0db0esw.js → approval-notifications-3g6yc8nv.js} +7 -7
  8. package/dist/{assistant-9g5jzq25.js → assistant-cpjgpjvp.js} +24 -22
  9. package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-hce1av1h.js} +1 -1
  10. package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-bztbxc4z.js} +1 -1
  11. package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-d7xcym0j.js} +1 -1
  12. package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-mkmm16gk.js} +2 -2
  13. package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-arrkbe8t.js} +4 -4
  14. package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
  15. package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-ykpyr5p8.js} +8 -8
  16. package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-ssg6z4bt.js} +4 -4
  17. package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-trd59v7b.js} +4 -4
  18. package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-yjcze0j1.js} +10 -10
  19. package/dist/{cli-2gvdvsxj.js → cli-01tvvtad.js} +63 -60
  20. package/dist/{cli-rhsc2zyx.js → cli-04zc3f7b.js} +1 -1
  21. package/dist/{cli-p1a4khta.js → cli-0k1a0sde.js} +6 -6
  22. package/dist/{cli-atm0hkes.js → cli-0pp1yjg2.js} +4 -4
  23. package/dist/{cli-0b4zam62.js → cli-0vcqcwfn.js} +18 -0
  24. package/dist/{cli-zhn4r1rz.js → cli-12vek61e.js} +72 -49
  25. package/dist/{cli-j2r1apqm.js → cli-1htmtqc2.js} +45 -44
  26. package/dist/{cli-a6q6x15h.js → cli-2amwhyv2.js} +8 -5
  27. package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
  28. package/dist/{cli-a02habn6.js → cli-2tw284hj.js} +2 -2
  29. package/dist/{cli-nc39ym5q.js → cli-39qm0rtm.js} +6 -6
  30. package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
  31. package/dist/cli-52nfye5j.js +673 -0
  32. package/dist/cli-55tc8cj4.js +252 -0
  33. package/dist/cli-5r95eqbh.js +186 -0
  34. package/dist/{cli-892y3vfp.js → cli-5tg94mdw.js} +7 -7
  35. package/dist/{cli-ynph3b70.js → cli-5x03v6en.js} +8 -8
  36. package/dist/{cli-1h4njv9y.js → cli-5z0g0e8v.js} +11 -2
  37. package/dist/{cli-6a3j25xd.js → cli-72yms3ey.js} +16 -16
  38. package/dist/{cli-h2qtafm4.js → cli-73q4g5nx.js} +17 -17
  39. package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
  40. package/dist/{cli-9g12h1aq.js → cli-7yn42w6m.js} +1 -1
  41. package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
  42. package/dist/{cli-4aswccje.js → cli-9qe5y107.js} +2 -2
  43. package/dist/{cli-7cp6aa1q.js → cli-9y4tgrkf.js} +23 -177
  44. package/dist/{cli-mhrr4d5b.js → cli-agjbj5x0.js} +1 -1
  45. package/dist/{cli-hnh8erra.js → cli-b93d81yg.js} +2 -2
  46. package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
  47. package/dist/{cli-b82a13ga.js → cli-bp6k9acz.js} +17 -21
  48. package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
  49. package/dist/{cli-t2s7j5cy.js → cli-bz97ff9n.js} +2 -2
  50. package/dist/{cli-0bgj4rh5.js → cli-c7j31hq9.js} +3 -3
  51. package/dist/{cli-p8zqbbt1.js → cli-cah298e5.js} +1 -1
  52. package/dist/{cli-9knhkkgr.js → cli-cjqyse9q.js} +3 -3
  53. package/dist/{cli-tb4j757d.js → cli-dkvtfgn4.js} +6 -6
  54. package/dist/{cli-14xdms9a.js → cli-e3ahxq5y.js} +6 -6
  55. package/dist/{cli-6n7y5ypy.js → cli-e8n0hdzd.js} +1 -1
  56. package/dist/{cli-q71g5q39.js → cli-en6dmkxd.js} +3 -3
  57. package/dist/{cli-xqbqwpxr.js → cli-eq4kew31.js} +9 -9
  58. package/dist/{cli-4kzp7r0q.js → cli-eqq0hwvx.js} +3 -3
  59. package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
  60. package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
  61. package/dist/{cli-bq97k63w.js → cli-fxd1mwtr.js} +2 -2
  62. package/dist/{cli-kbm659dk.js → cli-fy4gb74g.js} +2 -2
  63. package/dist/{cli-djt6wmrc.js → cli-fyaq4zdv.js} +6 -6
  64. package/dist/{cli-raqw9fw9.js → cli-gfy6hbd9.js} +6 -6
  65. package/dist/{cli-s9twe4x0.js → cli-h70a2mxy.js} +13 -8
  66. package/dist/cli-hbvgzjq4.js +69 -0
  67. package/dist/{cli-vy3fn0mz.js → cli-hhc47ack.js} +4 -4
  68. package/dist/{cli-m00c47q6.js → cli-j5gtytvg.js} +54 -24
  69. package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
  70. package/dist/{cli-yzxqwcvq.js → cli-k5jx8jya.js} +10 -3
  71. package/dist/{cli-rytq7dm2.js → cli-krbcr00p.js} +3 -3
  72. package/dist/{cli-453497a0.js → cli-kwr5qv5g.js} +2 -2
  73. package/dist/{cli-czvvnfr9.js → cli-m5qtmrbc.js} +2 -2
  74. package/dist/{cli-cstggwq7.js → cli-ma9ys8rt.js} +2 -2
  75. package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
  76. package/dist/{cli-wz4e5am2.js → cli-mcymtvwn.js} +320 -70
  77. package/dist/{cli-2aacfdcn.js → cli-mq2fbgva.js} +64 -3
  78. package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
  79. package/dist/{cli-k4r5sfaj.js → cli-n8f0fs3c.js} +4 -4
  80. package/dist/{cli-f8yhybxr.js → cli-nja15knq.js} +3 -3
  81. package/dist/{cli-6tvh1fwq.js → cli-pe3yxedk.js} +3 -3
  82. package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
  83. package/dist/{cli-n6ygvrrm.js → cli-q2dywc8h.js} +4 -4
  84. package/dist/{cli-8zmpwe79.js → cli-q8tc22bj.js} +5 -5
  85. package/dist/{cli-yvzxbztc.js → cli-r0mz92by.js} +2 -2
  86. package/dist/{cli-v3zcnr8g.js → cli-r14ac1y0.js} +1 -1
  87. package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
  88. package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
  89. package/dist/{cli-27fat7st.js → cli-sv2r3bw8.js} +7 -7
  90. package/dist/{cli-zb1hff00.js → cli-t75xngj1.js} +9 -9
  91. package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
  92. package/dist/{cli-5ptj757f.js → cli-tm60vtax.js} +1 -1
  93. package/dist/{cli-rpmw4fsv.js → cli-v9ya390t.js} +12 -12
  94. package/dist/{cli-075ccjh6.js → cli-wvjqaqcp.js} +2607 -65
  95. package/dist/{cli-2jtfm8kh.js → cli-xf4z5bdn.js} +4 -4
  96. package/dist/{cli-4g323fjh.js → cli-xm34qj8m.js} +2 -2
  97. package/dist/{cli-f7dhm7hh.js → cli-ya3kf4gs.js} +1 -1
  98. package/dist/{cli-rwgwen5v.js → cli-yegz2g06.js} +4 -4
  99. package/dist/{cli-nbakg5xh.js → cli-yfpc6qy9.js} +3 -3
  100. package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
  101. package/dist/cli.js +24 -21
  102. package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-wc6e4wct.js} +8 -8
  103. package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
  104. package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ppfgjd97.js} +9 -9
  105. package/dist/{commands-ctey7tr5.js → commands-tsv2vx5b.js} +3 -3
  106. package/dist/{controller-rqhbppg9.js → controller-ye4sdwsy.js} +4 -4
  107. package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-zn4dg69h.js} +25 -23
  108. package/dist/core-dxcy02sc.js +41 -0
  109. package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-q2g9vwts.js} +2 -2
  110. package/dist/{db-2ah39cyx.js → db-3r1fyr2n.js} +6 -2
  111. package/dist/{db-p5drc1d1.js → db-g111qn9j.js} +3 -3
  112. package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
  113. package/dist/{dispatcher-x6w14pde.js → dispatcher-4q8s0mx8.js} +22 -20
  114. package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
  115. package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-mmcw1z5s.js} +2 -2
  116. package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
  117. package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
  118. package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-04ke6hcp.js} +1 -1
  119. package/dist/{embedding-space-z6ptw3jk.js → embedding-space-kcdn52vz.js} +6 -6
  120. package/dist/{embeddings-0sxb1d2h.js → embeddings-jnzcd91a.js} +1 -1
  121. package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
  122. package/dist/{execute-6m1ex8ce.js → execute-74amghty.js} +1 -1
  123. package/dist/{external-channel-ezer7pk0.js → external-channel-v9zgxnxz.js} +2 -2
  124. package/dist/fx-adapter-0ar6pqm3.js +19 -0
  125. package/dist/grok-adapter-t6m74fb1.js +19 -0
  126. package/dist/handlers-9kwcrc4k.js +38 -0
  127. package/dist/{heartbeat-6c4fr49t.js → heartbeat-p8pk1msj.js} +25 -23
  128. package/dist/{hook-t1c5avbv.js → hook-k1h73zd7.js} +5 -5
  129. package/dist/{hook-02rt5tvq.js → hook-p5reemds.js} +7 -7
  130. package/dist/{http-qa3h32a1.js → http-ms1z5xxy.js} +565 -141
  131. package/dist/index-23cdfzr6.js +39 -0
  132. package/dist/{index-kqv9ebfj.js → index-76zzxtzf.js} +1 -1
  133. package/dist/{index-e42j998x.js → index-fbkqhvvj.js} +38 -19
  134. package/dist/index-g7kkjs5b.js +38 -0
  135. package/dist/{index-qpjk2hxk.js → index-gjn6qfgn.js} +1 -1
  136. package/dist/{index-akbgsdhh.js → index-kn63q1gr.js} +26 -24
  137. package/dist/index-stk36pa5.js +43 -0
  138. package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
  139. package/dist/{keepalive-jmf6pn8c.js → keepalive-031js8jz.js} +4 -4
  140. package/dist/lead-mfggjtfk.js +77 -0
  141. package/dist/{maintenance-g7v15tj1.js → maintenance-sq9v3qx9.js} +1 -1
  142. package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-zqmnyvs8.js} +3 -3
  143. package/dist/object-webhooks-r24wwb5y.js +21 -0
  144. package/dist/{onboard-m3fedypq.js → onboard-p25yhh7t.js} +5 -5
  145. package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-wcjc4zdk.js} +7 -7
  146. package/dist/{otel-impl-3ehm1hgc.js → otel-impl-ff1gf20m.js} +2 -2
  147. package/dist/{pending-fwj2fatd.js → pending-hxj5yatb.js} +23 -21
  148. package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-vkp4zz7p.js} +12 -12
  149. package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-9w7gx41w.js} +2 -2
  150. package/dist/{rbac-roles-8msjr07m.js → rbac-roles-84aw10nz.js} +3 -3
  151. package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-hz74vckp.js} +2 -2
  152. package/dist/{registry-32b1mft6.js → registry-eeyx1201.js} +1 -1
  153. package/dist/{render-v2-j7qggj8h.js → render-v2-nrdkg9gf.js} +5 -5
  154. package/dist/{resume-hj1mn65y.js → resume-s6ey36rh.js} +9 -9
  155. package/dist/{runtime-z31mdsgv.js → runtime-x0b4pyam.js} +1 -1
  156. package/dist/{session-access-w38fh09a.js → session-access-xv49tk14.js} +4 -4
  157. package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-r5j988ah.js} +3 -3
  158. package/dist/{setup-dsqmpfcr.js → setup-mj0krk1p.js} +1 -1
  159. package/dist/thread-buffer-temgaqsy.js +41 -0
  160. package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-cbrsfaar.js} +2 -2
  161. package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-f9d8nwnw.js} +3 -3
  162. package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-ns0ryw05.js} +3 -3
  163. package/dist/{work-objects-4ahy5es5.js → work-objects-pydhzast.js} +25 -23
  164. package/dist/worker-efcemc22.js +77 -0
  165. package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-9z2xec5e.js} +22 -20
  166. package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
  167. package/openapi.json +788 -253
  168. package/package.json +8 -5
  169. package/src/azure-devops/auth.ts +2 -3
  170. package/src/be/agent-fs-identity.ts +46 -0
  171. package/src/be/agent-history.ts +215 -0
  172. package/src/be/db/agents.ts +34 -12
  173. package/src/be/db/tasks/write.ts +2 -2
  174. package/src/be/db.ts +2 -0
  175. package/src/be/migrations/332_primitive_objects.sql +31 -0
  176. package/src/be/migrations/334_agent_history.sql +23 -0
  177. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  178. package/src/be/primitives/boards/elements.ts +717 -0
  179. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  180. package/src/be/primitives/boards/service.ts +121 -0
  181. package/src/be/primitives/object-webhooks.ts +348 -0
  182. package/src/be/primitives/objects.ts +686 -0
  183. package/src/be/primitives/sheets/a1.ts +136 -0
  184. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  185. package/src/be/primitives/sheets/engine.ts +199 -0
  186. package/src/be/primitives/sheets/format.ts +106 -0
  187. package/src/be/primitives/sheets/service.ts +415 -0
  188. package/src/be/primitives/write-object.ts +83 -0
  189. package/src/be/script-credential-broker.ts +8 -27
  190. package/src/be/scripts/typecheck.ts +216 -0
  191. package/src/be/seed/agent-fs-provision.ts +18 -0
  192. package/src/be/users.ts +19 -0
  193. package/src/commands/onboard/agent-fs-version.ts +1 -1
  194. package/src/commands/onboard/steps/harness.tsx +1 -1
  195. package/src/commands/provider-credentials.ts +1 -0
  196. package/src/e2b/env.ts +3 -1
  197. package/src/fs/agent-fs-provider.ts +33 -2
  198. package/src/gitlab/auth.ts +3 -4
  199. package/src/heartbeat/heartbeat.ts +11 -11
  200. package/src/http/agent-lifecycle.ts +152 -0
  201. package/src/http/agents.ts +12 -0
  202. package/src/http/all-routes.ts +2 -0
  203. package/src/http/auth.ts +2 -1
  204. package/src/http/index.ts +15 -0
  205. package/src/http/object-webhooks.ts +101 -0
  206. package/src/http/operator-actor.ts +2 -1
  207. package/src/http/sessions.ts +7 -0
  208. package/src/http/workflows.ts +32 -0
  209. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  210. package/src/providers/acp-targets.ts +2 -2
  211. package/src/providers/amp-adapter.ts +1 -1
  212. package/src/providers/opencode-adapter.ts +4 -1
  213. package/src/rbac/legacy-policy.ts +2 -0
  214. package/src/rbac/permissions.ts +5 -0
  215. package/src/script-workflows/guest-ctx.ts +32 -0
  216. package/src/script-workflows/workflow-ctx.ts +2 -0
  217. package/src/scripts-runtime/ctx.ts +9 -1
  218. package/src/scripts-runtime/executors/native.ts +106 -21
  219. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  220. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  221. package/src/scripts-runtime/sdk-allowlist.ts +88 -0
  222. package/src/scripts-runtime/swarm-sdk.ts +51 -3
  223. package/src/scripts-runtime/types/stdlib.d.ts +267 -0
  224. package/src/scripts-runtime/types/swarm-sdk.d.ts +267 -0
  225. package/src/server.ts +48 -0
  226. package/src/tests/agent-history.test.ts +313 -0
  227. package/src/tests/azure-devops-auth.test.ts +6 -0
  228. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  229. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  230. package/src/tests/credential-check.test.ts +12 -0
  231. package/src/tests/db-task-read-contract.test.ts +2 -0
  232. package/src/tests/db-task-write-contract.test.ts +2 -0
  233. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  234. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  235. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  236. package/src/tests/e2e-shards.test.ts +137 -0
  237. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  238. package/src/tests/extensions-heartbeat.test.ts +34 -0
  239. package/src/tests/gitlab-auth.test.ts +10 -0
  240. package/src/tests/heartbeat.test.ts +38 -0
  241. package/src/tests/http-api-integration.test.ts +0 -6
  242. package/src/tests/opencode-adapter.test.ts +11 -0
  243. package/src/tests/primitives-boards.test.ts +686 -0
  244. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  245. package/src/tests/primitives-objects.test.ts +248 -0
  246. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  247. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  248. package/src/tests/scripts-namespaces.test.ts +211 -0
  249. package/src/tests/secret-scrub-gate.test.ts +1 -0
  250. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  251. package/src/tests/secret-scrubber.test.ts +1 -1
  252. package/src/tests/session-tokens.test.ts +27 -0
  253. package/src/tests/sheet-engine.test.ts +58 -0
  254. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  255. package/src/tests/slack-read-boundaries.test.ts +4 -2
  256. package/src/tests/task-start-after-commit.test.ts +82 -0
  257. package/src/tests/ui-logs-parser.test.ts +67 -0
  258. package/src/tests/workflow-retry-v2.test.ts +101 -0
  259. package/src/tests/workflow-tla-races.test.ts +29 -0
  260. package/src/tools/boards.ts +260 -0
  261. package/src/tools/objects.ts +191 -0
  262. package/src/tools/sheets.ts +312 -0
  263. package/src/tools/slack-read.ts +10 -3
  264. package/src/tools/tool-config.ts +23 -0
  265. package/src/tools/workflows/create-workflow.ts +11 -1
  266. package/src/tools/workflows/patch-workflow-node.ts +4 -0
  267. package/src/tools/workflows/patch-workflow.ts +4 -0
  268. package/src/tools/workflows/update-workflow.ts +17 -0
  269. package/src/types.ts +16 -0
  270. package/src/utils/sandboxed-process.ts +47 -2
  271. package/src/utils/secret-scrubber.ts +61 -6
  272. package/src/workflows/engine.ts +35 -21
  273. package/src/workflows/input.ts +29 -1
  274. package/src/workflows/patch-definition.ts +15 -1
  275. package/src/workflows/retry-poller.ts +15 -2
  276. package/src/workflows/validation.ts +10 -0
  277. package/templates/ai-toolbox.manifest.json +1 -1
  278. package/templates/skills/agent-browser/SKILL.md +1 -0
  279. package/templates/skills/agent-browser/content.md +1 -0
  280. package/templates/skills/pages/content.md +5 -0
  281. package/templates/skills/swarm-docs/content.md +6 -1
  282. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  283. package/templates/skills/swarm-scripts/content.md +1 -0
  284. package/templates/skills/tdd-planning/content.md +5 -2
  285. package/dist/acp-adapter-weaaxey3.js +0 -16
  286. package/dist/core-df1n049h.js +0 -39
  287. package/dist/fx-adapter-zwmps9re.js +0 -19
  288. package/dist/grok-adapter-q0avf919.js +0 -19
  289. package/dist/handlers-g5jq0e4q.js +0 -36
  290. package/dist/index-1f6m47mq.js +0 -37
  291. package/dist/index-1p1mpqda.js +0 -36
  292. package/dist/index-tnkd410q.js +0 -41
  293. package/dist/lead-m5e7xt93.js +0 -75
  294. package/dist/thread-buffer-nf55vwx3.js +0 -39
  295. package/dist/worker-ews1nyhw.js +0 -75
  296. package/src/slack/socket-mode-guard.test.ts +0 -25
  297. package/src/tests/agent-activity.test.ts +0 -247
  298. package/src/tests/agent-fs-live-url.test.ts +0 -55
  299. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  300. package/src/tests/approval-sweeps-config.test.ts +0 -47
  301. package/src/tests/cards.test.ts +0 -169
  302. package/src/tests/chat-sdk-facts.test.ts +0 -23
  303. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  304. package/src/tests/core-auth.test.ts +0 -156
  305. package/src/tests/date-utils.test.ts +0 -48
  306. package/src/tests/db-context-versions.test.ts +0 -37
  307. package/src/tests/db-runtime.test.ts +0 -132
  308. package/src/tests/enabled-capabilities.test.ts +0 -20
  309. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  310. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  311. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  312. package/src/tests/github-event-labels.test.ts +0 -24
  313. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  314. package/src/tests/http-log-scrubbing.test.ts +0 -123
  315. package/src/tests/http-semconv-attributes.test.ts +0 -92
  316. package/src/tests/identity.test.ts +0 -117
  317. package/src/tests/inbox-state.test.ts +0 -167
  318. package/src/tests/internal-ai/models.test.ts +0 -54
  319. package/src/tests/launch-password-rejection.test.ts +0 -140
  320. package/src/tests/list-total-cache.test.ts +0 -88
  321. package/src/tests/match-route.test.ts +0 -187
  322. package/src/tests/memory-feature-flags.test.ts +0 -45
  323. package/src/tests/memory-get-tool.test.ts +0 -269
  324. package/src/tests/memory-health-endpoint.test.ts +0 -78
  325. package/src/tests/memory-http-access.test.ts +0 -221
  326. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  327. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  328. package/src/tests/openai-embedding-provider.test.ts +0 -159
  329. package/src/tests/org-identity.test.ts +0 -44
  330. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  331. package/src/tests/pages-browser-sdk.test.ts +0 -76
  332. package/src/tests/pages-feedback-keys.test.ts +0 -121
  333. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  334. package/src/tests/pages-list-endpoint.test.ts +0 -148
  335. package/src/tests/pages-password-mode.test.ts +0 -266
  336. package/src/tests/pages-public-authed-401.test.ts +0 -103
  337. package/src/tests/pages-public-html.test.ts +0 -297
  338. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  339. package/src/tests/pages-view-count.test.ts +0 -245
  340. package/src/tests/prompt-templates-db.test.ts +0 -616
  341. package/src/tests/rbac-engine.test.ts +0 -742
  342. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  343. package/src/tests/route-def-find-route.test.ts +0 -192
  344. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  345. package/src/tests/schedule-validation-helper.test.ts +0 -51
  346. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  347. package/src/tests/scheduler-backoff.test.ts +0 -166
  348. package/src/tests/script-run-token.test.ts +0 -75
  349. package/src/tests/scripts-extract-signature.test.ts +0 -47
  350. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  351. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  352. package/src/tests/short-id.test.ts +0 -23
  353. package/src/tests/skill-files-http.test.ts +0 -222
  354. package/src/tests/skill-get-file-tool.test.ts +0 -110
  355. package/src/tests/skill-script-refs.test.ts +0 -63
  356. package/src/tests/skill-update-scope.test.ts +0 -252
  357. package/src/tests/skills-bundle.test.ts +0 -99
  358. package/src/tests/slack-app-icon.test.ts +0 -94
  359. package/src/tests/slack-assistant-comention.test.ts +0 -139
  360. package/src/tests/slack-delete.test.ts +0 -157
  361. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  362. package/src/tests/slack-manifest.test.ts +0 -23
  363. package/src/tests/slack-task-output.test.ts +0 -90
  364. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  365. package/src/tests/swarm-diff.test.ts +0 -728
  366. package/src/tests/task-lifecycle-events.test.ts +0 -53
  367. package/src/tests/template-asset-config.test.ts +0 -18
  368. package/src/tests/template-fetch.test.ts +0 -490
  369. package/src/tests/themes-page-theme.test.ts +0 -155
  370. package/src/tests/tool-annotations.test.ts +0 -442
  371. package/src/tests/tool-output-agent-id.test.ts +0 -202
  372. package/src/tests/update-profile-agentid.test.ts +0 -248
  373. package/src/tests/whoami-route.test.ts +0 -162
  374. package/src/tests/workflow-definition-telemetry.test.ts +0 -144
  375. package/src/tests/workflow-patch.test.ts +0 -169
  376. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  377. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  378. package/src/tests/workflow-step-claims.test.ts +0 -152
  379. package/src/tests/workflow-step-order.test.ts +0 -92
  380. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  381. package/src/tests/workflow-versions.test.ts +0 -240
  382. package/src/tests/workflow-wait.test.ts +0 -26
@@ -1,5 +1,5 @@
1
- import { existsSync } from "node:fs";
2
- import { mkdir, rm, symlink } from "node:fs/promises";
1
+ import { existsSync, constants as fsConstants } from "node:fs";
2
+ import { chown, lstat, mkdir, open, rm, symlink } from "node:fs/promises";
3
3
  import { tmpdir as osTmpdir } from "node:os";
4
4
  import { fileURLToPath, pathToFileURL } from "node:url";
5
5
  import {
@@ -10,6 +10,8 @@ import {
10
10
  import {
11
11
  buildSandboxedCommand,
12
12
  readStreamCapped,
13
+ resolveSandboxIdentity,
14
+ type SandboxIdentity,
13
15
  sandboxSpawnEnv,
14
16
  } from "../../utils/sandboxed-process";
15
17
  import type { ExecutorInput, ExecutorOutput, ScriptExecutor, ScriptExecutorError } from "./types";
@@ -73,20 +75,77 @@ export function classifyExit(
73
75
  return "eval_error";
74
76
  }
75
77
 
76
- async function readResultFile(path: string): Promise<unknown | undefined> {
77
- const file = Bun.file(path);
78
- if (!(await file.exists())) return undefined;
79
- const text = await file.text();
78
+ /** Constraints on a file the script child wrote into its run dir. */
79
+ export interface RunDirFileCheck {
80
+ /** Largest file accepted, in bytes. */
81
+ maxBytes: number;
82
+ /** Required owner uid; set when the child runs under a dropped identity. */
83
+ ownerUid?: number;
84
+ }
85
+
86
+ // Missing flags (win32) fall back to 0, which leaves the open unchanged.
87
+ const RUN_DIR_OPEN_FLAGS =
88
+ fsConstants.O_RDONLY | (fsConstants.O_NOFOLLOW ?? 0) | (fsConstants.O_NONBLOCK ?? 0);
89
+
90
+ /**
91
+ * Reads a file the script child controls. The child can replace it with a
92
+ * symlink, a hard link, a FIFO or an oversized file, so the API must not read
93
+ * it by path: open without following links (non-blocking, so a FIFO cannot
94
+ * stall the open), then require a regular file, the expected owner and a size
95
+ * within the cap on the opened descriptor. Anything else reads as absent.
96
+ */
97
+ export async function readRunDirFile(
98
+ path: string,
99
+ check: RunDirFileCheck,
100
+ ): Promise<string | undefined> {
101
+ let handle: Awaited<ReturnType<typeof open>>;
102
+ try {
103
+ handle = await open(path, RUN_DIR_OPEN_FLAGS);
104
+ } catch {
105
+ return undefined;
106
+ }
107
+ try {
108
+ const stat = await handle.stat();
109
+ if (!stat.isFile()) return undefined;
110
+ if (check.ownerUid !== undefined && stat.uid !== check.ownerUid) return undefined;
111
+ if (stat.size > check.maxBytes) return undefined;
112
+ // A surviving group member can still append: read one byte past the stat
113
+ // size and treat a file that changed under the read as absent.
114
+ const buffer = Buffer.alloc(stat.size + 1);
115
+ let length = 0;
116
+ while (length < buffer.length) {
117
+ const { bytesRead } = await handle.read(buffer, length, buffer.length - length, length);
118
+ if (bytesRead === 0) break;
119
+ length += bytesRead;
120
+ }
121
+ if (length > stat.size) return undefined;
122
+ return buffer.toString("utf8", 0, length);
123
+ } finally {
124
+ await handle.close();
125
+ }
126
+ }
127
+
128
+ /** Whether anything exists at `path`, without following a final symlink. */
129
+ async function runDirEntryExists(path: string): Promise<boolean> {
130
+ try {
131
+ await lstat(path);
132
+ return true;
133
+ } catch {
134
+ return false;
135
+ }
136
+ }
137
+
138
+ async function readResultFile(path: string, check: RunDirFileCheck): Promise<unknown | undefined> {
139
+ const text = await readRunDirFile(path, check);
80
140
  if (!text) return undefined;
81
141
  return JSON.parse(text);
82
142
  }
83
143
 
84
144
  async function readRuntimeError(
85
145
  path: string,
146
+ check: RunDirFileCheck,
86
147
  ): Promise<import("./types").ScriptRuntimeError | undefined> {
87
- const file = Bun.file(path);
88
- if (!(await file.exists())) return undefined;
89
- const text = await file.text();
148
+ const text = await readRunDirFile(path, check);
90
149
  if (!text) return undefined;
91
150
  try {
92
151
  return JSON.parse(text) as import("./types").ScriptRuntimeError;
@@ -192,14 +251,21 @@ function harnessCommand(
192
251
  harnessPath: string,
193
252
  input: ExecutorInput,
194
253
  env: Record<string, string>,
254
+ runAs: SandboxIdentity | undefined,
195
255
  ): string[] {
196
- return buildSandboxedCommand(["bun", "run", harnessPath], env, {
197
- virtualMemoryMb: input.resources.memoryMb,
198
- cpuTimeSec: input.resources.cpuTimeSec,
199
- maxProcs: input.resources.maxProcs,
200
- maxFileKb: Math.floor(input.resources.maxFileBytes / 1024),
201
- maxFdCount: input.resources.maxFdCount,
202
- });
256
+ return buildSandboxedCommand(
257
+ ["bun", "run", harnessPath],
258
+ env,
259
+ {
260
+ virtualMemoryMb: input.resources.memoryMb,
261
+ cpuTimeSec: input.resources.cpuTimeSec,
262
+ maxProcs: input.resources.maxProcs,
263
+ maxFileKb: Math.floor(input.resources.maxFileBytes / 1024),
264
+ maxFdCount: input.resources.maxFdCount,
265
+ },
266
+ "inline",
267
+ runAs,
268
+ );
203
269
  }
204
270
 
205
271
  export class NativeScriptExecutor implements ScriptExecutor {
@@ -220,6 +286,7 @@ export class NativeScriptExecutor implements ScriptExecutor {
220
286
  const resultFile = `${tmpdir}/result.json`;
221
287
  const errorFile = `${tmpdir}/error.json`;
222
288
  const startedFile = `${tmpdir}/started.marker`;
289
+ const runAs = resolveSandboxIdentity();
223
290
  // In compiled binary mode, import.meta.url points into /$bunfs/ which spawned
224
291
  // subprocesses cannot access. Use the pre-built bundle from real filesystem instead.
225
292
  const harnessPath = process.env.SCRIPT_RUNTIME_DIR
@@ -257,6 +324,14 @@ export class NativeScriptExecutor implements ScriptExecutor {
257
324
  Bun.write(sourceFile, input.source),
258
325
  linkOrWriteBareImportShims(baseTmpDir, tmpdir),
259
326
  ]);
327
+ if (runAs) {
328
+ // The child writes its result and marker files into the run dir.
329
+ await Promise.all(
330
+ [tmpdir, `${tmpdir}/user-module`, argsFile, sourceFile].map((path) =>
331
+ chown(path, runAs.uid, runAs.gid),
332
+ ),
333
+ );
334
+ }
260
335
 
261
336
  // No await between this check and the spawn below.
262
337
  if (killed) return killedOutput();
@@ -268,7 +343,8 @@ export class NativeScriptExecutor implements ScriptExecutor {
268
343
 
269
344
  const harnessEnv: Record<string, string> = {
270
345
  PATH: process.env.PATH ?? "/usr/bin:/bin",
271
- HOME: process.env.HOME ?? "/tmp",
346
+ // The dropped identity cannot use the API's HOME.
347
+ HOME: runAs ? tmpdir : (process.env.HOME ?? "/tmp"),
272
348
  LANG: process.env.LANG ?? "C.UTF-8",
273
349
  LC_ALL: process.env.LC_ALL ?? "C.UTF-8",
274
350
  TMPDIR: tmpdir,
@@ -282,7 +358,7 @@ export class NativeScriptExecutor implements ScriptExecutor {
282
358
  };
283
359
 
284
360
  proc = registerProcessGroup(
285
- Bun.spawn(harnessCommand(harnessPath, input, harnessEnv), {
361
+ Bun.spawn(harnessCommand(harnessPath, input, harnessEnv, runAs), {
286
362
  // On POSIX, Bun.spawn only needs PATH itself to locate the `sh`
287
363
  // binary for argv[0] — the sandboxed command's `env -i` prelude is
288
364
  // what actually scrubs the child's environment down to `harnessEnv`
@@ -306,9 +382,18 @@ export class NativeScriptExecutor implements ScriptExecutor {
306
382
  readStreamCapped(proc.stderr, input.resources.maxStdoutBytes),
307
383
  proc.exited.catch(() => (timedOut ? 124 : 1)),
308
384
  ]).finally(() => clearTimeout(timeout));
309
- const result = exitCode === 0 ? await readResultFile(resultFile) : undefined;
310
- const runtimeError = exitCode === 0 ? undefined : await readRuntimeError(errorFile);
311
- const userCodeStarted = await Bun.file(startedFile).exists();
385
+ // The child owns the run dir: read its files only through the checked reader.
386
+ const runDirCheck: RunDirFileCheck = {
387
+ // ulimit -f already bounds what the child can write.
388
+ maxBytes: input.resources.maxFileBytes,
389
+ ...(runAs ? { ownerUid: runAs.uid } : {}),
390
+ };
391
+ const result = exitCode === 0 ? await readResultFile(resultFile, runDirCheck) : undefined;
392
+ const runtimeError =
393
+ exitCode === 0 ? undefined : await readRuntimeError(errorFile, runDirCheck);
394
+ // Presence only; anything at the path (even a planted link) reads as started,
395
+ // the conservative side for retry safety.
396
+ const userCodeStarted = await runDirEntryExists(startedFile);
312
397
  const error = classifyExit(exitCode, timedOut, killed, userCodeStarted);
313
398
 
314
399
  return {
@@ -14,7 +14,7 @@
14
14
  * `SANDBOX_WEB_SHIMS` (quickjs-web-shims.ts) runs first and adds URL,
15
15
  * URLSearchParams, TextEncoder and TextDecoder.
16
16
  * `__swarm_shape` (injected before this file) lists the configured api/mcp
17
- * connections and the `ctx.fs` methods, so `ctx` matches the native executor exactly.
17
+ * connections, the `ctx.fs` methods and the SDK namespaces, so `ctx` matches the native executor exactly.
18
18
  */
19
19
  export const SANDBOX_PRELUDE = String.raw`(() => {
20
20
  "use strict";
@@ -445,7 +445,14 @@ const registry = (kind) => {
445
445
  // ctx.fs / ctx.sh run on the host (script-fs.ts): agent-fs at /afs, scratch memory elsewhere.
446
446
  const fs = Object.freeze(Object.fromEntries(shape.fs.map((name) => [name, method("fs." + name)])));
447
447
  const sh = (command, options) => hostCall("sh", options === undefined ? [command] : [command, options]);
448
- const ctx = Object.freeze({ swarm, api: registry("api"), mcp: registry("mcp"), fs, sh, stdlib, logger: console });
448
+ // ctx.<ns>.<m> for each SDK_NAMESPACES entry; the host calls SDK method <ns>_<m> and unwraps it.
449
+ const namespaces = Object.fromEntries(
450
+ Object.entries(shape.namespaces).map(([ns, names]) => [
451
+ ns,
452
+ Object.freeze(Object.fromEntries(names.map((name) => [name, method(ns + "." + name)]))),
453
+ ]),
454
+ );
455
+ const ctx = Object.freeze({ ...namespaces, swarm, api: registry("api"), mcp: registry("mcp"), fs, sh, stdlib, logger: console });
449
456
 
450
457
  const define = (name, value) =>
451
458
  Object.defineProperty(globalThis, name, { value, writable: true, configurable: true, enumerable: false });
@@ -9,6 +9,7 @@ import { buildCtx, type RuntimeCtx } from "../ctx";
9
9
  import { Redacted, type Redacted as RedactedValue } from "../redacted";
10
10
  import { SCRIPT_SDK_RESPONSE_LIMIT_BYTES } from "../response-limit";
11
11
  import { ctxSignatureHintFor } from "../script-error-hints";
12
+ import { SDK_NAMESPACES, type SdkNamespaceRegistry } from "../sdk-allowlist";
12
13
  import { runtimeFetch } from "../stdlib/fetch";
13
14
  import { table } from "../stdlib/table";
14
15
  import { SwarmConfig } from "../swarm-config";
@@ -34,6 +35,8 @@ export type QuickJSJob = {
34
35
  configPayload: SwarmConfigPayload;
35
36
  resources: ScriptResourcePolicy;
36
37
  network: ExecutorInput["network"];
38
+ /** Tests inject a fixture; production uses `SDK_NAMESPACES`. */
39
+ namespaces?: SdkNamespaceRegistry;
37
40
  };
38
41
 
39
42
  // Set while a ctx.swarm or ctx.mcp host call runs. Those calls go to the swarm
@@ -224,6 +227,7 @@ function callable(target: unknown, name: string): (...args: unknown[]) => Promis
224
227
  /** Runs an async host call that the sandbox requested. Only these paths exist. */
225
228
  async function dispatchCall(
226
229
  hostCtx: RuntimeCtx,
230
+ namespaces: SdkNamespaceRegistry,
227
231
  sqlApiSlugs: ReadonlySet<string>,
228
232
  path: string,
229
233
  args: unknown[],
@@ -269,6 +273,10 @@ async function dispatchCall(
269
273
  );
270
274
  return swarmHostCalls.run(true, () => method(...args));
271
275
  }
276
+ if (kind && Object.hasOwn(namespaces, kind) && first && rest.length === 0) {
277
+ const method = callable(own(own(hostCtx, kind), first), `ctx.${kind}.${first}`);
278
+ return swarmHostCalls.run(true, () => method(...args));
279
+ }
272
280
  if ((kind === "api" || kind === "mcp") && first && rest.length > 0) {
273
281
  const name = rest.join(".");
274
282
  const client = own(hostCtx[kind], first);
@@ -530,7 +538,9 @@ async function evaluateJob(
530
538
  }
531
539
 
532
540
  const config = new SwarmConfig(job.configPayload);
541
+ const namespaces = job.namespaces ?? SDK_NAMESPACES;
533
542
  const hostCtx = buildCtx({
543
+ namespaces,
534
544
  swarmConfig: config,
535
545
  apiConnections: job.configPayload.apiConnections,
536
546
  mcpConnections: job.configPayload.mcpConnections,
@@ -545,6 +555,7 @@ async function evaluateJob(
545
555
  api: Object.fromEntries(Object.entries(hostCtx.api).map(([slug, c]) => [slug, Object.keys(c)])),
546
556
  mcp: Object.fromEntries(Object.entries(hostCtx.mcp).map(([slug, c]) => [slug, Object.keys(c)])),
547
557
  fs: Object.keys(hostCtx.fs),
558
+ namespaces,
548
559
  };
549
560
  // Accept both shapes, like eval-harness: callers may pass already-serialized JSON.
550
561
  const args = typeof job.args === "string" ? JSON.parse(job.args) : (job.args ?? null);
@@ -613,7 +624,7 @@ async function evaluateJob(
613
624
  return bridge(async () => {
614
625
  const bodyBytes = FETCH_PATHS.has(path) ? binaryBodySize(callArgs?.[0]) : 0;
615
626
  return host.call(
616
- () => dispatchCall(hostCtx, sqlApiSlugs, path, callArgs, host.signal),
627
+ () => dispatchCall(hostCtx, namespaces, sqlApiSlugs, path, callArgs, host.signal),
617
628
  true,
618
629
  bodyBytes,
619
630
  );
@@ -34,6 +34,29 @@ 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
+ // ── boards (also ctx.boards, see SDK_NAMESPACES) ──
53
+ boards_create: "board-create",
54
+ boards_get: "board-get",
55
+ boards_list: "board-list",
56
+ boards_addElements: "board-add-elements",
57
+ boards_updateElements: "board-update-elements",
58
+ boards_removeElements: "board-remove-elements",
59
+
37
60
  // ── repos ──
38
61
  repo_list: "get-repos",
39
62
  repo_update: "update-repo",
@@ -233,3 +256,68 @@ export function isMcpToolAllowedForScripts(mcpToolName: string): boolean {
233
256
  export function mcpToolNameForSdkMethod(name: string): string {
234
257
  return SDK_TOOL_NAME_MAP[name as keyof typeof SDK_TOOL_NAME_MAP] ?? name;
235
258
  }
259
+
260
+ /** `{ ns: methods }`: `ctx.<ns>.<m>(args)` calls SDK method `<ns>_<m>` and returns its unwrapped result. */
261
+ export type SdkNamespaceRegistry = Readonly<Record<string, readonly string[]>>;
262
+
263
+ /**
264
+ * Tool groups exposed as top-level `ctx.<ns>` namespaces in native and QuickJS
265
+ * scripts and in script workflows. A new entry also needs its `<ns>_<m>`
266
+ * methods in SDK_TOOL_NAME_MAP and a typed key on `ScriptContext` in
267
+ * `src/be/scripts/typecheck.ts`.
268
+ */
269
+ export const SDK_NAMESPACES: SdkNamespaceRegistry = Object.freeze({
270
+ objects: ["create", "get", "list", "reindex"],
271
+ sheets: ["create", "get", "list", "getRange", "setRange", "appendRows", "clearRange", "addTab"],
272
+ boards: ["create", "get", "list", "addElements", "updateElements", "removeElements"],
273
+ });
274
+
275
+ /** ctx keys a namespace may never shadow. */
276
+ export const RESERVED_CTX_KEYS: readonly string[] = [
277
+ "swarm",
278
+ "api",
279
+ "mcp",
280
+ "fs",
281
+ "sh",
282
+ "stdlib",
283
+ "logger",
284
+ "run",
285
+ "step",
286
+ "config",
287
+ ];
288
+
289
+ const NAMESPACE_NAME = /^[a-z][a-zA-Z]*$/;
290
+
291
+ export function sdkMethodForNamespace(ns: string, method: string): string {
292
+ return `${ns}_${method}`;
293
+ }
294
+
295
+ /** Throws unless every namespace is unreserved, well-named and maps to allowlisted SDK methods. */
296
+ export function assertNamespaces(registry: SdkNamespaceRegistry): void {
297
+ for (const [ns, methods] of Object.entries(registry)) {
298
+ if (!NAMESPACE_NAME.test(ns)) throw new Error(`SDK namespace '${ns}' has an invalid name`);
299
+ if (RESERVED_CTX_KEYS.includes(ns)) throw new Error(`SDK namespace '${ns}' is reserved`);
300
+ for (const method of methods) {
301
+ if (!NAMESPACE_NAME.test(method)) {
302
+ throw new Error(`SDK namespace method '${ns}.${method}' has an invalid name`);
303
+ }
304
+ const sdkMethod = sdkMethodForNamespace(ns, method);
305
+ if (!Object.hasOwn(SDK_TOOL_NAME_MAP, sdkMethod)) {
306
+ throw new Error(
307
+ `SDK namespace method '${ns}.${method}' needs '${sdkMethod}' in SDK_TOOL_NAME_MAP`,
308
+ );
309
+ }
310
+ }
311
+ }
312
+ }
313
+
314
+ /** A tool's structured payload as a namespace returns it: throws on a refusal, else drops `success`. */
315
+ export function unwrapToolPayload(label: string, payload: unknown): unknown {
316
+ if (payload === null || typeof payload !== "object" || Array.isArray(payload)) return payload;
317
+ const { success, ...rest } = payload as Record<string, unknown>;
318
+ if (success === false) {
319
+ const reason = typeof rest.message === "string" ? rest.message : "tool refused the call";
320
+ throw new Error(`${label} failed: ${reason}`);
321
+ }
322
+ return rest;
323
+ }
@@ -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
 
@@ -491,8 +499,8 @@ const READ_RETRY_STATUSES = new Set([502, 503, 504]);
491
499
 
492
500
  // MCP tool names that only read. Prefix/suffix rules cover get-* / list-* /
493
501
  // *-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.
502
+ // treated as a write, which is the safe default. Nothing checks this list
503
+ // against `readOnlyHint` annotations; add a read-only tool here by hand.
496
504
  // read-messages may mark messages read; repeating that is harmless.
497
505
  const READ_TOOL_PATTERN = /^(get|list)-|-(get|list|search)$/;
498
506
  const READ_TOOLS = new Set([
@@ -517,6 +525,7 @@ const READ_TOOLS = new Set([
517
525
  "app-query",
518
526
  "resolve-user",
519
527
  "room-decode",
528
+ "sheet-get-range",
520
529
  "read-messages",
521
530
  "check-model-profile",
522
531
  "preview-prompt-template",
@@ -766,3 +775,42 @@ export function createSwarmSdk(
766
775
  },
767
776
  }) as RuntimeSwarmSdk;
768
777
  }
778
+
779
+ export type SdkNamespaceClient = Readonly<Record<string, (args?: unknown) => Promise<unknown>>>;
780
+
781
+ /**
782
+ * One frozen client per registered namespace. `ctx.<ns>.<m>(args)` calls SDK
783
+ * method `<ns>_<m>`, throws on a non-2xx or a tool refusal, and returns the
784
+ * tool payload without `success` (flat `ctx.swarm.<ns>_<m>` keeps the envelope).
785
+ */
786
+ export function createNamespaceClients(
787
+ config: SwarmConfig,
788
+ options: { signal?: AbortSignal; registry?: SdkNamespaceRegistry } = {},
789
+ ): Readonly<Record<string, SdkNamespaceClient>> {
790
+ const { signal, registry = SDK_NAMESPACES } = options;
791
+ assertNamespaces(registry);
792
+ const call = (ns: string, method: string) => async (args?: unknown) => {
793
+ const label = `ctx.${ns}.${method}`;
794
+ const result = (await callTool(sdkMethodForNamespace(ns, method), args, config, signal)) as {
795
+ success: boolean;
796
+ status: number;
797
+ data: unknown;
798
+ };
799
+ const data = result.data as { success?: unknown; error?: unknown } | null;
800
+ // A tool refusal is a 200 with `data.success === false`: unwrapToolPayload throws its message.
801
+ if (!result.success && data?.success !== false) {
802
+ const reason =
803
+ data && typeof data === "object" && "error" in data ? String(data.error) : "api failed";
804
+ throw new Error(`${label} failed with ${result.status}: ${reason}`);
805
+ }
806
+ return unwrapToolPayload(label, result.data);
807
+ };
808
+ return Object.freeze(
809
+ Object.fromEntries(
810
+ Object.entries(registry).map(([ns, methods]) => [
811
+ ns,
812
+ Object.freeze(Object.fromEntries(methods.map((method) => [method, call(ns, method)]))),
813
+ ]),
814
+ ),
815
+ );
816
+ }