@desplega.ai/agent-swarm 2.13.4 → 2.14.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 (526) hide show
  1. package/dist/acp-adapter-99n6z9ky.js +17 -0
  2. package/dist/{acp-targets-zrk9k0n7.js → acp-targets-23exz4z4.js} +10 -10
  3. package/dist/{actions-acqqj9jn.js → actions-zcr25x27.js} +61 -40
  4. package/dist/{agent-fs-provision-zmaykqnd.js → agent-fs-provision-7fa9e12e.js} +4 -4
  5. package/dist/{amp-adapter-a7ts8tmw.js → amp-adapter-s7ytmv6b.js} +3 -3
  6. package/dist/{anthropic-messages-88b7s3n9.js → anthropic-messages-vdd1zmha.js} +10 -10
  7. package/dist/{app-tmwa442h.js → app-5d3sz1hy.js} +7 -7
  8. package/dist/{approval-notifications-6psaaaye.js → approval-notifications-7qgkzkzx.js} +8 -8
  9. package/dist/{assistant-564v6emv.js → assistant-p2yvhc3j.js} +37 -32
  10. package/dist/{boot-args-schema-n099e0f2.js → boot-args-schema-ry6cb0p7.js} +1 -1
  11. package/dist/{boot-reembed-epvg4fp9.js → boot-reembed-2hkm3vz2.js} +1 -1
  12. package/dist/{boot-reembed-chx66qfk.js → boot-reembed-c9643ms3.js} +1 -1
  13. package/dist/{boot-scrub-sweep-dhkfp0a7.js → boot-scrub-sweep-3ycxr51t.js} +2 -2
  14. package/dist/{boot-seeds-m74fc07r.js → boot-seeds-2hzvvzg0.js} +4 -4
  15. package/dist/{boxd-451q55ys.js → boxd-9py3x0jb.js} +2 -2
  16. package/dist/{claude-adapter-hw63yj3j.js → claude-adapter-dnkww93e.js} +9 -9
  17. package/dist/{claude-managed-adapter-z5s7fx6p.js → claude-managed-adapter-yk0cr5x6.js} +4 -4
  18. package/dist/{claude-managed-setup-wee1762m.js → claude-managed-setup-4byxpp47.js} +5 -5
  19. package/dist/{claude-sdk-session-cktyqkpk.js → claude-sdk-session-4wf3dbvs.js} +13163 -12195
  20. package/dist/{cli-5rxsb3wq.js → cli-096aftq6.js} +12 -7
  21. package/dist/{cli-5rgm8p39.js → cli-0e914dp9.js} +3 -3
  22. package/dist/{cli-bzcwwebm.js → cli-0h6m6z5g.js} +1 -1
  23. package/dist/{cli-cah298e5.js → cli-0k7ppk9k.js} +231 -124
  24. package/dist/{cli-ja450998.js → cli-1nfabrt4.js} +8 -8
  25. package/dist/{cli-jzerrzgc.js → cli-2414h5r9.js} +8 -8
  26. package/dist/{cli-b768ek79.js → cli-24wervhz.js} +38 -0
  27. package/dist/{cli-93n305hm.js → cli-2ayk9gn8.js} +2 -2
  28. package/dist/{cli-kr0jpw9c.js → cli-2ckwgs7q.js} +1 -1
  29. package/dist/{cli-d5pc8ep0.js → cli-2savn6mm.js} +11 -100
  30. package/dist/{cli-jbrc98qb.js → cli-2zjxake1.js} +4 -4
  31. package/dist/{cli-4q2c8rxw.js → cli-37p61fcg.js} +15 -9
  32. package/dist/{cli-2vp0z049.js → cli-39t9d248.js} +1 -1
  33. package/dist/{cli-sa02jsqt.js → cli-3mhdmcd4.js} +1 -1
  34. package/dist/{cli-x2cem5vy.js → cli-3wsabyt0.js} +2 -2
  35. package/dist/{cli-dqgnbnxs.js → cli-466jjrwe.js} +16 -2
  36. package/dist/{cli-zhwjdhjr.js → cli-6ajyhxh7.js} +2 -2
  37. package/dist/{cli-3bxrrh53.js → cli-6yy4fepf.js} +4 -4
  38. package/dist/{cli-hhtbandk.js → cli-73rmgm45.js} +2 -2
  39. package/dist/{cli-8b4rpnwj.js → cli-7ca8hczj.js} +1 -1
  40. package/dist/{cli-0h8skzss.js → cli-7g5qj2ca.js} +4 -3
  41. package/dist/{cli-m1sns1da.js → cli-7w1fs01q.js} +2 -2
  42. package/dist/{cli-xwsm6xkr.js → cli-84wxwt3z.js} +1 -1
  43. package/dist/{cli-qzz6tz8s.js → cli-84xn7bgz.js} +1 -1
  44. package/dist/{cli-49aq3cyn.js → cli-879txsac.js} +5 -5
  45. package/dist/{cli-bv4vvnmg.js → cli-8vbxjzk0.js} +3 -3
  46. package/dist/{cli-7by7vp6m.js → cli-91amj3md.js} +3 -3
  47. package/dist/{cli-60dwk8tx.js → cli-930zbczq.js} +3 -3
  48. package/dist/{cli-7g3fg4gf.js → cli-9fwznq4p.js} +10 -10
  49. package/dist/{cli-4pbwg7sn.js → cli-9j1t3kf6.js} +2 -2
  50. package/dist/{cli-tzw1jr2t.js → cli-9j47sgzy.js} +2 -2
  51. package/dist/{cli-0fgvnb0x.js → cli-ad00h1st.js} +7 -7
  52. package/dist/{cli-kj84fqxz.js → cli-adzmmcvf.js} +19 -7
  53. package/dist/{cli-3tzmh38q.js → cli-ayxxkk3p.js} +68 -25
  54. package/dist/{cli-4vynxtrb.js → cli-bqfx72e6.js} +10 -3
  55. package/dist/{cli-8cas2xvp.js → cli-cbg0j1yt.js} +2716 -2643
  56. package/dist/{cli-fw67mnyc.js → cli-cg1q8ymp.js} +1 -1
  57. package/dist/{cli-he5nxaa8.js → cli-dw9rtjm3.js} +1 -1
  58. package/dist/{cli-jg5txpm6.js → cli-dy754erz.js} +83 -1
  59. package/dist/{cli-tsc3pdfd.js → cli-edxfzgah.js} +4 -4
  60. package/dist/{cli-hyqksecw.js → cli-ejnhs815.js} +15 -15
  61. package/dist/{cli-k0nebh10.js → cli-enavhq6r.js} +1 -1
  62. package/dist/{cli-ea7nz50q.js → cli-f2rwt43y.js} +14 -14
  63. package/dist/{cli-zjdhrzm0.js → cli-f9g96z28.js} +8 -8
  64. package/dist/{cli-rmgvwcmy.js → cli-fww016hh.js} +534 -70
  65. package/dist/{cli-rv3y60bt.js → cli-g6a696c0.js} +4 -4
  66. package/dist/{cli-z1vam71h.js → cli-gc6b94tj.js} +2 -2
  67. package/dist/{cli-p436yrzp.js → cli-gcyws2bp.js} +2 -2
  68. package/dist/{cli-srktrbby.js → cli-hzhv7yac.js} +1 -1
  69. package/dist/{cli-0p76my9q.js → cli-jcnc5ret.js} +44 -32
  70. package/dist/{cli-tr19nyn9.js → cli-jgq9xptq.js} +7 -7
  71. package/dist/{cli-pz1dp12c.js → cli-jwnac23b.js} +1 -1
  72. package/dist/{cli-904wk98s.js → cli-kc7vd07m.js} +917 -350
  73. package/dist/{cli-t0jmkcah.js → cli-kg63yp1r.js} +14 -14
  74. package/dist/{cli-ts5yv7dn.js → cli-krk8y8c7.js} +835 -157
  75. package/dist/{cli-jyhbvdga.js → cli-m0ea8ggd.js} +8 -10
  76. package/dist/{cli-944w9wb4.js → cli-md4tn21h.js} +20 -15
  77. package/dist/{cli-zexwhj3f.js → cli-mv8ft7b0.js} +10 -9
  78. package/dist/{cli-phdzn699.js → cli-mw1tmn3x.js} +217 -27
  79. package/dist/{cli-5ashycw3.js → cli-njvpngc6.js} +3 -3
  80. package/dist/{cli-9ah37a8a.js → cli-phe2vcw5.js} +10 -7
  81. package/dist/{cli-eds5xnsz.js → cli-phmy14hb.js} +2 -2
  82. package/dist/{cli-n1kjs58m.js → cli-pq0kv31y.js} +5 -5
  83. package/dist/{cli-pz1nq5xm.js → cli-q457ga28.js} +6 -6
  84. package/dist/{cli-s33bzmk0.js → cli-q5n3deaf.js} +1 -1
  85. package/dist/{cli-4fpa0zns.js → cli-qkbevqer.js} +3 -3
  86. package/dist/{cli-29h5239w.js → cli-qrwjk4xy.js} +5 -5
  87. package/dist/{cli-kezzteka.js → cli-r04ve9xw.js} +1 -1
  88. package/dist/{cli-3xqad83h.js → cli-r495stwd.js} +2 -2
  89. package/dist/{cli-1kvcsd2f.js → cli-r9d2tya0.js} +71 -3
  90. package/dist/{cli-ybte1fqc.js → cli-rp1n2xpd.js} +1 -1
  91. package/dist/{cli-fkpnx3vf.js → cli-rs1rzwp4.js} +3 -2
  92. package/dist/{cli-h9d3sdnc.js → cli-rzbsh6bw.js} +1 -1
  93. package/dist/{cli-94gx6ze9.js → cli-s4pccby1.js} +1 -1
  94. package/dist/{cli-cq4am6vg.js → cli-shyhb4t5.js} +10 -10
  95. package/dist/{cli-gtj12v95.js → cli-srq69pn1.js} +1 -1
  96. package/dist/{cli-azj9t1f9.js → cli-tc165vrb.js} +48 -5
  97. package/dist/{cli-gse7bp3z.js → cli-v4z5v3jd.js} +300 -81
  98. package/dist/{cli-p3knvk62.js → cli-vxmmttmt.js} +132 -53
  99. package/dist/{cli-404am6f3.js → cli-w4bvtxet.js} +7 -7
  100. package/dist/{cli-gkv0r2hq.js → cli-wd7b5hgc.js} +71 -9
  101. package/dist/{cli-akm6y2a8.js → cli-wvbaq052.js} +1 -1
  102. package/dist/{cli-ywy8yz6t.js → cli-wvgg7r4j.js} +2 -2
  103. package/dist/{cli-ka48vpev.js → cli-wym6rxgt.js} +165 -6
  104. package/dist/{cli-nc4pbwmp.js → cli-yd7e590v.js} +12 -12
  105. package/dist/{cli-3zrwrnz7.js → cli-yjb3cddd.js} +1 -1
  106. package/dist/{cli-7gbff32z.js → cli-z8t4485r.js} +2 -2
  107. package/dist/{cli-hdhpdrka.js → cli-ze1ndjs4.js} +4 -6
  108. package/dist/{cli-50wa8k4h.js → cli-zy9bb22b.js} +1 -2
  109. package/dist/cli.js +28 -28
  110. package/dist/{codex-adapter-2fs2c0n6.js → codex-adapter-eq61radw.js} +8 -8
  111. package/dist/{codex-hook-jxjv6dy5.js → codex-hook-8nmepvz6.js} +3 -3
  112. package/dist/{codex-login-ktfg1cxk.js → codex-login-vbd9707w.js} +1 -1
  113. package/dist/{codex-session-runner-r55tmx4c.js → codex-session-runner-rfx355h4.js} +9 -9
  114. package/dist/{commands-0mxdy9x8.js → commands-d1z0sx62.js} +3 -3
  115. package/dist/{controller-g3vkfhr4.js → controller-9hz6d8x3.js} +4 -4
  116. package/dist/{controllers-connect-4wdmncqt.js → controllers-connect-tz07d2xr.js} +24 -25
  117. package/dist/core-dynsv289.js +41 -0
  118. package/dist/{cursor-adapter-t9qb96q2.js → cursor-adapter-ef22ze3j.js} +2 -2
  119. package/dist/{db-487vvyv9.js → db-gd81d68c.js} +3 -3
  120. package/dist/{db-76p7w3gr.js → db-vrckks6q.js} +4 -2
  121. package/dist/{devin-adapter-3bp6rape.js → devin-adapter-kdt6a2bh.js} +1 -1
  122. package/dist/{dispatcher-64rp6w67.js → dispatcher-76as8w2t.js} +21 -22
  123. package/dist/{docker-a59g3ebm.js → docker-51ta7jsh.js} +2 -2
  124. package/dist/dsh-adapter-ypfvcdyz.js +11 -0
  125. package/dist/{e2b-dc8f6ctq.js → e2b-05kn3kpq.js} +16 -5
  126. package/dist/{e2b-3ykbe805.js → e2b-dm9r8hpy.js} +3 -3
  127. package/dist/{easter-egg-3d-jrrwyf55.js → easter-egg-3d-sg21j15g.js} +1 -1
  128. package/dist/{embedding-space-001hhhpk.js → embedding-space-zsdw37bb.js} +13 -23
  129. package/dist/{embeddings-esj19cnw.js → embeddings-p4e3e1m6.js} +1 -1
  130. package/dist/{event-bus-7gbsr0g4.js → event-bus-tvf2grf4.js} +1 -1
  131. package/dist/{execute-301hkxqg.js → execute-nztd0af0.js} +1 -1
  132. package/dist/{external-channel-w10e2j05.js → external-channel-717yzn4d.js} +2 -2
  133. package/dist/fx-adapter-9k0hptnz.js +20 -0
  134. package/dist/grok-adapter-skdj2pce.js +20 -0
  135. package/dist/handlers-5btjqkz6.js +39 -0
  136. package/dist/{heartbeat-tbrj7vhq.js → heartbeat-vfb1gy84.js} +24 -25
  137. package/dist/{hook-tx917rqw.js → hook-ctz0xmp3.js} +11 -11
  138. package/dist/{hook-3am1sq68.js → hook-eh52p7yd.js} +6 -6
  139. package/dist/{http-3rmemtqy.js → http-zregegrx.js} +902 -198
  140. package/dist/{index-s7xtvc0f.js → index-5kx15d19.js} +1 -1
  141. package/dist/index-7w8p6em0.js +41 -0
  142. package/dist/index-evay0xyk.js +17 -0
  143. package/dist/{index-2jw11t8s.js → index-fdym6ryb.js} +25 -26
  144. package/dist/{index-3j803vnb.js → index-mtnbhe12.js} +20533 -19786
  145. package/dist/index-vz4semsx.js +38 -0
  146. package/dist/{index-gfnq66t1.js → index-x9qf8dg7.js} +294 -29
  147. package/dist/index-y3s0xp2v.js +43 -0
  148. package/dist/{k8s-36gfn847.js → k8s-ejkk0aw7.js} +2 -2
  149. package/dist/{keepalive-9px3t7qj.js → keepalive-zdqay870.js} +4 -5
  150. package/dist/lead-6cscw8a5.js +82 -0
  151. package/dist/{maintenance-vwqjwst6.js → maintenance-t5ndg11m.js} +1 -1
  152. package/dist/{node-2wfcey7d.js → node-0as4n1ef.js} +3 -3
  153. package/dist/{node-zd6shky9.js → node-dhxbt01p.js} +3 -3
  154. package/dist/{node-z67yjre7.js → node-jkdd5w7m.js} +290 -70
  155. package/dist/{node-hjn5n1yp.js → node-t0ct2zpw.js} +3 -5
  156. package/dist/{oauth-refresh-sweep-yqry3wn4.js → oauth-refresh-sweep-y9zyd7t6.js} +3 -4
  157. package/dist/{object-webhooks-8s1wtths.js → object-webhooks-mkca91s0.js} +7 -7
  158. package/dist/{onboard-hb8czx0p.js → onboard-ss995244.js} +11 -9
  159. package/dist/{opencode-adapter-djd6m6dk.js → opencode-adapter-mwpz0278.js} +8 -8
  160. package/dist/{otel-impl-2ymwyczz.js → otel-impl-6n6vva3x.js} +2 -2
  161. package/dist/{pending-nxavtvx7.js → pending-2sxh1t6j.js} +22 -23
  162. package/dist/{pi-mono-adapter-d2cpmcy4.js → pi-mono-adapter-sfb7zy43.js} +13 -13
  163. package/dist/{pricing-refresh-1yz8jkqv.js → pricing-refresh-h79bg4cf.js} +2 -2
  164. package/dist/{rbac-roles-7s6m31xw.js → rbac-roles-ckq0czp4.js} +2 -2
  165. package/dist/{rbac-roles-dbpx0x9v.js → rbac-roles-jg2e260w.js} +3 -3
  166. package/dist/{render-v2-7y20rjrn.js → render-v2-ymbshmn0.js} +7 -7
  167. package/dist/{resume-wz546x47.js → resume-jdhnt4jk.js} +10 -10
  168. package/dist/{runtime-cb5bd9tz.js → runtime-y28jhhnf.js} +1 -1
  169. package/dist/{session-access-4vcft8kq.js → session-access-k4ta5hvp.js} +5 -5
  170. package/dist/{session-source-backfill-57b50tpw.js → session-source-backfill-528j4s8j.js} +3 -3
  171. package/dist/{setup-e1tevjyj.js → setup-d6pj82fr.js} +15 -6
  172. package/dist/thread-buffer-9w6x5zec.js +40 -0
  173. package/dist/{tree-visibility-07wf1nct.js → tree-visibility-kjxv3nxk.js} +2 -2
  174. package/dist/{user-merge-jobs-n20qpv6s.js → user-merge-jobs-rabbncf6.js} +3 -3
  175. package/dist/{virtual-modules-6fxmn1yv.js → virtual-modules-22k51txd.js} +3 -3
  176. package/dist/{work-objects-eg7y48pe.js → work-objects-xtjbar3r.js} +26 -30
  177. package/dist/{worker-follow-up-jnvnnf2b.js → worker-follow-up-fg48vk6d.js} +21 -22
  178. package/dist/worker-g4aj93dt.js +82 -0
  179. package/dist/{x-d27jj7z7.js → x-vfsqypht.js} +2 -2
  180. package/openapi.json +633 -25
  181. package/package.json +10 -10
  182. package/src/apps/definition.ts +76 -24
  183. package/src/apps/row-store.ts +67 -0
  184. package/src/apps/script-types.ts +131 -21
  185. package/src/apps/store.ts +4 -1
  186. package/src/apps/sync.ts +20 -5
  187. package/src/azure-devops/boards-sync.ts +1 -1
  188. package/src/be/db/script-runs.ts +33 -0
  189. package/src/be/db/slack-card-groups.ts +147 -0
  190. package/src/be/db/slack-trees.ts +38 -1
  191. package/src/be/db/task-idempotency.ts +63 -0
  192. package/src/be/db/tasks/read.ts +27 -1
  193. package/src/be/db/tasks/write.ts +51 -14
  194. package/src/be/db/users/avatar.ts +12 -0
  195. package/src/be/db/workflow-idempotency.ts +6 -1
  196. package/src/be/db/workflows/read.ts +79 -0
  197. package/src/be/db.ts +129 -152
  198. package/src/be/improvements.ts +24 -2
  199. package/src/be/mcp-proxy.ts +45 -11
  200. package/src/be/memory/embedding-space.ts +10 -20
  201. package/src/be/memory/index.ts +35 -0
  202. package/src/be/memory/providers/openai-embedding.ts +10 -0
  203. package/src/be/migrations/344_user_avatar.sql +4 -0
  204. package/src/be/migrations/345_task_status_kind.sql +6 -0
  205. package/src/be/migrations/348_task_deferred_until.sql +4 -0
  206. package/src/be/migrations/354_durable_objects.sql +9 -0
  207. package/src/be/migrations/356_slack_outcome_card_groups.sql +14 -0
  208. package/src/be/migrations/357_task_idempotency_keys.sql +27 -0
  209. package/src/be/migrations/362_favorites_app.sql +36 -0
  210. package/src/be/primitives/object-embed.ts +2 -2
  211. package/src/be/primitives/objects.ts +2 -2
  212. package/src/be/repo-checked-update.ts +58 -5
  213. package/src/be/requester-timezone.ts +10 -0
  214. package/src/be/runtime-pools/supervisor.ts +1 -0
  215. package/src/be/script-connections.ts +5 -1
  216. package/src/be/script-credential-broker.ts +29 -2
  217. package/src/be/scripts/durable.ts +204 -0
  218. package/src/be/scripts/extract-schema.ts +29 -4
  219. package/src/be/scripts/run-credential.ts +1 -8
  220. package/src/be/scripts/typecheck.ts +33 -8
  221. package/src/be/seed-scripts/catalog/memory-eval.ts +11 -2
  222. package/src/be/seed-scripts/catalog/tool-usage.ts +27 -8
  223. package/src/be/swarm-config-guard.ts +91 -7
  224. package/src/be/users.ts +33 -12
  225. package/src/bitbucket/handlers.ts +1 -1
  226. package/src/comb/review-batch.ts +16 -5
  227. package/src/commands/context-preamble.ts +237 -0
  228. package/src/commands/credential-outcome-report.ts +96 -0
  229. package/src/commands/e2b.ts +14 -0
  230. package/src/commands/entrypoint-mcp-config.ts +231 -0
  231. package/src/commands/onboard/agent-fs-version.ts +1 -1
  232. package/src/commands/onboard/compose-generator.ts +2 -1
  233. package/src/commands/onboard/env-generator.ts +16 -7
  234. package/src/commands/runner.ts +72 -10
  235. package/src/commands/setup.tsx +17 -3
  236. package/src/event-waits/github.ts +39 -6
  237. package/src/event-waits/index.ts +4 -2
  238. package/src/event-waits/types.ts +10 -3
  239. package/src/extensions/contract-types.generated.ts +1 -1
  240. package/src/github/app.ts +177 -13
  241. package/src/github/handlers.ts +7 -2
  242. package/src/github/pull-request-state.ts +100 -11
  243. package/src/gitlab/handlers.ts +2 -2
  244. package/src/heartbeat/heartbeat.ts +6 -1
  245. package/src/hooks/hook.ts +8 -2
  246. package/src/hooks/native-tool-hooks.ts +4 -2
  247. package/src/http/api-keys.ts +26 -0
  248. package/src/http/apps.ts +82 -42
  249. package/src/http/asset-key-write.ts +45 -0
  250. package/src/http/assets.ts +4 -3
  251. package/src/http/comb.ts +21 -5
  252. package/src/http/config.ts +8 -4
  253. package/src/http/github-token.ts +27 -6
  254. package/src/http/heartbeat.ts +5 -0
  255. package/src/http/index.ts +12 -6
  256. package/src/http/kv.ts +7 -5
  257. package/src/http/mcp-oauth.ts +16 -0
  258. package/src/http/mcp-servers.ts +43 -3
  259. package/src/http/memory.ts +28 -1
  260. package/src/http/metrics.ts +11 -4
  261. package/src/http/onboarding.ts +12 -1
  262. package/src/http/pages.ts +4 -10
  263. package/src/http/repos.ts +27 -11
  264. package/src/http/request-principal.ts +27 -1
  265. package/src/http/schedules.ts +42 -14
  266. package/src/http/script-connection-proxy.ts +3 -1
  267. package/src/http/script-runs.ts +21 -10
  268. package/src/http/scripts.ts +177 -26
  269. package/src/http/session-cost-recompute.ts +9 -4
  270. package/src/http/sessions.ts +7 -2
  271. package/src/http/skills.ts +70 -0
  272. package/src/http/status.ts +2 -0
  273. package/src/http/tasks.ts +115 -19
  274. package/src/http/trackers/jira.ts +18 -3
  275. package/src/http/trackers/linear.ts +3 -0
  276. package/src/http/users.ts +5 -0
  277. package/src/http/webhooks.ts +19 -1
  278. package/src/http/workflows.ts +5 -10
  279. package/src/integrations/chat-sdk/commands.ts +3 -1
  280. package/src/jira/sync.ts +1 -1
  281. package/src/kv-limits.ts +2 -0
  282. package/src/kv-reserved-namespaces.ts +25 -2
  283. package/src/linear/sync.ts +5 -3
  284. package/src/prompts/session-templates.ts +50 -0
  285. package/src/prompts/session-turns.ts +30 -0
  286. package/src/providers/acp-targets.ts +2 -2
  287. package/src/providers/amp-adapter.ts +1 -1
  288. package/src/providers/claude-adapter.ts +5 -0
  289. package/src/providers/claude-managed-adapter.ts +14 -0
  290. package/src/providers/claude-sdk-session.ts +19 -1
  291. package/src/providers/cursor-adapter.ts +1 -1
  292. package/src/providers/dsh-adapter.ts +1 -1
  293. package/src/providers/opencode-adapter.ts +3 -5
  294. package/src/providers/runtime-dependencies.ts +11 -8
  295. package/src/rbac/legacy-policy.ts +7 -0
  296. package/src/rbac/permissions.ts +27 -0
  297. package/src/scheduler/deferred-task-waits.ts +74 -13
  298. package/src/scheduler/scheduler.ts +36 -18
  299. package/src/script-workflows/executor.ts +37 -8
  300. package/src/script-workflows/supervisor.ts +14 -0
  301. package/src/scripts-runtime/ctx.ts +5 -1
  302. package/src/scripts-runtime/durable-object-base.ts +19 -0
  303. package/src/scripts-runtime/eval-harness.ts +46 -1
  304. package/src/scripts-runtime/executors/native.ts +13 -1
  305. package/src/scripts-runtime/executors/quickjs-bundle.ts +20 -1
  306. package/src/scripts-runtime/executors/quickjs-prelude.ts +40 -1
  307. package/src/scripts-runtime/executors/quickjs-runner.ts +26 -3
  308. package/src/scripts-runtime/executors/quickjs-worker.ts +2 -1
  309. package/src/scripts-runtime/executors/types.ts +26 -0
  310. package/src/scripts-runtime/extract-signature.ts +96 -1
  311. package/src/scripts-runtime/loader.ts +11 -5
  312. package/src/scripts-runtime/mcp-client.ts +1 -1
  313. package/src/scripts-runtime/sdk-allowlist.ts +1 -0
  314. package/src/scripts-runtime/swarm-config.ts +7 -0
  315. package/src/scripts-runtime/swarm-sdk.ts +12 -2
  316. package/src/scripts-runtime/types/stdlib.d.ts +27 -1
  317. package/src/scripts-runtime/types/swarm-extension.d.ts +20 -2
  318. package/src/scripts-runtime/types/swarm-sdk.d.ts +27 -1
  319. package/src/slack/actions.ts +25 -1
  320. package/src/slack/assistant.ts +8 -0
  321. package/src/slack/blocks.ts +35 -0
  322. package/src/slack/channel-activity.ts +7 -0
  323. package/src/slack/enrich.ts +46 -54
  324. package/src/slack/files.ts +173 -23
  325. package/src/slack/handlers.test.ts +17 -19
  326. package/src/slack/handlers.ts +15 -14
  327. package/src/slack/render-v2.ts +403 -17
  328. package/src/slack/responses.ts +61 -5
  329. package/src/slack/session-mirror.ts +10 -5
  330. package/src/slack/task-output.ts +25 -14
  331. package/src/slack/templates.ts +9 -0
  332. package/src/slack/thread-participants.ts +64 -24
  333. package/src/slack/watcher.ts +4 -4
  334. package/src/slack/work-objects.ts +1 -1
  335. package/src/stdio.ts +5 -0
  336. package/src/tests/agents-list-model-display.test.ts +4 -0
  337. package/src/tests/api-drain-worker-e2e.test.ts +0 -2
  338. package/src/tests/approval-auto-cancellation-migration.test.ts +8 -19
  339. package/src/tests/approval-card-resolution.test.ts +2 -17
  340. package/src/tests/approval-requests-notifications.test.ts +41 -27
  341. package/src/tests/approval-requests.test.ts +137 -369
  342. package/src/tests/apps-script-types.test.ts +63 -16
  343. package/src/tests/apps-sort-order.test.ts +87 -0
  344. package/src/tests/apps-sync-engine.test.ts +5 -3
  345. package/src/tests/apps-table-filters-migration.test.ts +44 -25
  346. package/src/tests/bedrock-model-groups.test.ts +4 -0
  347. package/src/tests/bitbucket-handlers.test.ts +2 -0
  348. package/src/tests/channel-activity.test.ts +9 -0
  349. package/src/tests/chat-sdk-commands.test.ts +1 -0
  350. package/src/tests/chatgpt-subscription-model-groups.test.ts +4 -0
  351. package/src/tests/claude-adapter.test.ts +35 -0
  352. package/src/tests/claude-hook-output.test.ts +2 -0
  353. package/src/tests/claude-managed-adapter.test.ts +15 -3
  354. package/src/tests/claude-sdk-stderr.test.ts +28 -0
  355. package/src/tests/codex-adapter.test.ts +3 -92
  356. package/src/tests/codex-gpt6-release.test.ts +4 -9
  357. package/src/tests/codex-oauth-credential-info.test.ts +35 -18
  358. package/src/tests/codex-oauth.test.ts +0 -6
  359. package/src/tests/codex-pool.test.ts +5 -214
  360. package/src/tests/codex-rate-limit-parse.test.ts +0 -7
  361. package/src/tests/codex-swarm-events.test.ts +11 -54
  362. package/src/tests/comb-review-batch.test.ts +17 -4
  363. package/src/tests/comb-status.test.ts +1 -0
  364. package/src/tests/db-client-busy-retry.test.ts +49 -16
  365. package/src/tests/db-client.test.ts +11 -5
  366. package/src/tests/db-task-read-contract.test.ts +1 -0
  367. package/src/tests/db-task-write-contract.test.ts +2 -2
  368. package/src/tests/defer-task.test.ts +24 -1
  369. package/src/tests/dsh-adapter.test.ts +1 -1
  370. package/src/tests/e2b-dispatch.test.ts +13 -1
  371. package/src/tests/e2e-shards.test.ts +9 -9
  372. package/src/tests/enabled-tools.test.ts +0 -2
  373. package/src/tests/entrypoint-mcp-config.test.ts +642 -0
  374. package/src/tests/fixtures/base-prompt-baseline.json +6 -6
  375. package/src/tests/fixtures/onboard/content.env.txt +2 -2
  376. package/src/tests/fixtures/onboard/dev.env.txt +2 -2
  377. package/src/tests/fixtures/onboard/full-all.env.txt +2 -2
  378. package/src/tests/fixtures/onboard/full.env.txt +2 -2
  379. package/src/tests/fixtures/onboard/research.env.txt +2 -2
  380. package/src/tests/fixtures/onboard/solo.env.txt +2 -2
  381. package/src/tests/fixtures/runner-missing-dependency.ts +2 -1
  382. package/src/tests/fx-adapter.test.ts +4 -5
  383. package/src/tests/github-app-worker-auth-helper.test.ts +147 -1
  384. package/src/tests/gitlab-handlers.test.ts +2 -0
  385. package/src/tests/heartbeat-jev-gate.test.ts +9 -241
  386. package/src/tests/heartbeat-reroute-decision.test.ts +2 -0
  387. package/src/tests/heartbeat-supersede-resume.test.ts +2 -0
  388. package/src/tests/heartbeat.test.ts +1 -0
  389. package/src/tests/hook-mcp-config-precedence.test.ts +59 -0
  390. package/src/tests/hook-ping-me-order.test.ts +1 -0
  391. package/src/tests/hook-runtime-close.test.ts +1 -0
  392. package/src/tests/improvements-payload.test.ts +2 -2
  393. package/src/tests/key-usage-selection.test.ts +302 -0
  394. package/src/tests/memory-e2e.test.ts +34 -103
  395. package/src/tests/memory-key-paths.test.ts +5 -0
  396. package/src/tests/memory-rater-llm.test.ts +33 -149
  397. package/src/tests/memory-store.test.ts +24 -125
  398. package/src/tests/memory.test.ts +31 -100
  399. package/src/tests/merge-gate-detect-changes.test.ts +108 -2
  400. package/src/tests/model-groups-live-catalog.test.ts +4 -0
  401. package/src/tests/oauth-credential-bindings.test.ts +8 -3
  402. package/src/tests/oauth-refresh-failure.test.ts +15 -3
  403. package/src/tests/onboard-env.test.ts +1 -1
  404. package/src/tests/openai-compatible-providers.test.ts +5 -0
  405. package/src/tests/openapi-route-headers.test.ts +2 -1
  406. package/src/tests/opus-5-5-registry.test.ts +4 -0
  407. package/src/tests/otel-service-name.test.ts +0 -9
  408. package/src/tests/otel-session-cost-metrics.test.ts +1 -38
  409. package/src/tests/pool-session-logs.test.ts +8 -42
  410. package/src/tests/pre-push-affected-tests.test.ts +106 -0
  411. package/src/tests/prompt-template-session.test.ts +3 -0
  412. package/src/tests/provider-runtime-dependencies.test.ts +26 -15
  413. package/src/tests/routing-affinity-inventory.test.ts +11 -0
  414. package/src/tests/runner-api-drain.test.ts +2 -17
  415. package/src/tests/runner-context-preamble.test.ts +202 -0
  416. package/src/tests/runner-repo-clone-args.test.ts +116 -0
  417. package/src/tests/runner-terminal-window-report.test.ts +132 -0
  418. package/src/tests/runtime-supervisor-failures.test.ts +1 -0
  419. package/src/tests/sandboxed-process.test.ts +26 -21
  420. package/src/tests/schedule-http-triage-tools.test.ts +12 -9
  421. package/src/tests/scheduled-tasks.test.ts +14 -51
  422. package/src/tests/scheduler-occurrence.test.ts +60 -9
  423. package/src/tests/script-connections-mcp.test.ts +6 -3
  424. package/src/tests/script-connections.test.ts +4 -0
  425. package/src/tests/script-executor-conformance.test.ts +4 -48
  426. package/src/tests/script-executor-quickjs-pool.test.ts +9 -7
  427. package/src/tests/script-native-startup.test.ts +21 -25
  428. package/src/tests/scripts-namespaces.test.ts +3 -1
  429. package/src/tests/secret-rules.test.ts +4 -2
  430. package/src/tests/secret-scrubber.test.ts +8 -2
  431. package/src/tests/session-cost-recompute-unit.test.ts +39 -0
  432. package/src/tests/session-costs-recompute-all-providers.test.ts +6 -3
  433. package/src/tests/session-logs.test.ts +1 -260
  434. package/src/tests/session-route-posture.test.ts +7 -1
  435. package/src/tests/slack-file-tools-attachments.test.ts +14 -9
  436. package/src/tests/slack-identity-resolution.test.ts +10 -3
  437. package/src/tests/slack-inline-output.test.ts +10 -8
  438. package/src/tests/slack-render-v2.test.ts +14 -152
  439. package/src/tests/slack-steering.test.ts +8 -2
  440. package/src/tests/slack-thread-participants.test.ts +11 -1
  441. package/src/tests/sonnet-5-5-registry.test.ts +4 -0
  442. package/src/tests/swarm-config-encryption.test.ts +5 -8
  443. package/src/tests/task-cascade-fail.test.ts +1 -0
  444. package/src/tests/task-supersede-resume.test.ts +1 -0
  445. package/src/tests/test-proc.ts +5 -2
  446. package/src/tests/ui-spec-script-actions-config.test.ts +7 -3
  447. package/src/tests/window-stream-reporter.test.ts +122 -0
  448. package/src/tests/workflow-agent-task-retry.test.ts +1 -3
  449. package/src/tests/workflow-cascade-cancel.test.ts +1 -0
  450. package/src/tests/workflow-retry-v2.test.ts +34 -43
  451. package/src/tests/workflow-retry-validation.test.ts +8 -48
  452. package/src/tests/workflow-triggers-v2.test.ts +35 -11
  453. package/src/tests/worktree-reaper.test.ts +2 -2
  454. package/src/tools/app-patch.ts +6 -2
  455. package/src/tools/app-upsert.ts +8 -4
  456. package/src/tools/cancel-task.ts +2 -2
  457. package/src/tools/defer-task.ts +24 -79
  458. package/src/tools/get-task-details.ts +8 -4
  459. package/src/tools/get-tasks.ts +13 -2
  460. package/src/tools/kv/kv-get.ts +2 -0
  461. package/src/tools/kv/kv-list.ts +11 -5
  462. package/src/tools/kv/kv-set.ts +1 -3
  463. package/src/tools/manage-user.ts +9 -0
  464. package/src/tools/repos/update-repo.ts +37 -19
  465. package/src/tools/schedules/run-schedule-now.ts +21 -1
  466. package/src/tools/script-apis.ts +9 -4
  467. package/src/tools/script-common.ts +2 -2
  468. package/src/tools/script-run.ts +8 -0
  469. package/src/tools/script-upsert.ts +1 -1
  470. package/src/tools/slack-download-file.ts +15 -12
  471. package/src/tools/slack-post.ts +7 -1
  472. package/src/tools/slack-read.ts +3 -1
  473. package/src/tools/slack-reply.ts +16 -0
  474. package/src/tools/slack-start-thread.ts +8 -1
  475. package/src/tools/slack-upload-file.ts +99 -96
  476. package/src/tools/store-progress.ts +5 -3
  477. package/src/tools/swarm-config/set-config.ts +3 -1
  478. package/src/tools/swarm-x.ts +0 -2
  479. package/src/tools/utils.ts +3 -0
  480. package/src/types.ts +101 -2
  481. package/src/utils/constants.ts +32 -0
  482. package/src/utils/credentials.ts +42 -5
  483. package/src/utils/deferral-time.ts +61 -0
  484. package/src/utils/error-tracker.ts +6 -0
  485. package/src/utils/key-usage.ts +114 -0
  486. package/src/utils/request-auth-context.ts +15 -16
  487. package/src/utils/sandboxed-process.ts +1 -0
  488. package/src/utils/secret-scrubber.ts +1 -1
  489. package/src/workflows/engine.ts +6 -11
  490. package/src/workflows/executors/swarm-script.ts +0 -2
  491. package/src/workflows/foreach-driver.ts +6 -12
  492. package/src/workflows/input.ts +24 -1
  493. package/src/workflows/node-timeout.ts +18 -0
  494. package/src/workflows/resume.ts +5 -2
  495. package/src/workflows/retry-poller.ts +2 -1
  496. package/src/workflows/triggers.ts +21 -11
  497. package/src/x/composio.ts +10 -1
  498. package/templates/skills/apps/SKILL.md +6 -2
  499. package/templates/skills/apps/content.md +6 -2
  500. package/templates/skills/boards-and-sheets/content.md +4 -2
  501. package/templates/skills/code-quality/content.md +4 -4
  502. package/templates/skills/pages/content.md +7 -0
  503. package/templates/skills/scheduled-task-resilience/SKILL.md +2 -0
  504. package/templates/skills/scheduled-task-resilience/content.md +2 -0
  505. package/templates/skills/swarm-docs/content.md +8 -0
  506. package/templates/skills/swarm-scripts/SKILL.md +45 -0
  507. package/templates/skills/swarm-scripts/content.md +45 -0
  508. package/dist/acp-adapter-mr4temec.js +0 -17
  509. package/dist/cli-1vmhnncj.js +0 -173
  510. package/dist/cli-kj0hyr43.js +0 -51
  511. package/dist/cli-ysv0k1we.js +0 -459
  512. package/dist/core-gsvj5f3z.js +0 -42
  513. package/dist/dsh-adapter-8abzqk5c.js +0 -9
  514. package/dist/fx-adapter-4sjrbdne.js +0 -20
  515. package/dist/grok-adapter-3a0ezfee.js +0 -20
  516. package/dist/handlers-ef3k11hb.js +0 -41
  517. package/dist/index-aetfyx6p.js +0 -13
  518. package/dist/index-e6bq0exk.js +0 -42
  519. package/dist/index-hf2k1vge.js +0 -39
  520. package/dist/index-taxmejj3.js +0 -44
  521. package/dist/lead-5vt6f174.js +0 -83
  522. package/dist/thread-buffer-686pa1p1.js +0 -42
  523. package/dist/worker-4vp616ms.js +0 -83
  524. package/src/tests/apps-table-selection-migration.test.ts +0 -95
  525. package/src/tests/extensions-example-heartbeat-remediate.test.ts +0 -69
  526. package/src/tests/extensions-example-rewrite-and-suppress.test.ts +0 -70
@@ -0,0 +1,61 @@
1
+ // Pure time formatting for deferral cards, shared by `defer-task` and the
2
+ // channel renderers. Kept apart from the tool so Slack rendering does not load
3
+ // the tool's module graph.
4
+
5
+ export function isValidTimezone(zone: unknown): zone is string {
6
+ if (typeof zone !== "string" || !zone) return false;
7
+ try {
8
+ new Intl.DateTimeFormat("en-US", { timeZone: zone });
9
+ return true;
10
+ } catch {
11
+ return false;
12
+ }
13
+ }
14
+
15
+ /** Date/time parts of `date` as rendered in IANA zone `tz`. */
16
+ function partsInTz(date: Date, tz: string) {
17
+ const fmt = new Intl.DateTimeFormat("en-US", {
18
+ timeZone: tz,
19
+ year: "numeric",
20
+ month: "2-digit",
21
+ day: "2-digit",
22
+ hour: "2-digit",
23
+ minute: "2-digit",
24
+ timeZoneName: "short",
25
+ hourCycle: "h23",
26
+ });
27
+ const parts = Object.fromEntries(fmt.formatToParts(date).map((p) => [p.type, p.value]));
28
+ return {
29
+ year: parts.year!,
30
+ month: parts.month!,
31
+ day: parts.day!,
32
+ hour: parts.hour!,
33
+ minute: parts.minute!,
34
+ abbreviation: parts.timeZoneName!,
35
+ };
36
+ }
37
+
38
+ /**
39
+ * "today"/"tomorrow" or "MM-dd" plus "HH:MM", both computed in `tz`.
40
+ * Falls back to UTC (parts still computed correctly) if `tz` is not a valid
41
+ * IANA zone — the caller decides whether to label the fallback.
42
+ */
43
+ export function formatDeferralDateTime(
44
+ target: Date,
45
+ now: Date,
46
+ tz: string,
47
+ labelZone = false,
48
+ ): { date: string; time: string } {
49
+ const zone = isValidTimezone(tz) ? tz : "UTC";
50
+ const t = partsInTz(target, zone);
51
+ // Minute precision: this string is read by a human deciding whether to wait,
52
+ // and the wake-up is scheduler-polled anyway, so seconds were false precision.
53
+ const time = `${t.hour}:${t.minute}${labelZone ? ` ${t.abbreviation}` : ""}`;
54
+ const n = partsInTz(now, zone);
55
+ if (t.year === n.year && t.month === n.month && t.day === n.day) return { date: "today", time };
56
+ const tm = partsInTz(new Date(now.getTime() + 86_400_000), zone);
57
+ if (t.year === tm.year && t.month === tm.month && t.day === tm.day) {
58
+ return { date: "tomorrow", time };
59
+ }
60
+ return { date: `${t.month}-${t.day}`, time };
61
+ }
@@ -38,6 +38,12 @@ export interface RateLimitWindowInfo {
38
38
 
39
39
  export type RateLimitWindowTelemetry = Record<string, RateLimitWindowInfo>;
40
40
 
41
+ /**
42
+ * Name of the `custom` provider event that carries a session's merged window
43
+ * snapshot after each `rate_limit_event`. The runner streams it to the API.
44
+ */
45
+ export const RATE_LIMIT_WINDOWS_EVENT = "rate_limit_windows";
46
+
41
47
  /**
42
48
  * A key that hit its provider spend limit (OpenRouter key limit or credits).
43
49
  * `resetsAt` is null when the provider names no reset: the key stays benched
@@ -0,0 +1,114 @@
1
+ /**
2
+ * Lowest-score-first key ranking, with a 10-point band. Pure: shared by `GET /api/keys/available`
3
+ * (which computes the scores from stored windows) and the worker picker
4
+ * (`selectCredential`). It only orders admissible keys; it never excludes one.
5
+ */
6
+
7
+ import { type ModelFamily, windowForModelFamily } from "./model-rate-limit-windows";
8
+
9
+ /** Key-wide windows that count as a key's usage. Model-scoped weekly windows do not. */
10
+ export const KEY_USAGE_WINDOWS = ["five_hour", "seven_day"] as const;
11
+
12
+ type UsageWindow = { utilization?: number; resetsAt?: number; durationMins?: number };
13
+
14
+ /**
15
+ * How the worker ranks admissible pool keys (`CREDENTIAL_SELECTION_STRATEGY`).
16
+ * `pace`: most under even use first (`keyPaceFromWindows`). `usage`: lowest
17
+ * utilization first (`keyUsageFromWindows`).
18
+ */
19
+ export const CREDENTIAL_SELECTION_STRATEGIES = ["pace", "usage"] as const;
20
+ export type CredentialSelectionStrategy = (typeof CREDENTIAL_SELECTION_STRATEGIES)[number];
21
+
22
+ /** Parses the setting. Anything but `pace` is `usage`, the default until `pace` has soaked. */
23
+ export function credentialSelectionStrategy(
24
+ value: string | undefined,
25
+ ): CredentialSelectionStrategy {
26
+ return value?.trim().toLowerCase() === "pace" ? "pace" : "usage";
27
+ }
28
+
29
+ /**
30
+ * A key's current usage, as a utilization fraction (0..1, can exceed 1): the
31
+ * max over its non-expired `five_hour` and `seven_day` windows. A window past
32
+ * `resetsAt` (epoch seconds) counts as 0. No observation counts as 0, so a
33
+ * fresh key ranks first.
34
+ */
35
+ export function keyUsageFromWindows(
36
+ windows: Record<string, UsageWindow> | null | undefined,
37
+ nowMs: number,
38
+ ): number {
39
+ let usage = 0;
40
+ for (const name of KEY_USAGE_WINDOWS) {
41
+ const window = windows?.[name];
42
+ if (!window || typeof window.utilization !== "number" || !Number.isFinite(window.utilization))
43
+ continue;
44
+ if (typeof window.resetsAt === "number" && window.resetsAt * 1000 <= nowMs) continue;
45
+ usage = Math.max(usage, window.utilization);
46
+ }
47
+ return usage;
48
+ }
49
+
50
+ /**
51
+ * A key's pace delta, as a fraction: used minus the share of the window that
52
+ * has passed (the even-use point), taken as the max over the key's live
53
+ * `five_hour` and `seven_day` windows plus the weekly window of `modelFamily`
54
+ * (Fable, Opus, Sonnet) when given. Negative means quota that will go unused
55
+ * by the reset; the lowest delta ranks first, so a key over pace on any of
56
+ * those windows ranks behind one under pace on all of them. A window with no
57
+ * utilization, no reset or a passed reset is skipped. Undefined when none
58
+ * is left: the caller counts it as 0 (on pace), never as a reading.
59
+ */
60
+ export function keyPaceFromWindows(
61
+ windows: Record<string, UsageWindow> | null | undefined,
62
+ nowMs: number,
63
+ modelFamily?: ModelFamily,
64
+ ): number | undefined {
65
+ const modelWindow = modelFamily ? windowForModelFamily(modelFamily) : undefined;
66
+ let pace: number | undefined;
67
+ for (const name of [...KEY_USAGE_WINDOWS, ...(modelWindow ? [modelWindow] : [])]) {
68
+ const window = windows?.[name];
69
+ if (!window || typeof window.utilization !== "number" || !Number.isFinite(window.utilization))
70
+ continue;
71
+ if (typeof window.resetsAt !== "number" || window.resetsAt * 1000 <= nowMs) continue;
72
+ const durationMs = (window.durationMins ?? (name === "five_hour" ? 300 : 10080)) * 60_000;
73
+ const elapsed = Math.min(1, Math.max(0, 1 - (window.resetsAt * 1000 - nowMs) / durationMs));
74
+ pace = Math.max(pace ?? Number.NEGATIVE_INFINITY, window.utilization - elapsed);
75
+ }
76
+ return pace;
77
+ }
78
+
79
+ /**
80
+ * Width of the low-score band, as a utilization fraction. Every admissible key
81
+ * within this distance of the lowest score (usage or pace delta) is an equal candidate.
82
+ */
83
+ export const KEY_USAGE_BAND = 0.1;
84
+
85
+ /**
86
+ * Picks the key for a draw among `indices`:
87
+ * 1. the keys whose score (usage or pace delta) is within `band` of the lowest;
88
+ * 2. among them, the keys with the fewest running sessions (`sessionsByIndex`);
89
+ * 3. ties at random.
90
+ *
91
+ * A plain minimum would send every concurrent draw to one key until the next
92
+ * usage report lands. The session count moves at session start, so a burst
93
+ * spreads within seconds; the band still covers draws that land before the
94
+ * session-start report. An index with no usage or session entry counts as 0.
95
+ */
96
+ export function pickLowestUsage(
97
+ indices: readonly number[],
98
+ usageByIndex: readonly (number | null | undefined)[] | undefined,
99
+ sessionsByIndex?: readonly (number | null | undefined)[],
100
+ random: () => number = Math.random,
101
+ band: number = KEY_USAGE_BAND,
102
+ ): number | undefined {
103
+ if (indices.length === 0) return undefined;
104
+ const entryAt = (values: typeof usageByIndex, i: number) => {
105
+ const value = values?.[i];
106
+ return typeof value === "number" && Number.isFinite(value) ? value : 0;
107
+ };
108
+ const lowest = Math.min(...indices.map((i) => entryAt(usageByIndex, i)));
109
+ // The epsilon keeps a key exactly `band` above the lowest inside the band.
110
+ const inBand = indices.filter((i) => entryAt(usageByIndex, i) <= lowest + band + 1e-9);
111
+ const fewest = Math.min(...inBand.map((i) => entryAt(sessionsByIndex, i)));
112
+ const best = inBand.filter((i) => entryAt(sessionsByIndex, i) === fewest);
113
+ return best[Math.floor(random() * best.length)];
114
+ }
@@ -2,6 +2,14 @@ import { AsyncLocalStorage } from "node:async_hooks";
2
2
  import type { IncomingMessage } from "node:http";
3
3
  import type { User } from "../types";
4
4
 
5
+ /** Provenance carried by a script run's credential. */
6
+ export type ScriptRunProvenance = {
7
+ sourceStepId?: string;
8
+ sourceScriptRunId?: string;
9
+ objectChain?: string[];
10
+ depth?: number;
11
+ };
12
+
5
13
  export type HttpRequestAuth = (
6
14
  | { kind: "operator"; fingerprint: string }
7
15
  /**
@@ -14,7 +22,7 @@ export type HttpRequestAuth = (
14
22
  | { kind: "guest" }
15
23
  | { kind: "controller"; controllerId: string; tokenId: string; expiresAt: string }
16
24
  /** Session token bound to an ACP task, a worker runtime, or only its agent (aseph_ prefix). */
17
- | {
25
+ | ({
18
26
  kind: "agent";
19
27
  tokenKind: "task" | "runtime" | "agent";
20
28
  agentId: string;
@@ -22,14 +30,7 @@ export type HttpRequestAuth = (
22
30
  runtimeId: string | null;
23
31
  tokenId: string;
24
32
  expiresAt: string;
25
- /**
26
- * Set on a script run's per-run token (`mintScriptRunToken`): the
27
- * swarm-script workflow step that started the run, and the run's own
28
- * `script_runs` row. Rows the request creates are stamped with them.
29
- */
30
- sourceStepId?: string | null;
31
- sourceScriptRunId?: string | null;
32
- }
33
+ } & ScriptRunProvenance)
33
34
  ) & {
34
35
  /** Verified page context for agent-scoped operations. This does not identify the viewer. */
35
36
  page?: { id: string; executionAgentId: string };
@@ -104,19 +105,17 @@ export function getCurrentRequestUserId(): string | undefined {
104
105
  return authUserId(getCurrentRequestAuth());
105
106
  }
106
107
 
107
- /** Where the current request's script run came from, when it presents a script-run token. */
108
- export type RunProvenance = { sourceStepId: string | null; sourceScriptRunId: string | null };
109
-
110
108
  /**
111
109
  * Provenance of the current request: set only when it authenticated with a
112
110
  * script run's per-run token that recorded a step or a script run. Async work
113
111
  * started inside the request inherits it (the workflow engine continuing a run
114
112
  * it triggered), so callers stamp only rows a script can create directly.
115
113
  */
116
- export function getCurrentRunProvenance(): RunProvenance | null {
114
+ export function getCurrentRunProvenance(): ScriptRunProvenance | null {
117
115
  const auth = getCurrentRequestAuth();
118
116
  if (auth?.kind !== "agent") return null;
119
- const sourceStepId = auth.sourceStepId ?? null;
120
- const sourceScriptRunId = auth.sourceScriptRunId ?? null;
121
- return sourceStepId || sourceScriptRunId ? { sourceStepId, sourceScriptRunId } : null;
117
+ const { sourceStepId, sourceScriptRunId, objectChain, depth } = auth;
118
+ return sourceStepId || sourceScriptRunId || objectChain !== undefined || depth
119
+ ? { sourceStepId, sourceScriptRunId, objectChain, depth }
120
+ : null;
122
121
  }
@@ -224,6 +224,7 @@ function buildSandboxedCommandCore(
224
224
 
225
225
  return [
226
226
  useBashShell ? "bash" : "sh",
227
+ ...(useBashShell ? ["--noprofile", "--norc", "-p"] : []),
227
228
  "-c",
228
229
  `${ulimits}; exec ${dropPrivileges}env -i ${envAssignments} ${quotedInner}`,
229
230
  ];
@@ -61,7 +61,7 @@ import { GITLEAKS_RULES } from "./secret-rules.generated";
61
61
  * LangSmith, CircleCI, Google `AQ.`, HubSpot, New Relic and Sentry DSN
62
62
  * shapes; pass 4 redacts a PEM private key cut off before its END line.
63
63
  */
64
- export const SCRUBBER_RULES_VERSION = 15;
64
+ export const SCRUBBER_RULES_VERSION = 16;
65
65
 
66
66
  /** Env-var names that are always considered secrets, even without suffix hints. */
67
67
  const SENSITIVE_KEY_EXACT = new Set<string>([
@@ -57,7 +57,7 @@ import {
57
57
  import { getSecretInputKeys, redactSecretsForStorage, resolveInputs } from "./input";
58
58
  import { validateJsonSchema } from "./json-schema-validator";
59
59
  import { getMaxWorkflowStepsPerRun } from "./limits";
60
- import { resolveNodeTimeoutMs, startStepDeadline } from "./node-timeout";
60
+ import { runWithNodeDeadline } from "./node-timeout";
61
61
  import { findWorkflowReadinessProblems, formatReadinessRunError } from "./readiness";
62
62
  import {
63
63
  hasOwedSuccessors,
@@ -1127,18 +1127,13 @@ async function runClaimedStep(
1127
1127
  inputCtx: interpolationCtx,
1128
1128
  };
1129
1129
 
1130
- const deadline = startStepDeadline(resolveNodeTimeoutMs(node));
1131
-
1132
1130
  let result: Awaited<ReturnType<typeof executor.run>>;
1133
1131
  try {
1134
- result = await Promise.race([
1135
- executor.run({
1136
- config: interpolatedConfig,
1137
- context: executionCtx,
1138
- meta: { ...meta, signal: deadline.signal },
1139
- }),
1140
- deadline.expired,
1141
- ]).finally(deadline.clear);
1132
+ result = await runWithNodeDeadline(node, executor, {
1133
+ config: interpolatedConfig,
1134
+ context: executionCtx,
1135
+ meta,
1136
+ });
1142
1137
  } catch (err) {
1143
1138
  const errorMsg = err instanceof Error ? err.message : String(err);
1144
1139
 
@@ -18,7 +18,6 @@ import {
18
18
  MIN_SCRIPT_WALL_CLOCK_MS,
19
19
  } from "../../scripts-runtime/executors/types";
20
20
  import type { ExecutorMeta } from "../../types";
21
- import { getMcpBaseUrl } from "../../utils/constants";
22
21
  import { findInterpolationTokens } from "../../utils/template";
23
22
  import { BaseExecutor, type ExecutorResult } from "./base";
24
23
 
@@ -136,7 +135,6 @@ export class SwarmScriptExecutor extends BaseExecutor<
136
135
  fsMode: "none",
137
136
  executor: resolved.script.executor,
138
137
  agentId: agentId ?? "workflow",
139
- mcpBaseUrl: getMcpBaseUrl(),
140
138
  egressSecrets: credentials.egressSecrets,
141
139
  failedBindings: credentials.failedBindings,
142
140
  userConfig: credentials.userConfig,
@@ -47,7 +47,7 @@ import {
47
47
  settleForeachChild,
48
48
  } from "./foreach-join";
49
49
  import { getSecretInputKeys } from "./input";
50
- import { resolveNodeTimeoutMs, startStepDeadline } from "./node-timeout";
50
+ import { runWithNodeDeadline } from "./node-timeout";
51
51
  import { rebuildNodeExecutionInput } from "./step-input";
52
52
  import { claimAndOweWalk, type SuccessorWalkDebt } from "./successor-routing";
53
53
 
@@ -521,21 +521,15 @@ async function startChild(input: {
521
521
  }
522
522
 
523
523
  const executor = registry.get(bodyType);
524
- const deadline = startStepDeadline(resolveNodeTimeoutMs({ type: bodyType, config }));
525
524
  let result: Awaited<ReturnType<typeof executor.run>>;
526
525
  try {
527
- result = await Promise.race([
528
- executor.run({
529
- config,
530
- context: { ...ctx, ...bodyCtx },
531
- meta: { ...meta, stepId: child.id, nodeId: child.nodeId, signal: deadline.signal },
532
- }),
533
- deadline.expired,
534
- ]);
526
+ result = await runWithNodeDeadline({ type: bodyType, config }, executor, {
527
+ config,
528
+ context: { ...ctx, ...bodyCtx },
529
+ meta: { ...meta, stepId: child.id, nodeId: child.nodeId },
530
+ });
535
531
  } catch (err) {
536
532
  return { status: "failed", error: err instanceof Error ? err.message : String(err) };
537
- } finally {
538
- deadline.clear();
539
533
  }
540
534
 
541
535
  if (result.status === "failed") {
@@ -23,16 +23,39 @@ export async function resolveInputs(
23
23
  return resolved;
24
24
  }
25
25
 
26
+ /**
27
+ * The `${ENV_VAR}` names a workflow may read, from `WORKFLOW_INPUT_ENV_ALLOWLIST`
28
+ * (comma-separated, blanks ignored). Null means the variable is unset and imposes no
29
+ * restriction. An explicitly empty list allows no names. Read on every call, so a config
30
+ * reload applies at once.
31
+ */
32
+ export function workflowInputEnvAllowlist(): Set<string> | null {
33
+ const raw = process.env.WORKFLOW_INPUT_ENV_ALLOWLIST;
34
+ if (raw === undefined) return null;
35
+ const names = raw
36
+ .split(",")
37
+ .map((name) => name.trim())
38
+ .filter((name) => name.length > 0);
39
+ return new Set(names);
40
+ }
41
+
26
42
  /**
27
43
  * Resolve a single input value, supporting `${ENV_VAR}` and `secret.NAME`
28
44
  * references. A plain string is returned unchanged. Throws if a referenced
29
- * env var or swarm secret cannot be found.
45
+ * env var or swarm secret cannot be found, or if `WORKFLOW_INPUT_ENV_ALLOWLIST`
46
+ * is set and does not list the env var. This is the only place `${ENV_VAR}` is
47
+ * resolved: workflow input (`resolveInputs`) and webhook HMAC secrets both come here.
30
48
  */
31
49
  export async function resolveInputValue(value: string): Promise<string> {
32
50
  // Env var reference: ${MY_VAR}
33
51
  const envMatch = /^\$\{(.+)\}$/.exec(value);
34
52
  if (envMatch?.[1]) {
35
53
  const envName = envMatch[1];
54
+ const allowed = workflowInputEnvAllowlist();
55
+ // Checked before the read, so a name outside the list never touches process.env.
56
+ if (allowed && !allowed.has(envName)) {
57
+ throw new Error(`Environment variable "${envName}" is not in WORKFLOW_INPUT_ENV_ALLOWLIST`);
58
+ }
36
59
  const envValue = process.env[envName];
37
60
  if (envValue === undefined) {
38
61
  throw new Error(`Environment variable "${envName}" is not set`);
@@ -1,4 +1,5 @@
1
1
  import type { WorkflowNode } from "../types";
2
+ import type { BaseExecutor, ExecutorInput } from "./executors/base";
2
3
 
3
4
  /** Watchdog budget for a node that configures none. */
4
5
  export const DEFAULT_NODE_TIMEOUT_MS = 30_000;
@@ -49,3 +50,20 @@ export function startStepDeadline(timeoutMs: number): StepDeadline {
49
50
  });
50
51
  return { signal: controller.signal, expired, clear: () => clearTimeout(timer) };
51
52
  }
53
+
54
+ /** Give each executor invocation its own deadline, including retries. */
55
+ export async function runWithNodeDeadline(
56
+ node: Pick<WorkflowNode, "type" | "config">,
57
+ executor: BaseExecutor,
58
+ input: ExecutorInput,
59
+ ) {
60
+ const deadline = startStepDeadline(resolveNodeTimeoutMs(node));
61
+ try {
62
+ return await Promise.race([
63
+ executor.run({ ...input, meta: { ...input.meta, signal: deadline.signal } }),
64
+ deadline.expired,
65
+ ]);
66
+ } finally {
67
+ deadline.clear();
68
+ }
69
+ }
@@ -764,7 +764,10 @@ export async function cancelWorkflowRunRows(
764
764
  const withDependents =
765
765
  openTaskIds.length > 0 ? await getTaskIdsWithDependents() : new Set<string>();
766
766
  for (const taskId of openTaskIds) {
767
- await cancelTask(taskId, cancelReason, { cascadeDependents: withDependents.has(taskId) });
767
+ await cancelTask(taskId, cancelReason, {
768
+ cascadeDependents: withDependents.has(taskId),
769
+ statusKind: "workflow",
770
+ });
768
771
  }
769
772
  await cancelOpenWorkflowTreeSteps(runIds, cancelReason, now);
770
773
  await disarmWorkflowTreeRetries(runIds, now);
@@ -871,7 +874,7 @@ export async function cancelWorkflowRunStep(
871
874
  }
872
875
 
873
876
  const task = await getTaskByWorkflowRunStepId(stepId);
874
- if (task) await cancelTask(task.id, reason);
877
+ if (task) await cancelTask(task.id, reason, { statusKind: "workflow" });
875
878
  await updateWorkflowRunStep(stepId, {
876
879
  status: "cancelled",
877
880
  error: reason,
@@ -25,6 +25,7 @@ import type { AsyncExecutorResult } from "./executors/base";
25
25
  import type { ExecutorRegistry } from "./executors/registry";
26
26
  import { FOREACH_ITEMS_WAIT_FOR, parkAndDriveForeach, runForeachDrive } from "./foreach-driver";
27
27
  import { resolveForeachParent } from "./foreach-join";
28
+ import { runWithNodeDeadline } from "./node-timeout";
28
29
  import { rebuildNodeExecutionInput } from "./step-input";
29
30
  import { hasOwedSuccessors } from "./successor-routing";
30
31
  import { runStepValidation, validateOutputSchema } from "./validation";
@@ -124,7 +125,7 @@ export function startRetryPoller(registry: ExecutorRegistry, intervalMs = 5000):
124
125
  };
125
126
 
126
127
  try {
127
- const result = await executor.run({
128
+ const result = await runWithNodeDeadline(node, executor, {
128
129
  config: interpolatedConfig,
129
130
  context: ctx,
130
131
  meta,
@@ -1,6 +1,12 @@
1
1
  import crypto from "node:crypto";
2
- import { getWorkflow, getWorkflowsByScheduleId, listWorkflows } from "../be/db";
2
+ import {
3
+ getWorkflow,
4
+ getWorkflowsByEventName,
5
+ getWorkflowsByScheduleId,
6
+ listWorkflows,
7
+ } from "../be/db";
3
8
  import type { ScheduledTask, TriggerConfig } from "../types";
9
+ import { scrubSecrets } from "../utils/secret-scrubber";
4
10
  import { startWorkflowExecution } from "./engine";
5
11
  import type { ExecutorRegistry } from "./executors/registry";
6
12
  import { resolveInputValue } from "./input";
@@ -300,25 +306,29 @@ export async function logOpenWebhookTriggers(): Promise<void> {
300
306
 
301
307
  /**
302
308
  * Start every enabled workflow subscribed to a named in-process event.
303
- * Returns the workflow run IDs in workflow-list order.
309
+ * Returns the workflow run IDs in workflow-list order. A failed subscriber
310
+ * start is logged without preventing delivery to the remaining subscribers.
304
311
  */
305
312
  export async function handleEventTrigger(
306
313
  eventName: string,
307
314
  payload: unknown,
308
315
  registry: ExecutorRegistry,
309
316
  ): Promise<string[]> {
310
- const workflows = (await listWorkflows({ enabled: true })).filter((workflow) =>
311
- workflow.triggers.some(
312
- (trigger) => trigger.type === "event" && trigger.eventName === eventName,
313
- ),
314
- );
317
+ const workflows = await getWorkflowsByEventName(eventName);
315
318
 
316
319
  const runIds: string[] = [];
317
320
  for (const workflow of workflows) {
318
- const runId = await startWorkflowExecution(workflow, payload, registry, {
319
- triggerType: "event",
320
- });
321
- runIds.push(runId);
321
+ try {
322
+ const runId = await startWorkflowExecution(workflow, payload, registry, {
323
+ triggerType: "event",
324
+ });
325
+ runIds.push(runId);
326
+ } catch (err) {
327
+ console.error(
328
+ `[workflows] Failed to start workflow ${workflow.id} for ${eventName} event trigger:`,
329
+ scrubSecrets(err instanceof Error ? err.message : String(err)),
330
+ );
331
+ }
322
332
  }
323
333
  return runIds;
324
334
  }
package/src/x/composio.ts CHANGED
@@ -86,6 +86,7 @@ export function parseComposioArgs(
86
86
  if ((method === "GET" || method === "HEAD") && parsed.body !== undefined) {
87
87
  throw new Error(`${method} requests cannot include --body`);
88
88
  }
89
+ buildComposioUrl(parsed.baseUrl, parsed.endpoint, []);
89
90
 
90
91
  return parsed;
91
92
  }
@@ -131,6 +132,8 @@ export async function executeComposioRequest(
131
132
  body: args.body === undefined ? undefined : JSON.stringify(args.body),
132
133
  headers,
133
134
  method: args.method,
135
+ // A redirect would carry the key header to the new host.
136
+ redirect: "manual",
134
137
  });
135
138
  } catch (err) {
136
139
  return {
@@ -183,9 +186,11 @@ export function composioArgsFromParts(input: {
183
186
  throw new Error(`${method} requests cannot include a body`);
184
187
  }
185
188
  assertRelativeComposioPath(input.endpoint);
189
+ const baseUrl = input.baseUrl || process.env.COMPOSIO_BASE_URL || DEFAULT_COMPOSIO_BASE_URL;
190
+ buildComposioUrl(baseUrl, input.endpoint, []);
186
191
 
187
192
  return {
188
- baseUrl: input.baseUrl || process.env.COMPOSIO_BASE_URL || DEFAULT_COMPOSIO_BASE_URL,
193
+ baseUrl,
189
194
  body: input.body,
190
195
  endpoint: input.endpoint,
191
196
  headers: input.headers ?? {},
@@ -228,6 +233,10 @@ function buildComposioUrl(
228
233
  const normalizedBase = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
229
234
  const cleanEndpoint = endpoint.replace(/^\/+/, "");
230
235
  const url = new URL(cleanEndpoint, normalizedBase);
236
+ // The key header is bound to the base URL's host: a path must not change it.
237
+ if (url.origin !== new URL(normalizedBase).origin) {
238
+ throw new Error("endpoint must be a Composio API path on the configured base URL");
239
+ }
231
240
  for (const [key, value] of query) {
232
241
  url.searchParams.append(key, value);
233
242
  }
@@ -7,6 +7,8 @@ description: Build and iterate on schema-backed Swarm Apps with live models, nam
7
7
 
8
8
  Swarm Apps are persistent, agent-authored internal applications: a schema-backed row store, named queries, custom script/task actions, and a validated json-render interface served at `/apps/<id>`. Use an app when people need to view and change live records; use `create_page` for a static snapshot.
9
9
 
10
+ **When to use a sheet or board instead:** a tracker or grid people keep editing, with no queries or actions, is a sheet. A plan, diagram or map to think through is a board. Both are editable agent-fs files; see the `boards-and-sheets` skill. To show one inside an app, use the `ObjectEmbed` component (section "Embed a sheet or board").
11
+
10
12
  > **Capability gate**: app tools are available when the server's `CAPABILITIES` includes `pages` (for example `CAPABILITIES=core,task-pool,pages`). There is no separate `apps` capability. If these tools are absent from your MCP list, this is why.
11
13
 
12
14
  ## Tools and iteration loop
@@ -32,6 +34,8 @@ Swarm Apps are persistent, agent-authored internal applications: a schema-backed
32
34
 
33
35
  For every edit: `app-get` -> modify the smallest coherent subtree -> `app-patch` -> if rejected, fix every returned `issues[]` entry (`path` + `message`) and retry. Validation happens before storage, so a rejected update leaves the saved app unchanged. Do not guess at the current definition or use `app-upsert` with a partial definition.
34
36
 
37
+ When refreshing row data, write only the diff: read the current rows with `app-rows-list`, then `app-row-patch` the changed rows, `app-rows-create` the new ones, and `app-row-delete` the removed ones. Do not delete every row and recreate it, or recreate the model: a large rewrite can be interrupted partway and leave the app half-populated.
38
+
35
39
  `app-patch` can also change `name`; omit `description` to preserve it or pass `description: null` to clear it.
36
40
 
37
41
  ### Reading an app's callable surface
@@ -177,7 +181,7 @@ When a schema patch reports stale page/query bindings, repair them in that same
177
181
 
178
182
  Optional top-level `layout: "sidebar"` turns on the app shell (see Pages, routes, and page trees). Without it every page renders on the plain canvas, exactly as before.
179
183
 
180
- Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-10 models and at most 20 reusable elements; each declared model has 1-40 columns. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
184
+ Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-50 models, at most 100 actions, and at most 20 reusable elements; each declared model has 1-200 columns. Operators can change the model, column and action caps per swarm (`APPS_MAX_MODELS`, `APPS_MAX_COLUMNS_PER_MODEL`, `APPS_MAX_ACTIONS`, 1-1000 each); the save error names the current cap. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
181
185
 
182
186
  ### Reusable elements
183
187
 
@@ -409,7 +413,7 @@ Use a task action named Tackle when a person should hand one issue row to the sw
409
413
 
410
414
  For direct MCP calls, `app-query` accepts `{ appId, query, params? }` and returns rows from that declared named query; every supplied param must be referenced by a `$param` filter in that query. Use it when an agent needs to read app state without scraping the UI.
411
415
 
412
- Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
416
+ Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. A script is typechecked against only the apps it names (literal app id or `App_<Name>`). Types are budgeted at 1 MiB per app and 4 MiB for all the apps one script names. An app past a budget loses its types (calls still work, untyped): `app-upsert` and `app-patch` warn when the app is over the per-app budget, and `script-upsert` warns for each untyped app the script names. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
413
417
 
414
418
  ### Pages, routes, and page trees
415
419
 
@@ -2,6 +2,8 @@
2
2
 
3
3
  Swarm Apps are persistent, agent-authored internal applications: a schema-backed row store, named queries, custom script/task actions, and a validated json-render interface served at `/apps/<id>`. Use an app when people need to view and change live records; use `create_page` for a static snapshot.
4
4
 
5
+ **When to use a sheet or board instead:** a tracker or grid people keep editing, with no queries or actions, is a sheet. A plan, diagram or map to think through is a board. Both are editable agent-fs files; see the `boards-and-sheets` skill. To show one inside an app, use the `ObjectEmbed` component (section "Embed a sheet or board").
6
+
5
7
  > **Capability gate**: app tools are available when the server's `CAPABILITIES` includes `pages` (for example `CAPABILITIES=core,task-pool,pages`). There is no separate `apps` capability. If these tools are absent from your MCP list, this is why.
6
8
 
7
9
  ## Tools and iteration loop
@@ -27,6 +29,8 @@ Swarm Apps are persistent, agent-authored internal applications: a schema-backed
27
29
 
28
30
  For every edit: `app-get` -> modify the smallest coherent subtree -> `app-patch` -> if rejected, fix every returned `issues[]` entry (`path` + `message`) and retry. Validation happens before storage, so a rejected update leaves the saved app unchanged. Do not guess at the current definition or use `app-upsert` with a partial definition.
29
31
 
32
+ When refreshing row data, write only the diff: read the current rows with `app-rows-list`, then `app-row-patch` the changed rows, `app-rows-create` the new ones, and `app-row-delete` the removed ones. Do not delete every row and recreate it, or recreate the model: a large rewrite can be interrupted partway and leave the app half-populated.
33
+
30
34
  `app-patch` can also change `name`; omit `description` to preserve it or pass `description: null` to clear it.
31
35
 
32
36
  ### Reading an app's callable surface
@@ -172,7 +176,7 @@ When a schema patch reports stale page/query bindings, repair them in that same
172
176
 
173
177
  Optional top-level `layout: "sidebar"` turns on the app shell (see Pages, routes, and page trees). Without it every page renders on the plain canvas, exactly as before.
174
178
 
175
- Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-10 models and at most 20 reusable elements; each declared model has 1-40 columns. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
179
+ Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-50 models, at most 100 actions, and at most 20 reusable elements; each declared model has 1-200 columns. Operators can change the model, column and action caps per swarm (`APPS_MAX_MODELS`, `APPS_MAX_COLUMNS_PER_MODEL`, `APPS_MAX_ACTIONS`, 1-1000 each); the save error names the current cap. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
176
180
 
177
181
  ### Reusable elements
178
182
 
@@ -404,7 +408,7 @@ Use a task action named Tackle when a person should hand one issue row to the sw
404
408
 
405
409
  For direct MCP calls, `app-query` accepts `{ appId, query, params? }` and returns rows from that declared named query; every supplied param must be referenced by a `$param` filter in that query. Use it when an agent needs to read app state without scraping the UI.
406
410
 
407
- Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
411
+ Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. A script is typechecked against only the apps it names (literal app id or `App_<Name>`). Types are budgeted at 1 MiB per app and 4 MiB for all the apps one script names. An app past a budget loses its types (calls still work, untyped): `app-upsert` and `app-patch` warn when the app is over the per-app budget, and `script-upsert` warns for each untyped app the script names. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
408
412
 
409
413
  ### Pages, routes, and page trees
410
414