observability-toolkit-hooks 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (305) hide show
  1. package/CONFIG.md +144 -0
  2. package/README.md +201 -2
  3. package/dist/handlers/compact.js +38 -0
  4. package/dist/handlers/mcp-status.js +66 -0
  5. package/dist/handlers/notification.js +45 -0
  6. package/dist/handlers/post-tool-agent.js +157 -0
  7. package/dist/handlers/post-tool-changelog-sync.js +148 -0
  8. package/dist/handlers/post-tool-code-structure.js +116 -0
  9. package/dist/handlers/post-tool-edit-ledger.js +15 -0
  10. package/dist/handlers/post-tool-failure.js +83 -0
  11. package/dist/handlers/post-tool-git.js +79 -0
  12. package/dist/handlers/post-tool-mcp.js +105 -0
  13. package/dist/handlers/post-tool-outcome.js +48 -0
  14. package/dist/handlers/post-tool-task-state.js +74 -0
  15. package/dist/handlers/post-tool.js +132 -0
  16. package/dist/handlers/pre-tool-agent.js +192 -0
  17. package/dist/handlers/pre-tool.js +218 -0
  18. package/dist/handlers/session-end.js +39 -0
  19. package/dist/handlers/session-start.js +262 -0
  20. package/dist/handlers/stop-error-reminder.js +195 -0
  21. package/dist/handlers/stop-quality-evaluation.js +58 -0
  22. package/dist/handlers/stop-session-summary.js +62 -0
  23. package/dist/handlers/stop-token-metrics.js +83 -0
  24. package/dist/handlers/stop.js +25 -0
  25. package/dist/handlers/subagent.js +105 -0
  26. package/dist/handlers/tool-event-router.js +39 -0
  27. package/dist/handlers/user-prompt.js +218 -0
  28. package/dist/hook-runner.js +10 -0
  29. package/dist/hook-runner.js.map +7 -0
  30. package/dist/lib/agent/agent-context.js +123 -0
  31. package/dist/lib/agent/agent-evaluations.js +155 -0
  32. package/dist/lib/agent/agent-file-budget.js +65 -0
  33. package/dist/lib/agent/agent-sources.js +165 -0
  34. package/dist/lib/agent/synth-spans.js +51 -0
  35. package/dist/lib/core/bounded-label.js +6 -0
  36. package/dist/lib/core/category-rules.js +11 -0
  37. package/dist/lib/core/child-result.js +19 -0
  38. package/dist/lib/core/config-dir-recovery.js +22 -0
  39. package/dist/lib/core/constants.js +171 -0
  40. package/dist/lib/core/detached-runner.js +55 -0
  41. package/dist/lib/core/file-utils.js +353 -0
  42. package/dist/lib/core/format-utils.js +51 -0
  43. package/dist/lib/core/http-utils.js +74 -0
  44. package/dist/lib/core/http1-fetch.js +14 -0
  45. package/dist/lib/core/identity-key-resolver.js +149 -0
  46. package/dist/lib/core/jsonl-tail.js +207 -0
  47. package/dist/lib/core/load-envrc.js +72 -0
  48. package/dist/lib/core/parsers.js +43 -0
  49. package/dist/lib/core/regex.js +27 -0
  50. package/dist/lib/core/settings-env.js +31 -0
  51. package/dist/lib/core/shell-command.js +122 -0
  52. package/dist/lib/core/units.js +97 -0
  53. package/dist/lib/git/git-cache.js +158 -0
  54. package/dist/lib/git/git-commit.js +189 -0
  55. package/dist/lib/git/git-exec.js +30 -0
  56. package/dist/lib/mcp/mcp-completeness.js +40 -0
  57. package/dist/lib/mcp/mcp-config.js +118 -0
  58. package/dist/lib/mcp/mcp-failure-latch.js +22 -0
  59. package/dist/lib/mcp/mcp-identity-launcher.js +43 -0
  60. package/dist/lib/otel/attributes.js +322 -0
  61. package/dist/lib/otel/evaluation-attrs.js +51 -0
  62. package/dist/lib/otel/file-exporters.js +169 -0
  63. package/dist/lib/otel/host-resource.js +61 -0
  64. package/dist/lib/otel/otel-headers-helper.js +26 -0
  65. package/dist/lib/otel/otel-monitor.js +181 -0
  66. package/dist/lib/otel/otel.js +235 -0
  67. package/dist/lib/otel/otlp-headers.js +101 -0
  68. package/dist/lib/otel/otlp-post.js +122 -0
  69. package/dist/lib/otel/otlp-serialize.js +142 -0
  70. package/dist/lib/otel/otlp-signal.js +2 -0
  71. package/dist/lib/otel/remote-spans.js +142 -0
  72. package/dist/lib/otel/service-identity.js +10 -0
  73. package/dist/lib/otel/telemetry-alerts.js +43 -0
  74. package/dist/lib/otel/token-metrics.js +122 -0
  75. package/dist/lib/otel/trace-context.js +81 -0
  76. package/dist/lib/quality/judge-meta-eval.js +70 -0
  77. package/dist/lib/quality/judge-prompts.js +104 -0
  78. package/dist/lib/quality/judge-providers.js +193 -0
  79. package/dist/lib/quality/judge-transport.js +93 -0
  80. package/dist/lib/quality/llm-judge.js +170 -0
  81. package/dist/lib/quality/quality-budget.js +99 -0
  82. package/dist/lib/quality/quality-degradation.js +156 -0
  83. package/dist/lib/quality/quality-eval-handoff.js +74 -0
  84. package/dist/lib/quality/quality-evaluator.js +178 -0
  85. package/dist/lib/quality/quality-sampler.js +43 -0
  86. package/dist/lib/quality/quality-signals.js +150 -0
  87. package/dist/lib/runtime/categorizers.js +101 -0
  88. package/dist/lib/runtime/hook-input.js +16 -0
  89. package/dist/lib/runtime/hook-output.js +50 -0
  90. package/dist/lib/runtime/output-analyzer.js +160 -0
  91. package/dist/lib/runtime/run-handlers.js +32 -0
  92. package/dist/lib/runtime/tool-input.js +111 -0
  93. package/dist/lib/runtime/tool-output.js +44 -0
  94. package/dist/lib/runtime/unknown-tool.js +32 -0
  95. package/dist/lib/session/edit-ledger.js +29 -0
  96. package/dist/lib/session/forked-skill.js +39 -0
  97. package/dist/lib/session/handoffs.js +77 -0
  98. package/dist/lib/session/session-state.js +169 -0
  99. package/dist/lib/session/skill-rules.js +196 -0
  100. package/dist/lib/session/task-tracker.js +83 -0
  101. package/dist/lib/shipper/shipper-credentials.js +38 -0
  102. package/dist/lib/shipper/shipper-cursor.js +89 -0
  103. package/dist/lib/shipper/shipper-status.js +174 -0
  104. package/dist/lib/shipper/span-shipper.js +272 -0
  105. package/dist/lib/shipper/telemetry-shipper.js +39 -0
  106. package/dist/lib/transcript/agent-transcript-metrics.js +34 -0
  107. package/dist/lib/transcript/context-breakdown.js +134 -0
  108. package/dist/lib/transcript/context-history.js +69 -0
  109. package/dist/lib/transcript/context-tracker.js +226 -0
  110. package/dist/lib/transcript/message-count.js +49 -0
  111. package/dist/lib/transcript/model-ids.js +36 -0
  112. package/dist/lib/transcript/model-pricing.js +153 -0
  113. package/dist/lib/transcript/token-metrics-checkpoint.js +152 -0
  114. package/dist/lib/transcript/tool-call-durations.js +64 -0
  115. package/dist/lib/transcript/transcript-entry.js +67 -0
  116. package/dist/lib/transcript/transcript-fold.js +130 -0
  117. package/dist/lib/transcript/transcript-layout.js +39 -0
  118. package/dist/lib/transcript/transcript-parser.js +117 -0
  119. package/dist/runner/agent-context-4XTCLMLZ.js +23 -0
  120. package/dist/runner/agent-context-4XTCLMLZ.js.map +7 -0
  121. package/dist/runner/agent-file-budget-Q33ESBBE.js +68 -0
  122. package/dist/runner/agent-file-budget-Q33ESBBE.js.map +7 -0
  123. package/dist/runner/agent-transcript-metrics-W5CZZFMI.js +39 -0
  124. package/dist/runner/agent-transcript-metrics-W5CZZFMI.js.map +7 -0
  125. package/dist/runner/chunk-2NTNAJZE.js +49 -0
  126. package/dist/runner/chunk-2NTNAJZE.js.map +7 -0
  127. package/dist/runner/chunk-4KWBQTTG.js +78 -0
  128. package/dist/runner/chunk-4KWBQTTG.js.map +7 -0
  129. package/dist/runner/chunk-52RY6LQT.js +699 -0
  130. package/dist/runner/chunk-52RY6LQT.js.map +7 -0
  131. package/dist/runner/chunk-7OM5CYES.js +8695 -0
  132. package/dist/runner/chunk-7OM5CYES.js.map +7 -0
  133. package/dist/runner/chunk-7PEOKGYR.js +1568 -0
  134. package/dist/runner/chunk-7PEOKGYR.js.map +7 -0
  135. package/dist/runner/chunk-AGSGKELQ.js +126 -0
  136. package/dist/runner/chunk-AGSGKELQ.js.map +7 -0
  137. package/dist/runner/chunk-AVM7PJFW.js +12 -0
  138. package/dist/runner/chunk-AVM7PJFW.js.map +7 -0
  139. package/dist/runner/chunk-C3WHUMU5.js +178 -0
  140. package/dist/runner/chunk-C3WHUMU5.js.map +7 -0
  141. package/dist/runner/chunk-DGB4NSSD.js +157 -0
  142. package/dist/runner/chunk-DGB4NSSD.js.map +7 -0
  143. package/dist/runner/chunk-DNSTWC26.js +151 -0
  144. package/dist/runner/chunk-DNSTWC26.js.map +7 -0
  145. package/dist/runner/chunk-FDJJ3TYU.js +449 -0
  146. package/dist/runner/chunk-FDJJ3TYU.js.map +7 -0
  147. package/dist/runner/chunk-FGKYDQHZ.js +137 -0
  148. package/dist/runner/chunk-FGKYDQHZ.js.map +7 -0
  149. package/dist/runner/chunk-GG2I4TGI.js +582 -0
  150. package/dist/runner/chunk-GG2I4TGI.js.map +7 -0
  151. package/dist/runner/chunk-GNNKUMRF.js +60 -0
  152. package/dist/runner/chunk-GNNKUMRF.js.map +7 -0
  153. package/dist/runner/chunk-I7TD2QVR.js +118 -0
  154. package/dist/runner/chunk-I7TD2QVR.js.map +7 -0
  155. package/dist/runner/chunk-IJ4SLUBV.js +78 -0
  156. package/dist/runner/chunk-IJ4SLUBV.js.map +7 -0
  157. package/dist/runner/chunk-IY7AP7NA.js +32 -0
  158. package/dist/runner/chunk-IY7AP7NA.js.map +7 -0
  159. package/dist/runner/chunk-J3F3Z3EQ.js +177 -0
  160. package/dist/runner/chunk-J3F3Z3EQ.js.map +7 -0
  161. package/dist/runner/chunk-JLEO5OHU.js +104 -0
  162. package/dist/runner/chunk-JLEO5OHU.js.map +7 -0
  163. package/dist/runner/chunk-JRNNLOPR.js +168 -0
  164. package/dist/runner/chunk-JRNNLOPR.js.map +7 -0
  165. package/dist/runner/chunk-KGSA5JYP.js +82 -0
  166. package/dist/runner/chunk-KGSA5JYP.js.map +7 -0
  167. package/dist/runner/chunk-LBCZAYFR.js +125 -0
  168. package/dist/runner/chunk-LBCZAYFR.js.map +7 -0
  169. package/dist/runner/chunk-LHWRXY2G.js +41 -0
  170. package/dist/runner/chunk-LHWRXY2G.js.map +7 -0
  171. package/dist/runner/chunk-LQ2LGUYJ.js +41 -0
  172. package/dist/runner/chunk-LQ2LGUYJ.js.map +7 -0
  173. package/dist/runner/chunk-LYY6RCIE.js +158 -0
  174. package/dist/runner/chunk-LYY6RCIE.js.map +7 -0
  175. package/dist/runner/chunk-M4R4QIQH.js +41 -0
  176. package/dist/runner/chunk-M4R4QIQH.js.map +7 -0
  177. package/dist/runner/chunk-MC75VXMX.js +207 -0
  178. package/dist/runner/chunk-MC75VXMX.js.map +7 -0
  179. package/dist/runner/chunk-NKZU4RRG.js +104 -0
  180. package/dist/runner/chunk-NKZU4RRG.js.map +7 -0
  181. package/dist/runner/chunk-PJHWHJ3K.js +56 -0
  182. package/dist/runner/chunk-PJHWHJ3K.js.map +7 -0
  183. package/dist/runner/chunk-RIGVYJ2O.js +114 -0
  184. package/dist/runner/chunk-RIGVYJ2O.js.map +7 -0
  185. package/dist/runner/chunk-RWRGC7ZK.js +93 -0
  186. package/dist/runner/chunk-RWRGC7ZK.js.map +7 -0
  187. package/dist/runner/chunk-SRMAJQMV.js +54 -0
  188. package/dist/runner/chunk-SRMAJQMV.js.map +7 -0
  189. package/dist/runner/chunk-TRMFD36J.js +47 -0
  190. package/dist/runner/chunk-TRMFD36J.js.map +7 -0
  191. package/dist/runner/chunk-U4IOZYQ3.js +21 -0
  192. package/dist/runner/chunk-U4IOZYQ3.js.map +7 -0
  193. package/dist/runner/chunk-UEXDE3WP.js +83 -0
  194. package/dist/runner/chunk-UEXDE3WP.js.map +7 -0
  195. package/dist/runner/chunk-UW3GQZSM.js +50 -0
  196. package/dist/runner/chunk-UW3GQZSM.js.map +7 -0
  197. package/dist/runner/chunk-V2GSP6VR.js +46 -0
  198. package/dist/runner/chunk-V2GSP6VR.js.map +7 -0
  199. package/dist/runner/chunk-VOV4Y5VU.js +81 -0
  200. package/dist/runner/chunk-VOV4Y5VU.js.map +7 -0
  201. package/dist/runner/chunk-VT5T6OEI.js +65 -0
  202. package/dist/runner/chunk-VT5T6OEI.js.map +7 -0
  203. package/dist/runner/chunk-VUYVFWIN.js +12 -0
  204. package/dist/runner/chunk-VUYVFWIN.js.map +7 -0
  205. package/dist/runner/chunk-VVGOPPEN.js +36 -0
  206. package/dist/runner/chunk-VVGOPPEN.js.map +7 -0
  207. package/dist/runner/chunk-VXFSLM6P.js +14 -0
  208. package/dist/runner/chunk-VXFSLM6P.js.map +7 -0
  209. package/dist/runner/chunk-W3EK7JUT.js +26125 -0
  210. package/dist/runner/chunk-W3EK7JUT.js.map +7 -0
  211. package/dist/runner/chunk-WJHNCOUF.js +52 -0
  212. package/dist/runner/chunk-WJHNCOUF.js.map +7 -0
  213. package/dist/runner/chunk-WU7ANGCW.js +269 -0
  214. package/dist/runner/chunk-WU7ANGCW.js.map +7 -0
  215. package/dist/runner/chunk-X7XLMSZX.js +44 -0
  216. package/dist/runner/chunk-X7XLMSZX.js.map +7 -0
  217. package/dist/runner/chunk-XSO3B4QN.js +124 -0
  218. package/dist/runner/chunk-XSO3B4QN.js.map +7 -0
  219. package/dist/runner/chunk-YGFN3LN2.js +174 -0
  220. package/dist/runner/chunk-YGFN3LN2.js.map +7 -0
  221. package/dist/runner/chunk-YHYDBLVB.js +33 -0
  222. package/dist/runner/chunk-YHYDBLVB.js.map +7 -0
  223. package/dist/runner/compact-36NP3PKT.js +60 -0
  224. package/dist/runner/compact-36NP3PKT.js.map +7 -0
  225. package/dist/runner/getMachineId-bsd-AGENNHN6.js +42 -0
  226. package/dist/runner/getMachineId-bsd-AGENNHN6.js.map +7 -0
  227. package/dist/runner/getMachineId-bsd-I5WZGCL4.js +33 -0
  228. package/dist/runner/getMachineId-bsd-I5WZGCL4.js.map +7 -0
  229. package/dist/runner/getMachineId-bsd-ZXK225P7.js +33 -0
  230. package/dist/runner/getMachineId-bsd-ZXK225P7.js.map +7 -0
  231. package/dist/runner/getMachineId-darwin-47GDLEXL.js +42 -0
  232. package/dist/runner/getMachineId-darwin-47GDLEXL.js.map +7 -0
  233. package/dist/runner/getMachineId-darwin-5CRLMDD6.js +33 -0
  234. package/dist/runner/getMachineId-darwin-5CRLMDD6.js.map +7 -0
  235. package/dist/runner/getMachineId-darwin-ADG4I32N.js +33 -0
  236. package/dist/runner/getMachineId-darwin-ADG4I32N.js.map +7 -0
  237. package/dist/runner/getMachineId-linux-5KVS3T2M.js +27 -0
  238. package/dist/runner/getMachineId-linux-5KVS3T2M.js.map +7 -0
  239. package/dist/runner/getMachineId-linux-GDFB5GSO.js +34 -0
  240. package/dist/runner/getMachineId-linux-GDFB5GSO.js.map +7 -0
  241. package/dist/runner/getMachineId-linux-NQMWCRO3.js +27 -0
  242. package/dist/runner/getMachineId-linux-NQMWCRO3.js.map +7 -0
  243. package/dist/runner/getMachineId-unsupported-5PFIGMVX.js +18 -0
  244. package/dist/runner/getMachineId-unsupported-5PFIGMVX.js.map +7 -0
  245. package/dist/runner/getMachineId-unsupported-DW27K3ZX.js +18 -0
  246. package/dist/runner/getMachineId-unsupported-DW27K3ZX.js.map +7 -0
  247. package/dist/runner/getMachineId-unsupported-XV3FHTHD.js +25 -0
  248. package/dist/runner/getMachineId-unsupported-XV3FHTHD.js.map +7 -0
  249. package/dist/runner/getMachineId-win-5JVMW3EI.js +44 -0
  250. package/dist/runner/getMachineId-win-5JVMW3EI.js.map +7 -0
  251. package/dist/runner/getMachineId-win-SNESQF7R.js +35 -0
  252. package/dist/runner/getMachineId-win-SNESQF7R.js.map +7 -0
  253. package/dist/runner/getMachineId-win-UJYHSBM2.js +35 -0
  254. package/dist/runner/getMachineId-win-UJYHSBM2.js.map +7 -0
  255. package/dist/runner/git-commit-BA53DOJQ.js +30 -0
  256. package/dist/runner/git-commit-BA53DOJQ.js.map +7 -0
  257. package/dist/runner/hook-runner-JHH6PGKE.js +220 -0
  258. package/dist/runner/hook-runner-JHH6PGKE.js.map +7 -0
  259. package/dist/runner/judge-transport-R4TF5LEH.js +91 -0
  260. package/dist/runner/judge-transport-R4TF5LEH.js.map +7 -0
  261. package/dist/runner/mcp-status-QEUH2KGX.js +89 -0
  262. package/dist/runner/mcp-status-QEUH2KGX.js.map +7 -0
  263. package/dist/runner/notification-FKMBCSXF.js +69 -0
  264. package/dist/runner/notification-FKMBCSXF.js.map +7 -0
  265. package/dist/runner/post-tool-3MRHTBKH.js +192 -0
  266. package/dist/runner/post-tool-3MRHTBKH.js.map +7 -0
  267. package/dist/runner/post-tool-agent-BB34MNHI.js +370 -0
  268. package/dist/runner/post-tool-agent-BB34MNHI.js.map +7 -0
  269. package/dist/runner/post-tool-changelog-sync-OP2TT2I7.js +147 -0
  270. package/dist/runner/post-tool-changelog-sync-OP2TT2I7.js.map +7 -0
  271. package/dist/runner/post-tool-code-structure-LE7J2SC2.js +130 -0
  272. package/dist/runner/post-tool-code-structure-LE7J2SC2.js.map +7 -0
  273. package/dist/runner/post-tool-edit-ledger-IJMEYHKF.js +30 -0
  274. package/dist/runner/post-tool-edit-ledger-IJMEYHKF.js.map +7 -0
  275. package/dist/runner/post-tool-failure-XTH2I2Z7.js +111 -0
  276. package/dist/runner/post-tool-failure-XTH2I2Z7.js.map +7 -0
  277. package/dist/runner/post-tool-git-E46HZGZO.js +94 -0
  278. package/dist/runner/post-tool-git-E46HZGZO.js.map +7 -0
  279. package/dist/runner/post-tool-mcp-AMCDY5GH.js +144 -0
  280. package/dist/runner/post-tool-mcp-AMCDY5GH.js.map +7 -0
  281. package/dist/runner/post-tool-task-state-TLDOI33H.js +100 -0
  282. package/dist/runner/post-tool-task-state-TLDOI33H.js.map +7 -0
  283. package/dist/runner/pre-tool-SQE2FZQO.js +245 -0
  284. package/dist/runner/pre-tool-SQE2FZQO.js.map +7 -0
  285. package/dist/runner/pre-tool-agent-OZUPVFUI.js +218 -0
  286. package/dist/runner/pre-tool-agent-OZUPVFUI.js.map +7 -0
  287. package/dist/runner/quality-evaluator-XYNDKDRG.js +901 -0
  288. package/dist/runner/quality-evaluator-XYNDKDRG.js.map +7 -0
  289. package/dist/runner/session-end-3MJTDLLA.js +57 -0
  290. package/dist/runner/session-end-3MJTDLLA.js.map +7 -0
  291. package/dist/runner/session-start-5ZMCLKBS.js +352 -0
  292. package/dist/runner/session-start-5ZMCLKBS.js.map +7 -0
  293. package/dist/runner/shipper-status-MADX6SPG.js +37 -0
  294. package/dist/runner/shipper-status-MADX6SPG.js.map +7 -0
  295. package/dist/runner/span-shipper-4HQDHC47.js +3408 -0
  296. package/dist/runner/span-shipper-4HQDHC47.js.map +7 -0
  297. package/dist/runner/stop-RTKSIYJV.js +596 -0
  298. package/dist/runner/stop-RTKSIYJV.js.map +7 -0
  299. package/dist/runner/subagent-CBCG4OLZ.js +116 -0
  300. package/dist/runner/subagent-CBCG4OLZ.js.map +7 -0
  301. package/dist/runner/token-metrics-AD2RAFGM.js +31 -0
  302. package/dist/runner/token-metrics-AD2RAFGM.js.map +7 -0
  303. package/dist/runner/user-prompt-T5NZ2UJD.js +376 -0
  304. package/dist/runner/user-prompt-T5NZ2UJD.js.map +7 -0
  305. package/package.json +68 -5
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../lib/transcript/transcript-parser.ts", "../../../lib/quality/judge-providers.ts", "../../../lib/quality/judge-prompts.ts", "../../../lib/quality/llm-judge.ts", "../../../lib/quality/judge-meta-eval.ts", "../../../lib/quality/quality-degradation.ts", "../../../lib/quality/quality-evaluator.ts"],
4
+ "sourcesContent": ["/** Turns from Claude Code transcript JSONL, for the T2 judge. */\n\nimport { createHash } from 'node:crypto';\nimport { truncate } from '../core/format-utils.js';\nimport { parseJsonLines, readFileSlice } from '../core/jsonl-tail.js';\nimport { isByteCount } from '../core/units.js';\nimport {\n classifyEntry, isFailedRequest, mayBeConversational, toBlocks, type ContentBlock, type TranscriptEntry,\n} from './transcript-entry.js';\n\n// --- Types ---\n\n/** A response never delivered: the request failed (rate limit, server error, login). */\nexport type CutOffReason = 'api_error';\n\nexport interface Turn {\n userText: string;\n assistantText: string;\n toolResults: string[];\n /** `sampleTurns` skips marked turns so the judge never scores an incomplete response. */\n cutOffBy?: CutOffReason;\n /** The last delivered response's `message.id`: the API response id, semconv `gen_ai.response.id`. */\n responseId?: string;\n}\n\n/** `index` is the position among `extractTurns`' results; the transcript is append-only, so it locates the turn in any later read. */\nexport interface SampledTurn extends Turn {\n index: number;\n}\n\n// --- Constants ---\n\nexport const MAX_TEXT_LENGTH = 8000;\nexport const MAX_TOOL_RESULTS_PER_TURN = 20;\nexport const MAX_TOOL_RESULT_LENGTH = 500;\n\n// --- Content blocks ---\n\n/** `thinking` and `tool_use` blocks carry no `text` and drop out. */\nfunction extractTextContent(content: unknown): string {\n if (typeof content === 'string') return content;\n return toBlocks(content)\n .filter((block): block is ContentBlock & { text: string } => typeof block.text === 'string')\n .map(block => block.text)\n .join('\\n');\n}\n\n/** `tool_result` blocks arrive inside the USER entry that follows the `tool_use`. */\nfunction extractToolResults(content: unknown, limit: number): string[] {\n return toBlocks(content)\n .filter(block => block.type === 'tool_result')\n .slice(0, limit)\n .map(block => truncate(extractTextContent(block.content), MAX_TOOL_RESULT_LENGTH));\n}\n\n// --- Turn extraction ---\n\n/** A turn being built, untruncated until `toTurn`. */\nfunction newDraft(userText: string): Turn {\n return { userText, assistantText: '', toolResults: [] };\n}\n\n/** Stops past `MAX_TEXT_LENGTH`, which `toTurn` truncates to anyway. */\nfunction appendAssistantText(draft: Turn, text: string): void {\n if (!text || draft.assistantText.length > MAX_TEXT_LENGTH) return;\n draft.assistantText = draft.assistantText ? `${draft.assistantText}\\n${text}` : text;\n}\n\n/** `cutOffBy` and `responseId` are only ever set to defined values, so the spread adds no undefined keys. */\nfunction toTurn(draft: Turn): Turn | null {\n if (!draft.userText || !draft.assistantText) return null;\n return {\n ...draft,\n userText: truncate(draft.userText, MAX_TEXT_LENGTH),\n assistantText: truncate(draft.assistantText, MAX_TEXT_LENGTH),\n };\n}\n\nfunction readTranscript(transcriptPath: string, maxBytes: number): string | null {\n try {\n return readFileSlice(transcriptPath, maxBytes);\n } catch {\n return null;\n }\n}\n\n/** Reads only the first `maxBytes`, so turns appended after that size are not drawn. Throws on a bad `maxBytes`. */\nexport function extractTurns(transcriptPath: string, maxBytes: number): Turn[] {\n // Outside the read's catch, so a caller that drops the count fails instead of drawing no turns.\n if (!isByteCount(maxBytes)) {\n throw new RangeError(`extractTurns: maxBytes must be a non-negative integer, got ${String(maxBytes)}`);\n }\n const content = readTranscript(transcriptPath, maxBytes);\n if (content === null) return [];\n\n const turns: Turn[] = [];\n let draft = newDraft('');\n const emit = (): void => {\n const turn = toTurn(draft);\n if (turn) turns.push(turn);\n };\n\n for (const entry of parseJsonLines<TranscriptEntry>(content, mayBeConversational)) {\n const rawContent = entry.message?.content;\n const kind = classifyEntry(entry);\n\n if (kind === 'prompt') {\n // Tool output answers the turn in progress, so a tool-result-only entry must not end it.\n const remainingToolSlots = MAX_TOOL_RESULTS_PER_TURN - draft.toolResults.length;\n draft.toolResults.push(...extractToolResults(rawContent, remainingToolSlots));\n const text = extractTextContent(rawContent);\n if (text.trim()) {\n emit();\n draft = newDraft(text);\n }\n } else if (isFailedRequest(entry)) {\n draft.cutOffBy = 'api_error';\n } else if (kind === 'response') {\n appendAssistantText(draft, extractTextContent(rawContent));\n if (entry.message?.id) draft.responseId = entry.message.id;\n }\n // Any other notice (\"No response requested.\") is Claude Code's text, not the model's: the judge never scores it.\n }\n\n emit();\n return turns;\n}\n\n/** Indexes are assigned before filtering, so `turn.index` is a transcript position regardless of what was dropped. */\nexport function sampleTurns(turns: Turn[], maxTurns: number): SampledTurn[] {\n const eligible = turns.flatMap((turn, index) => (turn.cutOffBy ? [] : [{ ...turn, index }]));\n\n if (eligible.length <= maxTurns) return eligible;\n\n // Partial Fisher-Yates: the first `maxTurns` slots end up a uniform sample.\n for (let i = 0; i < maxTurns; i++) {\n const j = i + Math.floor(Math.random() * (eligible.length - i));\n const [picked, displaced] = [eligible[j], eligible[i]];\n if (picked !== undefined && displaced !== undefined) [eligible[i], eligible[j]] = [picked, displaced];\n }\n\n return eligible.slice(0, maxTurns).sort((a, b) => a.index - b.index);\n}\n\nconst TURN_USER_TEXT_HASH_ALGORITHM = 'sha256';\n\n/** Of the truncated `userText`, so the judged turn can be confirmed without storing transcript text. */\nexport function hashTurnUserText(userText: string): string {\n return createHash(TURN_USER_TEXT_HASH_ALGORITHM).update(userText).digest('hex');\n}\n", "/** Judge provider wire formats: endpoints, request bodies, response guards and credential lookup. Orchestration: `llm-judge.ts`. */\n\nimport { isJsonObject } from '../core/file-utils.js';\nimport { bearerHeaders, jsonHeaders } from '../core/http-utils.js';\nimport { DURATION_MS, TIME_MS } from '../core/units.js';\nimport { GENAI_PROVIDER_NAMES } from '../otel/attributes.js';\nimport { providerOfModel } from '../transcript/model-ids.js';\n\nconst JUDGE_MAX_TOKENS = 384;\n\n/** Tuned for Haiku. */\nconst JUDGE_TIMEOUT_MS = DURATION_MS.FIFTEEN_SECONDS;\n\n/** 3\u00D7 the slowest measured reasoning call (grok-4.6, 18.3 s): an abort costs a budget unit and yields no record. */\nconst REASONING_MODEL_TIMEOUT_MS = TIME_MS.MINUTE;\n\n/** One tick is 1e-10 USD (docs.x.ai/developers/cost-tracking). */\nconst XAI_TICKS_PER_USD = 1e10;\nconst ANTHROPIC_MESSAGES_URL = 'https://api.anthropic.com/v1/messages';\nconst ANTHROPIC_VERSION = '2023-06-01';\nconst XAI_CHAT_COMPLETIONS_URL = 'https://api.x.ai/v1/chat/completions';\nconst OPENAI_CHAT_COMPLETIONS_URL = 'https://api.openai.com/v1/chat/completions';\nconst OPENAI_KEY_PREFIX = 'sk-';\n\nconst RESPONSE_SHAPES = {\n ANTHROPIC: 'Anthropic',\n OPENAI_COMPATIBLE: 'OpenAI-compatible',\n} as const;\n\ntype ResponseShape = (typeof RESPONSE_SHAPES)[keyof typeof RESPONSE_SHAPES];\n\nexport type JudgeProvider = (typeof GENAI_PROVIDER_NAMES)[keyof typeof GENAI_PROVIDER_NAMES];\n\nexport interface JudgeResponse {\n text: string;\n inputTokens?: number;\n /** Billed output, reasoning included. */\n outputTokens?: number;\n reasoningTokens?: number;\n /** Provider-reported (OBP18/OBP19); reflects cached and tiered rates no rate card can express. */\n actualCostUsd?: number;\n}\n\nexport interface ProviderSpec {\n url: string;\n /** In precedence order; injected by the evaluator's `doppler run` wrapper (HRF6, JDC1). */\n keyEnvVars: readonly string[];\n /** A candidate without it is skipped, so a misfiled value cannot win the lookup. */\n keyPrefix?: string;\n timeoutMs: number;\n body(model: string, prompt: string): object;\n /** The key travels only through here, never a body, log or span. */\n headers(apiKey: string): Record<string, string>;\n parse(data: unknown): JudgeResponse;\n}\n\ninterface AnthropicResponse {\n content?: Array<{ type: string; text?: string }>;\n usage?: { input_tokens: number; output_tokens: number };\n}\n\n/** Optional fields may arrive as `null`; the guard treats that as absent. */\ninterface OpenAiCompatibleResponse {\n choices?: Array<{ message?: { content?: string | null } | null } | null> | null;\n usage?: {\n prompt_tokens: number;\n completion_tokens: number;\n completion_tokens_details?: { reasoning_tokens?: number | null } | null;\n } | null;\n /** xAI, post-discount, all charges (OBP18). */\n cost_in_usd_ticks?: number | null;\n}\n\n/** Surfaces as `error.type` on the judge span. */\nclass JudgeResponseShapeError extends Error {\n constructor(shape: ResponseShape) {\n super(`judge response does not match the ${shape} shape`);\n this.name = 'JudgeResponseShapeError';\n }\n}\n\nfunction isNumber(value: unknown): value is number {\n return typeof value === 'number';\n}\n\nfunction isString(value: unknown): value is string {\n return typeof value === 'string';\n}\n\nfunction isAbsentOr(value: unknown, check: (present: unknown) => boolean): boolean {\n return value === undefined || value === null || check(value);\n}\n\nfunction isAnthropicContent(value: unknown): boolean {\n if (!Array.isArray(value)) return false;\n const first: unknown = value[0];\n return isAbsentOr(first, (block) => isJsonObject(block) && isAbsentOr(block.text, isString));\n}\n\nfunction isAnthropicUsage(value: unknown): boolean {\n return isJsonObject(value) && isNumber(value.input_tokens) && isNumber(value.output_tokens);\n}\n\nfunction isAnthropicResponse(data: unknown): data is AnthropicResponse {\n return isJsonObject(data)\n && isAbsentOr(data.content, isAnthropicContent)\n && isAbsentOr(data.usage, isAnthropicUsage);\n}\n\nfunction asAnthropicResponse(data: unknown): AnthropicResponse {\n if (!isAnthropicResponse(data)) throw new JudgeResponseShapeError(RESPONSE_SHAPES.ANTHROPIC);\n return data;\n}\n\nfunction isOpenAiMessage(value: unknown): boolean {\n return isJsonObject(value) && isAbsentOr(value.content, isString);\n}\n\nfunction isOpenAiChoices(value: unknown): boolean {\n if (!Array.isArray(value)) return false;\n const first: unknown = value[0];\n return isAbsentOr(first, (choice) => isJsonObject(choice) && isAbsentOr(choice.message, isOpenAiMessage));\n}\n\n/** A string token count would concatenate rather than add and look like a real measurement. */\nfunction isOpenAiUsage(value: unknown): boolean {\n if (!isJsonObject(value)) return false;\n const isDetails = (details: unknown): boolean => isJsonObject(details) && isAbsentOr(details.reasoning_tokens, isNumber);\n return isNumber(value.prompt_tokens)\n && isNumber(value.completion_tokens)\n && isAbsentOr(value.completion_tokens_details, isDetails);\n}\n\nfunction isOpenAiCompatibleResponse(data: unknown): data is OpenAiCompatibleResponse {\n return isJsonObject(data)\n && isAbsentOr(data.choices, isOpenAiChoices)\n && isAbsentOr(data.usage, isOpenAiUsage)\n && isAbsentOr(data.cost_in_usd_ticks, isNumber);\n}\n\nfunction asOpenAiCompatibleResponse(data: unknown): OpenAiCompatibleResponse {\n if (!isOpenAiCompatibleResponse(data)) throw new JudgeResponseShapeError(RESPONSE_SHAPES.OPENAI_COMPATIBLE);\n return data;\n}\n\n/** `outputTokens` is the raw `completion_tokens`, whose meaning differs per provider. */\nfunction parseOpenAiCompatible(payload: OpenAiCompatibleResponse): JudgeResponse {\n return {\n text: payload.choices?.[0]?.message?.content ?? '',\n inputTokens: payload.usage?.prompt_tokens,\n outputTokens: payload.usage?.completion_tokens,\n // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- 0 reasoning tokens maps to undefined\n reasoningTokens: payload.usage?.completion_tokens_details?.reasoning_tokens || undefined,\n };\n}\n\nfunction promptBody(model: string, prompt: string): object {\n return { model, temperature: 0.0, messages: [{ role: 'user', content: prompt }] };\n}\n\n/** Anthropic and xAI cap output with `max_tokens`. */\nfunction maxTokensBody(model: string, prompt: string): object {\n return { ...promptBody(model, prompt), max_tokens: JUDGE_MAX_TOKENS };\n}\n\n/** GPT-5 rejects `max_tokens` and takes `temperature` only with reasoning `'none'`, which also stops reasoning from eating the cap. */\nfunction maxCompletionTokensBody(model: string, prompt: string): object {\n return { ...promptBody(model, prompt), max_completion_tokens: JUDGE_MAX_TOKENS, reasoning_effort: 'none' };\n}\n\nexport const PROVIDER_SPECS: Record<JudgeProvider, ProviderSpec> = {\n [GENAI_PROVIDER_NAMES.ANTHROPIC]: {\n url: ANTHROPIC_MESSAGES_URL,\n timeoutMs: JUDGE_TIMEOUT_MS,\n // Not ANTHROPIC_API_KEY first: Claude Code reads it and drops subscription auth when set.\n // The backup covers a revoked judge key (JUDGE-KEY-401).\n keyEnvVars: ['LLM_JUDGE_ANTHROPIC_KEY', 'ANTHROPIC_API_KEY'],\n body: maxTokensBody,\n headers: (apiKey) => jsonHeaders({ 'x-api-key': apiKey, 'anthropic-version': ANTHROPIC_VERSION }),\n parse: (data) => {\n const payload = asAnthropicResponse(data);\n return {\n text: payload.content?.[0]?.text ?? '',\n inputTokens: payload.usage?.input_tokens,\n outputTokens: payload.usage?.output_tokens,\n };\n },\n },\n [GENAI_PROVIDER_NAMES.XAI]: {\n url: XAI_CHAT_COMPLETIONS_URL,\n timeoutMs: REASONING_MODEL_TIMEOUT_MS,\n keyEnvVars: ['LLM_JUDGE_XAI_KEY', 'XAI_API_KEY'],\n body: maxTokensBody,\n headers: (apiKey) => jsonHeaders(bearerHeaders(apiKey)),\n parse: (data) => {\n const payload = asOpenAiCompatibleResponse(data);\n const base = parseOpenAiCompatible(payload);\n // A `null` cost is unreported, not $0.\n const ticks = payload.cost_in_usd_ticks ?? undefined;\n return {\n ...base,\n // xAI's `completion_tokens` EXCLUDES reasoning (~18\u00D7 under-report alone, Gate 2b).\n outputTokens:\n base.outputTokens === undefined ? undefined : base.outputTokens + (base.reasoningTokens ?? 0),\n actualCostUsd: ticks === undefined ? undefined : ticks / XAI_TICKS_PER_USD,\n };\n },\n },\n [GENAI_PROVIDER_NAMES.OPENAI]: {\n url: OPENAI_CHAT_COMPLETIONS_URL,\n timeoutMs: REASONING_MODEL_TIMEOUT_MS,\n // OPEN_AI_KEY first: OPENAI_API_KEY is a revoked key in Doppler.\n keyEnvVars: ['LLM_JUDGE_OPENAI_KEY', 'OPEN_AI_KEY', 'OPENAI_API_KEY'],\n keyPrefix: OPENAI_KEY_PREFIX,\n body: maxCompletionTokensBody,\n headers: (apiKey) => jsonHeaders(bearerHeaders(apiKey)),\n // OpenAI's `completion_tokens` already INCLUDES reasoning; no per-response cost.\n parse: (data) => parseOpenAiCompatible(asOpenAiCompatibleResponse(data)),\n },\n};\n\nconst JUDGE_PROVIDERS: ReadonlySet<string> = new Set(Object.values(GENAI_PROVIDER_NAMES));\n\nfunction isJudgeProvider(provider: string | undefined): provider is JudgeProvider {\n return provider !== undefined && JUDGE_PROVIDERS.has(provider);\n}\n\n/**\n * Shared provider lookup narrowed to judge providers. No default: routing an unknown model to\n * Anthropic would silently merge Gate 3b's two arms (cf. OBP16).\n */\nexport function providerForModel(model: string): JudgeProvider | undefined {\n const provider = providerOfModel(model);\n return isJudgeProvider(provider) ? provider : undefined;\n}\n\nfunction* keySources(spec: ProviderSpec): Generator<string | undefined, void, undefined> {\n for (const name of spec.keyEnvVars) yield process.env[name];\n}\n\n/**\n * Env vars in precedence order, deduplicated; a 401 moves to the next (JUDGE-KEY-401). Secrets come\n * from the evaluator's `doppler run` wrapper (JDC1), so nothing spawns Doppler in-process.\n */\nexport function* judgeApiKeys(provider: JudgeProvider): Generator<string, void, undefined> {\n const spec = PROVIDER_SPECS[provider];\n const seen = new Set<string>();\n for (const value of keySources(spec)) {\n if (!value || seen.has(value)) continue;\n if (spec.keyPrefix && !value.startsWith(spec.keyPrefix)) continue;\n seen.add(value);\n yield value;\n }\n}\n\n/** The key a call would start with, reading no further; undefined when the provider has none. */\nexport function firstJudgeApiKey(provider: JudgeProvider): string | undefined {\n const first = judgeApiKeys(provider).next();\n return first.done ? undefined : first.value;\n}\n", "/**\n * Judge prompt templates and their verdict parser: one contract, since every template ends with\n * the `Score:` / `Explanation:` format `parseJudgeVerdict` reads.\n */\n\nimport { truncate } from '../core/format-utils.js';\n\nexport interface JudgeTurn {\n userText: string;\n assistantText: string;\n toolResults: string[];\n}\n\nexport const JUDGE_METRIC_NAMES = {\n RELEVANCE: 'relevance',\n COHERENCE: 'coherence',\n} as const;\n\nexport type JudgeMetricName = (typeof JUDGE_METRIC_NAMES)[keyof typeof JUDGE_METRIC_NAMES];\n\n/** Prompt input caps: context bound and injection surface. */\nconst MAX_USER_TEXT_LEN = 500;\nconst MAX_ASSISTANT_TEXT_LEN = 2000;\nconst MAX_REASON_LEN = 400;\nconst MAX_TOOL_RESULTS_IN_PROMPT = 3;\n\nconst JUDGE_SCORE_PATTERN = /Score:\\s*(\\d+(?:\\.\\d+)?)/i;\nconst JUDGE_EXPLANATION_PATTERN = /Explanation:\\s*(.+)/i;\nconst SCORE_PARSE_FAILED = 'llm_judge_score_parse_failed';\n\n/** Score clamped to [0, 1]; reason falls back to the full text. */\nexport function parseJudgeVerdict(text: string): { score: number; reason: string } {\n const scoreText = JUDGE_SCORE_PATTERN.exec(text)?.[1];\n if (scoreText === undefined) throw new Error(SCORE_PARSE_FAILED);\n const score = Math.max(0, Math.min(1, parseFloat(scoreText)));\n const reason = JUDGE_EXPLANATION_PATTERN.exec(text)?.[1]?.trim() || text.trim();\n return { score, reason };\n}\n\nexport function buildJudgePrompt(metricName: JudgeMetricName, turn: JudgeTurn): string {\n return metricName === JUDGE_METRIC_NAMES.RELEVANCE\n ? buildRelevancePrompt(turn)\n : buildCoherencePrompt(turn);\n}\n\nexport function buildExplanationQualityPrompt(\n evaluationName: string,\n score: number,\n reason: string,\n userText: string,\n): string {\n const safeUser = truncate(userText, MAX_USER_TEXT_LEN);\n const safeReason = truncate(reason, MAX_REASON_LEN);\n\n return `You are evaluating the quality of a judge's explanation for an evaluation score.\n\nThe judge evaluated \"${evaluationName}\" and gave a score of ${score.toFixed(2)}.\n\nOriginal user request:\n${safeUser}\n\nJudge's explanation:\n${safeReason}\n\nRate the explanation quality on a scale from 0.0 to 1.0 based on:\n1. Specificity: Does it reference concrete details from the evaluated output?\n2. Evidence citation: Does it quote or paraphrase specific passages as evidence?\n3. Actionability: Does it suggest what could be improved?\n\n- 1.0: Highly specific, cites evidence, actionable\n- 0.7: Specific with some evidence, partially actionable\n- 0.5: General but relevant reasoning\n- 0.3: Vague or generic explanation\n- 0.0: No meaningful reasoning provided\n\nA concise but specific explanation can score highly.\n\nRespond in exactly this format:\nScore: X.XX\nExplanation: [1-2 sentences about the quality of the explanation]`;\n}\n\nfunction buildRelevancePrompt(turn: JudgeTurn): string {\n const safeUser = truncate(turn.userText, MAX_USER_TEXT_LEN);\n const safeAssistant = truncate(turn.assistantText, MAX_ASSISTANT_TEXT_LEN);\n const toolContext = turn.toolResults.length > 0\n ? `\\nTool results used:\\n${turn.toolResults.slice(0, MAX_TOOL_RESULTS_IN_PROMPT).join('\\n---\\n')}`\n : '';\n\n return `You are evaluating the relevance of an AI assistant's response to a user's request.\n\nUser request:\n${safeUser}\n\nAssistant response:\n${safeAssistant}${toolContext}\n\nRate the relevance of the response on a scale from 0.0 to 1.0:\n- 1.0: Perfectly relevant, directly addresses the user's request\n- 0.7: Mostly relevant with minor tangents\n- 0.5: Partially relevant\n- 0.3: Mostly irrelevant\n- 0.0: Completely irrelevant\n\nRespond in exactly this format:\nScore: X.XX\nExplanation: [1-2 sentences citing specific evidence from the response]`;\n}\n\nfunction buildCoherencePrompt(turn: Pick<JudgeTurn, 'assistantText'>): string {\n const safeAssistant = truncate(turn.assistantText, MAX_ASSISTANT_TEXT_LEN);\n\n return `You are evaluating the coherence of an AI assistant's response.\n\nAssistant response:\n${safeAssistant}\n\nRate the coherence on a scale from 0.0 to 1.0:\n- 1.0: Well-structured, clear, logically organized\n- 0.7: Mostly coherent with minor issues\n- 0.5: Somewhat coherent but hard to follow\n- 0.3: Mostly incoherent\n- 0.0: Completely incoherent\n\nRespond in exactly this format:\nScore: X.XX\nExplanation: [1-2 sentences citing specific evidence from the response]`;\n}\n", "/** LLM-as-Judge client: prompt in, `{ score, reason }` out. Providers: `judge-providers.ts`; prompts: `judge-prompts.ts`; spend: `quality-evaluator.ts`. */\n\nimport { errorTypeName } from '../core/format-utils.js';\nimport { errorCode, HTTP_STATUS, isHttpTimeoutError } from '../core/http-utils.js';\nimport { TIME_MS, UNITS } from '../core/units.js';\nimport {\n ERROR_TYPE_ATTR,\n GENAI_AGENT_ATTRIBUTES,\n GENAI_CLIENT_INFERENCE_DURATION_METRIC,\n GENAI_CLIENT_OPERATION_SPAN,\n GENAI_DURATION_BUCKETS_S,\n GENAI_OPERATION,\n GENAI_REQUEST_MODEL_ATTR,\n} from '../otel/attributes.js';\nimport { withSpan, recordMetric, type Span } from '../otel/otel.js';\nimport { recordInferenceCost, recordTokenUsage } from '../otel/token-metrics.js';\nimport { usageCostUsd } from '../transcript/model-pricing.js';\nimport { buildJudgePrompt, parseJudgeVerdict, type JudgeMetricName, type JudgeTurn } from './judge-prompts.js';\nimport {\n judgeApiKeys, PROVIDER_SPECS, providerForModel, type JudgeProvider, type JudgeResponse,\n} from './judge-providers.js';\nimport type { JudgeHttpResponse } from './judge-transport.js';\n\nexport interface JudgeResult {\n score: number;\n reason: string;\n /** For budget true-up (OBP19): provider-reported for xAI, token-computed for Anthropic. Absent on canary. */\n actualCostCents?: number;\n /** The `gen_ai.client.operation` span, for `appendEvaluation` to parent records to (OBP21). Absent on canary. */\n spanContext?: { traceId: string; spanId: string };\n}\n\nconst DEFAULT_JUDGE_MODEL = 'claude-haiku-4-5-20251001';\n\n/** `QUALITY_JUDGE_MODEL` override, read at module load. */\nexport const JUDGE_MODEL = process.env.QUALITY_JUDGE_MODEL || DEFAULT_JUDGE_MODEL;\n\nconst CANARY_SCORE_MIN = 0.2;\nconst CANARY_SCORE_SPAN = 0.3;\nconst CANARY_REASON = 'canary';\n\nconst CENTS_PER_USD = 100;\n\n/** One sample per retry, so a 529 storm is visible rather than reading as slow calls. */\nconst JUDGE_RETRY_METRIC = 'integritystudio.llm_judge.retries';\nconst RETRY_REASON_ATTR = 'integritystudio.llm_judge.retry_reason';\n\nconst REASONING_OUTPUT_TOKENS_ATTR = 'gen_ai.usage.reasoning.output_tokens';\n\nexport class MissingJudgeCredentialError extends Error {\n constructor(readonly provider: JudgeProvider) {\n super(`no api key for judge provider ${provider}`);\n this.name = 'MissingJudgeCredentialError';\n }\n}\n\nexport class UnknownJudgeModelError extends Error {\n constructor(readonly model: string) {\n super(`no judge provider claims model ${model}`);\n this.name = 'UnknownJudgeModelError';\n }\n}\n\nclass JudgeHttpError extends Error {\n constructor(provider: JudgeProvider, readonly status: number) {\n super(`${provider} API error: ${status}`);\n this.name = 'JudgeHttpError';\n }\n}\n\nfunction recordRetry(provider: JudgeProvider, reason: string): void {\n recordMetric(JUDGE_RETRY_METRIC, 1, {\n [GENAI_AGENT_ATTRIBUTES.PROVIDER_NAME]: provider,\n [RETRY_REASON_ATTR]: reason,\n }, { unit: UNITS.RETRY });\n}\n\n/** A transport error reports its code (`ECONNRESET`, `UND_ERR_SOCKET`); anything else its name. */\nfunction judgeErrorType(error: unknown): string {\n if (error instanceof JudgeHttpError) return `http_error_${error.status}`;\n if (!(error instanceof Error)) return 'unknown';\n if (isHttpTimeoutError(error)) return 'timeout';\n return errorCode(error) ?? errorTypeName(error);\n}\n\nfunction elapsedSeconds(startMs: number): number {\n return (Date.now() - startMs) / TIME_MS.SECOND;\n}\n\n/** Provider-reported, else token-based; undefined for an unknown model rather than a guessed rate (OBP19). */\nfunction judgeCostUsd(model: string, usage: JudgeResponse): number | undefined {\n if (usage.actualCostUsd !== undefined) return usage.actualCostUsd;\n if (usage.inputTokens === undefined || usage.outputTokens === undefined) return undefined;\n return usageCostUsd(model, { input: usage.inputTokens, output: usage.outputTokens });\n}\n\n/** Records the call's token and cost counters and returns the cost, undefined when unknown. */\nfunction recordJudgeUsage(span: Span, model: string, provider: JudgeProvider, usage: JudgeResponse): number | undefined {\n const { inputTokens, outputTokens, reasoningTokens } = usage;\n const costUsd = judgeCostUsd(model, usage);\n // Passed in, not re-derived from the model id, so the label is the provider routing chose.\n const labels = {\n model,\n operation: GENAI_OPERATION.EVALUATE,\n attributes: { [GENAI_AGENT_ATTRIBUTES.PROVIDER_NAME]: provider },\n };\n if (inputTokens !== undefined && outputTokens !== undefined) {\n recordTokenUsage({ ...labels, inputTokens, outputTokens, reasoningTokens });\n }\n if (costUsd !== undefined) recordInferenceCost(labels, costUsd);\n // A span attribute, not a metric label: unbounded cardinality.\n if (reasoningTokens !== undefined) span.setAttribute(REASONING_OUTPUT_TOKENS_ATTR, reasoningTokens);\n return costUsd;\n}\n\n/** Transient failures are retried inside `judgePost`; a 401 is not, so it reaches the key fallback here. */\nasync function postWithKeyFallback(\n post: (apiKey: string) => Promise<JudgeHttpResponse>,\n primaryKey: string,\n backupKeys: Iterator<string>,\n): Promise<JudgeHttpResponse> {\n let response = await post(primaryKey);\n while (response.status === HTTP_STATUS.UNAUTHORIZED) {\n const backup = backupKeys.next();\n if (backup.done) break;\n // eslint-disable-next-line no-await-in-loop -- frees the refused response's HTTP/1.1 socket first\n await response.discard();\n // eslint-disable-next-line no-await-in-loop -- backup keys are tried only after the previous key is refused\n response = await post(backup.value);\n }\n return response;\n}\n\n/** Provider derived from the model id, so a model and a credential cannot be mismatched at a call site. */\nexport async function callJudge(\n prompt: string,\n canary: boolean,\n model?: string,\n): Promise<JudgeResult> {\n if (canary) return { score: CANARY_SCORE_MIN + Math.random() * CANARY_SCORE_SPAN, reason: CANARY_REASON };\n\n const resolvedModel = model ?? JUDGE_MODEL;\n const provider = providerForModel(resolvedModel);\n if (!provider) throw new UnknownJudgeModelError(resolvedModel);\n\n const spec = PROVIDER_SPECS[provider];\n const keys = judgeApiKeys(provider);\n const primary = keys.next();\n if (primary.done) throw new MissingJudgeCredentialError(provider);\n\n const genAiAttributes = {\n [GENAI_AGENT_ATTRIBUTES.OPERATION_NAME]: GENAI_OPERATION.CHAT,\n [GENAI_REQUEST_MODEL_ATTR]: resolvedModel,\n [GENAI_AGENT_ATTRIBUTES.PROVIDER_NAME]: provider,\n };\n\n return withSpan(\n GENAI_CLIENT_OPERATION_SPAN,\n genAiAttributes,\n async (span: Span) => {\n // Lazy keeps undici off Stop's startup; before startMs so it is not counted as API latency.\n const { judgePost } = await import('./judge-transport.js');\n const startMs = Date.now();\n let errorType: string | undefined;\n\n try {\n const body = JSON.stringify(spec.body(resolvedModel, prompt));\n const post = (apiKey: string): Promise<JudgeHttpResponse> => judgePost({\n url: spec.url,\n headers: spec.headers(apiKey),\n body,\n timeoutMs: spec.timeoutMs,\n onRetry: (reason) => recordRetry(provider, reason),\n });\n const response = await postWithKeyFallback(post, primary.value, keys);\n\n if (!response.ok) {\n await response.discard();\n throw new JudgeHttpError(provider, response.status);\n }\n\n const usage = spec.parse(await response.json());\n const callCostUsd = recordJudgeUsage(span, resolvedModel, provider, usage);\n const { score, reason } = parseJudgeVerdict(usage.text);\n\n const { traceId, spanId } = span.spanContext();\n const actualCostCents = callCostUsd === undefined ? undefined : callCostUsd * CENTS_PER_USD;\n return { score, reason, actualCostCents, spanContext: { traceId, spanId } };\n } catch (error) {\n errorType = judgeErrorType(error);\n span.setAttribute(ERROR_TYPE_ATTR, errorType);\n throw error;\n } finally {\n const inferenceAttributes = errorType === undefined\n ? genAiAttributes\n : { ...genAiAttributes, [ERROR_TYPE_ATTR]: errorType };\n // HLS34: the full call including parse and pre-status failures; the only duration emitted for inference.\n recordMetric(GENAI_CLIENT_INFERENCE_DURATION_METRIC, elapsedSeconds(startMs), inferenceAttributes, {\n unit: UNITS.SECOND,\n boundaries: GENAI_DURATION_BUCKETS_S.TOOL,\n });\n }\n },\n );\n}\n\nexport async function callLlmJudge(\n metricName: JudgeMetricName,\n turn: JudgeTurn,\n canary: boolean,\n): Promise<JudgeResult> {\n return callJudge(buildJudgePrompt(metricName, turn), canary);\n}\n", "/** Meta-evaluation policy: which judged explanations are re-scored, and by which model (AA3 Gate 3b). */\n\nimport { UNITS } from '../core/units.js';\nimport { GENAI_AGENT_ATTRIBUTES, GENAI_REQUEST_MODEL_ATTR } from '../otel/attributes.js';\nimport { recordMetric } from '../otel/otel.js';\nimport { firstJudgeApiKey, providerForModel } from './judge-providers.js';\nimport { JUDGE_MODEL } from './llm-judge.js';\nimport { QUALITY_ATTRS } from './quality-eval-handoff.js';\nimport { QUALITY_METRIC_NAMES } from './quality-signals.js';\n\nconst META_EVAL_JUDGE_MODEL = process.env.META_EVAL_JUDGE_MODEL || JUDGE_MODEL;\n\n/** Mirrors META_EVAL_SAMPLE_RATE in the toolkit's llm-judge-config.ts. */\nexport const META_EVAL_SAMPLE_RATE = 0.1;\n\n/** `META_EVAL_SAMPLE_RATE` override (AA3 Gate 3b). Invalid values fall back, not clamp, so a typo cannot toggle meta-eval. */\nexport function metaEvalSampleRate(): number {\n const raw = process.env.META_EVAL_SAMPLE_RATE;\n const rate = raw === undefined || raw.trim() === '' ? NaN : Number(raw);\n return Number.isFinite(rate) && rate >= 0 && rate <= 1 ? rate : META_EVAL_SAMPLE_RATE;\n}\n\n/** Must match EXPLANATION_QUALITY_CRITERIA.name in the toolkit. */\nexport const META_EVAL_METRIC_NAME = 'explanation_quality';\n\nexport function shouldMetaEvaluate(evaluationName: string, canary: boolean): boolean {\n if (canary) return false;\n if (evaluationName === META_EVAL_METRIC_NAME) return false;\n return Math.random() < metaEvalSampleRate();\n}\n\n/**\n * `META_EVAL_JUDGE_MODELS`, comma-separated: per-evaluation picks run AA3 Gate 3b's arms over one\n * population. Read at module load; settings.json `env` does not reach hooks, so export it beforehand.\n */\nconst META_EVAL_JUDGE_MODEL_POOL: readonly string[] = (process.env.META_EVAL_JUDGE_MODELS ?? '')\n .split(',')\n .map((model) => model.trim())\n .filter(Boolean);\n\nconst META_EVAL_UNAVAILABLE_REASONS = {\n UNKNOWN_PROVIDER: 'unknown_provider',\n MISSING_CREDENTIAL: 'missing_credential',\n} as const;\n\nfunction recordArmUnavailable(model: string, reason: string, extra: Record<string, string> = {}): void {\n recordMetric(QUALITY_METRIC_NAMES.META_EVAL_ARM_UNAVAILABLE, 1,\n { [GENAI_REQUEST_MODEL_ATTR]: model, [QUALITY_ATTRS.META_EVAL_UNAVAILABLE_REASON]: reason, ...extra },\n { unit: UNITS.FAILURE });\n}\n\n/** Drops and counts unusable arms; one reaching `callJudge` would record nothing and look like slow collection. */\nfunction resolveUsableMetaEvalModels(): readonly string[] {\n const configured = META_EVAL_JUDGE_MODEL_POOL.length > 0\n ? META_EVAL_JUDGE_MODEL_POOL\n : [META_EVAL_JUDGE_MODEL];\n\n const usable: string[] = [];\n for (const model of configured) {\n const provider = providerForModel(model);\n if (!provider) {\n recordArmUnavailable(model, META_EVAL_UNAVAILABLE_REASONS.UNKNOWN_PROVIDER);\n continue;\n }\n if (firstJudgeApiKey(provider) === undefined) {\n recordArmUnavailable(model, META_EVAL_UNAVAILABLE_REASONS.MISSING_CREDENTIAL, { [GENAI_AGENT_ATTRIBUTES.PROVIDER_NAME]: provider });\n continue;\n }\n usable.push(model);\n }\n return usable;\n}\n\n/** Once per process: pool and credentials are fixed, so each unusable arm is counted once. */\nlet usableMetaEvalModels: readonly string[] | undefined;\n\nexport function pickMetaEvalJudgeModel(): string | undefined {\n usableMetaEvalModels ??= resolveUsableMetaEvalModels();\n if (usableMetaEvalModels.length === 0) return undefined;\n const index = Math.floor(Math.random() * usableMetaEvalModels.length);\n return usableMetaEvalModels[index];\n}\n", "/**\n * Post-judge EWMA drift detector mirroring the toolkit's `detectEWMADrift()`. Hooks cannot import the\n * toolkit, so constants are named after their `quality-constants.ts` originals: grep both when retuning.\n * Never feed a canary score here.\n */\n\nimport { join } from 'node:path';\nimport { isJsonObject, loadJsonObject, writeJsonAtomic } from '../core/file-utils.js';\nimport { UNITS } from '../core/units.js';\nimport { SESSION_ATTRIBUTES } from '../otel/attributes.js';\nimport { EVALUATION_ATTRS } from '../otel/evaluation-attrs.js';\nimport { addEvent, recordCounter } from '../otel/otel.js';\nimport { qualityStateDir } from '../session/session-state.js';\nimport { QUALITY_ATTRS } from './quality-eval-handoff.js';\n\nconst POST_JUDGE_RECENT_SCORES_LIMIT = 20;\n/** Consecutive drifting checks that confirm degradation */\nconst POST_JUDGE_BREACH_CONFIRMATION = 2;\nconst POST_JUDGE_EWMA_LAMBDA = 0.1;\n/** Toolkit `EWMA_DRIFT_MAD_MULTIPLE` \u2014 drift when |EWMA \u2212 baseline mean| > k \u00D7 MAD */\nconst POST_JUDGE_DRIFT_MAD_MULTIPLE = 2;\n/** Toolkit `EWMA_DRIFT_MIN_VALUES` \u2014 scores required before the detector runs */\nconst POST_JUDGE_MIN_SCORES = 5;\n/** Toolkit `EWMA_BASELINE_FRACTION` \u2014 leading share of the window treated as baseline */\nconst POST_JUDGE_BASELINE_FRACTION = 0.7;\nconst POST_JUDGE_BASELINE_MIN_POINTS = 3;\n/** Toolkit `EWMA_RANGE_FALLBACK_RATIO` \u2014 used when the baseline has no spread (MAD = 0) */\nconst POST_JUDGE_RANGE_FALLBACK_RATIO = 0.1;\n/** Toolkit `MAD_CONSISTENCY_FACTOR` \u2014 scales MAD to a normal-equivalent sigma */\nconst POST_JUDGE_MAD_CONSISTENCY_FACTOR = 1.4826;\nconst DEGRADATION_STATE_FILENAME = 'degradation.json';\n\nfunction degradationStatePath(): string {\n return join(qualityStateDir(), DEGRADATION_STATE_FILENAME);\n}\n\nexport const DEGRADATION_CHECK_METRIC = 'integritystudio.quality.degradation_check';\nexport const DEGRADATION_CONFIRMED_EVENT = 'integritystudio.quality.degradation_confirmed';\n\ntype DegradationStatus = 'healthy' | 'warning' | 'critical';\n\nexport interface DegradationCheckResult {\n status: DegradationStatus;\n consecutiveBreaches: number;\n}\n\nexport interface DegradationScore {\n metricName: string;\n score: number;\n}\n\ninterface DegradationHooksState {\n consecutiveBreaches: Record<string, number>;\n /** Oldest first */\n recentScores: Record<string, number[]>;\n lastUpdated: string;\n}\n\n/** Anything not of the expected shape is dropped, so a torn write costs one window's history, never the hook. */\nfunction loadDegradationHooksState(): DegradationHooksState {\n const state: DegradationHooksState = { consecutiveBreaches: {}, recentScores: {}, lastUpdated: '' };\n const raw = loadJsonObject(degradationStatePath());\n if (!raw) return state;\n if (isJsonObject(raw.recentScores)) {\n for (const [metric, scores] of Object.entries(raw.recentScores)) {\n if (Array.isArray(scores)) {\n state.recentScores[metric] = scores.filter((s): s is number => typeof s === 'number');\n }\n }\n }\n if (isJsonObject(raw.consecutiveBreaches)) {\n for (const [metric, count] of Object.entries(raw.consecutiveBreaches)) {\n if (typeof count === 'number') state.consecutiveBreaches[metric] = count;\n }\n }\n return state;\n}\n\nfunction saveDegradationHooksState(state: DegradationHooksState): void {\n // Atomic: concurrent sessions share this file.\n writeJsonAtomic(degradationStatePath(), state, { silent: true });\n}\n\nconst ascending = (a: number, b: number): number => a - b;\n\nfunction median(sortedValues: number[]): number {\n const mid = Math.floor(sortedValues.length / 2);\n const upper = sortedValues[mid] ?? Number.NaN;\n if (sortedValues.length % 2 !== 0) return upper;\n return ((sortedValues[mid - 1] ?? Number.NaN) + upper) / 2;\n}\n\n/** Toolkit `computeMAD` \u2014 median absolute deviation, normal-consistency scaled */\nfunction scaledMAD(values: number[]): number {\n const center = median([...values].sort(ascending));\n const deviations = values.map((v) => Math.abs(v - center)).sort(ascending);\n return median(deviations) * POST_JUDGE_MAD_CONSISTENCY_FACTOR;\n}\n\n/** Toolkit `computeEWMA`. At \u03BB = 0.1 a sharp late drop is damped: fewer false positives, slower detection. */\nfunction ewma(values: number[]): number {\n const [first = Number.NaN, ...rest] = values;\n let smoothed = first;\n for (const value of rest) {\n smoothed = POST_JUDGE_EWMA_LAMBDA * value + (1 - POST_JUDGE_EWMA_LAMBDA) * smoothed;\n }\n return smoothed;\n}\n\n/** Toolkit `detectEWMADrift`: EWMA more than k \u00D7 MAD from the baseline mean, or past the range fallback when the baseline has no spread. */\nfunction detectDrift(values: number[]): boolean {\n if (values.length < POST_JUDGE_MIN_SCORES) return false;\n const baselineEnd = Math.max(\n POST_JUDGE_BASELINE_MIN_POINTS,\n Math.floor(values.length * POST_JUDGE_BASELINE_FRACTION),\n );\n const baseline = values.slice(0, baselineEnd);\n const baselineMean = baseline.reduce((sum, v) => sum + v, 0) / baseline.length;\n const deviation = Math.abs(ewma(values) - baselineMean);\n const mad = scaledMAD(baseline);\n if (mad === 0) {\n const range = Math.max(...values) - Math.min(...values);\n return range > 0 && deviation > POST_JUDGE_RANGE_FALLBACK_RATIO * range;\n }\n return deviation > POST_JUDGE_DRIFT_MAD_MULTIPLE * mad;\n}\n\n/** Appends the score to its metric's window and classifies it; null while the window fills. */\nfunction applyScore(state: DegradationHooksState, { metricName, score }: DegradationScore): DegradationCheckResult | null {\n const scores = [...(state.recentScores[metricName] ?? []), score].slice(-POST_JUDGE_RECENT_SCORES_LIMIT);\n state.recentScores[metricName] = scores;\n if (scores.length < POST_JUDGE_MIN_SCORES) return null;\n\n const drifting = detectDrift(scores);\n const consecutiveBreaches = drifting ? (state.consecutiveBreaches[metricName] ?? 0) + 1 : 0;\n state.consecutiveBreaches[metricName] = consecutiveBreaches;\n if (!drifting) return { status: 'healthy', consecutiveBreaches };\n const confirmed = consecutiveBreaches >= POST_JUDGE_BREACH_CONFIRMATION;\n return { status: confirmed ? 'critical' : 'warning', consecutiveBreaches };\n}\n\nfunction emitDrift(metricName: string, { status, consecutiveBreaches }: DegradationCheckResult, sessionId: string): void {\n const confirmed = status === 'critical';\n recordCounter(DEGRADATION_CHECK_METRIC, 1, {\n [EVALUATION_ATTRS.NAME]: metricName,\n [QUALITY_ATTRS.STATUS]: status,\n [QUALITY_ATTRS.CONFIRMED]: confirmed,\n [SESSION_ATTRIBUTES.SESSION_ID]: sessionId,\n }, { unit: UNITS.CHECK });\n // Lands on the evaluator's T2 span; a no-op without an active span.\n if (confirmed) {\n addEvent(DEGRADATION_CONFIRMED_EVENT, {\n [QUALITY_ATTRS.METRIC_NAME]: metricName,\n [QUALITY_ATTRS.STATUS]: status,\n [QUALITY_ATTRS.CONSECUTIVE_BREACHES]: consecutiveBreaches,\n [QUALITY_ATTRS.DRIFT_DETECTED]: true,\n [QUALITY_ATTRS.CONFIRMED]: true,\n [SESSION_ATTRIBUTES.SESSION_ID]: sessionId,\n });\n }\n}\n\n/**\n * One drift is `warning`; POST_JUDGE_BREACH_CONFIRMATION in a row is `critical` and emits the\n * confirmed event. One state read/write per batch, applied in array order. An entry is null while its\n * window fills or for a non-finite score (never stored); all null on failure. Never throws.\n */\nexport function checkPostJudgeDegradationBatch(\n entries: readonly DegradationScore[],\n sessionId: string,\n): Array<DegradationCheckResult | null> {\n const nothing = entries.map((): DegradationCheckResult | null => null);\n if (!entries.some(({ score }) => Number.isFinite(score))) return nothing;\n try {\n const state = loadDegradationHooksState();\n const results = entries.map((entry) => (Number.isFinite(entry.score) ? applyScore(state, entry) : null));\n state.lastUpdated = new Date().toISOString();\n saveDegradationHooksState(state);\n entries.forEach(({ metricName }, index) => {\n const result = results[index];\n if (result && result.status !== 'healthy') emitDrift(metricName, result, sessionId);\n });\n return results;\n } catch {\n return nothing;\n }\n}\n", "/**\n * Detached T2 evaluator (`hook-runner evaluate-quality`, HDF3): scores sampled turns for relevance and\n * coherence, meta-evaluates some explanations, writes metrics and evaluation events. Every paid call\n * reserves budget first and releases on throw (HRV5).\n */\n\nimport { HOOK_EVENT_NAMES } from '../core/constants.js';\nimport { UNITS } from '../core/units.js';\nimport { SESSION_ATTRIBUTES, HOOK_NAMES, HOOK_TYPE_ATTR, HOOK_TRIGGER_ATTR } from '../otel/attributes.js';\nimport { EVALUATION_ATTRS } from '../otel/evaluation-attrs.js';\nimport { instrumentHook, setSessionId, shutdownTelemetry } from '../otel/otel-monitor.js';\nimport { recordMetric } from '../otel/otel.js';\nimport { spawnTelemetryShipper } from '../shipper/telemetry-shipper.js';\nimport { extractTurns, hashTurnUserText, sampleTurns, type SampledTurn } from '../transcript/transcript-parser.js';\nimport { META_EVAL_METRIC_NAME, pickMetaEvalJudgeModel, shouldMetaEvaluate } from './judge-meta-eval.js';\nimport { buildExplanationQualityPrompt, JUDGE_METRIC_NAMES, type JudgeMetricName } from './judge-prompts.js';\nimport { callJudge, callLlmJudge, type JudgeResult } from './llm-judge.js';\nimport { getBudgetUsage, tryReserveBudget, releaseBudget, trueUpBudget, COST_PER_METRIC_CENTS } from './quality-budget.js';\nimport { checkPostJudgeDegradationBatch, type DegradationScore } from './quality-degradation.js';\nimport {\n parseEvaluationArgs, QUALITY_ATTRS, QUALITY_EVAL_SKIP_REASONS, QUALITY_EVAL_TYPE_LLM, QUALITY_EVALUATION_HOOK_TYPE,\n} from './quality-eval-handoff.js';\nimport { SAMPLING_CONFIG } from './quality-sampler.js';\nimport {\n emitEvaluationLatency, appendEvaluation, QUALITY_METRIC_NAMES,\n EVALUATOR_KIND, EVALUATION_COHORT,\n type EvaluationCohort, type JudgedTurnRef,\n} from './quality-signals.js';\n\n\n/** Order is load-bearing: it fixes reservation order and the order scores reach the drift window. */\nconst BASE_JUDGE_METRICS: readonly JudgeMetricName[] = [JUDGE_METRIC_NAMES.RELEVANCE, JUDGE_METRIC_NAMES.COHERENCE];\n\nconst BASE_JUDGE_METRIC_KEYS: Record<JudgeMetricName, string> = {\n [JUDGE_METRIC_NAMES.RELEVANCE]: QUALITY_METRIC_NAMES.LLM_RELEVANCE,\n [JUDGE_METRIC_NAMES.COHERENCE]: QUALITY_METRIC_NAMES.LLM_COHERENCE,\n};\n\nconst PRODUCER = 'hook:stop-quality-evaluation';\n\n/** Drains the SDK before returning: metrics are collected only at meter shutdown. False on malformed args. */\nexport async function runEvaluationHandoff(args: readonly string[]): Promise<boolean> {\n const record = parseEvaluationArgs(args);\n if (!record) return false;\n setSessionId(record.sessionId);\n try {\n const allTurns = extractTurns(record.transcriptPath, record.transcriptBytes);\n await evaluateTurns({\n sessionId: record.sessionId,\n canary: record.canary,\n turns: sampleTurns(allTurns, SAMPLING_CONFIG.MAX_TURNS_PER_SESSION),\n turnsTotal: allTurns.length,\n });\n return true;\n } finally {\n await shutdownTelemetry();\n // Ships now, not at the next Stop (HDF12).\n spawnTelemetryShipper();\n }\n}\n\ninterface EvaluationSample {\n sessionId: string;\n canary: boolean;\n turns: SampledTurn[];\n turnsTotal: number;\n}\n\n/** Never throws: a judge failure is counted, not raised. */\nasync function evaluateTurns(session: EvaluationSample): Promise<void> {\n const { sessionId, canary, turns } = session;\n\n await instrumentHook(HOOK_NAMES.QUALITY_EVALUATION, async (ctx) => {\n const startMs = Date.now();\n\n ctx.addAttributes({\n [SESSION_ATTRIBUTES.SESSION_ID]: sessionId,\n [QUALITY_ATTRS.EVAL_TYPE]: QUALITY_EVAL_TYPE_LLM,\n [QUALITY_ATTRS.CANARY]: canary,\n [QUALITY_ATTRS.TURNS_SAMPLED]: turns.length,\n [QUALITY_ATTRS.TURNS_TOTAL]: session.turnsTotal,\n });\n\n try {\n if (turns.length === 0) {\n ctx.addAttribute(QUALITY_ATTRS.EVAL_SKIPPED_REASON, QUALITY_EVAL_SKIP_REASONS.NO_TURNS);\n return;\n }\n\n // Concurrent; each reserves before its first await, so budget is granted in launch order.\n const calls = turns.flatMap((turn) => (\n BASE_JUDGE_METRICS.map((metricName) => ({ turn, metricName }))\n ));\n const results = await Promise.all(calls.map(\n ({ turn, metricName }) => reservedJudgeCall(\n () => callLlmJudge(metricName, turn, canary), metricName, sessionId,\n ),\n ));\n\n // Launch order: the drift window is order-sensitive. Scores are unitless 0\u20131 indexes\n // (pinned by metric-units.test.ts).\n const pendingMetaEvals: Array<() => Promise<boolean>> = [];\n const driftScores: DegradationScore[] = [];\n for (const [index, { turn, metricName }] of calls.entries()) {\n const result = results[index];\n if (!result) continue;\n\n // Indexed inline so metric-units.test.ts can resolve the metric name from source.\n recordMetric(BASE_JUDGE_METRIC_KEYS[metricName], result.score, judgeScoreAttrs(session));\n appendJudgeEvaluation(session, { name: metricName, result, turnRef: turnRefOf(turn) });\n driftScores.push({ metricName: BASE_JUDGE_METRIC_KEYS[metricName], score: result.score });\n\n pendingMetaEvals.push(() => maybeMetaEvaluate(session, metricName, result, turn));\n }\n\n // NORMAL cohort only: a canary's random score would manufacture the degradation the check exists to detect.\n if (!canary) checkPostJudgeDegradationBatch(driftScores, sessionId);\n\n // Thunks, so none starts before every base score above is written in order.\n const metaEvalsRan = await Promise.all(pendingMetaEvals.map((run) => run()));\n ctx.addAttribute(QUALITY_ATTRS.META_EVALS_RUN, metaEvalsRan.filter(Boolean).length);\n } finally {\n const durationMs = Date.now() - startMs;\n emitEvaluationLatency(durationMs, HOOK_NAMES.QUALITY_EVALUATION);\n ctx.addAttribute(QUALITY_ATTRS.EVAL_DURATION_MS, durationMs);\n\n const budget = getBudgetUsage();\n ctx.addAttribute(QUALITY_ATTRS.BUDGET_USED_CENTS, budget.estimatedCostCents);\n ctx.addAttribute(QUALITY_ATTRS.BUDGET_REMAINING_CENTS, budget.remaining);\n }\n }, { [HOOK_TRIGGER_ATTR]: HOOK_EVENT_NAMES.stop, [HOOK_TYPE_ATTR]: QUALITY_EVALUATION_HOOK_TYPE });\n}\n\n/**\n * Reserve, call, release on throw; null when refused or failed. Reserves before the first `await`, so\n * launches are granted in order; `onResult` runs inside the try, so a recording throw also releases.\n */\nasync function reservedJudgeCall(\n call: () => Promise<JudgeResult>,\n evaluationName: string,\n sessionId: string,\n onResult?: (result: JudgeResult) => void,\n): Promise<JudgeResult | null> {\n if (!tryReserveBudget(COST_PER_METRIC_CENTS)) return null;\n try {\n const result = await call();\n if (result.actualCostCents !== undefined) {\n trueUpBudget(result.actualCostCents, COST_PER_METRIC_CENTS);\n }\n onResult?.(result);\n return result;\n } catch {\n releaseBudget(COST_PER_METRIC_CENTS);\n recordMetric(QUALITY_METRIC_NAMES.LLM_JUDGE_FAILURES, 1, { [SESSION_ATTRIBUTES.SESSION_ID]: sessionId, [EVALUATION_ATTRS.NAME]: evaluationName }, { unit: UNITS.FAILURE });\n return null;\n }\n}\n\n/** From the flag that produced the score: canary scores are random and must not record as NORMAL (OBP16). */\nfunction cohortFor(canary: boolean): EvaluationCohort {\n return canary ? EVALUATION_COHORT.CANARY : EVALUATION_COHORT.NORMAL;\n}\n\ntype SessionScope = Pick<EvaluationSample, 'sessionId' | 'canary'>;\n\nfunction turnRefOf(turn: SampledTurn): JudgedTurnRef {\n return {\n index: turn.index,\n userTextHash: hashTurnUserText(turn.userText),\n ...(turn.responseId && { responseId: turn.responseId }),\n };\n}\n\nfunction judgeScoreAttrs({ sessionId, canary }: SessionScope): Record<string, string> {\n return {\n [EVALUATION_ATTRS.EVALUATOR_KIND]: EVALUATOR_KIND.LLM,\n [EVALUATION_ATTRS.COHORT]: cohortFor(canary),\n [SESSION_ATTRIBUTES.SESSION_ID]: sessionId,\n };\n}\n\ninterface JudgeScore {\n name: string;\n result: JudgeResult;\n turnRef: JudgedTurnRef;\n extraAttributes?: Record<string, string>;\n}\n\nfunction appendJudgeEvaluation(\n { sessionId, canary }: SessionScope,\n { name, result, turnRef, extraAttributes }: JudgeScore,\n): void {\n appendEvaluation({\n name,\n score: result.score,\n kind: EVALUATOR_KIND.LLM,\n cohort: cohortFor(canary),\n producer: PRODUCER,\n sessionId,\n judgeSpan: result.spanContext,\n turn: turnRef,\n explanation: result.reason,\n extraAttributes,\n });\n}\n\n/** Whether a meta-eval score was recorded. */\nasync function maybeMetaEvaluate(\n session: SessionScope,\n evaluationName: string,\n result: JudgeResult,\n turn: SampledTurn,\n): Promise<boolean> {\n const { sessionId, canary } = session;\n if (!shouldMetaEvaluate(evaluationName, canary)) return false;\n\n // Before the reservation, so an unusable arm consumes no spend.\n const metaModel = pickMetaEvalJudgeModel();\n if (!metaModel) return false;\n\n const scored = await reservedJudgeCall(\n () => callJudge(\n buildExplanationQualityPrompt(evaluationName, result.score, result.reason, turn.userText),\n false,\n metaModel,\n ),\n META_EVAL_METRIC_NAME,\n sessionId,\n (metaResult) => {\n const original = { [EVALUATION_ATTRS.META_ORIGINAL_EVALUATION]: evaluationName };\n recordMetric(QUALITY_METRIC_NAMES.LLM_EXPLANATION_QUALITY, metaResult.score, {\n ...judgeScoreAttrs(session),\n ...original,\n });\n appendJudgeEvaluation(session, {\n name: META_EVAL_METRIC_NAME,\n result: metaResult,\n turnRef: turnRefOf(turn),\n extraAttributes: original,\n });\n },\n );\n return scored !== null;\n}\n"],
5
+ "mappings": "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",
6
+ "names": ["reason"]
7
+ }
@@ -0,0 +1,57 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ spawnTelemetryShipper
5
+ } from "./chunk-UEXDE3WP.js";
6
+ import "./chunk-JRNNLOPR.js";
7
+ import "./chunk-YGFN3LN2.js";
8
+ import "./chunk-IJ4SLUBV.js";
9
+ import {
10
+ boundedLabel
11
+ } from "./chunk-VXFSLM6P.js";
12
+ import {
13
+ instrumentHook
14
+ } from "./chunk-WU7ANGCW.js";
15
+ import {
16
+ HOOK_NAMES,
17
+ HOOK_TYPE_ATTR,
18
+ SESSION_ATTRIBUTES
19
+ } from "./chunk-7OM5CYES.js";
20
+ import "./chunk-GG2I4TGI.js";
21
+ import "./chunk-SRMAJQMV.js";
22
+ import "./chunk-YHYDBLVB.js";
23
+ import "./chunk-DNSTWC26.js";
24
+ import "./chunk-52RY6LQT.js";
25
+ import {
26
+ UNITS
27
+ } from "./chunk-RWRGC7ZK.js";
28
+ import "./chunk-7PEOKGYR.js";
29
+ import "./chunk-GNNKUMRF.js";
30
+
31
+ // handlers/session-end.ts
32
+ var SESSION_END_REASONS = /* @__PURE__ */ new Set([
33
+ "clear",
34
+ "resume",
35
+ "logout",
36
+ "prompt_input_exit",
37
+ "other"
38
+ ]);
39
+ var END_REASON_ATTR = "integritystudio.session.end_reason";
40
+ async function handleSessionEnd(input) {
41
+ await instrumentHook(HOOK_NAMES.SESSION_END, (ctx) => {
42
+ const raw = input.reason ?? "";
43
+ const reason = boundedLabel(raw, SESSION_END_REASONS);
44
+ ctx.addAttributes({
45
+ [END_REASON_ATTR]: reason,
46
+ "integritystudio.session.end_reason_raw": raw
47
+ });
48
+ ctx.logger.info("Session ended", { [END_REASON_ATTR]: reason });
49
+ ctx.recordMetric("integritystudio.session.ends", 1, { [END_REASON_ATTR]: reason }, { unit: UNITS.SESSION });
50
+ ctx.recordEvent("session.end", { [SESSION_ATTRIBUTES.SESSION_ID]: input.session_id });
51
+ spawnTelemetryShipper();
52
+ }, { [HOOK_TYPE_ATTR]: "session" });
53
+ }
54
+ export {
55
+ handleSessionEnd
56
+ };
57
+ //# sourceMappingURL=session-end-3MJTDLLA.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../handlers/session-end.ts"],
4
+ "sourcesContent": ["/**\n * SessionEnd (CCH4): record the end reason and spawn the shipper so spans after\n * the final turn are not left for the next session's first Stop.\n *\n * Hard budget: Claude Code runs the whole SessionEnd phase under one `timeoutMs`\n * shared by every registered hook, 1500 ms unless raised by\n * `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` (CONFIG.md \u00A7 Register Hooks). Nothing\n * network-bound or transcript-sized belongs here; put it in `stop.ts`.\n */\n\nimport { boundedLabel } from '../lib/core/bounded-label.js';\nimport { UNITS } from '../lib/core/units.js';\nimport { HOOK_NAMES, HOOK_TYPE_ATTR, SESSION_ATTRIBUTES } from '../lib/otel/attributes.js';\nimport { instrumentHook } from '../lib/otel/otel-monitor.js';\nimport type { SessionEndHookInput } from '../lib/runtime/hook-input.js';\nimport { spawnTelemetryShipper } from '../lib/shipper/telemetry-shipper.js';\n\n/** Claude Code's `reason` enum as of 2.1.319; anything else is labeled `other`. */\nconst SESSION_END_REASONS = new Set([\n 'clear',\n 'resume',\n 'logout',\n 'prompt_input_exit',\n 'other',\n]);\n\nconst END_REASON_ATTR = 'integritystudio.session.end_reason';\n\nexport async function handleSessionEnd(input: SessionEndHookInput): Promise<void> {\n await instrumentHook(HOOK_NAMES.SESSION_END, (ctx) => {\n const raw = input.reason ?? '';\n // Bounded in the metric, raw on the span, so payload drift is visible without a new series.\n const reason = boundedLabel(raw, SESSION_END_REASONS);\n\n ctx.addAttributes({\n [END_REASON_ATTR]: reason,\n 'integritystudio.session.end_reason_raw': raw,\n });\n\n ctx.logger.info('Session ended', { [END_REASON_ATTR]: reason });\n\n ctx.recordMetric('integritystudio.session.ends', 1, { [END_REASON_ATTR]: reason }, { unit: UNITS.SESSION });\n\n // OBP12: unlike session.start, no previous_id on end.\n ctx.recordEvent('session.end', { [SESSION_ATTRIBUTES.SESSION_ID]: input.session_id });\n\n spawnTelemetryShipper();\n }, { [HOOK_TYPE_ATTR]: 'session' });\n}\n"],
5
+ "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,IAAM,sBAAsB,oBAAI,IAAI;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,IAAM,kBAAkB;AAExB,eAAsB,iBAAiB,OAA2C;AAChF,QAAM,eAAe,WAAW,aAAa,CAAC,QAAQ;AACpD,UAAM,MAAM,MAAM,UAAU;AAE5B,UAAM,SAAS,aAAa,KAAK,mBAAmB;AAEpD,QAAI,cAAc;AAAA,MAChB,CAAC,eAAe,GAAG;AAAA,MACnB,0CAA0C;AAAA,IAC5C,CAAC;AAED,QAAI,OAAO,KAAK,iBAAiB,EAAE,CAAC,eAAe,GAAG,OAAO,CAAC;AAE9D,QAAI,aAAa,gCAAgC,GAAG,EAAE,CAAC,eAAe,GAAG,OAAO,GAAG,EAAE,MAAM,MAAM,QAAQ,CAAC;AAG1G,QAAI,YAAY,eAAe,EAAE,CAAC,mBAAmB,UAAU,GAAG,MAAM,WAAW,CAAC;AAEpF,0BAAsB;AAAA,EACxB,GAAG,EAAE,CAAC,cAAc,GAAG,UAAU,CAAC;AACpC;",
6
+ "names": []
7
+ }
@@ -0,0 +1,352 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ shouldSampleSession
5
+ } from "./chunk-PJHWHJ3K.js";
6
+ import {
7
+ trackSessionContext,
8
+ trackSessionContextFast
9
+ } from "./chunk-FDJJ3TYU.js";
10
+ import "./chunk-XSO3B4QN.js";
11
+ import "./chunk-X7XLMSZX.js";
12
+ import "./chunk-4KWBQTTG.js";
13
+ import {
14
+ resetFailureTracking
15
+ } from "./chunk-IY7AP7NA.js";
16
+ import {
17
+ activeTaskCompletion
18
+ } from "./chunk-KGSA5JYP.js";
19
+ import {
20
+ formatShipperWarning,
21
+ isShipperHealthy,
22
+ readShipperStatus
23
+ } from "./chunk-YGFN3LN2.js";
24
+ import "./chunk-IJ4SLUBV.js";
25
+ import "./chunk-LQ2LGUYJ.js";
26
+ import {
27
+ writePlainContext
28
+ } from "./chunk-2NTNAJZE.js";
29
+ import {
30
+ instrumentHook,
31
+ persistSpanContext,
32
+ recordSessionPredecessor,
33
+ saveSessionContext
34
+ } from "./chunk-WU7ANGCW.js";
35
+ import {
36
+ CONTEXT_ATTRIBUTES,
37
+ GIT_ATTRIBUTES,
38
+ HOOK_NAMES,
39
+ HOOK_TYPE_ATTR,
40
+ PROCESS_ATTRIBUTES,
41
+ SESSION_ATTRIBUTES,
42
+ VCS_ATTRIBUTES
43
+ } from "./chunk-7OM5CYES.js";
44
+ import {
45
+ probeGitStatus,
46
+ readHeadBranch,
47
+ splitOwnerRepo
48
+ } from "./chunk-GG2I4TGI.js";
49
+ import "./chunk-SRMAJQMV.js";
50
+ import {
51
+ TRANSCRIPT_PROJECT_SLUG_PATTERN
52
+ } from "./chunk-YHYDBLVB.js";
53
+ import {
54
+ clearSession
55
+ } from "./chunk-I7TD2QVR.js";
56
+ import {
57
+ CONVERSATION_ID_ENV,
58
+ conversationIdOf,
59
+ saveCurrentSessionId,
60
+ saveSessionStartBranch
61
+ } from "./chunk-DNSTWC26.js";
62
+ import {
63
+ GIT_TIMEOUT_MS,
64
+ THRESHOLDS,
65
+ loadJson,
66
+ readdirOrEmpty,
67
+ writeStderr
68
+ } from "./chunk-52RY6LQT.js";
69
+ import {
70
+ PERCENT_PER_UNIT,
71
+ TIME_MS,
72
+ UNITS,
73
+ formatPercent
74
+ } from "./chunk-RWRGC7ZK.js";
75
+ import "./chunk-7PEOKGYR.js";
76
+ import "./chunk-GNNKUMRF.js";
77
+
78
+ // handlers/session-start.ts
79
+ import * as fs from "node:fs";
80
+ import * as os from "node:os";
81
+ import * as path from "node:path";
82
+
83
+ // lib/runtime/hook-input.ts
84
+ var SESSION_START_SOURCE = {
85
+ STARTUP: "startup",
86
+ RESUME: "resume",
87
+ CLEAR: "clear",
88
+ COMPACT: "compact",
89
+ FORK: "fork"
90
+ };
91
+
92
+ // lib/session/handoffs.ts
93
+ import { statSync } from "node:fs";
94
+ import { join } from "node:path";
95
+ var HANDOFF_DIR = join("docs", "handoffs");
96
+ var MAX_PARENT_LEVELS = 3;
97
+ var MAX_HANDOFFS = 5;
98
+ var STALE_HANDOFF_DAYS = 14;
99
+ function findHandoffDir(startDir) {
100
+ let cur = startDir;
101
+ for (let level = 0; level <= MAX_PARENT_LEVELS; level++) {
102
+ const dir = join(cur, HANDOFF_DIR);
103
+ try {
104
+ if (statSync(dir).isDirectory()) {
105
+ return { dir, prefix: "../".repeat(level) };
106
+ }
107
+ } catch {
108
+ }
109
+ const parent = join(cur, "..");
110
+ if (parent === cur) break;
111
+ cur = parent;
112
+ }
113
+ return null;
114
+ }
115
+ function findPendingHandoffs(startDir, now = Date.now()) {
116
+ const found = findHandoffDir(startDir);
117
+ if (!found) return [];
118
+ const handoffs = [];
119
+ for (const name of readdirOrEmpty(found.dir)) {
120
+ if (!name.endsWith(".md")) continue;
121
+ try {
122
+ const { mtimeMs } = statSync(join(found.dir, name));
123
+ handoffs.push({
124
+ path: `${found.prefix}${HANDOFF_DIR}/${name}`,
125
+ ageDays: Math.floor((now - mtimeMs) / TIME_MS.DAY),
126
+ mtimeMs
127
+ });
128
+ } catch {
129
+ }
130
+ }
131
+ return handoffs.sort((a, b) => b.mtimeMs - a.mtimeMs).slice(0, MAX_HANDOFFS).map(({ path: path2, ageDays }) => ({ path: path2, ageDays }));
132
+ }
133
+ function formatHandoffBanner(handoffs) {
134
+ if (handoffs.length === 0) return [];
135
+ const lines = ["", `Pending handoff${handoffs.length === 1 ? "" : "s"} from a previous session:`];
136
+ for (const { path: path2, ageDays } of handoffs) {
137
+ const age = ageDays === 0 ? "today" : `${ageDays}d old`;
138
+ const stale = ageDays >= STALE_HANDOFF_DAYS ? " \u2014 stale, confirm it is still wanted" : "";
139
+ lines.push(` ${path2} (${age})${stale}`);
140
+ }
141
+ lines.push("Read these before other work, then propose next steps and confirm with the user.");
142
+ return lines;
143
+ }
144
+
145
+ // handlers/session-start.ts
146
+ var CONTEXT_BANNER_MIN_TOKENS = 1e4;
147
+ var TOKENS_PER_MILLION = 1e6;
148
+ var TOKENS_PER_THOUSAND = 1e3;
149
+ var FULL_UTILIZATION_PERCENT = PERCENT_PER_UNIT;
150
+ var UTILIZATION_HIGH_PERCENT = 70;
151
+ var UTILIZATION_WARN_PERCENT = 50;
152
+ var DEFAULT_ACTIVE_TASKS_SUBDIR = path.join("dev", "active");
153
+ var UNKNOWN_PROJECT_NAME = "unknown";
154
+ var CONTINUING_SOURCES = /* @__PURE__ */ new Set([SESSION_START_SOURCE.RESUME, SESSION_START_SOURCE.FORK]);
155
+ var isFreshStart = (source) => source === void 0 || source === SESSION_START_SOURCE.STARTUP;
156
+ var continuesTranscript = (source) => source !== void 0 && CONTINUING_SOURCES.has(source);
157
+ async function handleSessionStart(input) {
158
+ await instrumentHook(HOOK_NAMES.SESSION_START, async (ctx) => {
159
+ const cwd = process.cwd();
160
+ const sessionId = input.session_id;
161
+ const gitStatus = probeGitStatus(cwd, GIT_TIMEOUT_MS.HOOK_PATH).catch(() => null);
162
+ persistSpanContext(ctx, sessionId, saveSessionContext);
163
+ recordSessionIdentity(ctx, input);
164
+ ctx.logger.info("Session starting", {
165
+ [PROCESS_ATTRIBUTES.WORKING_DIRECTORY]: cwd,
166
+ [SESSION_ATTRIBUTES.SESSION_ID]: sessionId
167
+ });
168
+ prepareSessionState(ctx, sessionId);
169
+ const isResume = continuesTranscript(input.source);
170
+ const sections = [
171
+ reportContext(ctx, input, cwd, isResume),
172
+ isResume ? reportRestoredTasks(ctx, sessionId) : null
173
+ ];
174
+ const git = await gitStatus;
175
+ sections.push(
176
+ reportEnvironment(ctx, cwd),
177
+ reportProject(ctx, cwd),
178
+ reportActiveTasks(ctx),
179
+ git ? reportGit(ctx, git) : null
180
+ );
181
+ const notices = [...shipperNotice(ctx), ...handoffNotice(ctx, cwd)];
182
+ const checksPerformed = sections.filter((section) => section !== null).length;
183
+ ctx.addAttribute("integritystudio.session.checks_performed", checksPerformed);
184
+ ctx.recordMetric("integritystudio.session.checks", checksPerformed, void 0, {
185
+ description: "Startup checks performed per session",
186
+ unit: UNITS.CHECK
187
+ });
188
+ const banner = [...sections.flatMap((section) => section ?? []), ...notices];
189
+ if (banner.length === 0) return;
190
+ const bannerText = banner.join("\n");
191
+ writePlainContext(bannerText);
192
+ ctx.logger.info(bannerText);
193
+ }, { [HOOK_TYPE_ATTR]: "session" });
194
+ }
195
+ function recordSessionIdentity(ctx, input) {
196
+ const projectSlug = deriveProjectSlug(input.transcript_path);
197
+ if (projectSlug) ctx.addAttribute(SESSION_ATTRIBUTES.PROJECT_SLUG, projectSlug);
198
+ const conversationId = conversationIdOf(input.session_id);
199
+ if (conversationId) ctx.addAttribute(SESSION_ATTRIBUTES.CONVERSATION_ID, conversationId);
200
+ const sessionId = input.session_id;
201
+ const previousId = recordPredecessor(input.source, sessionId, process.env[CONVERSATION_ID_ENV] || projectSlug);
202
+ if (previousId) ctx.addAttribute(SESSION_ATTRIBUTES.PREVIOUS_ID, previousId);
203
+ ctx.recordEvent("session.start", {
204
+ [SESSION_ATTRIBUTES.SESSION_ID]: sessionId,
205
+ ...previousId ? { [SESSION_ATTRIBUTES.PREVIOUS_ID]: previousId } : {}
206
+ });
207
+ }
208
+ function recordPredecessor(source, sessionId, groupingKey) {
209
+ if (!isFreshStart(source) || !groupingKey) return null;
210
+ return distinctPredecessor(recordSessionPredecessor(groupingKey, sessionId), sessionId);
211
+ }
212
+ function prepareSessionState(ctx, sessionId) {
213
+ resetFailureTracking(sessionId);
214
+ clearSession(sessionId);
215
+ const projectDir = process.env.CLAUDE_PROJECT_DIR;
216
+ if (projectDir) {
217
+ saveCurrentSessionId(sessionId, projectDir);
218
+ const startBranch = readHeadBranch(projectDir);
219
+ if (startBranch) saveSessionStartBranch(sessionId, startBranch);
220
+ }
221
+ ctx.addAttribute("integritystudio.quality.eval_sampled", shouldSampleSession(sessionId));
222
+ }
223
+ function reportContext(ctx, input, cwd, isResume) {
224
+ const trackParams = {
225
+ sessionId: input.session_id,
226
+ transcriptPath: input.transcript_path,
227
+ isResume,
228
+ attributes: { [PROCESS_ATTRIBUTES.WORKING_DIRECTORY]: cwd }
229
+ };
230
+ const contextData = isResume ? trackSessionContext(trackParams) : trackSessionContextFast(trackParams);
231
+ if (!isResume && isFreshStart(input.source)) {
232
+ setImmediate(() => {
233
+ try {
234
+ trackSessionContext(trackParams);
235
+ } catch {
236
+ }
237
+ });
238
+ }
239
+ ctx.addAttributes(contextSpanAttributes(contextData));
240
+ const headline = {
241
+ [CONTEXT_ATTRIBUTES.UTILIZATION_PERCENT]: contextData.utilizationPercent,
242
+ [CONTEXT_ATTRIBUTES.ESTIMATED_TOKENS]: contextData.estimatedTokens
243
+ };
244
+ if (contextData.utilizationPercent > FULL_UTILIZATION_PERCENT) {
245
+ ctx.recordEvent("integritystudio.context.overflow", headline);
246
+ writeStderr(`[OVERFLOW] Context utilization exceeded ${FULL_UTILIZATION_PERCENT}%: ${contextData.utilizationPercent.toFixed(1)}%`);
247
+ }
248
+ ctx.logger.debug("Context tracked", { ...headline, [CONTEXT_ATTRIBUTES.FREE_SPACE]: contextData.freeSpace });
249
+ if (!contextData.isResume && contextData.estimatedTokens <= CONTEXT_BANNER_MIN_TOKENS) return null;
250
+ const { estimatedTokens, utilizationPercent, freeSpace } = contextData;
251
+ return [
252
+ `Context: ${formatTokens(estimatedTokens)} tokens (${utilizationPercent.toFixed(1)}%, ${utilizationLabel(utilizationPercent)}), ${formatTokens(freeSpace)} free`
253
+ ];
254
+ }
255
+ function contextSpanAttributes(contextData) {
256
+ return {
257
+ [CONTEXT_ATTRIBUTES.ESTIMATED_TOKENS]: contextData.estimatedTokens,
258
+ [CONTEXT_ATTRIBUTES.UTILIZATION_PERCENT]: contextData.utilizationPercent,
259
+ [CONTEXT_ATTRIBUTES.FREE_SPACE]: contextData.freeSpace,
260
+ [CONTEXT_ATTRIBUTES.TRANSCRIPT_SIZE]: contextData.transcriptSize,
261
+ [CONTEXT_ATTRIBUTES.MESSAGE_COUNT]: contextData.messageCount,
262
+ [CONTEXT_ATTRIBUTES.IS_RESUME]: contextData.isResume
263
+ };
264
+ }
265
+ function reportRestoredTasks(ctx, sessionId) {
266
+ const tasks = activeTaskCompletion(sessionId);
267
+ if (!tasks) return null;
268
+ const { active, ratio } = tasks;
269
+ ctx.addAttributes({
270
+ "integritystudio.task.restored_count": active.length,
271
+ "integritystudio.task.completion_ratio": ratio
272
+ });
273
+ ctx.recordMetric("integritystudio.session.task_completion", ratio, void 0, { unit: UNITS.RATIO });
274
+ const lines = [`Tasks: ${active.length} restored (${formatPercent(ratio)} complete)`];
275
+ if (ratio < THRESHOLDS.TASK_COMPLETION_RATIO) {
276
+ lines.push(` [!] Low completion ratio: ${ratio.toFixed(2)}`);
277
+ }
278
+ return lines;
279
+ }
280
+ function reportEnvironment(ctx, cwd) {
281
+ ctx.addAttribute(PROCESS_ATTRIBUTES.RUNTIME_VERSION, process.version);
282
+ ctx.logger.debug("Environment check passed", { [PROCESS_ATTRIBUTES.RUNTIME_VERSION]: process.version });
283
+ ctx.addAttribute(PROCESS_ATTRIBUTES.WORKING_DIRECTORY, cwd);
284
+ return [];
285
+ }
286
+ function reportProject(ctx, cwd) {
287
+ const pkg = loadJson(path.join(cwd, "package.json"));
288
+ if (!pkg) return null;
289
+ const projectName = pkg.name || UNKNOWN_PROJECT_NAME;
290
+ ctx.addAttribute(SESSION_ATTRIBUTES.PROJECT_NAME, projectName);
291
+ return [];
292
+ }
293
+ function reportActiveTasks(ctx) {
294
+ const activeDir = process.env.ACTIVE_TASKS_DIR || path.join(os.homedir(), DEFAULT_ACTIVE_TASKS_SUBDIR);
295
+ if (!fs.existsSync(activeDir)) return null;
296
+ const taskNames = fs.readdirSync(activeDir);
297
+ ctx.addAttribute("integritystudio.tasks.active", taskNames.length);
298
+ ctx.recordMetric("integritystudio.session.active_tasks", taskNames.length, void 0, { unit: UNITS.TASK });
299
+ return taskNames.length > 0 ? [`Active tasks (${taskNames.length}): ${taskNames.join(", ")}`] : [];
300
+ }
301
+ function reportGit(ctx, { branch, uncommitted, repository }) {
302
+ ctx.addAttribute(VCS_ATTRIBUTES.REF_HEAD_NAME, branch);
303
+ ctx.addAttribute(GIT_ATTRIBUTES.UNCOMMITTED, uncommitted);
304
+ if (repository) {
305
+ const { owner, name } = splitOwnerRepo(repository);
306
+ ctx.addAttribute(VCS_ATTRIBUTES.REPOSITORY_NAME, name);
307
+ if (owner) ctx.addAttribute(VCS_ATTRIBUTES.OWNER_NAME, owner);
308
+ }
309
+ return [uncommitted > 0 ? `Git: ${branch} (${uncommitted} uncommitted changes)` : `Git: ${branch} (clean)`];
310
+ }
311
+ function shipperNotice(ctx) {
312
+ const shipperStatus = readShipperStatus();
313
+ if (!shipperStatus || isShipperHealthy(shipperStatus.outcome)) return [];
314
+ ctx.addAttribute("integritystudio.telemetry.shipper.outcome", shipperStatus.outcome);
315
+ return [formatShipperWarning(shipperStatus)];
316
+ }
317
+ function handoffNotice(ctx, cwd) {
318
+ const handoffs = findPendingHandoffs(cwd);
319
+ if (handoffs.length === 0) return [];
320
+ ctx.addAttribute("integritystudio.session.handoffs_pending", handoffs.length);
321
+ return formatHandoffBanner(handoffs);
322
+ }
323
+ function deriveProjectSlug(transcriptPath) {
324
+ if (!transcriptPath) return null;
325
+ return transcriptPath.match(TRANSCRIPT_PROJECT_SLUG_PATTERN)?.[1] ?? null;
326
+ }
327
+ function distinctPredecessor(priorSessionId, currentSessionId) {
328
+ return priorSessionId && priorSessionId !== currentSessionId ? priorSessionId : null;
329
+ }
330
+ function formatTokens(tokens) {
331
+ if (tokens >= TOKENS_PER_MILLION) {
332
+ return `${(tokens / TOKENS_PER_MILLION).toFixed(1)}M`;
333
+ }
334
+ if (tokens >= TOKENS_PER_THOUSAND) {
335
+ return `${(tokens / TOKENS_PER_THOUSAND).toFixed(0)}K`;
336
+ }
337
+ return String(tokens);
338
+ }
339
+ function utilizationLabel(percent) {
340
+ const safePct = Number.isFinite(percent) ? percent : 0;
341
+ if (safePct > FULL_UTILIZATION_PERCENT) return "OVERFLOW";
342
+ if (safePct >= UTILIZATION_HIGH_PERCENT) return "HIGH";
343
+ if (safePct >= UTILIZATION_WARN_PERCENT) return "WARN";
344
+ return "OK";
345
+ }
346
+ export {
347
+ deriveProjectSlug,
348
+ distinctPredecessor,
349
+ handleSessionStart,
350
+ utilizationLabel
351
+ };
352
+ //# sourceMappingURL=session-start-5ZMCLKBS.js.map