@desplega.ai/agent-swarm 2.8.2 → 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 (258) hide show
  1. package/dist/acp-adapter-xq6s2z6t.js +14 -0
  2. package/dist/{actions-kxek041g.js → actions-ewz7bp4g.js} +20 -19
  3. package/dist/{amp-adapter-ce7jjke4.js → amp-adapter-f25tqhnf.js} +3 -3
  4. package/dist/{app-v6zz8yh0.js → app-mkptw0k7.js} +4 -4
  5. package/dist/{assistant-m0sw9xx2.js → assistant-c47rfe77.js} +23 -22
  6. package/dist/{boot-args-schema-66bk37wv.js → boot-args-schema-4vb0xsat.js} +1 -1
  7. package/dist/{boot-reembed-edjpwsc1.js → boot-reembed-1ghy2sab.js} +1 -1
  8. package/dist/{boot-reembed-y27n09tz.js → boot-reembed-htr73hbs.js} +1 -1
  9. package/dist/{boot-scrub-sweep-1xc35965.js → boot-scrub-sweep-yrytg42z.js} +4 -4
  10. package/dist/{boot-seeds-7hjj91qj.js → boot-seeds-n2b3dx4e.js} +4 -4
  11. package/dist/{boxd-ent8ch04.js → boxd-jmfqgkqa.js} +1 -1
  12. package/dist/{claude-adapter-stw7jdcf.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-y6z2perp.js → claude-managed-setup-hfvry1bd.js} +5 -5
  15. package/dist/{claude-sdk-session-vvya8wqk.js → claude-sdk-session-0hamqzc7.js} +10 -11
  16. package/dist/{cli-v1dv1r37.js → cli-0bcgyj5b.js} +74 -3
  17. package/dist/{cli-t2tma8gb.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-0cq8y6m7.js → cli-4ax9mvvg.js} +4 -4
  22. package/dist/{cli-tekytdq9.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-9mb2q6pb.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-kjtwrhea.js → cli-7c5tgqhf.js} +5 -5
  30. package/dist/{cli-2gxeg5gr.js → cli-8476gtwf.js} +1 -1
  31. package/dist/{cli-zh9rsbqf.js → cli-922z7gwm.js} +3 -3
  32. package/dist/{cli-jrzkw01m.js → cli-93t5s4zq.js} +2 -2
  33. package/dist/{cli-gyt3zydq.js → cli-9zmb7ptc.js} +9 -9
  34. package/dist/{cli-dzpc6en0.js → cli-am1ptset.js} +2 -2
  35. package/dist/{cli-w401b9tq.js → cli-awwptga4.js} +1 -1
  36. package/dist/{cli-26ctbcdp.js → cli-bhsfbmk8.js} +3 -3
  37. package/dist/{cli-mxn1qvbn.js → cli-bj6qhgte.js} +14 -32
  38. package/dist/{cli-g70vxtjh.js → cli-c0xjnr8z.js} +2 -2
  39. package/dist/{cli-jdknh18m.js → cli-c3ng0mb4.js} +13 -13
  40. package/dist/{cli-f4e8r23x.js → cli-c71n3bxq.js} +11 -6
  41. package/dist/{cli-6rc5frdm.js → cli-crpf163n.js} +25 -18
  42. package/dist/{cli-1qkz151v.js → cli-dpsfwh7n.js} +13 -21
  43. package/dist/{cli-xzm9vcfg.js → cli-dtdht77h.js} +2 -2
  44. package/dist/{cli-a0z912j7.js → cli-e2w34h6z.js} +137 -62
  45. package/dist/{cli-eddnyg3t.js → cli-emekyyhr.js} +1 -1
  46. package/dist/{cli-d84byzn8.js → cli-f1kwb5fc.js} +109 -33
  47. package/dist/{cli-0jzra9ad.js → cli-gn9y6fn7.js} +2 -2
  48. package/dist/{cli-vdektqgf.js → cli-gpz1d0t2.js} +4 -4
  49. package/dist/{cli-rcecc3yq.js → cli-h9yy18gy.js} +84 -36
  50. package/dist/{cli-m5akxq8q.js → cli-j8cjdzan.js} +1 -1
  51. package/dist/{cli-m9s2qff2.js → cli-jg5txpm6.js} +187 -93
  52. package/dist/{cli-b98a65ed.js → cli-k2rw11py.js} +3 -3
  53. package/dist/{cli-3e875j5p.js → cli-k96cecs7.js} +276 -47
  54. package/dist/{cli-3vjhs18n.js → cli-kd56bmk4.js} +1 -1
  55. package/dist/{cli-3sy2xags.js → cli-kmemts3w.js} +12 -12
  56. package/dist/{cli-f6bahpn5.js → cli-knva3nmx.js} +2 -2
  57. package/dist/{cli-959kp5h2.js → cli-kw44j53p.js} +13 -13
  58. package/dist/{cli-bsywb58a.js → cli-mdpbjnzq.js} +10 -10
  59. package/dist/{cli-2kvhc7x8.js → cli-me0r8gzr.js} +35 -76
  60. package/dist/{cli-4vzgeta4.js → cli-mwwmka77.js} +14 -14
  61. package/dist/{cli-q24n86d2.js → cli-n5t077me.js} +2 -2
  62. package/dist/{cli-rvhdmjvt.js → cli-nx2n3z6p.js} +1 -1
  63. package/dist/{cli-28fq781p.js → cli-pe4d96rb.js} +1 -1
  64. package/dist/{cli-3rkdne1h.js → cli-pxwtcgcp.js} +2 -2
  65. package/dist/{cli-n6vtrcht.js → cli-qmqt520k.js} +2 -2
  66. package/dist/{cli-pchypa1s.js → cli-qps8je6j.js} +17 -2
  67. package/dist/{cli-97ae65rz.js → cli-rjvsf9qa.js} +5 -5
  68. package/dist/{cli-e1p3n5gq.js → cli-rqfvkx5t.js} +6 -6
  69. package/dist/{cli-3vmb0n58.js → cli-s7zz734a.js} +1 -1
  70. package/dist/{cli-rmzsadkf.js → cli-s8p8hhty.js} +2 -2
  71. package/dist/{cli-j24zbska.js → cli-sdvcrq5x.js} +5 -5
  72. package/dist/{cli-5y340nzn.js → cli-sg27rk2t.js} +5 -5
  73. package/dist/{cli-d6521kb5.js → cli-skmhsnqh.js} +1 -1
  74. package/dist/{cli-5mrq3ake.js → cli-t4dv07kr.js} +1 -1
  75. package/dist/{cli-z1w943va.js → cli-t5ys4ebm.js} +3 -3
  76. package/dist/{cli-f4r3g076.js → cli-tas6ckky.js} +2 -2
  77. package/dist/{cli-1pz0330a.js → cli-tf79ryyy.js} +1 -1
  78. package/dist/{cli-kc7v1nfv.js → cli-tnzebztn.js} +1 -1
  79. package/dist/{cli-pfs8adn4.js → cli-vx421edw.js} +3 -3
  80. package/dist/{cli-kchjb7qy.js → cli-x3ex5bqf.js} +1 -1
  81. package/dist/cli-yss07azk.js +142 -0
  82. package/dist/{cli-fwy8kfd6.js → cli-z8cvws4c.js} +98 -16
  83. package/dist/{cli-g5mtmf6t.js → cli-zdaypkq9.js} +146 -52
  84. package/dist/{cli-fpjmegdb.js → cli-zeaehgyd.js} +2 -2
  85. package/dist/{cli-837vfs2x.js → cli-ztq5z4e1.js} +4 -4
  86. package/dist/cli.js +20 -20
  87. package/dist/{codex-adapter-zerf5qsp.js → codex-adapter-2brxx5ta.js} +7 -8
  88. package/dist/{codex-hook-30gyhzxe.js → codex-hook-c930c3ea.js} +1 -1
  89. package/dist/{codex-login-bcda78ge.js → codex-login-cbrs1h5w.js} +1 -1
  90. package/dist/{codex-session-runner-89s304py.js → codex-session-runner-y9anfj0r.js} +8 -9
  91. package/dist/{commands-jeh1b51j.js → commands-wn9q06qr.js} +3 -3
  92. package/dist/{controller-mctfbrse.js → controller-fw608czd.js} +4 -4
  93. package/dist/{controllers-connect-nxa1ddwn.js → controllers-connect-63j5rdcm.js} +20 -20
  94. package/dist/{cursor-adapter-qj8vehv6.js → cursor-adapter-6mb9jme8.js} +2 -2
  95. package/dist/{db-2dvay0es.js → db-0m6v5tq4.js} +3 -3
  96. package/dist/{db-b36qn6k3.js → db-y4wfrzbm.js} +4 -2
  97. package/dist/{devin-adapter-xedz98zv.js → devin-adapter-r0yx3gv8.js} +1 -1
  98. package/dist/{dispatcher-gndbta01.js → dispatcher-9tq2zzdj.js} +17 -17
  99. package/dist/{docker-866qpzt9.js → docker-j75atvpt.js} +2 -2
  100. package/dist/{dsh-adapter-f75sz821.js → dsh-adapter-t09sv4tq.js} +2 -2
  101. package/dist/{e2b-jbm7mj93.js → e2b-7s9dscap.js} +2 -2
  102. package/dist/{e2b-3gpc2n3w.js → e2b-a7vzs2vj.js} +2 -2
  103. package/dist/{easter-egg-3d-533knw22.js → easter-egg-3d-fbwvmwhe.js} +1 -1
  104. package/dist/{embedding-space-4p05vb2x.js → embedding-space-wh8de1t9.js} +6 -6
  105. package/dist/{embeddings-m6768mgh.js → embeddings-3hpbdtjr.js} +1 -1
  106. package/dist/{event-bus-e66gh7cc.js → event-bus-tr6h3gv8.js} +1 -1
  107. package/dist/{execute-b3mrb1mv.js → execute-4bdf8sdy.js} +1 -1
  108. package/dist/{external-channel-gjv3jne3.js → external-channel-ts2fwqh0.js} +2 -2
  109. package/dist/fx-adapter-1rnxnf56.js +17 -0
  110. package/dist/grok-adapter-efhmf1r8.js +17 -0
  111. package/dist/handlers-anrr3py9.js +32 -0
  112. package/dist/{heartbeat-a1tv60gt.js → heartbeat-2ze5fzpc.js} +20 -20
  113. package/dist/{hook-8h5dzcgq.js → hook-ca54yd4s.js} +5 -5
  114. package/dist/{hook-cyaps9ba.js → hook-gaehe2w5.js} +7 -7
  115. package/dist/{http-t15mhbd9.js → http-jfg8t2yk.js} +3861 -1798
  116. package/dist/{index-tvfafeyy.js → index-3gv6sc4z.js} +1 -1
  117. package/dist/{index-qav6455f.js → index-3yvzbhxd.js} +97 -22
  118. package/dist/index-8w2aznds.js +33 -0
  119. package/dist/{index-w1zqf680.js → index-csgrxedz.js} +1 -1
  120. package/dist/index-qnjvr362.js +37 -0
  121. package/dist/index-yzxd3sn9.js +32 -0
  122. package/dist/{keepalive-91s7hzrb.js → keepalive-k2a3qe73.js} +4 -4
  123. package/dist/lead-zhxqbfdv.js +69 -0
  124. package/dist/{maintenance-7pjmy5xy.js → maintenance-gb5sd5nc.js} +1 -1
  125. package/dist/{node-4c5jqxr3.js → node-7qsx5kvm.js} +1 -1
  126. package/dist/{oauth-refresh-sweep-rzqfm94j.js → oauth-refresh-sweep-y7rm6bkb.js} +3 -3
  127. package/dist/{onboard-74st7pag.js → onboard-jmc5qerv.js} +3 -3
  128. package/dist/{opencode-adapter-arn7gm8q.js → opencode-adapter-7eade9ev.js} +6 -7
  129. package/dist/{otel-impl-rnzey8cb.js → otel-impl-8j1xhxqd.js} +2 -2
  130. package/dist/{pi-mono-adapter-6mkwq64n.js → pi-mono-adapter-yqmaf32x.js} +13 -13
  131. package/dist/{pricing-refresh-ha21jhk7.js → pricing-refresh-1nj722h6.js} +2 -2
  132. package/dist/{rbac-roles-wqhma4dr.js → rbac-roles-b1mtr6dr.js} +3 -3
  133. package/dist/{rbac-roles-59dxachk.js → rbac-roles-n1f3frk1.js} +2 -2
  134. package/dist/{render-v2-14kpzx12.js → render-v2-1gfpd8rj.js} +4 -4
  135. package/dist/{resume-gsa5fb5f.js → resume-w1s1eh5v.js} +7 -7
  136. package/dist/{runtime-1hv06jsn.js → runtime-84g5egsc.js} +1 -1
  137. package/dist/{session-access-skm7bnp6.js → session-access-y6z1txk4.js} +4 -4
  138. package/dist/{session-source-backfill-pbqzbncv.js → session-source-backfill-gxxwfh12.js} +3 -3
  139. package/dist/{setup-5yermsem.js → setup-r91gstyk.js} +1 -1
  140. package/dist/{virtual-modules-gazyapte.js → virtual-modules-cgnj6kme.js} +3 -3
  141. package/dist/{work-objects-xj0ck0w4.js → work-objects-qcxzg61c.js} +20 -20
  142. package/dist/worker-7j2907g6.js +69 -0
  143. package/dist/{worker-follow-up-911xc0b8.js → worker-follow-up-y2d2h7km.js} +17 -17
  144. package/dist/{x-2fyrt5pp.js → x-qhxq2ama.js} +2 -2
  145. package/openapi.json +1214 -108
  146. package/package.json +3 -3
  147. package/src/be/db/tasks/read.ts +33 -0
  148. package/src/be/db.ts +32 -7
  149. package/src/be/migrations/289_automation_savings_daily.sql +47 -0
  150. package/src/be/migrations/291_task_slack_participants.sql +4 -0
  151. package/src/be/migrations/293_savings_component_links.sql +58 -0
  152. package/src/be/migrations/296_automation_savings_daily_read_index.sql +6 -0
  153. package/src/be/model-profile-check.ts +10 -2
  154. package/src/be/savings/compute.ts +511 -16
  155. package/src/be/savings/model.ts +282 -14
  156. package/src/be/savings/read.ts +1500 -0
  157. package/src/be/savings/rollup.ts +571 -0
  158. package/src/be/scripts/run-credential.ts +15 -3
  159. package/src/be/scripts/typecheck.ts +86 -4
  160. package/src/be/seed-scripts/catalog/dreaming-learnings.ts +10 -2
  161. package/src/be/seed-scripts/catalog/dreaming-memtax-create.ts +70 -4
  162. package/src/be/swarm-config-guard.ts +8 -0
  163. package/src/be/users.ts +29 -2
  164. package/src/commands/runner.ts +159 -41
  165. package/src/extensions/contract-types.generated.ts +1 -1
  166. package/src/http/index.ts +8 -1
  167. package/src/http/poll.ts +14 -1
  168. package/src/http/requested-by.ts +97 -1
  169. package/src/http/savings.ts +676 -190
  170. package/src/http/scripts.ts +26 -15
  171. package/src/http/tasks.ts +43 -5
  172. package/src/prompts/session-templates.ts +80 -3
  173. package/src/providers/acp-targets.ts +1 -1
  174. package/src/providers/amp-adapter.ts +1 -1
  175. package/src/providers/claude-adapter.ts +0 -20
  176. package/src/providers/claude-flag-settings.ts +12 -10
  177. package/src/providers/codex-adapter.ts +9 -34
  178. package/src/providers/opencode-adapter.ts +34 -12
  179. package/src/scheduler/scheduler.ts +20 -14
  180. package/src/scripts-runtime/ctx.ts +1 -1
  181. package/src/scripts-runtime/executors/quickjs-bundle.ts +1 -0
  182. package/src/scripts-runtime/executors/quickjs-prelude.ts +162 -2
  183. package/src/scripts-runtime/executors/quickjs-runner.ts +4 -1
  184. package/src/scripts-runtime/stdlib/fetch.ts +113 -15
  185. package/src/scripts-runtime/stdlib/index.ts +3 -1
  186. package/src/scripts-runtime/stdlib/retry.ts +174 -0
  187. package/src/scripts-runtime/swarm-sdk.ts +186 -17
  188. package/src/scripts-runtime/types/stdlib.d.ts +86 -4
  189. package/src/scripts-runtime/types/swarm-extension.d.ts +26 -0
  190. package/src/scripts-runtime/types/swarm-sdk.d.ts +60 -2
  191. package/src/slack/actions.ts +1 -0
  192. package/src/slack/assistant.ts +2 -0
  193. package/src/slack/enrich.ts +144 -50
  194. package/src/slack/handlers.ts +37 -95
  195. package/src/slack/templates.ts +9 -0
  196. package/src/slack/thread-buffer.ts +45 -71
  197. package/src/slack/thread-participants.ts +187 -0
  198. package/src/tests/base-prompt.test.ts +5 -4
  199. package/src/tests/claude-adapter-binary.test.ts +7 -1
  200. package/src/tests/claude-adapter.test.ts +10 -64
  201. package/src/tests/claude-flag-settings.test.ts +15 -11
  202. package/src/tests/claude-hook-credentials.test.ts +0 -1
  203. package/src/tests/claude-sdk-lifecycle.test.ts +5 -1
  204. package/src/tests/codex-adapter.test.ts +17 -78
  205. package/src/tests/create-task-vcs-repo.test.ts +136 -0
  206. package/src/tests/db-task-read-contract.test.ts +2 -0
  207. package/src/tests/db-task-write-contract.test.ts +1 -0
  208. package/src/tests/docs-index-footprint.test.js +3 -3
  209. package/src/tests/dreaming-learnings.test.ts +104 -0
  210. package/src/tests/extensions-pre-task.test.ts +4 -2
  211. package/src/tests/fetch-resolved-env.test.ts +47 -1
  212. package/src/tests/opencode-adapter.test.ts +53 -6
  213. package/src/tests/prompt-template-session.test.ts +17 -1
  214. package/src/tests/runner-requester-profile.test.ts +139 -1
  215. package/src/tests/savings-compound.test.ts +774 -0
  216. package/src/tests/savings-compute.test.ts +7 -198
  217. package/src/tests/savings-fleet-latency.test.ts +143 -0
  218. package/src/tests/savings-fleet-read.test.ts +195 -0
  219. package/src/tests/savings-fleet-scale.test.ts +222 -0
  220. package/src/tests/savings-model.test.ts +212 -0
  221. package/src/tests/savings-read.test.ts +367 -0
  222. package/src/tests/savings-rollup.test.ts +766 -0
  223. package/src/tests/savings-scripts.test.ts +611 -0
  224. package/src/tests/script-connections.test.ts +2 -0
  225. package/src/tests/script-executor-conformance.test.ts +444 -0
  226. package/src/tests/scripts-http.test.ts +55 -0
  227. package/src/tests/scripts-runtime-fetch.test.ts +2 -2
  228. package/src/tests/secret-rules.test.ts +124 -1
  229. package/src/tests/secret-scrubber.test.ts +1 -1
  230. package/src/tests/slack-dm-implicit-mention.test.ts +20 -1
  231. package/src/tests/slack-identity-resolution.test.ts +23 -0
  232. package/src/tests/slack-inbound-files.test.ts +2 -1
  233. package/src/tests/slack-thread-participants.test.ts +429 -0
  234. package/src/tests/tool-annotations.test.ts +30 -0
  235. package/src/types.ts +31 -0
  236. package/src/utils/mcp-server-fetcher.test.ts +89 -0
  237. package/src/utils/mcp-server-fetcher.ts +13 -5
  238. package/src/utils/request-auth-context.ts +24 -0
  239. package/src/utils/secret-rules.generated.ts +1 -1
  240. package/src/utils/secret-scrubber.ts +154 -29
  241. package/src/workflows/executors/swarm-script.ts +23 -19
  242. package/templates/skills/swarm-scripts/SKILL.md +5 -4
  243. package/templates/skills/swarm-scripts/content.md +5 -4
  244. package/templates/skills/work-on-task/SKILL.md +1 -1
  245. package/templates/skills/work-on-task/content.md +1 -1
  246. package/templates/workflows/dreaming/content.md +1 -1
  247. package/dist/acp-adapter-fqzkxyra.js +0 -15
  248. package/dist/cli-4bd1rck6.js +0 -4
  249. package/dist/cli-xf3qw745.js +0 -104
  250. package/dist/fx-adapter-rpsgb1tw.js +0 -18
  251. package/dist/grok-adapter-n2m3zjg1.js +0 -18
  252. package/dist/handlers-nv8edn19.js +0 -32
  253. package/dist/index-ksmyd6kc.js +0 -37
  254. package/dist/index-rjnrje98.js +0 -32
  255. package/dist/index-tv3413wy.js +0 -33
  256. package/dist/lead-3hmddvrm.js +0 -70
  257. package/dist/worker-qgg0m2gw.js +0 -70
  258. package/src/providers/ctx-mode-env.ts +0 -10
@@ -22,6 +22,12 @@ type Quantile = keyof SavingsBand;
22
22
 
23
23
  export const CALIBRATION_MODEL = "claude-opus-5-5";
24
24
  export const CALIBRATED_AT = "2026-11-05";
25
+ /**
26
+ * Version of the constants and of the facts the daily rollup stores. Bump it
27
+ * with any change here or in the rollup's SQL: buckets computed under an older
28
+ * version are recomputed on the next tick.
29
+ */
30
+ export const MODEL_VERSION = 2;
25
31
 
26
32
  /** Agent turns per deterministic op. */
27
33
  export const K = 0.2753;
@@ -43,8 +49,25 @@ export const ERR_JOB: SavingsBand = { p10: 0.542, p50: 1.0, p90: 1.508 };
43
49
  export const ERR_FLEET: SavingsBand = { p10: 0.746, p50: 1.0, p90: 1.325 };
44
50
  /** Ops of a swarm-script node whose script is not in the catalog. */
45
51
  export const DEFAULT_OPS = 9;
52
+ /** Ops of a script run with inline source (no catalog entry), from v7. */
53
+ export const INLINE_OPS = 3.9;
54
+ /** Job id of the script runs that carry no script name (inline source). */
55
+ export const INLINE_SCRIPT_NAME = "(inline source)";
46
56
  /** Upper bound on the ops counted for one script. */
47
57
  export const MAX_SCRIPT_OPS = 100;
58
+ /**
59
+ * Enabled-only rule (an event router): an event-triggered workflow that ran
60
+ * more than this many times a day on average, and where fewer than
61
+ * ROUTER_MAX_EFFECT_SHARE of its runs had an effect, is a filter over an event
62
+ * stream. Only its effect runs count, each as one agent decision.
63
+ * The v7 script names the router; a product needs a rule. The plan's 24 a day
64
+ * also caught an event workflow that does real work on every run (41 runs a
65
+ * day, no linked effects), so the threshold is 10 events an hour.
66
+ */
67
+ export const ROUTER_MIN_RUNS_PER_DAY = 240;
68
+ export const ROUTER_MAX_EFFECT_SHARE = 0.1;
69
+ /** Share of runs with `triggerType='event'` for a workflow to count as event-triggered. */
70
+ export const ROUTER_MIN_EVENT_SHARE = 0.9;
48
71
 
49
72
  // Session cost (USD) and agent-active hours by session length in turns
50
73
  // (index 0 = 1 turn), per tier, from 30 days of session_costs repriced at each
@@ -243,6 +266,12 @@ export type WorkflowFacts = {
243
266
  schedRuns: number;
244
267
  /** Of `schedRuns`, the runs that created an agent task or started a child workflow. */
245
268
  schedEffectRuns: number;
269
+ /** Runs started by an event trigger. */
270
+ eventRuns: number;
271
+ /** Runs of any trigger and status that created an agent task or started a child workflow. */
272
+ effectRuns: number;
273
+ /** Deterministic ops summed over the steps of the effect runs. */
274
+ effectOpsSum: number;
246
275
  /** Deterministic ops summed over every step of every run. */
247
276
  opsSum: number;
248
277
  agentTasks: number;
@@ -251,6 +280,13 @@ export type WorkflowFacts = {
251
280
  agentMs: number;
252
281
  /** Lead follow-up review cost of those agent tasks. */
253
282
  followupUsd: number;
283
+ /**
284
+ * Session cost of tasks the runs caused without owning them: descendants of
285
+ * the agent-task nodes' tasks, and tasks the script steps created with their
286
+ * descendants. Kept on both sides of the saving, like `agentUsd`.
287
+ */
288
+ childTaskUsd: number;
289
+ childTaskMs: number;
254
290
  /** LLM cost a run reported itself (report node). */
255
291
  recordedLlmUsd: number;
256
292
  /** LLM cost estimated from SystemOne tokens and raw-llm output size. */
@@ -260,6 +296,8 @@ export type WorkflowFacts = {
260
296
  };
261
297
 
262
298
  export type PricedWorkflow = {
299
+ /** True when the enabled-only rule priced only the effect runs. */
300
+ enabledOnlyRule: boolean;
263
301
  runs: number;
264
302
  substitutedRuns: number;
265
303
  /** Schedule runs above the hourly cap that still count because they had an effect. */
@@ -290,6 +328,10 @@ export type PricedWorkflow = {
290
328
  agentOnlyUsdPerRun: number;
291
329
  };
292
330
 
331
+ /** Agent spend the runs caused: kept on both sides of the saving. */
332
+ const keptSpendOf = (f: WorkflowFacts): number => f.agentUsd + f.followupUsd + f.childTaskUsd;
333
+ const keptHoursOf = (f: WorkflowFacts): number => (f.agentMs + f.childTaskMs) / 3.6e6;
334
+
293
335
  /**
294
336
  * Split spend into measured and estimated. The window picks the LLM source
295
337
  * (`useRecorded`): when any run recorded its LLM cost, no day adds an estimate.
@@ -299,7 +341,7 @@ function spendOf(
299
341
  useRecorded: boolean,
300
342
  ): { measuredUsd: number; estimatedLlmUsd: number } {
301
343
  return {
302
- measuredUsd: facts.agentUsd + facts.followupUsd + (useRecorded ? facts.recordedLlmUsd : 0),
344
+ measuredUsd: keptSpendOf(facts) + (useRecorded ? facts.recordedLlmUsd : 0),
303
345
  estimatedLlmUsd: useRecorded ? 0 : facts.estimatedLlmUsd,
304
346
  };
305
347
  }
@@ -310,20 +352,91 @@ const bandOf = (fn: (q: Quantile) => number): SavingsBand => ({
310
352
  p90: fn("p90"),
311
353
  });
312
354
 
355
+ /** Schedule runs one version of a job substitutes, and how many of them fit under the cap. */
356
+ export type ScheduleAllocation = { vSched: number; vCap: number };
357
+
358
+ /**
359
+ * Share the hourly cap across the versions of one job (`jobKey`), in order.
360
+ * A run with a downstream effect always counts, so the job total is
361
+ * max(min(all schedule runs, cap), all effect runs). Same arithmetic as v7.
362
+ */
363
+ export function allocateSchedule(
364
+ versions: readonly Pick<WorkflowFacts, "schedRuns" | "schedEffectRuns">[],
365
+ days: number,
366
+ ): ScheduleAllocation[] {
367
+ const cap = CAP_PER_DAY * days;
368
+ let used = 0;
369
+ let eff = 0;
370
+ return versions.map((v) => {
371
+ const vCap = Math.min(v.schedRuns, Math.max(0, cap - used));
372
+ const vSched = Math.max(Math.min(used + v.schedRuns, cap), eff + v.schedEffectRuns) - used;
373
+ used += vSched;
374
+ eff += v.schedEffectRuns;
375
+ return { vSched, vCap };
376
+ });
377
+ }
378
+
379
+ /** The enabled-only rule (see ROUTER_MIN_RUNS_PER_DAY). */
380
+ export function isEnabledOnlyRouter(facts: WorkflowFacts, days: number): boolean {
381
+ return (
382
+ facts.runs > ROUTER_MIN_RUNS_PER_DAY * days &&
383
+ facts.effectRuns < ROUTER_MAX_EFFECT_SHARE * facts.runs &&
384
+ facts.eventRuns >= ROUTER_MIN_EVENT_SHARE * facts.runs
385
+ );
386
+ }
387
+
388
+ /** A router run with an effect is one agent decision at the run's own ops; the job it starts is priced on its own row. */
389
+ function priceRouter(
390
+ facts: WorkflowFacts,
391
+ opts: { tier: SavingsTier; band: "job" | "fleet"; curve?: CurveSet },
392
+ ): PricedWorkflow {
393
+ const v = facts.effectRuns;
394
+ const opsPerRun = v > 0 ? facts.effectOpsSum / v : 0;
395
+ const tau = Math.min(TAU_MAX, T0 + K * opsPerRun);
396
+ const unitUsd = v > 0 ? curve(tau, opts.tier, "usd", opts.curve) : 0;
397
+ const unitHrs = v > 0 ? curve(tau, opts.tier, "hrs", opts.curve) : 0;
398
+ const review = unitUsd > 0 ? F_FOLLOWUP : 0;
399
+ const err = opts.band === "job" ? ERR_JOB : ERR_FLEET;
400
+ const agentOnlyUsd = bandOf((q) => v * (R[q] * unitUsd * err[q] + review));
401
+ const agentOnlyHours = bandOf((q) => v * R[q] * unitHrs * err[q]);
402
+ return {
403
+ enabledOnlyRule: true,
404
+ runs: facts.runs,
405
+ substitutedRuns: v,
406
+ effectRuns: v,
407
+ enabledOnlyRuns: facts.runs - v,
408
+ capApplied: false,
409
+ opsPerRun,
410
+ // Measured spend is reported; the rule subtracts nothing (v7: the jobs
411
+ // the router starts are priced, with their spend, on their own rows).
412
+ ...spendOf(facts, facts.recordedLlmUsd > 0),
413
+ actualUsd: 0,
414
+ agentOnlyUsd,
415
+ savingUsd: agentOnlyUsd,
416
+ actualHours: 0,
417
+ agentOnlyHours,
418
+ hoursSaved: agentOnlyHours,
419
+ agentOnlyUsdPerRun: R.p50 * unitUsd + review,
420
+ };
421
+ }
422
+
313
423
  /**
314
424
  * Price one workflow's facts at a tier. `band` picks the error spread: `job`
315
- * for a single job, `fleet` for a sum over many jobs. `curve` overrides the
316
- * shipped session-cost curve with a deployment calibration.
425
+ * for a single job, `fleet` for a sum over many jobs. `allocation` carries the
426
+ * cap shared with the job's other versions (`allocateSchedule`); without it the
427
+ * workflow is the job's only version. `curve` overrides the shipped
428
+ * session-cost curve with a deployment calibration.
317
429
  */
318
430
  export function priceWorkflow(
319
431
  facts: WorkflowFacts,
320
432
  opts: { tier: SavingsTier; days: number; band: "job" | "fleet"; curve?: CurveSet },
433
+ allocation?: ScheduleAllocation,
321
434
  ): PricedWorkflow {
322
- const cap = CAP_PER_DAY * opts.days;
435
+ if (isEnabledOnlyRouter(facts, opts.days)) return priceRouter(facts, opts);
323
436
  const runs = facts.runs;
324
437
  // Schedule runs: at most the hourly cap, but a run with a downstream effect always counts.
325
- const vCap = Math.min(facts.schedRuns, cap);
326
- const vSched = Math.max(vCap, facts.schedEffectRuns);
438
+ const { vSched, vCap } =
439
+ allocation ?? (allocateSchedule([facts], opts.days)[0] as ScheduleAllocation);
327
440
  const substituted = vSched + (facts.countedRuns - facts.schedRuns);
328
441
  const opsPerRun = runs > 0 ? facts.opsSum / runs : 0;
329
442
  const tau = Math.min(TAU_MAX, T0 + K * opsPerRun);
@@ -334,19 +447,20 @@ export function priceWorkflow(
334
447
  const review = unitUsd > 0 ? F_FOLLOWUP : 0;
335
448
  const share = runs > 0 ? substituted / runs : 0;
336
449
  const { measuredUsd, estimatedLlmUsd } = spendOf(facts, facts.recordedLlmUsd > 0);
337
- const keptUsd = (facts.agentUsd + facts.followupUsd) * share;
338
- const keptHours = (facts.agentMs / 3.6e6) * share;
450
+ const keptUsd = keptSpendOf(facts) * share;
451
+ const keptHours = keptHoursOf(facts) * share;
339
452
  const actualUsd = (measuredUsd + estimatedLlmUsd) * share;
340
- const actualHours = (facts.agentMs / 3.6e6 + facts.computeSecs / 3600) * share;
453
+ const actualHours = (keptHoursOf(facts) + facts.computeSecs / 3600) * share;
341
454
  const err = opts.band === "job" ? ERR_JOB : ERR_FLEET;
342
455
  const agentOnlyUsd = bandOf((q) => keptUsd + substituted * (R[q] * unitUsd * err[q] + review));
343
456
  const agentOnlyHours = bandOf((q) => keptHours + substituted * R[q] * unitHrs * err[q]);
344
457
  return {
458
+ enabledOnlyRule: false,
345
459
  runs,
346
460
  substitutedRuns: substituted,
347
461
  effectRuns: vSched - vCap,
348
462
  enabledOnlyRuns: runs - substituted,
349
- capApplied: facts.schedRuns > cap,
463
+ capApplied: vCap < facts.schedRuns,
350
464
  opsPerRun,
351
465
  measuredUsd,
352
466
  estimatedLlmUsd,
@@ -367,12 +481,15 @@ export function priceWorkflow(
367
481
  * cost (tau), the substituted share and the LLM source are the window's.
368
482
  * When the hourly cap or the effect rule makes the window's counted schedule
369
483
  * runs differ from the raw ones, they are spread pro rata over the days'
370
- * schedule runs.
484
+ * schedule runs. A workflow priced by the enabled-only rule splits by its
485
+ * days' effect runs.
371
486
  */
372
487
  export function splitByDay(
373
488
  facts: WorkflowFacts,
374
489
  byDay: readonly (WorkflowFacts & { day: string })[],
375
490
  opts: { tier: SavingsTier; days: number; curve?: CurveSet },
491
+ /** The window's pricing when it is already known (a cap shared with other versions). */
492
+ pricedWindow?: PricedWorkflow,
376
493
  ): {
377
494
  day: string;
378
495
  savingUsd: number;
@@ -380,20 +497,29 @@ export function splitByDay(
380
497
  measuredUsd: number;
381
498
  estimatedLlmUsd: number;
382
499
  }[] {
383
- const priced = priceWorkflow(facts, { ...opts, band: "job" });
500
+ const priced = pricedWindow ?? priceWorkflow(facts, { ...opts, band: "job" });
501
+ const useRecorded = facts.recordedLlmUsd > 0;
502
+ // Enabled-only rule: each effect run is one decision at the window's unit cost.
503
+ if (priced.enabledOnlyRule) {
504
+ return byDay.map((d) => ({
505
+ day: d.day,
506
+ savingUsd: d.effectRuns * priced.agentOnlyUsdPerRun,
507
+ actualUsd: 0,
508
+ ...spendOf(d, useRecorded),
509
+ }));
510
+ }
384
511
  const runs = facts.runs;
385
512
  const share = runs > 0 ? priced.substitutedRuns / runs : 0;
386
513
  const nonSched = facts.countedRuns - facts.schedRuns;
387
514
  const vSched = priced.substitutedRuns - nonSched;
388
515
  // p50 agent-only cost of one substituted run (ERR_JOB.p50 is 1). The sum test pins this.
389
516
  const unitUsd = priced.agentOnlyUsdPerRun;
390
- const useRecorded = facts.recordedLlmUsd > 0;
391
517
  return byDay.map((d) => {
392
518
  const substituted =
393
519
  (facts.schedRuns > 0 ? (vSched * d.schedRuns) / facts.schedRuns : 0) +
394
520
  (d.countedRuns - d.schedRuns);
395
521
  const { measuredUsd, estimatedLlmUsd } = spendOf(d, useRecorded);
396
- const keptUsd = (d.agentUsd + d.followupUsd) * share;
522
+ const keptUsd = keptSpendOf(d) * share;
397
523
  const actualUsd = (measuredUsd + estimatedLlmUsd) * share;
398
524
  return {
399
525
  day: d.day,
@@ -404,3 +530,145 @@ export function splitByDay(
404
530
  };
405
531
  });
406
532
  }
533
+
534
+ /** Tier-independent facts about one script (by name) over a window. */
535
+ export type ScriptFacts = {
536
+ /** Every run that started in the window. */
537
+ runs: number;
538
+ /** Runs started through an API endpoint: enabled-only unless they had an effect. */
539
+ apiRuns: number;
540
+ /** Non-API runs whose output names an agent task created while they ran. */
541
+ effectRuns: number;
542
+ /** API runs with such an effect. */
543
+ apiEffectRuns: number;
544
+ /** Ops summed over every run (ops per run times runs). */
545
+ opsSum: number;
546
+ /** Wall time of the runs. */
547
+ computeSecs: number;
548
+ };
549
+
550
+ export type ScriptKind = "script-scheduled" | "script-agent-invoked";
551
+
552
+ /**
553
+ * Price one script's facts at a tier, as v7 `scriptJobs` does. A scheduled
554
+ * script (a schedule targets it) is a standalone agent task with a lead
555
+ * review; any other script is priced as the extra turns it would add to the
556
+ * calling agent's session (no bootstrap, no review). Non-API runs count at
557
+ * most 24 a day, unless they had a downstream effect. An API run counts only
558
+ * when it had an effect, then as a standalone decision with a review.
559
+ * Scripts record no LLM spend and keep no agent active, so their actual
560
+ * cost and agent-hours are 0.
561
+ */
562
+ export function priceScript(
563
+ facts: ScriptFacts,
564
+ opts: {
565
+ tier: SavingsTier;
566
+ days: number;
567
+ band: "job" | "fleet";
568
+ kind: ScriptKind;
569
+ curve?: CurveSet;
570
+ },
571
+ ): PricedWorkflow {
572
+ const runs = facts.runs;
573
+ const nonApi = runs - facts.apiRuns;
574
+ const vCap = Math.min(nonApi, CAP_PER_DAY * opts.days);
575
+ const v = Math.max(vCap, Math.min(nonApi, facts.effectRuns));
576
+ const apiV = facts.apiEffectRuns;
577
+ const opsPerRun = runs > 0 ? facts.opsSum / runs : 0;
578
+ const tau = Math.min(TAU_MAX, T0 + K * opsPerRun);
579
+ const fullUsd = curve(tau, opts.tier, "usd", opts.curve);
580
+ const fullHrs = curve(tau, opts.tier, "hrs", opts.curve);
581
+ const scheduled = opts.kind === "script-scheduled";
582
+ const unitUsd = scheduled
583
+ ? fullUsd
584
+ : Math.max(0, fullUsd - curve(T0, opts.tier, "usd", opts.curve));
585
+ const unitHrs = scheduled
586
+ ? fullHrs
587
+ : Math.max(0, fullHrs - curve(T0, opts.tier, "hrs", opts.curve));
588
+ const review = scheduled ? F_FOLLOWUP : 0;
589
+ const err = opts.band === "job" ? ERR_JOB : ERR_FLEET;
590
+ const agentOnlyUsd = bandOf(
591
+ (q) => v * (R[q] * unitUsd * err[q] + review) + apiV * (R[q] * fullUsd * err[q] + F_FOLLOWUP),
592
+ );
593
+ const agentOnlyHours = bandOf(
594
+ (q) => v * R[q] * unitHrs * err[q] + apiV * R[q] * fullHrs * err[q],
595
+ );
596
+ // A script run keeps no agent active: scheduled and API runs have no agent,
597
+ // and an agent-invoked run's wait is already inside the turns `unitHrs`
598
+ // removes. v7 subtracted the runs' wall time, which made short runs negative.
599
+ const actualHours = 0;
600
+ return {
601
+ enabledOnlyRule: false,
602
+ runs,
603
+ substitutedRuns: v + apiV,
604
+ effectRuns: v - vCap + apiV,
605
+ enabledOnlyRuns: runs - v - apiV,
606
+ capApplied: vCap < nonApi,
607
+ opsPerRun,
608
+ measuredUsd: 0,
609
+ estimatedLlmUsd: 0,
610
+ actualUsd: 0,
611
+ agentOnlyUsd,
612
+ savingUsd: agentOnlyUsd,
613
+ actualHours,
614
+ agentOnlyHours,
615
+ hoursSaved: bandOf((q) => agentOnlyHours[q] - actualHours),
616
+ agentOnlyUsdPerRun: R.p50 * unitUsd + review,
617
+ };
618
+ }
619
+
620
+ /**
621
+ * Split a script's window p50 saving across the UTC days its runs started
622
+ * on, so the days sum to `priceScript` over the window. Counted non-API runs
623
+ * are spread pro rata over the days' non-API runs; API effect runs count on
624
+ * their own day.
625
+ */
626
+ export function splitScriptByDay(
627
+ facts: ScriptFacts,
628
+ byDay: readonly (ScriptFacts & { day: string })[],
629
+ priced: PricedWorkflow,
630
+ ): {
631
+ day: string;
632
+ savingUsd: number;
633
+ actualUsd: number;
634
+ measuredUsd: number;
635
+ estimatedLlmUsd: number;
636
+ }[] {
637
+ const nonApi = facts.runs - facts.apiRuns;
638
+ const v = priced.substitutedRuns - facts.apiEffectRuns;
639
+ const apiUnit =
640
+ facts.apiEffectRuns > 0
641
+ ? (priced.agentOnlyUsd.p50 - v * priced.agentOnlyUsdPerRun) / facts.apiEffectRuns
642
+ : 0;
643
+ return byDay.map((d) => ({
644
+ day: d.day,
645
+ savingUsd:
646
+ (nonApi > 0 ? (v * (d.runs - d.apiRuns)) / nonApi : 0) * priced.agentOnlyUsdPerRun +
647
+ d.apiEffectRuns * apiUnit,
648
+ actualUsd: 0,
649
+ measuredUsd: 0,
650
+ estimatedLlmUsd: 0,
651
+ }));
652
+ }
653
+
654
+ const TIER_MODEL: Record<SavingsTier, string> = {
655
+ smol: "haiku-5-5",
656
+ regular: "sonnet-5-5",
657
+ smart: "opus-5-5",
658
+ ultra: "fable-5-1",
659
+ };
660
+
661
+ /** The model's assumptions in words, from the v7 estimator, with this port's constants. */
662
+ export function savingsAssumptions(tier: SavingsTier): string[] {
663
+ return [
664
+ `Tier ${tier} prices sessions at ${TIER_MODEL[tier]} on the fleet's measured session token profile (${CALIBRATION_MODEL}, calibrated ${CALIBRATED_AT}).`,
665
+ `Agent turns per deterministic op K=${K}, bootstrap T0=${T0} turns, session length capped at ${TAU_MAX} turns (fleet p95).`,
666
+ `Schedule-triggered runs count at most ${CAP_PER_DAY} a day per job (an agent would not poll faster than hourly) unless they caused a downstream effect; event and manual runs count 1:1; skipped and cancelled runs are excluded.`,
667
+ `Event routers (over ${ROUTER_MIN_RUNS_PER_DAY} event runs a day, under ${ROUTER_MAX_EFFECT_SHARE * 100}% with an effect) and API-invoked script runs are enabled-only: an effect run counts as one agent decision, never as the job it starts, which is priced on its own row.`,
668
+ "Effect links: a workflow run created an agent task (agent_tasks.workflowRunId) or started a child workflow run (workflow_runs.parentStepId); a script run wrote the id of an agent task created during the run into its output.",
669
+ `Failure and retry multiplier R=${R.p50} (p10 ${R.p10}, p90 ${R.p90}) from scheduled agent tasks; lead follow-up review $${F_FOLLOWUP} per standalone agent task.`,
670
+ "Scripts no schedule targets are priced as the extra turns they add to the calling agent's session (no bootstrap, no review).",
671
+ "Agent-task nodes inside workflows count at their actual cost on both sides; only the deterministic glue is substituted.",
672
+ "Scripts record no LLM spend, so their actual cost counts as $0; LLM calls made inside scripts are not counted.",
673
+ ];
674
+ }