observability-toolkit-hooks 0.0.0-stage → 1.0.1

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 (306) hide show
  1. package/CONFIG.md +144 -0
  2. package/LICENSE +95 -0
  3. package/README.md +201 -2
  4. package/dist/handlers/compact.js +38 -0
  5. package/dist/handlers/mcp-status.js +66 -0
  6. package/dist/handlers/notification.js +45 -0
  7. package/dist/handlers/post-tool-agent.js +157 -0
  8. package/dist/handlers/post-tool-changelog-sync.js +148 -0
  9. package/dist/handlers/post-tool-code-structure.js +116 -0
  10. package/dist/handlers/post-tool-edit-ledger.js +15 -0
  11. package/dist/handlers/post-tool-failure.js +83 -0
  12. package/dist/handlers/post-tool-git.js +79 -0
  13. package/dist/handlers/post-tool-mcp.js +105 -0
  14. package/dist/handlers/post-tool-outcome.js +48 -0
  15. package/dist/handlers/post-tool-task-state.js +74 -0
  16. package/dist/handlers/post-tool.js +132 -0
  17. package/dist/handlers/pre-tool-agent.js +192 -0
  18. package/dist/handlers/pre-tool.js +218 -0
  19. package/dist/handlers/session-end.js +39 -0
  20. package/dist/handlers/session-start.js +262 -0
  21. package/dist/handlers/stop-error-reminder.js +195 -0
  22. package/dist/handlers/stop-quality-evaluation.js +58 -0
  23. package/dist/handlers/stop-session-summary.js +62 -0
  24. package/dist/handlers/stop-token-metrics.js +83 -0
  25. package/dist/handlers/stop.js +25 -0
  26. package/dist/handlers/subagent.js +105 -0
  27. package/dist/handlers/tool-event-router.js +39 -0
  28. package/dist/handlers/user-prompt.js +218 -0
  29. package/dist/hook-runner.js +10 -0
  30. package/dist/hook-runner.js.map +7 -0
  31. package/dist/lib/agent/agent-context.js +123 -0
  32. package/dist/lib/agent/agent-evaluations.js +155 -0
  33. package/dist/lib/agent/agent-file-budget.js +65 -0
  34. package/dist/lib/agent/agent-sources.js +165 -0
  35. package/dist/lib/agent/synth-spans.js +51 -0
  36. package/dist/lib/core/bounded-label.js +6 -0
  37. package/dist/lib/core/category-rules.js +11 -0
  38. package/dist/lib/core/child-result.js +19 -0
  39. package/dist/lib/core/config-dir-recovery.js +22 -0
  40. package/dist/lib/core/constants.js +171 -0
  41. package/dist/lib/core/detached-runner.js +55 -0
  42. package/dist/lib/core/file-utils.js +353 -0
  43. package/dist/lib/core/format-utils.js +51 -0
  44. package/dist/lib/core/http-utils.js +74 -0
  45. package/dist/lib/core/http1-fetch.js +14 -0
  46. package/dist/lib/core/identity-key-resolver.js +149 -0
  47. package/dist/lib/core/jsonl-tail.js +207 -0
  48. package/dist/lib/core/load-envrc.js +72 -0
  49. package/dist/lib/core/parsers.js +43 -0
  50. package/dist/lib/core/regex.js +27 -0
  51. package/dist/lib/core/settings-env.js +31 -0
  52. package/dist/lib/core/shell-command.js +122 -0
  53. package/dist/lib/core/units.js +97 -0
  54. package/dist/lib/git/git-cache.js +158 -0
  55. package/dist/lib/git/git-commit.js +189 -0
  56. package/dist/lib/git/git-exec.js +30 -0
  57. package/dist/lib/mcp/mcp-completeness.js +40 -0
  58. package/dist/lib/mcp/mcp-config.js +118 -0
  59. package/dist/lib/mcp/mcp-failure-latch.js +22 -0
  60. package/dist/lib/mcp/mcp-identity-launcher.js +43 -0
  61. package/dist/lib/otel/attributes.js +322 -0
  62. package/dist/lib/otel/evaluation-attrs.js +51 -0
  63. package/dist/lib/otel/file-exporters.js +169 -0
  64. package/dist/lib/otel/host-resource.js +61 -0
  65. package/dist/lib/otel/otel-headers-helper.js +26 -0
  66. package/dist/lib/otel/otel-monitor.js +181 -0
  67. package/dist/lib/otel/otel.js +235 -0
  68. package/dist/lib/otel/otlp-headers.js +101 -0
  69. package/dist/lib/otel/otlp-post.js +122 -0
  70. package/dist/lib/otel/otlp-serialize.js +142 -0
  71. package/dist/lib/otel/otlp-signal.js +2 -0
  72. package/dist/lib/otel/remote-spans.js +142 -0
  73. package/dist/lib/otel/service-identity.js +10 -0
  74. package/dist/lib/otel/telemetry-alerts.js +43 -0
  75. package/dist/lib/otel/token-metrics.js +122 -0
  76. package/dist/lib/otel/trace-context.js +81 -0
  77. package/dist/lib/quality/judge-meta-eval.js +70 -0
  78. package/dist/lib/quality/judge-prompts.js +104 -0
  79. package/dist/lib/quality/judge-providers.js +193 -0
  80. package/dist/lib/quality/judge-transport.js +93 -0
  81. package/dist/lib/quality/llm-judge.js +170 -0
  82. package/dist/lib/quality/quality-budget.js +99 -0
  83. package/dist/lib/quality/quality-degradation.js +156 -0
  84. package/dist/lib/quality/quality-eval-handoff.js +74 -0
  85. package/dist/lib/quality/quality-evaluator.js +178 -0
  86. package/dist/lib/quality/quality-sampler.js +43 -0
  87. package/dist/lib/quality/quality-signals.js +150 -0
  88. package/dist/lib/runtime/categorizers.js +101 -0
  89. package/dist/lib/runtime/hook-input.js +16 -0
  90. package/dist/lib/runtime/hook-output.js +50 -0
  91. package/dist/lib/runtime/output-analyzer.js +160 -0
  92. package/dist/lib/runtime/run-handlers.js +32 -0
  93. package/dist/lib/runtime/tool-input.js +111 -0
  94. package/dist/lib/runtime/tool-output.js +44 -0
  95. package/dist/lib/runtime/unknown-tool.js +32 -0
  96. package/dist/lib/session/edit-ledger.js +29 -0
  97. package/dist/lib/session/forked-skill.js +39 -0
  98. package/dist/lib/session/handoffs.js +77 -0
  99. package/dist/lib/session/session-state.js +169 -0
  100. package/dist/lib/session/skill-rules.js +196 -0
  101. package/dist/lib/session/task-tracker.js +83 -0
  102. package/dist/lib/shipper/shipper-credentials.js +38 -0
  103. package/dist/lib/shipper/shipper-cursor.js +89 -0
  104. package/dist/lib/shipper/shipper-status.js +174 -0
  105. package/dist/lib/shipper/span-shipper.js +272 -0
  106. package/dist/lib/shipper/telemetry-shipper.js +39 -0
  107. package/dist/lib/transcript/agent-transcript-metrics.js +34 -0
  108. package/dist/lib/transcript/context-breakdown.js +134 -0
  109. package/dist/lib/transcript/context-history.js +69 -0
  110. package/dist/lib/transcript/context-tracker.js +226 -0
  111. package/dist/lib/transcript/message-count.js +49 -0
  112. package/dist/lib/transcript/model-ids.js +36 -0
  113. package/dist/lib/transcript/model-pricing.js +153 -0
  114. package/dist/lib/transcript/token-metrics-checkpoint.js +152 -0
  115. package/dist/lib/transcript/tool-call-durations.js +64 -0
  116. package/dist/lib/transcript/transcript-entry.js +67 -0
  117. package/dist/lib/transcript/transcript-fold.js +130 -0
  118. package/dist/lib/transcript/transcript-layout.js +39 -0
  119. package/dist/lib/transcript/transcript-parser.js +117 -0
  120. package/dist/runner/agent-context-4XTCLMLZ.js +23 -0
  121. package/dist/runner/agent-context-4XTCLMLZ.js.map +7 -0
  122. package/dist/runner/agent-file-budget-Q33ESBBE.js +68 -0
  123. package/dist/runner/agent-file-budget-Q33ESBBE.js.map +7 -0
  124. package/dist/runner/agent-transcript-metrics-W5CZZFMI.js +39 -0
  125. package/dist/runner/agent-transcript-metrics-W5CZZFMI.js.map +7 -0
  126. package/dist/runner/chunk-2NTNAJZE.js +49 -0
  127. package/dist/runner/chunk-2NTNAJZE.js.map +7 -0
  128. package/dist/runner/chunk-4KWBQTTG.js +78 -0
  129. package/dist/runner/chunk-4KWBQTTG.js.map +7 -0
  130. package/dist/runner/chunk-52RY6LQT.js +699 -0
  131. package/dist/runner/chunk-52RY6LQT.js.map +7 -0
  132. package/dist/runner/chunk-7OM5CYES.js +8695 -0
  133. package/dist/runner/chunk-7OM5CYES.js.map +7 -0
  134. package/dist/runner/chunk-7PEOKGYR.js +1568 -0
  135. package/dist/runner/chunk-7PEOKGYR.js.map +7 -0
  136. package/dist/runner/chunk-AGSGKELQ.js +126 -0
  137. package/dist/runner/chunk-AGSGKELQ.js.map +7 -0
  138. package/dist/runner/chunk-AVM7PJFW.js +12 -0
  139. package/dist/runner/chunk-AVM7PJFW.js.map +7 -0
  140. package/dist/runner/chunk-C3WHUMU5.js +178 -0
  141. package/dist/runner/chunk-C3WHUMU5.js.map +7 -0
  142. package/dist/runner/chunk-DGB4NSSD.js +157 -0
  143. package/dist/runner/chunk-DGB4NSSD.js.map +7 -0
  144. package/dist/runner/chunk-DNSTWC26.js +151 -0
  145. package/dist/runner/chunk-DNSTWC26.js.map +7 -0
  146. package/dist/runner/chunk-FDJJ3TYU.js +449 -0
  147. package/dist/runner/chunk-FDJJ3TYU.js.map +7 -0
  148. package/dist/runner/chunk-FGKYDQHZ.js +137 -0
  149. package/dist/runner/chunk-FGKYDQHZ.js.map +7 -0
  150. package/dist/runner/chunk-GG2I4TGI.js +582 -0
  151. package/dist/runner/chunk-GG2I4TGI.js.map +7 -0
  152. package/dist/runner/chunk-GNNKUMRF.js +60 -0
  153. package/dist/runner/chunk-GNNKUMRF.js.map +7 -0
  154. package/dist/runner/chunk-I7TD2QVR.js +118 -0
  155. package/dist/runner/chunk-I7TD2QVR.js.map +7 -0
  156. package/dist/runner/chunk-IJ4SLUBV.js +78 -0
  157. package/dist/runner/chunk-IJ4SLUBV.js.map +7 -0
  158. package/dist/runner/chunk-IY7AP7NA.js +32 -0
  159. package/dist/runner/chunk-IY7AP7NA.js.map +7 -0
  160. package/dist/runner/chunk-J3F3Z3EQ.js +177 -0
  161. package/dist/runner/chunk-J3F3Z3EQ.js.map +7 -0
  162. package/dist/runner/chunk-JLEO5OHU.js +104 -0
  163. package/dist/runner/chunk-JLEO5OHU.js.map +7 -0
  164. package/dist/runner/chunk-JRNNLOPR.js +168 -0
  165. package/dist/runner/chunk-JRNNLOPR.js.map +7 -0
  166. package/dist/runner/chunk-KGSA5JYP.js +82 -0
  167. package/dist/runner/chunk-KGSA5JYP.js.map +7 -0
  168. package/dist/runner/chunk-LBCZAYFR.js +125 -0
  169. package/dist/runner/chunk-LBCZAYFR.js.map +7 -0
  170. package/dist/runner/chunk-LHWRXY2G.js +41 -0
  171. package/dist/runner/chunk-LHWRXY2G.js.map +7 -0
  172. package/dist/runner/chunk-LQ2LGUYJ.js +41 -0
  173. package/dist/runner/chunk-LQ2LGUYJ.js.map +7 -0
  174. package/dist/runner/chunk-LYY6RCIE.js +158 -0
  175. package/dist/runner/chunk-LYY6RCIE.js.map +7 -0
  176. package/dist/runner/chunk-M4R4QIQH.js +41 -0
  177. package/dist/runner/chunk-M4R4QIQH.js.map +7 -0
  178. package/dist/runner/chunk-MC75VXMX.js +207 -0
  179. package/dist/runner/chunk-MC75VXMX.js.map +7 -0
  180. package/dist/runner/chunk-NKZU4RRG.js +104 -0
  181. package/dist/runner/chunk-NKZU4RRG.js.map +7 -0
  182. package/dist/runner/chunk-PJHWHJ3K.js +56 -0
  183. package/dist/runner/chunk-PJHWHJ3K.js.map +7 -0
  184. package/dist/runner/chunk-RIGVYJ2O.js +114 -0
  185. package/dist/runner/chunk-RIGVYJ2O.js.map +7 -0
  186. package/dist/runner/chunk-RWRGC7ZK.js +93 -0
  187. package/dist/runner/chunk-RWRGC7ZK.js.map +7 -0
  188. package/dist/runner/chunk-SRMAJQMV.js +54 -0
  189. package/dist/runner/chunk-SRMAJQMV.js.map +7 -0
  190. package/dist/runner/chunk-TRMFD36J.js +47 -0
  191. package/dist/runner/chunk-TRMFD36J.js.map +7 -0
  192. package/dist/runner/chunk-U4IOZYQ3.js +21 -0
  193. package/dist/runner/chunk-U4IOZYQ3.js.map +7 -0
  194. package/dist/runner/chunk-UEXDE3WP.js +83 -0
  195. package/dist/runner/chunk-UEXDE3WP.js.map +7 -0
  196. package/dist/runner/chunk-UW3GQZSM.js +50 -0
  197. package/dist/runner/chunk-UW3GQZSM.js.map +7 -0
  198. package/dist/runner/chunk-V2GSP6VR.js +46 -0
  199. package/dist/runner/chunk-V2GSP6VR.js.map +7 -0
  200. package/dist/runner/chunk-VOV4Y5VU.js +81 -0
  201. package/dist/runner/chunk-VOV4Y5VU.js.map +7 -0
  202. package/dist/runner/chunk-VT5T6OEI.js +65 -0
  203. package/dist/runner/chunk-VT5T6OEI.js.map +7 -0
  204. package/dist/runner/chunk-VUYVFWIN.js +12 -0
  205. package/dist/runner/chunk-VUYVFWIN.js.map +7 -0
  206. package/dist/runner/chunk-VVGOPPEN.js +36 -0
  207. package/dist/runner/chunk-VVGOPPEN.js.map +7 -0
  208. package/dist/runner/chunk-VXFSLM6P.js +14 -0
  209. package/dist/runner/chunk-VXFSLM6P.js.map +7 -0
  210. package/dist/runner/chunk-W3EK7JUT.js +26125 -0
  211. package/dist/runner/chunk-W3EK7JUT.js.map +7 -0
  212. package/dist/runner/chunk-WJHNCOUF.js +52 -0
  213. package/dist/runner/chunk-WJHNCOUF.js.map +7 -0
  214. package/dist/runner/chunk-WU7ANGCW.js +269 -0
  215. package/dist/runner/chunk-WU7ANGCW.js.map +7 -0
  216. package/dist/runner/chunk-X7XLMSZX.js +44 -0
  217. package/dist/runner/chunk-X7XLMSZX.js.map +7 -0
  218. package/dist/runner/chunk-XSO3B4QN.js +124 -0
  219. package/dist/runner/chunk-XSO3B4QN.js.map +7 -0
  220. package/dist/runner/chunk-YGFN3LN2.js +174 -0
  221. package/dist/runner/chunk-YGFN3LN2.js.map +7 -0
  222. package/dist/runner/chunk-YHYDBLVB.js +33 -0
  223. package/dist/runner/chunk-YHYDBLVB.js.map +7 -0
  224. package/dist/runner/compact-36NP3PKT.js +60 -0
  225. package/dist/runner/compact-36NP3PKT.js.map +7 -0
  226. package/dist/runner/getMachineId-bsd-AGENNHN6.js +42 -0
  227. package/dist/runner/getMachineId-bsd-AGENNHN6.js.map +7 -0
  228. package/dist/runner/getMachineId-bsd-I5WZGCL4.js +33 -0
  229. package/dist/runner/getMachineId-bsd-I5WZGCL4.js.map +7 -0
  230. package/dist/runner/getMachineId-bsd-ZXK225P7.js +33 -0
  231. package/dist/runner/getMachineId-bsd-ZXK225P7.js.map +7 -0
  232. package/dist/runner/getMachineId-darwin-47GDLEXL.js +42 -0
  233. package/dist/runner/getMachineId-darwin-47GDLEXL.js.map +7 -0
  234. package/dist/runner/getMachineId-darwin-5CRLMDD6.js +33 -0
  235. package/dist/runner/getMachineId-darwin-5CRLMDD6.js.map +7 -0
  236. package/dist/runner/getMachineId-darwin-ADG4I32N.js +33 -0
  237. package/dist/runner/getMachineId-darwin-ADG4I32N.js.map +7 -0
  238. package/dist/runner/getMachineId-linux-5KVS3T2M.js +27 -0
  239. package/dist/runner/getMachineId-linux-5KVS3T2M.js.map +7 -0
  240. package/dist/runner/getMachineId-linux-GDFB5GSO.js +34 -0
  241. package/dist/runner/getMachineId-linux-GDFB5GSO.js.map +7 -0
  242. package/dist/runner/getMachineId-linux-NQMWCRO3.js +27 -0
  243. package/dist/runner/getMachineId-linux-NQMWCRO3.js.map +7 -0
  244. package/dist/runner/getMachineId-unsupported-5PFIGMVX.js +18 -0
  245. package/dist/runner/getMachineId-unsupported-5PFIGMVX.js.map +7 -0
  246. package/dist/runner/getMachineId-unsupported-DW27K3ZX.js +18 -0
  247. package/dist/runner/getMachineId-unsupported-DW27K3ZX.js.map +7 -0
  248. package/dist/runner/getMachineId-unsupported-XV3FHTHD.js +25 -0
  249. package/dist/runner/getMachineId-unsupported-XV3FHTHD.js.map +7 -0
  250. package/dist/runner/getMachineId-win-5JVMW3EI.js +44 -0
  251. package/dist/runner/getMachineId-win-5JVMW3EI.js.map +7 -0
  252. package/dist/runner/getMachineId-win-SNESQF7R.js +35 -0
  253. package/dist/runner/getMachineId-win-SNESQF7R.js.map +7 -0
  254. package/dist/runner/getMachineId-win-UJYHSBM2.js +35 -0
  255. package/dist/runner/getMachineId-win-UJYHSBM2.js.map +7 -0
  256. package/dist/runner/git-commit-BA53DOJQ.js +30 -0
  257. package/dist/runner/git-commit-BA53DOJQ.js.map +7 -0
  258. package/dist/runner/hook-runner-JHH6PGKE.js +220 -0
  259. package/dist/runner/hook-runner-JHH6PGKE.js.map +7 -0
  260. package/dist/runner/judge-transport-R4TF5LEH.js +91 -0
  261. package/dist/runner/judge-transport-R4TF5LEH.js.map +7 -0
  262. package/dist/runner/mcp-status-QEUH2KGX.js +89 -0
  263. package/dist/runner/mcp-status-QEUH2KGX.js.map +7 -0
  264. package/dist/runner/notification-FKMBCSXF.js +69 -0
  265. package/dist/runner/notification-FKMBCSXF.js.map +7 -0
  266. package/dist/runner/post-tool-3MRHTBKH.js +192 -0
  267. package/dist/runner/post-tool-3MRHTBKH.js.map +7 -0
  268. package/dist/runner/post-tool-agent-BB34MNHI.js +370 -0
  269. package/dist/runner/post-tool-agent-BB34MNHI.js.map +7 -0
  270. package/dist/runner/post-tool-changelog-sync-OP2TT2I7.js +147 -0
  271. package/dist/runner/post-tool-changelog-sync-OP2TT2I7.js.map +7 -0
  272. package/dist/runner/post-tool-code-structure-LE7J2SC2.js +130 -0
  273. package/dist/runner/post-tool-code-structure-LE7J2SC2.js.map +7 -0
  274. package/dist/runner/post-tool-edit-ledger-IJMEYHKF.js +30 -0
  275. package/dist/runner/post-tool-edit-ledger-IJMEYHKF.js.map +7 -0
  276. package/dist/runner/post-tool-failure-XTH2I2Z7.js +111 -0
  277. package/dist/runner/post-tool-failure-XTH2I2Z7.js.map +7 -0
  278. package/dist/runner/post-tool-git-E46HZGZO.js +94 -0
  279. package/dist/runner/post-tool-git-E46HZGZO.js.map +7 -0
  280. package/dist/runner/post-tool-mcp-AMCDY5GH.js +144 -0
  281. package/dist/runner/post-tool-mcp-AMCDY5GH.js.map +7 -0
  282. package/dist/runner/post-tool-task-state-TLDOI33H.js +100 -0
  283. package/dist/runner/post-tool-task-state-TLDOI33H.js.map +7 -0
  284. package/dist/runner/pre-tool-SQE2FZQO.js +245 -0
  285. package/dist/runner/pre-tool-SQE2FZQO.js.map +7 -0
  286. package/dist/runner/pre-tool-agent-OZUPVFUI.js +218 -0
  287. package/dist/runner/pre-tool-agent-OZUPVFUI.js.map +7 -0
  288. package/dist/runner/quality-evaluator-XYNDKDRG.js +901 -0
  289. package/dist/runner/quality-evaluator-XYNDKDRG.js.map +7 -0
  290. package/dist/runner/session-end-3MJTDLLA.js +57 -0
  291. package/dist/runner/session-end-3MJTDLLA.js.map +7 -0
  292. package/dist/runner/session-start-5ZMCLKBS.js +352 -0
  293. package/dist/runner/session-start-5ZMCLKBS.js.map +7 -0
  294. package/dist/runner/shipper-status-MADX6SPG.js +37 -0
  295. package/dist/runner/shipper-status-MADX6SPG.js.map +7 -0
  296. package/dist/runner/span-shipper-4HQDHC47.js +3408 -0
  297. package/dist/runner/span-shipper-4HQDHC47.js.map +7 -0
  298. package/dist/runner/stop-RTKSIYJV.js +596 -0
  299. package/dist/runner/stop-RTKSIYJV.js.map +7 -0
  300. package/dist/runner/subagent-CBCG4OLZ.js +116 -0
  301. package/dist/runner/subagent-CBCG4OLZ.js.map +7 -0
  302. package/dist/runner/token-metrics-AD2RAFGM.js +31 -0
  303. package/dist/runner/token-metrics-AD2RAFGM.js.map +7 -0
  304. package/dist/runner/user-prompt-T5NZ2UJD.js +376 -0
  305. package/dist/runner/user-prompt-T5NZ2UJD.js.map +7 -0
  306. package/package.json +70 -5
@@ -0,0 +1,69 @@
1
+ /**
2
+ * `telemetry/context-history.json`: one record per measured session start plus daily averages.
3
+ * The file is the contract with the observability-toolkit MCP server (`src/tools/context-stats.ts`).
4
+ */
5
+ import * as path from 'node:path';
6
+ import { CLAUDE_HOME } from '../core/constants.js';
7
+ import { isJsonObject, loadJsonObject, withFileLock, writeJsonAtomic } from '../core/file-utils.js';
8
+ import { utcDateStamp } from '../core/format-utils.js';
9
+ const CONTEXT_HISTORY_PATH = path.join(CLAUDE_HOME, 'telemetry', 'context-history.json');
10
+ const CONTEXT_HISTORY_LOCK_PATH = `${CONTEXT_HISTORY_PATH}.lock`;
11
+ const HISTORY_VERSION = 1;
12
+ const MAX_HISTORY_SESSIONS = 1000;
13
+ const MAX_HISTORY_DAYS = 90;
14
+ function isObjectArray(value) {
15
+ return Array.isArray(value) && value.every(isJsonObject);
16
+ }
17
+ /** Missing, unparseable or misshapen file: empty history. */
18
+ function loadHistory() {
19
+ const stored = loadJsonObject(CONTEXT_HISTORY_PATH);
20
+ if (stored && isObjectArray(stored.sessions) && isObjectArray(stored.dailyAverages)) {
21
+ return stored;
22
+ }
23
+ return {
24
+ version: HISTORY_VERSION,
25
+ sessions: [],
26
+ dailyAverages: [],
27
+ };
28
+ }
29
+ /** Atomic, so a concurrent reader never reads a partial file as no history. */
30
+ function saveHistory(history) {
31
+ writeJsonAtomic(CONTEXT_HISTORY_PATH, {
32
+ ...history,
33
+ sessions: history.sessions.slice(-MAX_HISTORY_SESSIONS),
34
+ dailyAverages: history.dailyAverages.slice(-MAX_HISTORY_DAYS),
35
+ });
36
+ }
37
+ function runningAverage(mean, count, sample) {
38
+ return (mean * count + sample) / (count + 1);
39
+ }
40
+ function updateDailyAverages(history, sessionData) {
41
+ const today = utcDateStamp(new Date(sessionData.timestamp));
42
+ let todayAvg = history.dailyAverages.find((d) => d.date === today);
43
+ if (!todayAvg) {
44
+ todayAvg = {
45
+ date: today,
46
+ avgTokens: 0,
47
+ avgUtilization: 0,
48
+ sessionCount: 0,
49
+ maxTokens: 0,
50
+ minTokens: Infinity,
51
+ };
52
+ history.dailyAverages.push(todayAvg);
53
+ }
54
+ const { estimatedTokens, utilizationPercent } = sessionData;
55
+ todayAvg.avgTokens = runningAverage(todayAvg.avgTokens, todayAvg.sessionCount, estimatedTokens);
56
+ todayAvg.avgUtilization = runningAverage(todayAvg.avgUtilization, todayAvg.sessionCount, utilizationPercent);
57
+ todayAvg.sessionCount++;
58
+ todayAvg.maxTokens = Math.max(todayAvg.maxTokens, estimatedTokens);
59
+ todayAvg.minTokens = Math.min(todayAvg.minTokens, estimatedTokens);
60
+ }
61
+ /** Locked, so concurrent starts never drop each other's entry. */
62
+ export function appendToHistory(data) {
63
+ withFileLock(CONTEXT_HISTORY_LOCK_PATH, () => {
64
+ const history = loadHistory();
65
+ history.sessions.push(data);
66
+ updateDailyAverages(history, data);
67
+ saveHistory(history);
68
+ });
69
+ }
@@ -0,0 +1,226 @@
1
+ /**
2
+ * Context window utilization. `trackSessionContext` scans the transcript at session start;
3
+ * `getSessionUsage` reads the latest API usage record per prompt. History and context metrics
4
+ * skip unmeasured starts (a fresh transcript is still empty when the hook runs, and its zero
5
+ * would drag every average down); only the starts counter counts them.
6
+ */
7
+ import * as fs from 'node:fs';
8
+ import { TRANSCRIPT_SCAN_BYTES } from '../core/constants.js';
9
+ import { linesNewestFirst, parseJsonLine, readFileSlice, readLinesBackward } from '../core/jsonl-tail.js';
10
+ import { PERCENT_PER_UNIT, roundTo, TENTHS_PER_UNIT, UNITS } from '../core/units.js';
11
+ import { CONTEXT_ATTRIBUTES, SESSION_ATTRIBUTES, SESSION_METRICS } from '../otel/attributes.js';
12
+ import { initTelemetry, recordCounter, recordMetric } from '../otel/otel.js';
13
+ import { categorizeTranscript, classifyRecords, CONTEXT_TYPES, headClassifications, sumBreakdown, usageBreakdownFrom, } from './context-breakdown.js';
14
+ import { appendToHistory } from './context-history.js';
15
+ import { countSessionMessages } from './message-count.js';
16
+ import { contextWindowForModel } from './model-pricing.js';
17
+ import { promptTokens, responseUsage, usageCounts } from './transcript-entry.js';
18
+ import { findTranscriptPath } from './transcript-layout.js';
19
+ const TRANSCRIPT_MODEL_FIELD_PATTERN = /"model"\s*:\s*"([^"]*)"/;
20
+ function utilizationPercent(tokens, contextWindow) {
21
+ return (tokens / contextWindow) * PERCENT_PER_UNIT;
22
+ }
23
+ /** Utilization as a fraction of the window; above 1 when usage outgrows the largest known window. */
24
+ function utilizationRatio(tokens, contextWindow) {
25
+ return tokens / contextWindow;
26
+ }
27
+ function freeSpaceIn(contextWindow, tokens) {
28
+ return Math.max(0, contextWindow - tokens);
29
+ }
30
+ /** First model field in the head; none yet means the default window. Exported for tests. */
31
+ export function contextWindowFromTranscript(content) {
32
+ const match = content.match(TRANSCRIPT_MODEL_FIELD_PATTERN);
33
+ return contextWindowForModel(match?.[1]);
34
+ }
35
+ // One wording per instrument: the two recorders are separate processes, and differing descriptions would conflict.
36
+ const CONTEXT_METRIC_DESCRIPTIONS = {
37
+ size: 'Context size in tokens',
38
+ utilization: 'Context window utilization, as a fraction of the window',
39
+ freeSpace: 'Free context space in tokens',
40
+ byType: 'Context size by content type in tokens',
41
+ };
42
+ /** Utilization is a fraction with unit `1`, not a percentage: https://opentelemetry.io/docs/specs/semconv/general/metrics/#instrument-units */
43
+ function recordContextMetrics(attrs, sizeTokens, contextWindow, breakdown) {
44
+ recordMetric(SESSION_METRICS.CONTEXT_SIZE, sizeTokens, attrs, {
45
+ description: CONTEXT_METRIC_DESCRIPTIONS.size,
46
+ unit: UNITS.TOKEN,
47
+ });
48
+ recordMetric(SESSION_METRICS.CONTEXT_UTILIZATION, utilizationRatio(sizeTokens, contextWindow), attrs, {
49
+ description: CONTEXT_METRIC_DESCRIPTIONS.utilization,
50
+ unit: UNITS.RATIO,
51
+ });
52
+ recordMetric(SESSION_METRICS.FREE_SPACE, freeSpaceIn(contextWindow, sizeTokens), attrs, {
53
+ description: CONTEXT_METRIC_DESCRIPTIONS.freeSpace,
54
+ unit: UNITS.TOKEN,
55
+ });
56
+ if (breakdown) {
57
+ for (const contextType of CONTEXT_TYPES) {
58
+ recordMetric(SESSION_METRICS.CONTEXT_BY_TYPE, breakdown[contextType], {
59
+ ...attrs,
60
+ [CONTEXT_ATTRIBUTES.TYPE]: contextType,
61
+ }, { description: CONTEXT_METRIC_DESCRIPTIONS.byType, unit: UNITS.TOKEN });
62
+ }
63
+ }
64
+ }
65
+ function readTranscriptHead(transcriptPath, transcriptSize) {
66
+ return readFileSlice(transcriptPath, Math.min(transcriptSize, TRANSCRIPT_SCAN_BYTES), 0);
67
+ }
68
+ const EMPTY_SCAN = {
69
+ estimatedTokens: 0,
70
+ transcriptSize: 0,
71
+ messageCount: 0,
72
+ contextWindow: contextWindowForModel(undefined),
73
+ };
74
+ /** Head read bounded to TRANSCRIPT_SCAN_BYTES, totals scaled to file size; EMPTY_SCAN when unreadable. */
75
+ function scanTranscript(sessionId, transcriptPath) {
76
+ try {
77
+ const transcriptSize = fs.statSync(transcriptPath).size;
78
+ const messageCount = countSessionMessages(sessionId, transcriptPath);
79
+ // A usage record beats the byte estimate.
80
+ const { measured, head } = measureFromLatestUsage(sessionId, transcriptPath, transcriptSize);
81
+ if (measured) {
82
+ const { latestUsage, breakdown } = measured;
83
+ return {
84
+ estimatedTokens: latestUsage.totalContextTokens,
85
+ transcriptSize,
86
+ messageCount,
87
+ contextWindow: latestUsage.contextWindow,
88
+ breakdown,
89
+ };
90
+ }
91
+ const content = head ?? readTranscriptHead(transcriptPath, transcriptSize);
92
+ const breakdown = categorizeTranscript(content, transcriptSize);
93
+ return {
94
+ estimatedTokens: sumBreakdown(breakdown),
95
+ transcriptSize,
96
+ messageCount,
97
+ // Never promoted from the estimate: a large file proves no larger window.
98
+ contextWindow: contextWindowFromTranscript(content),
99
+ breakdown,
100
+ };
101
+ }
102
+ catch {
103
+ return EMPTY_SCAN;
104
+ }
105
+ }
106
+ function buildSessionData(params, scan) {
107
+ const { sessionId, isResume = false } = params;
108
+ const { estimatedTokens, transcriptSize, messageCount, contextWindow, breakdown } = scan;
109
+ return {
110
+ sessionId,
111
+ timestamp: new Date().toISOString(),
112
+ estimatedTokens,
113
+ utilizationPercent: roundTo(utilizationPercent(estimatedTokens, contextWindow), TENTHS_PER_UNIT),
114
+ freeSpace: freeSpaceIn(contextWindow, estimatedTokens),
115
+ transcriptSize,
116
+ messageCount,
117
+ isResume,
118
+ breakdown,
119
+ };
120
+ }
121
+ function recordSessionStart(data, contextWindow, attributes) {
122
+ initTelemetry();
123
+ const metricAttrs = {
124
+ [SESSION_ATTRIBUTES.SESSION_ID]: data.sessionId,
125
+ [CONTEXT_ATTRIBUTES.IS_RESUME]: data.isResume,
126
+ ...attributes,
127
+ };
128
+ recordCounter(SESSION_METRICS.STARTS, 1, metricAttrs, {
129
+ description: 'Number of session starts tracked',
130
+ unit: UNITS.SESSION,
131
+ });
132
+ if (!(data.estimatedTokens > 0))
133
+ return;
134
+ recordContextMetrics(metricAttrs, data.estimatedTokens, contextWindow, data.breakdown);
135
+ appendToHistory(data);
136
+ }
137
+ /** The one place a session start is recorded. */
138
+ export function trackSessionContext(params) {
139
+ const scan = params.transcriptPath ? scanTranscript(params.sessionId, params.transcriptPath) : EMPTY_SCAN;
140
+ const data = buildSessionData(params, scan);
141
+ recordSessionStart(data, scan.contextWindow, params.attributes ?? {});
142
+ return data;
143
+ }
144
+ /** Banner fast path: no I/O and no recording, which would count every start twice. */
145
+ export function trackSessionContextFast(params) {
146
+ return buildSessionData(params, EMPTY_SCAN);
147
+ }
148
+ function usageFromLine(line) {
149
+ if (!line.includes('"usage"'))
150
+ return null;
151
+ const entry = parseJsonLine(line);
152
+ if (!entry)
153
+ return null;
154
+ const usage = responseUsage(entry);
155
+ if (!usage)
156
+ return null;
157
+ const { inputTokens, cacheReadTokens, cacheCreationTokens } = usageCounts(usage);
158
+ const totalContextTokens = promptTokens(usage);
159
+ const contextWindow = contextWindowForModel(entry.message?.model, totalContextTokens);
160
+ return {
161
+ inputTokens,
162
+ cacheReadTokens,
163
+ cacheCreationTokens,
164
+ totalContextTokens,
165
+ utilizationPercent: utilizationPercent(totalContextTokens, contextWindow),
166
+ freeSpace: freeSpaceIn(contextWindow, totalContextTokens),
167
+ contextWindow,
168
+ };
169
+ }
170
+ /**
171
+ * A head holding the whole file is searched in place; a longer file is read newest-first from its tail.
172
+ * Null on a read failure too, so the caller keeps its head results.
173
+ */
174
+ function findLatestUsage(filePath, size, head) {
175
+ try {
176
+ const lines = size <= TRANSCRIPT_SCAN_BYTES
177
+ ? linesNewestFirst(head)
178
+ : readLinesBackward(filePath, size, TRANSCRIPT_SCAN_BYTES);
179
+ for (const line of lines) {
180
+ const result = usageFromLine(line);
181
+ if (result)
182
+ return result;
183
+ }
184
+ return null;
185
+ }
186
+ catch {
187
+ return null;
188
+ }
189
+ }
190
+ /** A full head's classification is cached for the next call. */
191
+ function measureFromLatestUsage(sessionId, transcriptPath, transcriptSize) {
192
+ const headFull = transcriptSize >= TRANSCRIPT_SCAN_BYTES;
193
+ const cached = headFull ? headClassifications.load(sessionId, transcriptPath) : null;
194
+ // Read the head only when something consumes it: the in-window usage lookup or an uncached classification.
195
+ const head = cached && transcriptSize > TRANSCRIPT_SCAN_BYTES ? null : readTranscriptHead(transcriptPath, transcriptSize);
196
+ const latestUsage = findLatestUsage(transcriptPath, transcriptSize, head ?? '');
197
+ if (!latestUsage)
198
+ return { measured: null, head };
199
+ const classified = cached ?? classifyRecords(head ?? '', true);
200
+ if (!cached && headFull)
201
+ headClassifications.save(sessionId, transcriptPath, classified);
202
+ return { measured: { latestUsage, breakdown: usageBreakdownFrom(classified, latestUsage.totalContextTokens) }, head };
203
+ }
204
+ /** `transcriptPath` is ground truth when the payload carries it. */
205
+ export function getSessionUsage(sessionId, transcriptPath) {
206
+ const sessionFile = transcriptPath ?? findTranscriptPath(sessionId);
207
+ if (!sessionFile)
208
+ return null;
209
+ try {
210
+ // statSync is the existence check: ENOENT lands in the catch.
211
+ const { measured } = measureFromLatestUsage(sessionId, sessionFile, fs.statSync(sessionFile).size);
212
+ if (!measured)
213
+ return null;
214
+ const { contextWindow, ...latestUsage } = measured.latestUsage;
215
+ const usage = {
216
+ ...latestUsage,
217
+ breakdown: measured.breakdown,
218
+ messageCount: countSessionMessages(sessionId, sessionFile),
219
+ };
220
+ recordContextMetrics({ [SESSION_ATTRIBUTES.SESSION_ID]: sessionId }, usage.totalContextTokens, contextWindow, usage.breakdown);
221
+ return usage;
222
+ }
223
+ catch {
224
+ return null;
225
+ }
226
+ }
@@ -0,0 +1,49 @@
1
+ /**
2
+ * Exact per-session turn count, kept incrementally by byte offset: a tail-only count
3
+ * understates long transcripts. Matches raw bytes rather than using jsonl-tail's
4
+ * decoding reader, which is about 4x slower; the ASCII markers match exactly pre-decode.
5
+ */
6
+ import { statSync } from 'node:fs';
7
+ import { SYNTHETIC_MODEL, THRESHOLDS } from '../core/constants.js';
8
+ import { byteMarkers, consumeLines, hasAnyMarker, readLinesFrom } from '../core/jsonl-tail.js';
9
+ import { isNonNegativeInteger, TIME_MS } from '../core/units.js';
10
+ import { resumeOffset, transcriptCheckpointStore } from '../session/session-state.js';
11
+ import { CONVERSATION_RECORD_TYPES, fieldMarkers } from './transcript-entry.js';
12
+ const CHECKPOINT_FILE = 'message-count.json';
13
+ const CHECKPOINT_VERSION = 1;
14
+ const CHECKPOINT_TTL_MS = TIME_MS.DAY;
15
+ /** `classifyEntry`'s `prompt` and `response` record types, as raw bytes. Matched without JSON.parse, so nested content can count a line once. */
16
+ const TURN_MARKERS = byteMarkers([...CONVERSATION_RECORD_TYPES].flatMap((type) => fieldMarkers('type', type)));
17
+ /** Claude Code's own notices are not turns (`classifyEntry`'s `notice`). Nested content is JSON-escaped, so these only match a real `model` field. */
18
+ const SYNTHETIC_MARKERS = byteMarkers(fieldMarkers('model', SYNTHETIC_MODEL));
19
+ function isTurnBuffer(bytes) {
20
+ return hasAnyMarker(bytes, TURN_MARKERS) && !hasAnyMarker(bytes, SYNTHETIC_MARKERS);
21
+ }
22
+ const checkpoints = transcriptCheckpointStore({
23
+ file: CHECKPOINT_FILE,
24
+ version: CHECKPOINT_VERSION,
25
+ isValidBody: (v) => isNonNegativeInteger(v.offset) && isNonNegativeInteger(v.count),
26
+ ttlMs: CHECKPOINT_TTL_MS,
27
+ });
28
+ /** The whole-transcript count, or what the checkpoint knew when unreadable. */
29
+ export function countSessionMessages(sessionId, transcriptPath) {
30
+ const cp = checkpoints.load(sessionId, transcriptPath);
31
+ const fallback = cp?.count ?? 0;
32
+ let fileSize;
33
+ try {
34
+ fileSize = statSync(transcriptPath).size;
35
+ }
36
+ catch {
37
+ return fallback;
38
+ }
39
+ const start = resumeOffset(cp, fileSize);
40
+ let count = start > 0 ? fallback : 0;
41
+ // Complete lines of [start, EOF) in bounded chunks; a trailing fragment waits for the next call.
42
+ const lines = readLinesFrom(transcriptPath, start, THRESHOLDS.MESSAGE_COUNT_MAX_READ_BYTES);
43
+ const offset = consumeLines(lines, start, (bytes) => {
44
+ if (isTurnBuffer(bytes))
45
+ count++;
46
+ });
47
+ checkpoints.save(sessionId, transcriptPath, { offset, count });
48
+ return count;
49
+ }
@@ -0,0 +1,36 @@
1
+ /** Model id matching shared by the family-keyed tables (the rate card and the context windows) and the provider lookup. */
2
+ import { GENAI_PROVIDER_NAMES } from '../otel/attributes.js';
3
+ const MODEL_ID_DATE_SUFFIX = /-\d{8}$/;
4
+ const MODEL_ID_DISPLAY_TAG = /\[[^\]]*\]$/;
5
+ /** Claude Code's display suffix selecting a model's 1M-context variant; never in an API id. */
6
+ const LARGE_CONTEXT_DISPLAY_TAG = '[1m]';
7
+ export function normalizeModelId(model) {
8
+ return model.trim().replace(MODEL_ID_DISPLAY_TAG, '').replace(MODEL_ID_DATE_SUFFIX, '');
9
+ }
10
+ export function hasLargeContextTag(model) {
11
+ return model.trim().endsWith(LARGE_CONTEXT_DISPLAY_TAG);
12
+ }
13
+ export const longestFirst = (keys) => keys.sort((a, b) => b.length - a.length);
14
+ // `gen_ai.provider.name` registry members (semantic-conventions-genai docs/registry/attributes/gen-ai.md, source dated in otel/attributes.ts); `meta` is a local value, not one.
15
+ const GCP_GEMINI_PROVIDER = 'gcp.gemini';
16
+ const META_PROVIDER = 'meta';
17
+ const MISTRAL_AI_PROVIDER = 'mistral_ai';
18
+ /** Model-id prefix → `gen_ai.provider.name`. The judge's three providers keep their dashed prefixes, which route its API calls. */
19
+ const PROVIDER_BY_MODEL_PREFIX = [
20
+ ['claude-', GENAI_PROVIDER_NAMES.ANTHROPIC],
21
+ ['gpt-', GENAI_PROVIDER_NAMES.OPENAI],
22
+ ['grok-', GENAI_PROVIDER_NAMES.XAI],
23
+ ['gemini', GCP_GEMINI_PROVIDER],
24
+ ['llama', META_PROVIDER],
25
+ ['mistral', MISTRAL_AI_PROVIDER],
26
+ ];
27
+ /** The provider a model id names by its prefix; undefined when none does, never a guess. */
28
+ export function providerOfModel(model) {
29
+ const id = normalizeModelId(model);
30
+ return PROVIDER_BY_MODEL_PREFIX.find(([prefix]) => id.startsWith(prefix))?.[1];
31
+ }
32
+ /** Longest-prefix match on the undated id, so a point release resolves to its family. */
33
+ export function matchFamily(model, familiesLongestFirst) {
34
+ const id = normalizeModelId(model);
35
+ return familiesLongestFirst.find((known) => id === known || id.startsWith(`${known}-`));
36
+ }
@@ -0,0 +1,153 @@
1
+ /** The rate card: USD per token for each model family, and the cost of one call. No OTel, so report scripts can import it. */
2
+ import { hasLargeContextTag, longestFirst, matchFamily } from './model-ids.js';
3
+ import { inputTokensIncludingCache, tokenCount, usageCounts } from './transcript-entry.js';
4
+ // Cache prices as multiples of the model's input price (platform.claude.com pricing: prompt caching).
5
+ const CACHE_WRITE_5M_MULTIPLIER = 1.25;
6
+ const CACHE_WRITE_1H_MULTIPLIER = 2;
7
+ const CACHE_READ_MULTIPLIER = 0.1;
8
+ /** Fable and Mythos 5.1 and later; Fable and Mythos 5 keep CACHE_READ_MULTIPLIER. */
9
+ const FABLE_5_1_AND_LATER_CACHE_READ_MULTIPLIER = 0.025;
10
+ const OPUS_SONNET_5_5_CACHE_READ_MULTIPLIER = 0.05;
11
+ const GPT_4O_CACHE_READ_MULTIPLIER = 0.5;
12
+ const HAIKU_5_5_LONG_CONTEXT_THRESHOLD_TOKENS = 100_000;
13
+ /** xAI bills a whole request at its long-context rates once the prompt reaches this size, inclusive. */
14
+ const XAI_LONG_CONTEXT_FROM_TOKENS = 200_000;
15
+ /** `thresholdTokens` is exclusive ("over"), so an inclusive boundary sits one token lower. */
16
+ const XAI_LONG_CONTEXT_THRESHOLD_TOKENS = XAI_LONG_CONTEXT_FROM_TOKENS - 1;
17
+ /** xAI's long-context rates are double its base rates. */
18
+ const XAI_LONG_CONTEXT_RATE_FACTOR = 2;
19
+ function xaiRow({ input, output }) {
20
+ return {
21
+ input,
22
+ output,
23
+ longContext: {
24
+ thresholdTokens: XAI_LONG_CONTEXT_THRESHOLD_TOKENS,
25
+ input: input * XAI_LONG_CONTEXT_RATE_FACTOR,
26
+ output: output * XAI_LONG_CONTEXT_RATE_FACTOR,
27
+ },
28
+ };
29
+ }
30
+ // Rows shared by several families; each family keeps its own key below.
31
+ const FABLE_5_2 = { input: 8.0, output: 40.0, cacheReadMultiplier: FABLE_5_1_AND_LATER_CACHE_READ_MULTIPLIER };
32
+ const FABLE_5_1 = { input: 10.0, output: 50.0, cacheReadMultiplier: FABLE_5_1_AND_LATER_CACHE_READ_MULTIPLIER };
33
+ const FABLE_5 = { input: 10.0, output: 50.0 };
34
+ const OPUS_4_5_TO_5 = { input: 5.0, output: 25.0 };
35
+ const SONNET_4_TO_4_6 = { input: 3.0, output: 15.0 };
36
+ const GROK_4_5_TO_4_7 = xaiRow({ input: 2.0, output: 6.0 });
37
+ const GROK_4_20_TO_4_3 = xaiRow({ input: 1.25, output: 2.5 });
38
+ // USD per 1M tokens. Claude rows follow platform.claude.com/docs/en/about-claude/pricing, grok rows
39
+ // docs.x.ai/developers/pricing. Keys are undated family ids: `normalizeModelId` strips date stamps and display tags, so a
40
+ // dated key can never be hit. xAI's cached-input rates (0.15x–0.25x) are not encoded: the judge
41
+ // sends no cache counts. For xAI the provider's own `cost_in_usd_ticks` is still preferred.
42
+ const MODEL_PRICING = {
43
+ 'claude-fable-5-2': FABLE_5_2,
44
+ 'claude-mythos-5-2': FABLE_5_2,
45
+ 'claude-fable-5-1': FABLE_5_1,
46
+ 'claude-mythos-5-1': FABLE_5_1,
47
+ 'claude-fable-5': FABLE_5,
48
+ 'claude-mythos-5': FABLE_5,
49
+ 'claude-opus-5-5': { input: 4.0, output: 20.0, cacheReadMultiplier: OPUS_SONNET_5_5_CACHE_READ_MULTIPLIER },
50
+ 'claude-opus-5': OPUS_4_5_TO_5,
51
+ 'claude-opus-4-8': OPUS_4_5_TO_5,
52
+ 'claude-opus-4-7': OPUS_4_5_TO_5,
53
+ 'claude-opus-4-6': OPUS_4_5_TO_5,
54
+ 'claude-opus-4-5': OPUS_4_5_TO_5,
55
+ 'claude-sonnet-5-5': { input: 2.0, output: 10.0, cacheReadMultiplier: OPUS_SONNET_5_5_CACHE_READ_MULTIPLIER },
56
+ 'claude-sonnet-5': { input: 2.0, output: 10.0 },
57
+ 'claude-sonnet-4-6': SONNET_4_TO_4_6,
58
+ 'claude-sonnet-4-5': SONNET_4_TO_4_6,
59
+ 'claude-sonnet-4': SONNET_4_TO_4_6,
60
+ 'claude-haiku-5-5': {
61
+ input: 0.10,
62
+ output: 0.50,
63
+ longContext: { thresholdTokens: HAIKU_5_5_LONG_CONTEXT_THRESHOLD_TOKENS, input: 0.50, output: 2.50 },
64
+ },
65
+ 'claude-haiku-4-5': { input: 1.0, output: 5.0 },
66
+ 'claude-3-5-haiku': { input: 0.80, output: 4.0 },
67
+ 'grok-4.7': GROK_4_5_TO_4_7,
68
+ 'grok-4.6': GROK_4_5_TO_4_7,
69
+ 'grok-4.5': GROK_4_5_TO_4_7,
70
+ 'grok-4.3': GROK_4_20_TO_4_3,
71
+ 'grok-4.20': GROK_4_20_TO_4_3,
72
+ // A coding model, but served by /v1/chat/completions, so the judge can land on it.
73
+ 'grok-build-0.1': xaiRow({ input: 1.0, output: 2.0 }),
74
+ 'gpt-5.4-mini': { input: 0.75, output: 4.5 },
75
+ 'gpt-4o': { input: 2.5, output: 10.0, cacheReadMultiplier: GPT_4O_CACHE_READ_MULTIPLIER },
76
+ // An ISO-dated snapshot keeps its date (only 8-digit stamps are stripped), and this one costs more than gpt-4o.
77
+ // It predates OpenAI prompt caching, so it keeps the default cache-read rate rather than gpt-4o's.
78
+ 'gpt-4o-2024-05-13': { input: 5.0, output: 15.0 },
79
+ 'gpt-4o-mini': { input: 0.15, output: 0.6, cacheReadMultiplier: GPT_4O_CACHE_READ_MULTIPLIER },
80
+ 'gpt-4-turbo': { input: 10.0, output: 30.0 },
81
+ };
82
+ const PRICED_MODEL_IDS = longestFirst(Object.keys(MODEL_PRICING));
83
+ function lookupPricingRow(model) {
84
+ const family = matchFamily(model, PRICED_MODEL_IDS);
85
+ return family ? MODEL_PRICING[family] : undefined;
86
+ }
87
+ export function lookupModelPricing(model) {
88
+ const row = lookupPricingRow(model);
89
+ return row && { input: row.input, output: row.output };
90
+ }
91
+ const TOKENS_PER_PRICED_UNIT = 1_000_000;
92
+ /** Every priced count from one raw usage record, with the cache-write total split into 5-minute and 1-hour writes. */
93
+ export function pricedUsageCounts(usage) {
94
+ const { inputTokens, outputTokens, cacheReadTokens, cacheCreationTokens } = usageCounts(usage);
95
+ const cacheWrite1h = tokenCount(usage.cache_creation?.ephemeral_1h_input_tokens);
96
+ const reported5m = usage.cache_creation?.ephemeral_5m_input_tokens;
97
+ return {
98
+ input: inputTokens,
99
+ output: outputTokens,
100
+ cacheRead: cacheReadTokens,
101
+ // Without a 5-minute figure, the rest of the cache-write total is 5-minute writes, the API default.
102
+ cacheWrite5m: typeof reported5m === 'number' ? tokenCount(reported5m) : Math.max(0, cacheCreationTokens - cacheWrite1h),
103
+ cacheWrite1h,
104
+ };
105
+ }
106
+ /** USD for one call's tokens, cache reads and writes at their rates; undefined for a model not on the rate card. */
107
+ export function usageCostUsd(model, counts) {
108
+ const row = lookupPricingRow(model);
109
+ if (!row)
110
+ return undefined;
111
+ const cacheRead = counts.cacheRead ?? 0;
112
+ const cacheWrite5m = counts.cacheWrite5m ?? 0;
113
+ const cacheWrite1h = counts.cacheWrite1h ?? 0;
114
+ const promptTokens = inputTokensIncludingCache(counts.input, cacheWrite5m + cacheWrite1h, cacheRead);
115
+ // A prompt over the model's long-context threshold moves the whole call to that tier.
116
+ const rates = row.longContext && promptTokens > row.longContext.thresholdTokens ? row.longContext : row;
117
+ const inputEquivalent = counts.input
118
+ + cacheWrite5m * CACHE_WRITE_5M_MULTIPLIER
119
+ + cacheWrite1h * CACHE_WRITE_1H_MULTIPLIER
120
+ + cacheRead * (row.cacheReadMultiplier ?? CACHE_READ_MULTIPLIER);
121
+ return (inputEquivalent * rates.input + counts.output * rates.output) / TOKENS_PER_PRICED_UNIT;
122
+ }
123
+ // --- Context window catalog ---
124
+ const DEFAULT_CONTEXT_WINDOW_TOKENS = 200_000;
125
+ const LARGE_CONTEXT_WINDOW_TOKENS = 1_000_000;
126
+ /**
127
+ * Family ids documented at 1M, matched like the rate card; all others are 200K. Mirrors the
128
+ * observability-toolkit's `MODEL_CONTEXT_WINDOWS`, which cannot be imported from here.
129
+ * https://platform.claude.com/docs/en/about-claude/models/overview
130
+ * Exported for the toolkit parity test; prefer `contextWindowForModel` at call sites.
131
+ */
132
+ export const MODEL_CONTEXT_WINDOWS = {
133
+ 'claude-fable-5': LARGE_CONTEXT_WINDOW_TOKENS,
134
+ 'claude-mythos-5': LARGE_CONTEXT_WINDOW_TOKENS,
135
+ 'claude-opus-5': LARGE_CONTEXT_WINDOW_TOKENS,
136
+ 'claude-opus-4-8': LARGE_CONTEXT_WINDOW_TOKENS,
137
+ 'claude-opus-4-7': LARGE_CONTEXT_WINDOW_TOKENS,
138
+ 'claude-opus-4-6': LARGE_CONTEXT_WINDOW_TOKENS,
139
+ 'claude-sonnet-5': LARGE_CONTEXT_WINDOW_TOKENS,
140
+ 'claude-sonnet-4-6': LARGE_CONTEXT_WINDOW_TOKENS,
141
+ 'claude-haiku-5-5': LARGE_CONTEXT_WINDOW_TOKENS,
142
+ };
143
+ const WINDOWED_MODEL_IDS = longestFirst(Object.keys(MODEL_CONTEXT_WINDOWS));
144
+ /** `observedTokens` promotes to 1M when usage exceeds the table entry — proves a larger window for models not yet listed. */
145
+ export function contextWindowForModel(model, observedTokens) {
146
+ if (!model)
147
+ return DEFAULT_CONTEXT_WINDOW_TOKENS;
148
+ if (hasLargeContextTag(model))
149
+ return LARGE_CONTEXT_WINDOW_TOKENS;
150
+ const family = matchFamily(model, WINDOWED_MODEL_IDS);
151
+ const mapped = family === undefined ? DEFAULT_CONTEXT_WINDOW_TOKENS : MODEL_CONTEXT_WINDOWS[family] ?? DEFAULT_CONTEXT_WINDOW_TOKENS;
152
+ return observedTokens !== undefined && observedTokens > mapped ? LARGE_CONTEXT_WINDOW_TOKENS : mapped;
153
+ }