@desplega.ai/agent-swarm 2.8.1 → 2.8.3

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 (318) hide show
  1. package/dist/acp-adapter-xq6s2z6t.js +14 -0
  2. package/dist/{actions-pwjpn0j6.js → actions-ewz7bp4g.js} +20 -19
  3. package/dist/{amp-adapter-cq9jgj6x.js → amp-adapter-f25tqhnf.js} +3 -3
  4. package/dist/{app-cnfffgwg.js → app-mkptw0k7.js} +4 -4
  5. package/dist/{assistant-kpn317y1.js → assistant-c47rfe77.js} +23 -22
  6. package/dist/{boot-args-schema-pbbnhmc3.js → boot-args-schema-4vb0xsat.js} +1 -1
  7. package/dist/{boot-reembed-9m0ysxma.js → boot-reembed-1ghy2sab.js} +1 -1
  8. package/dist/{boot-reembed-majbn53m.js → boot-reembed-htr73hbs.js} +1 -1
  9. package/dist/{boot-scrub-sweep-app8g8ym.js → boot-scrub-sweep-yrytg42z.js} +4 -4
  10. package/dist/{boot-seeds-pbtmvcjm.js → boot-seeds-n2b3dx4e.js} +4 -4
  11. package/dist/{boxd-qbkxy6ap.js → boxd-jmfqgkqa.js} +2 -2
  12. package/dist/{claude-adapter-wn1g3qp5.js → claude-adapter-r33pqnzx.js} +8 -9
  13. package/dist/{claude-managed-adapter-jh6c523j.js → claude-managed-adapter-hddmxjyj.js} +4 -4
  14. package/dist/{claude-managed-setup-pd47nzch.js → claude-managed-setup-hfvry1bd.js} +5 -5
  15. package/dist/{claude-sdk-session-3a2a6589.js → claude-sdk-session-0hamqzc7.js} +10 -11
  16. package/dist/{cli-v1dv1r37.js → cli-0bcgyj5b.js} +74 -3
  17. package/dist/{cli-a3b239vq.js → cli-0vksaxvr.js} +2 -2
  18. package/dist/{cli-mrt48bx7.js → cli-15204js0.js} +1 -1
  19. package/dist/{cli-8aes17e4.js → cli-1m96dc36.js} +3 -3
  20. package/dist/{cli-2r0jcc3k.js → cli-2d0cghfn.js} +1 -1
  21. package/dist/{cli-wk18cm92.js → cli-4ax9mvvg.js} +4 -4
  22. package/dist/{cli-9wngrawf.js → cli-4dpkjc2e.js} +6 -6
  23. package/dist/{cli-x1wa213s.js → cli-4e1hfbpq.js} +5 -5
  24. package/dist/{cli-7349va39.js → cli-500c09j9.js} +921 -431
  25. package/dist/{cli-m4dqmnbp.js → cli-54qr8mcd.js} +2 -2
  26. package/dist/{cli-m88rpzkh.js → cli-5a7szzfh.js} +2 -2
  27. package/dist/{cli-bst1vp7e.js → cli-5y2fvw4z.js} +13 -5
  28. package/dist/{cli-vj75tyaw.js → cli-6yygkr0w.js} +7 -7
  29. package/dist/{cli-7b8sbmag.js → cli-7c5tgqhf.js} +5 -5
  30. package/dist/{cli-2gxeg5gr.js → cli-8476gtwf.js} +1 -1
  31. package/dist/{cli-yncmerje.js → cli-922z7gwm.js} +4 -4
  32. package/dist/{cli-jrzkw01m.js → cli-93t5s4zq.js} +2 -2
  33. package/dist/{cli-sn7rtnj4.js → cli-9zmb7ptc.js} +9 -9
  34. package/dist/{cli-tk7cjj8h.js → cli-am1ptset.js} +3 -3
  35. package/dist/{cli-cyhbbd1z.js → cli-awwptga4.js} +1 -1
  36. package/dist/{cli-89cqnasv.js → cli-bhsfbmk8.js} +19 -7
  37. package/dist/{cli-9vhebtjz.js → cli-bj6qhgte.js} +15 -32
  38. package/dist/{cli-g70vxtjh.js → cli-c0xjnr8z.js} +2 -2
  39. package/dist/{cli-vqptjbr7.js → cli-c3ng0mb4.js} +14 -14
  40. package/dist/{cli-re4raaj0.js → cli-c71n3bxq.js} +11 -6
  41. package/dist/{cli-7p1kvkck.js → cli-crpf163n.js} +25 -18
  42. package/dist/{cli-k0wwfqbg.js → cli-dns0y538.js} +4 -0
  43. package/dist/{cli-d3p5vwbk.js → cli-dpsfwh7n.js} +13 -21
  44. package/dist/{cli-xzm9vcfg.js → cli-dtdht77h.js} +2 -2
  45. package/dist/{cli-bb431xey.js → cli-e2w34h6z.js} +231 -68
  46. package/dist/{cli-eddnyg3t.js → cli-emekyyhr.js} +1 -1
  47. package/dist/{cli-d84byzn8.js → cli-f1kwb5fc.js} +109 -33
  48. package/dist/{cli-0jzra9ad.js → cli-gn9y6fn7.js} +2 -2
  49. package/dist/{cli-tqegb8eq.js → cli-gpz1d0t2.js} +4 -4
  50. package/dist/{cli-7w69ne2f.js → cli-h9yy18gy.js} +239 -67
  51. package/dist/{cli-m5akxq8q.js → cli-j8cjdzan.js} +1 -1
  52. package/dist/{cli-m9s2qff2.js → cli-jg5txpm6.js} +187 -93
  53. package/dist/{cli-k26bkr9t.js → cli-k2rw11py.js} +3 -3
  54. package/dist/{cli-93k32c37.js → cli-k96cecs7.js} +377 -61
  55. package/dist/{cli-3vjhs18n.js → cli-kd56bmk4.js} +1 -1
  56. package/dist/{cli-k0615eh8.js → cli-kmemts3w.js} +13 -13
  57. package/dist/{cli-pcad4cb1.js → cli-knva3nmx.js} +2 -2
  58. package/dist/{cli-b085njxz.js → cli-kw44j53p.js} +15 -14
  59. package/dist/{cli-bsywb58a.js → cli-mdpbjnzq.js} +10 -10
  60. package/dist/{cli-syybb0p1.js → cli-me0r8gzr.js} +35 -76
  61. package/dist/{cli-4r05hnqa.js → cli-mwwmka77.js} +15 -15
  62. package/dist/{cli-1xh9a7hn.js → cli-n5t077me.js} +2 -2
  63. package/dist/{cli-rvhdmjvt.js → cli-nx2n3z6p.js} +1 -1
  64. package/dist/{cli-28fq781p.js → cli-pe4d96rb.js} +1 -1
  65. package/dist/{cli-3rkdne1h.js → cli-pxwtcgcp.js} +2 -2
  66. package/dist/{cli-zcsw143p.js → cli-qmqt520k.js} +2 -2
  67. package/dist/{cli-2zp0et3v.js → cli-qps8je6j.js} +70 -19
  68. package/dist/{cli-xae4g51r.js → cli-rh15cakt.js} +1 -1
  69. package/dist/{cli-k93bq1wq.js → cli-rjvsf9qa.js} +5 -5
  70. package/dist/{cli-6mma83xa.js → cli-rqfvkx5t.js} +7 -7
  71. package/dist/{cli-dy32zecz.js → cli-s7zz734a.js} +1 -1
  72. package/dist/{cli-yn2bbre9.js → cli-s8p8hhty.js} +2 -2
  73. package/dist/{cli-vbh10fqa.js → cli-sdvcrq5x.js} +5 -5
  74. package/dist/{cli-b5rs97a6.js → cli-sg27rk2t.js} +5 -5
  75. package/dist/{cli-d6521kb5.js → cli-skmhsnqh.js} +1 -1
  76. package/dist/{cli-5mrq3ake.js → cli-t4dv07kr.js} +1 -1
  77. package/dist/{cli-hxpyc9sn.js → cli-t5ys4ebm.js} +3 -3
  78. package/dist/{cli-qmqk2yc2.js → cli-tas6ckky.js} +2 -2
  79. package/dist/{cli-p1w18yhx.js → cli-tf79ryyy.js} +1 -1
  80. package/dist/{cli-kc7v1nfv.js → cli-tnzebztn.js} +1 -1
  81. package/dist/{cli-gax7fk3t.js → cli-vx421edw.js} +3 -3
  82. package/dist/{cli-kchjb7qy.js → cli-x3ex5bqf.js} +1 -1
  83. package/dist/cli-yss07azk.js +142 -0
  84. package/dist/{cli-0ntbxyaa.js → cli-z8cvws4c.js} +363 -47
  85. package/dist/{cli-tacge1w0.js → cli-zdaypkq9.js} +146 -52
  86. package/dist/{cli-b8e9nb04.js → cli-zeaehgyd.js} +2 -2
  87. package/dist/{cli-jcpr5smb.js → cli-ztq5z4e1.js} +4 -4
  88. package/dist/cli.js +21 -21
  89. package/dist/{codex-adapter-nha71q3n.js → codex-adapter-2brxx5ta.js} +7 -8
  90. package/dist/{codex-hook-h3vk6xzr.js → codex-hook-c930c3ea.js} +2 -2
  91. package/dist/{codex-login-bcda78ge.js → codex-login-cbrs1h5w.js} +1 -1
  92. package/dist/{codex-session-runner-ak9x1k1h.js → codex-session-runner-y9anfj0r.js} +8 -9
  93. package/dist/{commands-f587qpq8.js → commands-wn9q06qr.js} +3 -3
  94. package/dist/{controller-hxx8wwy1.js → controller-fw608czd.js} +4 -4
  95. package/dist/{controllers-connect-k5sg9m9h.js → controllers-connect-63j5rdcm.js} +20 -20
  96. package/dist/{cursor-adapter-n5nc3mfe.js → cursor-adapter-6mb9jme8.js} +2 -2
  97. package/dist/{db-nzf8zb5z.js → db-0m6v5tq4.js} +3 -3
  98. package/dist/{db-amm8w15a.js → db-y4wfrzbm.js} +4 -2
  99. package/dist/{devin-adapter-xedz98zv.js → devin-adapter-r0yx3gv8.js} +1 -1
  100. package/dist/{dispatcher-89zrts8f.js → dispatcher-9tq2zzdj.js} +17 -17
  101. package/dist/{docker-866qpzt9.js → docker-j75atvpt.js} +2 -2
  102. package/dist/{dsh-adapter-nrhbrjz8.js → dsh-adapter-t09sv4tq.js} +2 -2
  103. package/dist/{e2b-s16txnpx.js → e2b-7s9dscap.js} +3 -3
  104. package/dist/{e2b-jkwfhbcv.js → e2b-a7vzs2vj.js} +3 -3
  105. package/dist/{easter-egg-3d-533knw22.js → easter-egg-3d-fbwvmwhe.js} +1 -1
  106. package/dist/{embedding-space-ezwenjmj.js → embedding-space-wh8de1t9.js} +6 -6
  107. package/dist/{embeddings-np74ht6g.js → embeddings-3hpbdtjr.js} +1 -1
  108. package/dist/{event-bus-e66gh7cc.js → event-bus-tr6h3gv8.js} +1 -1
  109. package/dist/{execute-b3mrb1mv.js → execute-4bdf8sdy.js} +1 -1
  110. package/dist/{external-channel-z46yx9d7.js → external-channel-ts2fwqh0.js} +2 -2
  111. package/dist/fx-adapter-1rnxnf56.js +17 -0
  112. package/dist/grok-adapter-efhmf1r8.js +17 -0
  113. package/dist/handlers-anrr3py9.js +32 -0
  114. package/dist/{heartbeat-dt9qw9c8.js → heartbeat-2ze5fzpc.js} +20 -20
  115. package/dist/{hook-8k6fbz9b.js → hook-ca54yd4s.js} +5 -5
  116. package/dist/{hook-jgcgygex.js → hook-gaehe2w5.js} +8 -8
  117. package/dist/{http-haw4r8ne.js → http-jfg8t2yk.js} +3839 -122
  118. package/dist/{index-tvfafeyy.js → index-3gv6sc4z.js} +1 -1
  119. package/dist/{index-tez78qj3.js → index-3yvzbhxd.js} +100 -23
  120. package/dist/index-8w2aznds.js +33 -0
  121. package/dist/{index-5gk12my8.js → index-csgrxedz.js} +1 -1
  122. package/dist/index-qnjvr362.js +37 -0
  123. package/dist/index-yzxd3sn9.js +32 -0
  124. package/dist/{keepalive-xn6s7rmg.js → keepalive-k2a3qe73.js} +4 -4
  125. package/dist/lead-zhxqbfdv.js +69 -0
  126. package/dist/{maintenance-vdts800b.js → maintenance-gb5sd5nc.js} +1 -1
  127. package/dist/{node-4c5jqxr3.js → node-7qsx5kvm.js} +1 -1
  128. package/dist/{oauth-refresh-sweep-094c8wfk.js → oauth-refresh-sweep-y7rm6bkb.js} +3 -3
  129. package/dist/{onboard-v99eh56m.js → onboard-jmc5qerv.js} +4 -4
  130. package/dist/{opencode-adapter-dsagkhtw.js → opencode-adapter-7eade9ev.js} +6 -7
  131. package/dist/{otel-impl-q7yr9yp0.js → otel-impl-8j1xhxqd.js} +2 -2
  132. package/dist/{pi-mono-adapter-546cd1cc.js → pi-mono-adapter-yqmaf32x.js} +14 -13
  133. package/dist/{pricing-refresh-7dh2yase.js → pricing-refresh-1nj722h6.js} +2 -2
  134. package/dist/{rbac-roles-mdmc96p4.js → rbac-roles-b1mtr6dr.js} +3 -3
  135. package/dist/{rbac-roles-npbmdh77.js → rbac-roles-n1f3frk1.js} +2 -2
  136. package/dist/{render-v2-twhhwmms.js → render-v2-1gfpd8rj.js} +4 -4
  137. package/dist/{resume-5gsrjd5e.js → resume-w1s1eh5v.js} +7 -7
  138. package/dist/{runtime-1hv06jsn.js → runtime-84g5egsc.js} +1 -1
  139. package/dist/{session-access-m191x30x.js → session-access-y6z1txk4.js} +4 -4
  140. package/dist/{session-source-backfill-nt923ask.js → session-source-backfill-gxxwfh12.js} +3 -3
  141. package/dist/{setup-wv467afy.js → setup-r91gstyk.js} +1 -1
  142. package/dist/{virtual-modules-gazyapte.js → virtual-modules-cgnj6kme.js} +3 -3
  143. package/dist/{work-objects-8zkrpy13.js → work-objects-qcxzg61c.js} +20 -20
  144. package/dist/worker-7j2907g6.js +69 -0
  145. package/dist/{worker-follow-up-cecqszem.js → worker-follow-up-y2d2h7km.js} +19 -17
  146. package/dist/{x-2fyrt5pp.js → x-qhxq2ama.js} +2 -2
  147. package/openapi.json +2908 -351
  148. package/package.json +4 -4
  149. package/src/apps/catalog.generated.json +120 -1
  150. package/src/apps/definition.ts +38 -11
  151. package/src/apps/page-validator.ts +88 -0
  152. package/src/be/db/model-profiles.ts +110 -11
  153. package/src/be/db/tasks/read.ts +53 -0
  154. package/src/be/db/workflow-run-definitions.ts +19 -8
  155. package/src/be/db-client.ts +43 -5
  156. package/src/be/db.ts +40 -9
  157. package/src/be/migrations/284_model_profile_fallbacks.sql +9 -0
  158. package/src/be/migrations/289_automation_savings_daily.sql +47 -0
  159. package/src/be/migrations/291_task_slack_participants.sql +4 -0
  160. package/src/be/migrations/293_savings_component_links.sql +58 -0
  161. package/src/be/migrations/296_automation_savings_daily_read_index.sql +6 -0
  162. package/src/be/model-profile-check.ts +53 -20
  163. package/src/be/runtime-pools/routing.ts +1 -0
  164. package/src/be/savings/calibrate.ts +468 -0
  165. package/src/be/savings/compute.ts +677 -0
  166. package/src/be/savings/model.ts +674 -0
  167. package/src/be/savings/read.ts +1500 -0
  168. package/src/be/savings/rollup.ts +571 -0
  169. package/src/be/scripts/run-credential.ts +15 -3
  170. package/src/be/scripts/typecheck.ts +91 -4
  171. package/src/be/seed/agent-fs-provision.ts +48 -11
  172. package/src/be/seed/workflows-seeder.ts +67 -23
  173. package/src/be/seed-scripts/catalog/dreaming-learnings.ts +10 -2
  174. package/src/be/seed-scripts/catalog/dreaming-memtax-create.ts +70 -4
  175. package/src/be/skill-parser.ts +19 -7
  176. package/src/be/swarm-config-guard.ts +8 -0
  177. package/src/be/users.ts +29 -2
  178. package/src/commands/onboard/agent-fs-version.ts +1 -1
  179. package/src/commands/provider-error-class.ts +97 -0
  180. package/src/commands/runner.ts +258 -58
  181. package/src/extensions/contract-types.generated.ts +1 -1
  182. package/src/http/all-routes.ts +2 -0
  183. package/src/http/fs.ts +8 -2
  184. package/src/http/index.ts +11 -0
  185. package/src/http/model-profiles.ts +43 -10
  186. package/src/http/poll.ts +15 -1
  187. package/src/http/requested-by.ts +97 -1
  188. package/src/http/savings-calibration.ts +277 -0
  189. package/src/http/savings.ts +849 -0
  190. package/src/http/scripts.ts +26 -15
  191. package/src/http/tasks.ts +89 -9
  192. package/src/http/trackers/authorize-gate.ts +41 -0
  193. package/src/http/trackers/jira.ts +26 -4
  194. package/src/http/trackers/linear.ts +26 -4
  195. package/src/integrations/chat-sdk/limits.ts +6 -1
  196. package/src/jira/oauth.ts +7 -1
  197. package/src/linear/README.md +2 -1
  198. package/src/linear/oauth.ts +7 -1
  199. package/src/prompts/session-templates.ts +80 -3
  200. package/src/providers/acp-targets.ts +1 -1
  201. package/src/providers/amp-adapter.ts +1 -1
  202. package/src/providers/claude-adapter.ts +0 -20
  203. package/src/providers/claude-flag-settings.ts +12 -10
  204. package/src/providers/codex-adapter.ts +12 -34
  205. package/src/providers/opencode-adapter.ts +34 -12
  206. package/src/providers/pi-mono-adapter.ts +6 -5
  207. package/src/providers/types.ts +7 -0
  208. package/src/scheduler/scheduler.ts +20 -14
  209. package/src/scripts-runtime/ctx.ts +1 -1
  210. package/src/scripts-runtime/executors/quickjs-bundle.ts +1 -0
  211. package/src/scripts-runtime/executors/quickjs-prelude.ts +162 -2
  212. package/src/scripts-runtime/executors/quickjs-runner.ts +4 -1
  213. package/src/scripts-runtime/sdk-allowlist.ts +11 -1
  214. package/src/scripts-runtime/stdlib/fetch.ts +113 -15
  215. package/src/scripts-runtime/stdlib/index.ts +3 -1
  216. package/src/scripts-runtime/stdlib/retry.ts +174 -0
  217. package/src/scripts-runtime/swarm-sdk.ts +192 -17
  218. package/src/scripts-runtime/types/stdlib.d.ts +95 -4
  219. package/src/scripts-runtime/types/swarm-extension.d.ts +60 -0
  220. package/src/scripts-runtime/types/swarm-sdk.d.ts +69 -2
  221. package/src/slack/actions.ts +1 -0
  222. package/src/slack/assistant.ts +2 -0
  223. package/src/slack/enrich.ts +144 -50
  224. package/src/slack/handlers.ts +37 -95
  225. package/src/slack/templates.ts +9 -0
  226. package/src/slack/thread-buffer.ts +45 -71
  227. package/src/slack/thread-participants.ts +187 -0
  228. package/src/tasks/worker-follow-up.ts +142 -3
  229. package/src/tests/agent-fs-provision-seeder.test.ts +81 -0
  230. package/src/tests/apps-chart-shell.test.ts +170 -0
  231. package/src/tests/apps-icon.test.ts +156 -2
  232. package/src/tests/base-prompt.test.ts +5 -4
  233. package/src/tests/chat-sdk-relay.test.ts +12 -0
  234. package/src/tests/claude-adapter-binary.test.ts +7 -1
  235. package/src/tests/claude-adapter.test.ts +10 -64
  236. package/src/tests/claude-flag-settings.test.ts +15 -11
  237. package/src/tests/claude-hook-credentials.test.ts +0 -1
  238. package/src/tests/claude-sdk-lifecycle.test.ts +5 -1
  239. package/src/tests/codex-adapter.test.ts +28 -78
  240. package/src/tests/comb-default.test.ts +6 -0
  241. package/src/tests/core-auth.test.ts +7 -6
  242. package/src/tests/create-task-vcs-repo.test.ts +136 -0
  243. package/src/tests/db-client-busy-retry.test.ts +58 -6
  244. package/src/tests/db-task-read-contract.test.ts +2 -0
  245. package/src/tests/db-task-write-contract.test.ts +1 -0
  246. package/src/tests/deploy-guard.test.ts +154 -0
  247. package/src/tests/docs-index-footprint.test.js +3 -3
  248. package/src/tests/dreaming-learnings.test.ts +104 -0
  249. package/src/tests/extensions-pre-task.test.ts +4 -2
  250. package/src/tests/fetch-resolved-env.test.ts +47 -1
  251. package/src/tests/fixtures/app-shell-charts-definition.json.txt +180 -0
  252. package/src/tests/model-profile-fallbacks.test.ts +482 -0
  253. package/src/tests/model-profiles-api.test.ts +1 -0
  254. package/src/tests/opencode-adapter.test.ts +53 -6
  255. package/src/tests/pi-mono-session-cost-on-abort.test.ts +115 -0
  256. package/src/tests/prompt-template-session.test.ts +17 -1
  257. package/src/tests/provider-error-class.test.ts +174 -0
  258. package/src/tests/runner-provider-fallback.test.ts +197 -0
  259. package/src/tests/runner-requester-profile.test.ts +139 -1
  260. package/src/tests/savings-calibration-api.test.ts +264 -0
  261. package/src/tests/savings-calibration.test.ts +201 -0
  262. package/src/tests/savings-compound.test.ts +774 -0
  263. package/src/tests/savings-compute.test.ts +215 -0
  264. package/src/tests/savings-fleet-latency.test.ts +143 -0
  265. package/src/tests/savings-fleet-read.test.ts +195 -0
  266. package/src/tests/savings-fleet-scale.test.ts +222 -0
  267. package/src/tests/savings-model.test.ts +499 -0
  268. package/src/tests/savings-read.test.ts +367 -0
  269. package/src/tests/savings-rollup.test.ts +766 -0
  270. package/src/tests/savings-scripts.test.ts +611 -0
  271. package/src/tests/script-connections.test.ts +4 -0
  272. package/src/tests/script-executor-conformance.test.ts +444 -0
  273. package/src/tests/scripts-http.test.ts +55 -0
  274. package/src/tests/scripts-runtime-fetch.test.ts +2 -2
  275. package/src/tests/sdk-allowlist.test.ts +40 -0
  276. package/src/tests/secret-rules.test.ts +124 -1
  277. package/src/tests/secret-scrubber.test.ts +1 -1
  278. package/src/tests/seed-workflows.test.ts +167 -11
  279. package/src/tests/skill-parser.test.ts +45 -0
  280. package/src/tests/slack-dm-implicit-mention.test.ts +20 -1
  281. package/src/tests/slack-identity-resolution.test.ts +23 -0
  282. package/src/tests/slack-inbound-files.test.ts +2 -1
  283. package/src/tests/slack-thread-participants.test.ts +429 -0
  284. package/src/tests/tool-annotations.test.ts +30 -0
  285. package/src/tests/tracker-oauth-authorize-auth.test.ts +262 -0
  286. package/src/tests/workflow-definition-pinning.test.ts +128 -3
  287. package/src/tests/workflow-script-principal.test.ts +94 -4
  288. package/src/tools/app-upsert.ts +1 -1
  289. package/src/tools/model-profiles/list-model-profiles.ts +4 -2
  290. package/src/tools/update-profile.ts +1 -1
  291. package/src/types.ts +146 -33
  292. package/src/utils/constants.ts +2 -0
  293. package/src/utils/mcp-server-fetcher.test.ts +89 -0
  294. package/src/utils/mcp-server-fetcher.ts +13 -5
  295. package/src/utils/request-auth-context.ts +24 -0
  296. package/src/utils/secret-rules.generated.ts +1 -1
  297. package/src/utils/secret-scrubber.ts +154 -29
  298. package/src/workflows/executors/swarm-script.ts +23 -19
  299. package/templates/skills/apps/SKILL.md +62 -3
  300. package/templates/skills/apps/content.md +62 -3
  301. package/templates/skills/swarm-docs/content.md +2 -0
  302. package/templates/skills/swarm-scripts/SKILL.md +5 -4
  303. package/templates/skills/swarm-scripts/content.md +5 -4
  304. package/templates/skills/work-on-task/SKILL.md +1 -1
  305. package/templates/skills/work-on-task/content.md +1 -1
  306. package/templates/workflows/dreaming/content.md +1 -1
  307. package/dist/acp-adapter-pdy3qsvg.js +0 -15
  308. package/dist/cli-4bd1rck6.js +0 -4
  309. package/dist/cli-jywyhqws.js +0 -104
  310. package/dist/fx-adapter-3q12snn6.js +0 -18
  311. package/dist/grok-adapter-ahb1w033.js +0 -18
  312. package/dist/handlers-vbww69re.js +0 -32
  313. package/dist/index-4xwaf5th.js +0 -32
  314. package/dist/index-f0hcrs8e.js +0 -33
  315. package/dist/index-s4ewdma4.js +0 -37
  316. package/dist/lead-6ygbfhbh.js +0 -70
  317. package/dist/worker-mz5z7kj0.js +0 -70
  318. package/src/providers/ctx-mode-env.ts +0 -10
@@ -0,0 +1,571 @@
1
+ /**
2
+ * Hourly rollup of the savings model into `automation_savings_daily`: one row
3
+ * per workflow per UTC day with the tier-independent facts of
4
+ * `computeWorkflowWindow`, and per script name the facts of
5
+ * `computeScriptWindow` (subKind '' for non-API runs, 'api' for API runs).
6
+ * Each tick recomputes the days that are not final yet (today and yesterday)
7
+ * once they are RECOMPUTE_AFTER_MS old, days computed under an older
8
+ * MODEL_VERSION, and missing days of the last ROLLUP_DAYS, newest first,
9
+ * within a time budget.
10
+ * Same shape as `db-retention.ts`: single-flight tick, abort on stop, unref'd
11
+ * timers, a catch-up tick while work is left.
12
+ */
13
+ import { AsyncLocalStorage } from "node:async_hooks";
14
+ import { getDbClient } from "../db";
15
+ import type { DbExecutor } from "../db-client";
16
+ import {
17
+ computeScriptWindow,
18
+ computeWorkflowLinksDay,
19
+ computeWorkflowWindow,
20
+ type SavingsLink,
21
+ type SavingsSql,
22
+ } from "./compute";
23
+ import { jobKey, MODEL_VERSION, type ScriptFacts, type WorkflowFacts } from "./model";
24
+
25
+ const DAY_MS = 86_400_000;
26
+ /**
27
+ * Days kept and backfilled: the longest window the API serves (90 days,
28
+ * rolling) touches 91 UTC days.
29
+ */
30
+ export const ROLLUP_DAYS = 91;
31
+ const ROLLUP_INTERVAL_MS = 60 * 60 * 1000;
32
+ /**
33
+ * A day that is not final yet is recomputed once its last computation is this
34
+ * old: every hourly tick redoes it, while a catch-up tick a minute later moves
35
+ * on to the days still missing instead of redoing it.
36
+ */
37
+ export const RECOMPUTE_AFTER_MS = 30 * 60 * 1000;
38
+ /**
39
+ * Bucket and marker `computedAt` is the time the scan started, not the time of
40
+ * the write. A run that commits a little after its `startedAt` can still miss
41
+ * a scan that started after that `startedAt`, so the refresh looks back this
42
+ * far before the watermark for runs newer than the last scan.
43
+ */
44
+ export const WATERMARK_SLACK_MS = 30_000;
45
+ const CATCHUP_INTERVAL_MS = 60 * 1000;
46
+ const DEFAULT_TICK_BUDGET_MS = 5 * 60 * 1000;
47
+
48
+ export const utcDay = (ms: number): string => new Date(ms).toISOString().slice(0, 10);
49
+ export const dayStartIso = (day: string): string => `${day}T00:00:00.000Z`;
50
+ const dayStartMs = (day: string): number => Date.parse(dayStartIso(day));
51
+
52
+ /**
53
+ * A day is final once computed a full day after it ended: by then the agent
54
+ * sessions its runs started have reported their cost.
55
+ */
56
+ export const isFinalDay = (day: string, computedAt: string): boolean =>
57
+ Date.parse(computedAt) >= dayStartMs(day) + 2 * DAY_MS;
58
+
59
+ const FACT_COLUMNS = [
60
+ "runs",
61
+ "countedRuns",
62
+ "schedRuns",
63
+ "schedEffectRuns",
64
+ "eventRuns",
65
+ "effectRuns",
66
+ "effectOpsSum",
67
+ "opsSum",
68
+ "agentTasks",
69
+ "agentUsd",
70
+ "agentMs",
71
+ "followupUsd",
72
+ "childTaskUsd",
73
+ "childTaskMs",
74
+ "recordedLlmUsd",
75
+ "estimatedLlmUsd",
76
+ "computeSecs",
77
+ ] as const satisfies readonly (keyof WorkflowFacts)[];
78
+ export { FACT_COLUMNS as SAVINGS_FACT_COLUMNS };
79
+
80
+ type WorkflowRow = { id: string; name: string; definition: unknown };
81
+ /**
82
+ * Bumped after every write to the rollup tables, so a cached fleet read
83
+ * (`read.ts`) knows its buckets changed. Every writer lives in this file.
84
+ */
85
+ let generation = 0;
86
+ export const savingsRollupGeneration = (): number => generation;
87
+ const bumpGeneration = () => {
88
+ generation++;
89
+ };
90
+
91
+ export type WorkflowBucket = { workflowId: string; name: string; facts: WorkflowFacts };
92
+ export type WorkflowDay = { buckets: WorkflowBucket[]; links: SavingsLink[] };
93
+
94
+ function parseDefinition(definition: unknown): unknown {
95
+ if (typeof definition !== "string") return definition ?? {};
96
+ try {
97
+ return JSON.parse(definition);
98
+ } catch {
99
+ return {};
100
+ }
101
+ }
102
+
103
+ async function listWorkflows(): Promise<WorkflowRow[]> {
104
+ const rows = await getDbClient().query<WorkflowRow>(
105
+ "SELECT id, name, definition FROM workflows ORDER BY name",
106
+ );
107
+ return rows.map((w) => ({ ...w, definition: parseDefinition(w.definition) }));
108
+ }
109
+
110
+ export type SavingsJobKind = "workflow" | "script";
111
+
112
+ /** Days of the last ROLLUP_DAYS that need a (re)computation, newest first. */
113
+ export async function daysToCompute(kind: SavingsJobKind, now: number): Promise<string[]> {
114
+ const oldest = utcDay(now - (ROLLUP_DAYS - 1) * DAY_MS);
115
+ const markers = await getDbClient().query<{
116
+ day: string;
117
+ modelVersion: number;
118
+ computedAt: string;
119
+ }>(
120
+ "SELECT day, modelVersion, computedAt FROM automation_savings_days WHERE jobKind=? AND day>=?",
121
+ [kind, oldest],
122
+ );
123
+ const byDay = new Map(markers.map((m) => [m.day, m]));
124
+ const days: string[] = [];
125
+ for (let i = 0; i < ROLLUP_DAYS; i++) {
126
+ const day = utcDay(now - i * DAY_MS);
127
+ const m = byDay.get(day);
128
+ const due =
129
+ !m ||
130
+ Number(m.modelVersion) !== MODEL_VERSION ||
131
+ (!isFinalDay(day, m.computedAt) && now - Date.parse(m.computedAt) >= RECOMPUTE_AFTER_MS);
132
+ if (due) days.push(day);
133
+ }
134
+ return days;
135
+ }
136
+
137
+ export const workflowDaysToCompute = (now: number): Promise<string[]> =>
138
+ daysToCompute("workflow", now);
139
+
140
+ /**
141
+ * Facts of every workflow with runs on `day`, and the day's links from
142
+ * workflows to what their runs caused (`computeWorkflowLinksDay`). The spend
143
+ * of tasks a workflow caused without owning them goes into its bucket.
144
+ */
145
+ export async function computeWorkflowDay(
146
+ day: string,
147
+ sql: SavingsSql,
148
+ signal?: AbortSignal,
149
+ ): Promise<WorkflowDay> {
150
+ const window = { start: dayStartIso(day), end: dayStartIso(utcDay(dayStartMs(day) + DAY_MS)) };
151
+ const buckets: WorkflowBucket[] = [];
152
+ const workflows = await listWorkflows();
153
+ for (const w of workflows) {
154
+ signal?.throwIfAborted();
155
+ const out = await computeWorkflowWindow(w, window, sql, {
156
+ maxRuns: Number.POSITIVE_INFINITY,
157
+ });
158
+ if (out.status === "ok" && out.facts.runs > 0) {
159
+ buckets.push({ workflowId: w.id, name: w.name, facts: out.facts });
160
+ }
161
+ }
162
+ signal?.throwIfAborted();
163
+ const { links, childTasks } = await computeWorkflowLinksDay(window, workflows, sql);
164
+ for (const b of buckets) {
165
+ const spend = childTasks.get(b.workflowId);
166
+ if (!spend) continue;
167
+ b.facts.childTaskUsd += spend.usd;
168
+ b.facts.childTaskMs += spend.ms;
169
+ }
170
+ // shortcut: unowned task spend of a workflow with no run that day (a task
171
+ // created after midnight by a run that started before) is dropped from its
172
+ // kept cost; it is kept on both sides, so the saving does not move. Carry it
173
+ // to the run's day if the actual figure needs it.
174
+ return { buckets, links };
175
+ }
176
+
177
+ /**
178
+ * Upsert one bucket unless the stored one comes from a newer scan: a refresh
179
+ * that scanned after the rollup's scan began keeps its bucket when the rollup
180
+ * writes later, and the other way round.
181
+ */
182
+ const UPSERT_BUCKET = `INSERT INTO automation_savings_daily
183
+ (day, jobKind, jobId, jobKey, jobName, subKind, ${FACT_COLUMNS.join(", ")}, modelVersion, computedAt)
184
+ VALUES (?, 'workflow', ?, ?, ?, '', ${FACT_COLUMNS.map(() => "?").join(", ")}, ?, ?)
185
+ ON CONFLICT(day, jobKind, jobId, subKind) DO UPDATE SET
186
+ jobKey=excluded.jobKey, jobName=excluded.jobName,
187
+ ${FACT_COLUMNS.map((c) => `${c}=excluded.${c}`).join(", ")},
188
+ modelVersion=excluded.modelVersion, computedAt=excluded.computedAt
189
+ WHERE excluded.computedAt >= automation_savings_daily.computedAt
190
+ OR automation_savings_daily.modelVersion <> excluded.modelVersion`;
191
+
192
+ const bucketParams = (day: string, b: WorkflowBucket, computedAt: string) => [
193
+ day,
194
+ b.workflowId,
195
+ jobKey(b.name),
196
+ b.name,
197
+ ...FACT_COLUMNS.map((c) => b.facts[c]),
198
+ MODEL_VERSION,
199
+ computedAt,
200
+ ];
201
+
202
+ const INSERT_LINK = `INSERT OR REPLACE INTO automation_savings_links
203
+ (day, parentJobId, childKind, childJobId, linkKind, n, actualUsd, keptUsd, modelVersion, computedAt)
204
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`;
205
+
206
+ /**
207
+ * Replace one day's workflow buckets and links and mark the day computed, atomically.
208
+ * `scannedAt` is when the day's scan started. Buckets a refresh wrote from a
209
+ * later scan stay; every other bucket of the day is replaced. Links come only
210
+ * from the day pass, so they are replaced whole.
211
+ */
212
+ export async function writeWorkflowDay(
213
+ day: string,
214
+ workflowDay: WorkflowDay,
215
+ scannedAt: string,
216
+ ): Promise<void> {
217
+ await getDbClient().transaction(async (tx) => {
218
+ await tx.run(
219
+ "DELETE FROM automation_savings_daily WHERE day=? AND jobKind='workflow' AND (computedAt<=? OR modelVersion<>?)",
220
+ [day, scannedAt, MODEL_VERSION],
221
+ );
222
+ await tx.run("DELETE FROM automation_savings_links WHERE day=?", [day]);
223
+ for (const b of workflowDay.buckets) {
224
+ await tx.run(UPSERT_BUCKET, bucketParams(day, b, scannedAt));
225
+ }
226
+ for (const l of workflowDay.links) {
227
+ await tx.run(INSERT_LINK, [
228
+ day,
229
+ l.parentJobId,
230
+ l.childKind,
231
+ l.childJobId,
232
+ l.linkKind,
233
+ l.n,
234
+ l.actualUsd,
235
+ l.keptUsd,
236
+ MODEL_VERSION,
237
+ scannedAt,
238
+ ]);
239
+ }
240
+ await markDay(tx, day, "workflow", scannedAt);
241
+ });
242
+ bumpGeneration();
243
+ }
244
+
245
+ /** Mark a day computed, unless a newer scan under the same model version already did. */
246
+ async function markDay(
247
+ tx: DbExecutor,
248
+ day: string,
249
+ kind: SavingsJobKind,
250
+ computedAt: string,
251
+ ): Promise<void> {
252
+ await tx.run(
253
+ `INSERT INTO automation_savings_days (day, jobKind, modelVersion, computedAt) VALUES (?, ?, ?, ?)
254
+ ON CONFLICT(day, jobKind) DO UPDATE SET modelVersion=excluded.modelVersion, computedAt=excluded.computedAt
255
+ WHERE excluded.computedAt >= automation_savings_days.computedAt
256
+ OR automation_savings_days.modelVersion <> excluded.modelVersion`,
257
+ [day, kind, MODEL_VERSION, computedAt],
258
+ );
259
+ }
260
+
261
+ export type ScriptBucket = { scriptName: string; facts: ScriptFacts };
262
+
263
+ /** Facts of every script name with runs on `day`. */
264
+ export function computeScriptDay(day: string, sql: SavingsSql): Promise<ScriptBucket[]> {
265
+ const window = { start: dayStartIso(day), end: dayStartIso(utcDay(dayStartMs(day) + DAY_MS)) };
266
+ return computeScriptSlice(window, sql);
267
+ }
268
+
269
+ /** Facts of every script name (or of `scriptName`) with runs in `window`, summed over its days. */
270
+ export async function computeScriptSlice(
271
+ window: { start: string; end: string },
272
+ sql: SavingsSql,
273
+ opts: { scriptName?: string } = {},
274
+ ): Promise<ScriptBucket[]> {
275
+ const out: ScriptBucket[] = [];
276
+ for (const s of await computeScriptWindow(window, sql, opts)) {
277
+ const facts: ScriptFacts = {
278
+ runs: 0,
279
+ apiRuns: 0,
280
+ effectRuns: 0,
281
+ apiEffectRuns: 0,
282
+ opsSum: 0,
283
+ computeSecs: 0,
284
+ };
285
+ for (const d of s.byDay) {
286
+ for (const k of Object.keys(facts) as (keyof ScriptFacts)[]) facts[k] += d[k];
287
+ }
288
+ if (facts.runs > 0) out.push({ scriptName: s.scriptName, facts });
289
+ }
290
+ return out;
291
+ }
292
+
293
+ const INSERT_SCRIPT_BUCKET = `INSERT OR REPLACE INTO automation_savings_daily
294
+ (day, jobKind, jobId, jobKey, jobName, subKind, runs, countedRuns, effectRuns, opsSum, computeSecs, modelVersion, computedAt)
295
+ VALUES (?, 'script', ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`;
296
+
297
+ /**
298
+ * Replace one day's script buckets and mark the day computed, atomically.
299
+ * Each script gets a subKind '' row for its non-API runs (with the wall time
300
+ * of all its runs) and, when it had API runs, an 'api' row for those.
301
+ * `scannedAt` is when the day's scan started.
302
+ */
303
+ export async function writeScriptDay(
304
+ day: string,
305
+ buckets: ScriptBucket[],
306
+ scannedAt: string,
307
+ ): Promise<void> {
308
+ await getDbClient().transaction(async (tx) => {
309
+ await tx.run("DELETE FROM automation_savings_daily WHERE day=? AND jobKind='script'", [day]);
310
+ for (const { scriptName, facts } of buckets) {
311
+ const perRun = facts.runs > 0 ? facts.opsSum / facts.runs : 0;
312
+ const nonApi = facts.runs - facts.apiRuns;
313
+ const base = [day, scriptName, scriptName, scriptName];
314
+ await tx.run(INSERT_SCRIPT_BUCKET, [
315
+ ...base,
316
+ "",
317
+ nonApi,
318
+ nonApi,
319
+ facts.effectRuns,
320
+ perRun * nonApi,
321
+ facts.computeSecs,
322
+ MODEL_VERSION,
323
+ scannedAt,
324
+ ]);
325
+ if (facts.apiRuns > 0) {
326
+ await tx.run(INSERT_SCRIPT_BUCKET, [
327
+ ...base,
328
+ "api",
329
+ facts.apiRuns,
330
+ facts.apiRuns,
331
+ facts.apiEffectRuns,
332
+ perRun * facts.apiRuns,
333
+ 0,
334
+ MODEL_VERSION,
335
+ scannedAt,
336
+ ]);
337
+ }
338
+ }
339
+ await markDay(tx, day, "script", scannedAt);
340
+ });
341
+ bumpGeneration();
342
+ }
343
+
344
+ /**
345
+ * Recompute today's bucket of one workflow when it has a run newer than the
346
+ * last rollup of today, so a detail page shows a run within seconds instead of
347
+ * an hour. Skipped above LIVE_MAX_RUNS runs today (the hourly tick covers
348
+ * those) and before the rollup has computed today at all. `skipped` means no
349
+ * scan ran; `computed` and `refused` mean the day's scans ran. `now` must be
350
+ * taken before the scan: it becomes the bucket's watermark.
351
+ */
352
+ export async function refreshWorkflowToday(
353
+ workflow: WorkflowRow,
354
+ sql: SavingsSql,
355
+ now: number,
356
+ ): Promise<"skipped" | "computed" | "refused"> {
357
+ const day = utcDay(now);
358
+ const client = getDbClient();
359
+ const marker = await client.get<{ computedAt: string }>(
360
+ "SELECT computedAt FROM automation_savings_days WHERE day=? AND jobKind='workflow' AND modelVersion=?",
361
+ [day, MODEL_VERSION],
362
+ );
363
+ if (!marker) return "skipped";
364
+ const bucket = await client.get<{
365
+ computedAt: string;
366
+ childTaskUsd: number;
367
+ childTaskMs: number;
368
+ }>(
369
+ "SELECT computedAt, childTaskUsd, childTaskMs FROM automation_savings_daily WHERE day=? AND jobKind='workflow' AND jobId=? AND subKind=''",
370
+ [day, workflow.id],
371
+ );
372
+ const since =
373
+ bucket && bucket.computedAt > marker.computedAt ? bucket.computedAt : marker.computedAt;
374
+ const newer = await client.get<{ n: number }>(
375
+ "SELECT count(*) n FROM workflow_runs WHERE workflowId=? AND startedAt>=?",
376
+ [workflow.id, new Date(Date.parse(since) - WATERMARK_SLACK_MS).toISOString()],
377
+ );
378
+ if (!Number(newer?.n)) return "skipped";
379
+ const out = await computeWorkflowWindow(
380
+ { id: workflow.id, definition: parseDefinition(workflow.definition) },
381
+ { start: dayStartIso(day), end: dayStartIso(utcDay(dayStartMs(day) + DAY_MS)) },
382
+ sql,
383
+ );
384
+ if (out.status !== "ok") return "refused";
385
+ // Unowned task spend comes from the hourly day pass; keep it.
386
+ out.facts.childTaskUsd = Number(bucket?.childTaskUsd) || 0;
387
+ out.facts.childTaskMs = Number(bucket?.childTaskMs) || 0;
388
+ const computedAt = new Date(now).toISOString();
389
+ await client.run(
390
+ UPSERT_BUCKET,
391
+ bucketParams(
392
+ day,
393
+ { workflowId: workflow.id, name: workflow.name, facts: out.facts },
394
+ computedAt,
395
+ ),
396
+ );
397
+ bumpGeneration();
398
+ return "computed";
399
+ }
400
+
401
+ export type SavingsRollupTickOptions = {
402
+ now?: number;
403
+ /** Wall-clock budget of one tick; days left over go to a catch-up tick. */
404
+ budgetMs?: number;
405
+ };
406
+
407
+ export type SavingsRollupStats = {
408
+ ticks: number;
409
+ lastTickAt: string | null;
410
+ daysComputed: number;
411
+ daysPending: number;
412
+ lastError: string | null;
413
+ };
414
+
415
+ let rollupSql: SavingsSql | null = null;
416
+ let rollupTimer: ReturnType<typeof setInterval> | null = null;
417
+ let catchupTimer: ReturnType<typeof setTimeout> | null = null;
418
+ let tickPromise: Promise<SavingsRollupStats> | null = null;
419
+ let abortController: AbortController | null = null;
420
+ /** When a day last failed; it waits behind the other due days for an hour. */
421
+ const failedAt = new Map<string, number>();
422
+ let stats: SavingsRollupStats = {
423
+ ticks: 0,
424
+ lastTickAt: null,
425
+ daysComputed: 0,
426
+ daysPending: 0,
427
+ lastError: null,
428
+ };
429
+
430
+ // Timers must not inherit a caller's AsyncLocalStorage (an open transaction).
431
+ const scheduleContextFree = AsyncLocalStorage.snapshot();
432
+
433
+ function clearCatchup(): void {
434
+ if (catchupTimer) {
435
+ clearTimeout(catchupTimer);
436
+ catchupTimer = null;
437
+ }
438
+ }
439
+
440
+ /** Run one rollup pass. Concurrent callers share the running tick. */
441
+ export function runSavingsRollupTick(
442
+ sql: SavingsSql,
443
+ options: SavingsRollupTickOptions = {},
444
+ ): Promise<SavingsRollupStats> {
445
+ if (tickPromise) return tickPromise;
446
+ const controller = new AbortController();
447
+ abortController = controller;
448
+ const promise = Promise.resolve().then(async () => {
449
+ clearCatchup();
450
+ const startedAt = Date.now();
451
+ const now = options.now ?? startedAt;
452
+ const budget = options.budgetMs ?? DEFAULT_TICK_BUDGET_MS;
453
+ stats = { ...stats, ticks: stats.ticks + 1, lastTickAt: new Date(startedAt).toISOString() };
454
+ let computed = 0;
455
+ let pending: { kind: SavingsJobKind; day: string }[] = [];
456
+ let lastError: string | null = null;
457
+ try {
458
+ const oldest = utcDay(now - (ROLLUP_DAYS - 1) * DAY_MS);
459
+ await getDbClient().run("DELETE FROM automation_savings_daily WHERE day<?", [oldest]);
460
+ await getDbClient().run("DELETE FROM automation_savings_days WHERE day<?", [oldest]);
461
+ await getDbClient().run("DELETE FROM automation_savings_links WHERE day<?", [oldest]);
462
+ bumpGeneration();
463
+ const wf = await daysToCompute("workflow", now);
464
+ const sc = await daysToCompute("script", now);
465
+ // Newest day first; a day's workflows before its scripts.
466
+ pending = [
467
+ ...wf.map((day) => ({ kind: "workflow" as const, day })),
468
+ ...sc.map((day) => ({ kind: "script" as const, day })),
469
+ ].sort((a, b) => b.day.localeCompare(a.day) || (a.kind === "workflow" ? -1 : 1));
470
+ // A day that failed recently goes last, so a day that keeps failing
471
+ // cannot spend every tick's budget ahead of the days behind it.
472
+ const recentlyFailed = (p: { kind: SavingsJobKind; day: string }) =>
473
+ now - (failedAt.get(`${p.kind}:${p.day}`) ?? -Infinity) < ROLLUP_INTERVAL_MS;
474
+ pending = [...pending.filter((p) => !recentlyFailed(p)), ...pending.filter(recentlyFailed)];
475
+ } catch (err) {
476
+ lastError = err instanceof Error ? err.message : String(err);
477
+ }
478
+ // A day that fails (a query over its budget) is retried next hour; it
479
+ // never blocks the older days behind it.
480
+ const failed: string[] = [];
481
+ // Every tick attempts at least one day, so a short budget still makes progress.
482
+ while (
483
+ pending.length > 0 &&
484
+ !controller.signal.aborted &&
485
+ (computed + failed.length === 0 || Date.now() - startedAt <= budget)
486
+ ) {
487
+ const { kind, day } = pending.shift() as { kind: SavingsJobKind; day: string };
488
+ const key = `${kind}:${day}`;
489
+ try {
490
+ // The watermark is taken before the scan: a run that starts during the
491
+ // scan is newer than the marker, so the detail refresh still finds it.
492
+ const scannedAt = new Date(options.now ?? Date.now()).toISOString();
493
+ if (kind === "workflow") {
494
+ const workflowDay = await computeWorkflowDay(day, sql, controller.signal);
495
+ await writeWorkflowDay(day, workflowDay, scannedAt);
496
+ } else {
497
+ const buckets = await computeScriptDay(day, sql);
498
+ await writeScriptDay(day, buckets, scannedAt);
499
+ }
500
+ failedAt.delete(key);
501
+ computed += 1;
502
+ } catch (err) {
503
+ if (controller.signal.aborted) break;
504
+ failed.push(key);
505
+ failedAt.set(key, now);
506
+ lastError = `${kind} ${day}: ${err instanceof Error ? err.message : String(err)}`;
507
+ }
508
+ }
509
+ if (lastError) console.warn(`[savings-rollup] ${lastError.slice(0, 300)}`);
510
+ stats = { ...stats, lastError };
511
+ stats = {
512
+ ...stats,
513
+ daysComputed: stats.daysComputed + computed,
514
+ daysPending: pending.length + failed.length,
515
+ };
516
+ // Work left and progress made: continue soon instead of in an hour.
517
+ if (rollupTimer && pending.length > 0 && computed > 0 && !controller.signal.aborted) {
518
+ catchupTimer = scheduleContextFree(() =>
519
+ setTimeout(() => {
520
+ catchupTimer = null;
521
+ if (rollupSql) void runSavingsRollupTick(rollupSql);
522
+ }, CATCHUP_INTERVAL_MS),
523
+ );
524
+ if (typeof catchupTimer.unref === "function") catchupTimer.unref();
525
+ }
526
+ return { ...stats };
527
+ });
528
+ const tracked: Promise<SavingsRollupStats> = promise.finally(() => {
529
+ if (tickPromise === tracked) tickPromise = null;
530
+ if (abortController === controller) abortController = null;
531
+ });
532
+ tickPromise = tracked;
533
+ return tracked;
534
+ }
535
+
536
+ export function getSavingsRollupStats(): SavingsRollupStats {
537
+ return { ...stats };
538
+ }
539
+
540
+ /**
541
+ * Start the hourly rollup. The first tick runs in the background: a fresh
542
+ * deployment backfills ROLLUP_DAYS days over several catch-up ticks.
543
+ */
544
+ export function startSavingsRollup(sql: SavingsSql, intervalMs = ROLLUP_INTERVAL_MS): void {
545
+ if (rollupTimer) return;
546
+ rollupSql = sql;
547
+ rollupTimer = scheduleContextFree(() =>
548
+ setInterval(() => void runSavingsRollupTick(sql), intervalMs),
549
+ );
550
+ if (typeof rollupTimer.unref === "function") rollupTimer.unref();
551
+ void runSavingsRollupTick(sql);
552
+ }
553
+
554
+ export async function stopSavingsRollup(): Promise<void> {
555
+ if (rollupTimer) {
556
+ clearInterval(rollupTimer);
557
+ rollupTimer = null;
558
+ }
559
+ clearCatchup();
560
+ abortController?.abort();
561
+ await tickPromise?.catch(() => undefined);
562
+ }
563
+
564
+ /** Test hook to keep module state from leaking between test files. */
565
+ export async function resetSavingsRollupForTests(): Promise<void> {
566
+ await stopSavingsRollup();
567
+ rollupSql = null;
568
+ failedAt.clear();
569
+ bumpGeneration();
570
+ stats = { ticks: 0, lastTickAt: null, daysComputed: 0, daysPending: 0, lastError: null };
571
+ }
@@ -20,6 +20,14 @@ export type ScriptApiCredential = {
20
20
  release: () => Promise<void>;
21
21
  };
22
22
 
23
+ /**
24
+ * Where a script run came from, bound to its token so the rows it creates can
25
+ * be traced back (`sourceStepId`, `parentScriptRunId`). `sourceStepId` is the
26
+ * swarm-script workflow step that started the run, inherited by nested runs;
27
+ * `sourceScriptRunId` is the run's own `script_runs` id.
28
+ */
29
+ export type ScriptRunProvenance = { sourceStepId?: string; sourceScriptRunId?: string };
30
+
23
31
  /**
24
32
  * Resolve the api credential a script run acts as. When the run has a real
25
33
  * executing agent, mint a short-lived token bound to it so `ctx.swarm` calls
@@ -28,11 +36,14 @@ export type ScriptApiCredential = {
28
36
  * pass sentinel ids like "schedule"/"workflow") keep the operator key, their
29
37
  * existing behavior. The caller must `release()` when the run ends.
30
38
  */
31
- export async function acquireScriptApiCredential(agentId: string): Promise<ScriptApiCredential> {
39
+ export async function acquireScriptApiCredential(
40
+ agentId: string,
41
+ provenance: ScriptRunProvenance = {},
42
+ ): Promise<ScriptApiCredential> {
32
43
  if (!(await getAgentById(agentId))) {
33
44
  return { apiKey: undefined, release: async () => {} };
34
45
  }
35
- const token = await mintScriptRunToken(agentId, SCRIPT_RUN_TOKEN_TTL_MS);
46
+ const token = await mintScriptRunToken(agentId, SCRIPT_RUN_TOKEN_TTL_MS, provenance);
36
47
  let released = false;
37
48
  return {
38
49
  apiKey: token.plaintext,
@@ -54,8 +65,9 @@ export async function acquireScriptApiCredential(agentId: string): Promise<Scrip
54
65
  */
55
66
  export async function runScriptWithRunCredential(
56
67
  input: Omit<RunScriptInput, "apiKey">,
68
+ provenance: ScriptRunProvenance = {},
57
69
  ): Promise<RunScriptOutput> {
58
- const credential = await acquireScriptApiCredential(input.agentId);
70
+ const credential = await acquireScriptApiCredential(input.agentId, provenance);
59
71
  try {
60
72
  return await runScript({ ...input, apiKey: credential.apiKey });
61
73
  } finally {