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,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../handlers/stop-error-reminder.ts", "../../../handlers/stop-quality-evaluation.ts", "../../../lib/otel/telemetry-alerts.ts", "../../../handlers/stop-session-summary.ts", "../../../lib/transcript/token-metrics-checkpoint.ts", "../../../handlers/stop-token-metrics.ts", "../../../handlers/stop.ts"],
4
+ "sourcesContent": ["/**\n * Scans this session's edited files for the risky patterns the conformance audit\n * found (CCH0b, CCH1c, CCH5) and delivers a self-check via `additionalContext`\n * once per session. The latch is load-bearing: additionalContext on Stop resumes\n * the session and the trigger stays true, so without it the session never stops.\n */\n\nimport { existsSync } from 'node:fs';\nimport { OTHER_LABEL } from '../lib/core/bounded-label.js';\nimport { readTextOrNull } from '../lib/core/file-utils.js';\nimport { HOOK_NAMES, HOOK_TYPE_ATTR } from '../lib/otel/attributes.js';\nimport { instrumentHook, type HookContext } from '../lib/otel/otel-monitor.js';\nimport {\n getFileCategory, isJsTsFile, isJsTsNonSourceFile, type FileCategory,\n} from '../lib/runtime/categorizers.js';\nimport type { StopHookInput } from '../lib/runtime/hook-input.js';\nimport { addAdditionalContext } from '../lib/runtime/hook-output.js';\nimport { loadEdits, type EditEntry } from '../lib/session/edit-ledger.js';\nimport { sessionMarkerPath, sessionStateRoot, claimOnce } from '../lib/session/session-state.js';\n\nconst EXCLUDED_PATH_SUBSTRINGS = ['types/', '.styles.ts'] as const;\n\nfunction shouldCheckErrorHandling(filePath: string): boolean {\n if (!isJsTsFile(filePath) || isJsTsNonSourceFile(filePath)) return false;\n return !EXCLUDED_PATH_SUBSTRINGS.some((sub) => filePath.includes(sub));\n}\n\nconst SIGNAL_PATTERNS = {\n hasConsoleLog: [/\\bconsole\\.log\\(/],\n // Four or more digits: a timeout that may exceed HOOK_TIMEOUT_MS and so never fire (CCH1c).\n hasHardcodedTimeout: [/[,{]\\s*timeout:\\s*\\d{4,}/, /setTimeout\\s*\\([^,]+,\\s*\\d{4,}/],\n hasSilentCatch: [/catch\\s*(?:\\([^)]*\\))?\\s*\\{\\s*\\}/],\n hasApiCall: [/\\bfetch\\s*\\(|axios\\.|apiClient\\./i],\n} as const satisfies Record<string, readonly RegExp[]>;\n\ntype Signal = keyof typeof SIGNAL_PATTERNS;\ntype FileAnalysis = Record<Signal, boolean>;\n\nfunction analyzeFileContent(filePath: string): FileAnalysis | null {\n const content = readTextOrNull(filePath);\n if (content === null) return null;\n const analysis = {} as FileAnalysis;\n for (const [signal, patterns] of Object.entries(SIGNAL_PATTERNS) as Array<[Signal, readonly RegExp[]]>) {\n analysis[signal] = patterns.some((re) => re.test(content));\n }\n return analysis;\n}\n\ninterface ReminderSection {\n heading: string;\n countAttribute: string;\n /** Each signal the section checks, with the line it renders when any file trips it */\n checks: ReadonlyArray<{ signal: Signal; line: string }>;\n bestPractice?: string;\n}\n\n/**\n * No section for `'other'`, so such a file can neither trigger the reminder nor burn\n * the session's single delivery slot on a bare header (CCH6b). A new `FileCategory`\n * is a compile error until it gets a section.\n */\nconst REMINDER_SECTIONS: Readonly<Record<Exclude<FileCategory, typeof OTHER_LABEL>, ReminderSection>> = {\n 'hooks-handler': {\n heading: 'Hooks Handler',\n countAttribute: 'integritystudio.error_reminder.files.hooks_handler',\n checks: [\n {\n signal: 'hasConsoleLog',\n line: '- Plain stdout (`writePlainContext()`) does not reach Claude outside SessionStart/UserPromptSubmit/UserPromptExpansion \u2014 use `addAdditionalContext()` on Stop/PostToolUse (CCH0b).',\n },\n {\n signal: 'hasSilentCatch',\n line: '- Does the catch block swallow the error silently? A hook that fails open exits 0 with no delivery and no telemetry (CCH5).',\n },\n ],\n bestPractice: 'Best practice: route output through the channel that reaches Claude at this event; let errors surface rather than hide them.',\n },\n 'hooks-lib': {\n heading: 'Hooks Library',\n countAttribute: 'integritystudio.error_reminder.files.hooks_lib',\n checks: [\n {\n signal: 'hasHardcodedTimeout',\n line: '- Is the hardcoded timeout below `HOOK_TIMEOUT_MS`? A timeout above the harness limit is unreachable \u2014 the process is killed first with no error, no telemetry, and no retry (CCH1c). Use `THRESHOLDS.*` constants.',\n },\n {\n signal: 'hasSilentCatch',\n line: '- Does the catch block swallow the error silently? A library that fails open hides the failure from the handler and from telemetry (CCH5).',\n },\n ],\n bestPractice: 'Best practice: validate timeout values against `HOOK_TIMEOUT_MS`; propagate or log errors rather than silently catching them.',\n },\n scripts: {\n heading: 'Scripts',\n countAttribute: 'integritystudio.error_reminder.files.scripts',\n checks: [\n { signal: 'hasSilentCatch', line: '- Does the catch block swallow the error silently?' },\n { signal: 'hasApiCall', line: '- Do network calls handle transient failures and log on exhaustion?' },\n ],\n },\n};\n\ntype SectionCategory = keyof typeof REMINDER_SECTIONS;\n\n/** `FileCategory` is a closed union, so every category but `other` keys a section. */\nconst isSectionCategory = (category: FileCategory): category is SectionCategory => category !== OTHER_LABEL;\n\n/** Marker latching the error reminder to one delivery per session. */\nconst ERROR_REMINDER_MARKER = 'error-reminder';\n\nconst SKIP_ENV_VAR = 'SKIP_ERROR_REMINDER';\nconst SKIP_ENV_ON = '1';\n\nconst ATTR = {\n FILES_EDITED: 'integritystudio.error_reminder.files.edited',\n FILES_RENDERABLE: 'integritystudio.error_reminder.files.renderable',\n FILES_TOTAL: 'integritystudio.error_reminder.files.total',\n NEEDS_ATTENTION: 'integritystudio.error_reminder.needs_attention',\n ALREADY_DELIVERED: 'integritystudio.error_reminder.already_delivered',\n /** Section-category files the ledger names but that could not be read (deleted, moved, unreadable) */\n FILES_UNREADABLE: 'integritystudio.error_reminder.files.unreadable',\n} as const;\n\nconst REMINDER_TITLE = '## Error Handling Self-Check';\nconst REMINDER_CLOSING = `Address whichever points apply, or state why they do not. Set \\`${SKIP_ENV_VAR}=${SKIP_ENV_ON}\\` to disable this check.`;\n\n/** Atomic claim of the per-session delivery slot (see the module note). `stateRoot` keeps tests out of $HOME. */\nexport function claimErrorReminder(sessionId: string, stateRoot: string = sessionStateRoot()): boolean {\n return claimOnce(sessionMarkerPath(sessionId, ERROR_REMINDER_MARKER, stateRoot));\n}\n\n/** Non-claiming peek, so a Stop after delivery skips the file scan; the claim itself stays atomic. */\nfunction errorReminderDelivered(sessionId: string): boolean {\n return existsSync(sessionMarkerPath(sessionId, ERROR_REMINDER_MARKER));\n}\n\ninterface SectionReport {\n section: ReminderSection;\n analyses: FileAnalysis[];\n tripped: Array<ReminderSection['checks'][number]>;\n}\n\ninterface GroupedAnalyses {\n analysesByCategory: Map<SectionCategory, FileAnalysis[]>;\n unreadableCount: number;\n}\n\nfunction groupAnalysesByCategory(editedFiles: readonly EditEntry[]): GroupedAnalyses {\n // The ledger is append-only, so a file edited N times appears N times.\n const analysesByCategory = new Map<SectionCategory, FileAnalysis[]>();\n let unreadableCount = 0;\n for (const path of new Set(editedFiles.map((file) => file.path))) {\n if (!shouldCheckErrorHandling(path)) continue;\n const category = getFileCategory(path);\n if (!isSectionCategory(category)) continue;\n const analysis = analyzeFileContent(path);\n if (!analysis) {\n unreadableCount++;\n continue;\n }\n const bucket = analysesByCategory.get(category) ?? [];\n bucket.push(analysis);\n analysesByCategory.set(category, bucket);\n }\n return { analysesByCategory, unreadableCount };\n}\n\nfunction renderReminder(sections: readonly SectionReport[]): string {\n const lines: string[] = [REMINDER_TITLE, ''];\n\n for (const { section, analyses, tripped } of sections) {\n if (analyses.length === 0) continue;\n lines.push(`**${section.heading}** \u2014 ${analyses.length} file(s) edited`, '');\n lines.push(...tripped.map(({ line }) => line));\n lines.push('');\n if (section.bestPractice) lines.push(section.bestPractice, '');\n }\n\n lines.push(REMINDER_CLOSING);\n\n return lines.join('\\n');\n}\n\nfunction reportAlreadyDelivered(ctx: HookContext): void {\n ctx.addAttribute(ATTR.ALREADY_DELIVERED, true);\n ctx.logger.debug('Error reminder already delivered this session');\n}\n\nexport async function handleErrorReminder(input: StopHookInput): Promise<void> {\n if (process.env[SKIP_ENV_VAR] === SKIP_ENV_ON) return;\n\n await instrumentHook(HOOK_NAMES.ERROR_HANDLING_REMINDER, (ctx) => {\n ctx.logger.debug('Error handling reminder starting');\n\n const sessionId = input.session_id;\n if (errorReminderDelivered(sessionId)) {\n reportAlreadyDelivered(ctx);\n return;\n }\n\n const editedFiles = loadEdits(sessionId);\n ctx.addAttribute(ATTR.FILES_EDITED, editedFiles.length);\n\n if (editedFiles.length === 0) {\n ctx.logger.debug('No files edited this session');\n return;\n }\n\n const { analysesByCategory, unreadableCount } = groupAnalysesByCategory(editedFiles);\n\n const sections = (Object.entries(REMINDER_SECTIONS) as Array<[SectionCategory, ReminderSection]>)\n .map(([category, section]) => {\n const analyses = analysesByCategory.get(category) ?? [];\n const tripped = section.checks.filter(({ signal }) => analyses.some((analysis) => analysis[signal]));\n return { section, analyses, tripped };\n });\n\n const analyzedCount = sections.reduce((sum, { analyses }) => sum + analyses.length, 0);\n const needsAttention = sections.some(({ tripped }) => tripped.length > 0);\n\n ctx.addAttributes({\n ...Object.fromEntries(sections.map(({ section, analyses }) => [section.countAttribute, analyses.length])),\n [ATTR.NEEDS_ATTENTION]: needsAttention,\n [ATTR.FILES_RENDERABLE]: analyzedCount,\n [ATTR.FILES_UNREADABLE]: unreadableCount,\n });\n\n if (!needsAttention) {\n ctx.logger.debug('No actionable patterns in a category the reminder renders', {\n [ATTR.FILES_RENDERABLE]: analyzedCount,\n });\n return;\n }\n\n ctx.logger.info('Error handling patterns detected', {\n [ATTR.FILES_TOTAL]: editedFiles.length,\n [ATTR.FILES_RENDERABLE]: analyzedCount,\n });\n\n if (!claimErrorReminder(sessionId)) {\n reportAlreadyDelivered(ctx);\n return;\n }\n\n addAdditionalContext(renderReminder(sections));\n }, { [HOOK_TYPE_ATTR]: 'error' });\n}\n", "/**\n * T2 quality evaluation, Stop side: sampling and budget gates, a `stat` of the\n * transcript, and a spawn of the detached evaluator (`hook-runner\n * evaluate-quality`). The judge calls happen in that child, so nothing here\n * waits on the network.\n */\n\nimport { statSync } from 'node:fs';\n\nimport { writeStderr } from '../lib/core/format-utils.js';\nimport { HOOK_NAMES, HOOK_TYPE_ATTR } from '../lib/otel/attributes.js';\nimport { instrumentHook } from '../lib/otel/otel-monitor.js';\nimport { hasBudget } from '../lib/quality/quality-budget.js';\nimport {\n QUALITY_ATTRS, QUALITY_EVAL_SKIP_REASONS, QUALITY_EVAL_TYPE_LLM, QUALITY_EVALUATION_HOOK_TYPE, spawnQualityEvaluator,\n} from '../lib/quality/quality-eval-handoff.js';\nimport { getSessionSamplingInfo } from '../lib/quality/quality-sampler.js';\nimport type { StopHookInput } from '../lib/runtime/hook-input.js';\n\nexport async function handleQualityEvaluation(input: StopHookInput): Promise<void> {\n const { session_id: sessionId, transcript_path: transcriptPath } = input;\n\n const samplingInfo = getSessionSamplingInfo(sessionId);\n if (!samplingInfo.sampled) return;\n\n // A snapshot, not a reservation: the evaluator reserves per call under the lock.\n if (!hasBudget()) {\n writeStderr('[Quality] Daily evaluation budget exhausted');\n return;\n }\n\n // No credential check: the key may live only in Doppler, which the detached\n // evaluator resolves; a missing key surfaces there as llm_judge_failures (HRF6).\n await instrumentHook(HOOK_NAMES.QUALITY_EVALUATION_QUEUE, (ctx) => {\n const canary = samplingInfo.canary;\n ctx.addAttributes({\n [QUALITY_ATTRS.EVAL_TYPE]: QUALITY_EVAL_TYPE_LLM,\n [QUALITY_ATTRS.CANARY]: canary,\n });\n\n let transcriptBytes: number;\n try {\n transcriptBytes = statSync(transcriptPath).size;\n } catch {\n ctx.addAttribute(QUALITY_ATTRS.EVAL_SKIPPED_REASON, QUALITY_EVAL_SKIP_REASONS.NO_TRANSCRIPT);\n return;\n }\n if (transcriptBytes === 0) {\n ctx.addAttribute(QUALITY_ATTRS.EVAL_SKIPPED_REASON, QUALITY_EVAL_SKIP_REASONS.NO_TURNS);\n return;\n }\n ctx.addAttribute(QUALITY_ATTRS.TRANSCRIPT_BYTES, transcriptBytes);\n\n // The size bounds the evaluator's read to the transcript this Stop saw.\n const spawned = spawnQualityEvaluator({\n sessionId,\n canary,\n transcriptPath,\n transcriptBytes,\n });\n ctx.addAttribute(QUALITY_ATTRS.EVAL_QUEUED, spawned.ok);\n if (!spawned.ok) {\n ctx.addAttribute(QUALITY_ATTRS.EVAL_SKIPPED_REASON, spawned.reason);\n ctx.addAttribute(QUALITY_ATTRS.EVAL_SKIPPED_DETAIL, spawned.detail);\n }\n }, { [HOOK_TYPE_ATTR]: QUALITY_EVALUATION_HOOK_TYPE });\n}\n", "/**\n * Alert rules for hooks telemetry, evaluated by the stop handler. Rules are data:\n * each `ALERT_RULES` entry carries its own threshold comparison.\n * @internal\n */\n\nimport { THRESHOLDS } from '../core/constants.js';\n\ntype AlertSeverity = 'warning' | 'critical';\n/** Direction in which an observed value has to cross `threshold` to fire the rule. */\ntype AlertComparator = 'below' | 'above';\n\nexport interface AlertRule {\n name: string;\n severity: AlertSeverity;\n message: string;\n}\n\n/** An alert rule plus the declarative condition that fires it. */\ninterface AlertDefinition extends AlertRule {\n readonly comparator: AlertComparator;\n /** Compared against the metric this rule watches \u2014 a ratio or a count, per rule. */\n readonly threshold: number;\n}\n\n/** Scraping has no tolerance band: one failed invocation is already worth reporting. */\nconst NO_FAILURES_TOLERATED = 0;\n\n/** Freeze a row (table freeze is shallow and rows are handed to callers) and pin its literal types via `const`. */\nconst defineRule = <const T extends AlertDefinition>(rule: T): Readonly<T> => Object.freeze(rule);\n\nexport const ALERT_RULES = Object.freeze({\n taskCompletionLow: defineRule({\n name: 'task-completion-low',\n severity: 'warning',\n message: `Task completion ratio below ${THRESHOLDS.TASK_COMPLETION_RATIO}, investigate incomplete work`,\n comparator: 'below',\n threshold: THRESHOLDS.TASK_COMPLETION_RATIO,\n }),\n mcpScrapeIncomplete: defineRule({\n name: 'mcp-scrape-incomplete',\n severity: 'warning',\n message: 'MCP scraping incomplete, check for failed invocations',\n comparator: 'above',\n threshold: NO_FAILURES_TOLERATED,\n }),\n});\n\n/** Fire `rule` when `value` crosses its threshold. Non-finite values never alert; range is the caller's job. */\nfunction evaluate(rule: AlertDefinition, value: number): AlertRule[] {\n if (!Number.isFinite(value)) return [];\n const breached = rule.comparator === 'below' ? value < rule.threshold : value > rule.threshold;\n return breached ? [rule] : [];\n}\n\n/** Task completion alerts against a 0\u20131 ratio. */\nexport function evaluateTaskAlerts(completionRatio: number): AlertRule[] {\n return evaluate(ALERT_RULES.taskCompletionLow, completionRatio);\n}\n\n/** MCP scraping alerts; nothing scraped or a negative count means nothing to report. */\nexport function evaluateScrapingAlerts(failedCount: number, totalCount: number): AlertRule[] {\n if (totalCount <= 0 || failedCount < 0) return [];\n return evaluate(ALERT_RULES.mcpScrapeIncomplete, failedCount);\n}\n", "/** Session-level roll-ups: MCP failure summary, T1 task-completion signal, and the alert rules over both. */\n\nimport { formatPercent, UNITS } from '../lib/core/units.js';\nimport { loadInvocations, summarizeInvocations } from '../lib/mcp/mcp-completeness.js';\nimport { ALERT_ATTRS, SESSION_ATTRIBUTES, HOOK_NAMES, HOOK_TYPE_ATTR } from '../lib/otel/attributes.js';\nimport { instrumentHook } from '../lib/otel/otel-monitor.js';\nimport { evaluateTaskAlerts, evaluateScrapingAlerts, type AlertRule } from '../lib/otel/telemetry-alerts.js';\nimport { emitTaskCompletion, appendEvaluation, EVALUATOR_KIND, EVALUATION_COHORT } from '../lib/quality/quality-signals.js';\nimport { activeTaskCompletion } from '../lib/session/task-tracker.js';\n\nconst PRODUCER = 'hook:stop-session-summary';\n\nexport async function handleSessionSummary(sessionId: string): Promise<void> {\n // One read feeds the summary, the failure detail and the scraping alert.\n const mcpInvocations = loadInvocations(sessionId);\n const mcpSummary = summarizeInvocations(mcpInvocations);\n const mcpEntries = Object.entries(mcpSummary);\n const failedEntries = mcpEntries.filter(([, s]) => s.failed > 0);\n const mcpTotalFailed = failedEntries.reduce((sum, [, s]) => sum + s.failed, 0);\n const mcpTotalAll = mcpEntries.reduce((sum, [, s]) => sum + s.total, 0);\n\n if (failedEntries.length > 0) {\n const failedServers = failedEntries.map(([key]) => key).join(',');\n\n await instrumentHook(HOOK_NAMES.MCP_SESSION_FAILURE_SUMMARY, (ctx) => {\n ctx.addAttributes({\n 'integritystudio.mcp.session_failed_count': mcpTotalFailed,\n 'integritystudio.mcp.session_total_count': mcpTotalAll,\n 'integritystudio.mcp.session_failed_servers': failedServers,\n });\n ctx.recordMetric('integritystudio.mcp.session_failures', mcpTotalFailed, {\n [SESSION_ATTRIBUTES.SESSION_ID]: sessionId,\n }, { unit: UNITS.FAILURE });\n }, { [HOOK_TYPE_ATTR]: 'mcp-session-failure-summary' });\n }\n const triggered: AlertRule[] = [];\n\n const tasks = activeTaskCompletion(sessionId);\n if (tasks) {\n const { active, ratio } = tasks;\n triggered.push(...evaluateTaskAlerts(ratio));\n emitTaskCompletion(ratio, sessionId);\n appendEvaluation({\n name: 'task_completion',\n score: ratio,\n kind: EVALUATOR_KIND.RULE,\n cohort: EVALUATION_COHORT.NORMAL,\n producer: PRODUCER,\n sessionId,\n explanation: `${active.length} active tasks, completion ratio: ${formatPercent(ratio)}`,\n });\n }\n\n triggered.push(...evaluateScrapingAlerts(mcpTotalFailed, mcpTotalAll));\n\n if (triggered.length > 0) {\n await instrumentHook(HOOK_NAMES.TELEMETRY_ALERT_EVALUATION, (ctx) => {\n ctx.addAttribute('integritystudio.alerts.triggered_count', triggered.length);\n for (const alert of triggered) {\n ctx.recordEvent(`integritystudio.alert.${alert.severity}`, {\n [ALERT_ATTRS.NAME]: alert.name,\n [ALERT_ATTRS.MESSAGE]: alert.message,\n });\n ctx.recordMetric(`integritystudio.alerts.${alert.severity}`, 1, {\n [ALERT_ATTRS.NAME]: alert.name,\n }, { unit: UNITS.ALERT });\n }\n }, { [HOOK_TYPE_ATTR]: 'alert-evaluation' });\n }\n}\n", "/**\n * Per-session { byte offset, running totals } checkpoint, so each Stop reads only the bytes\n * appended since the last; the same walk pairs `tool_use` \u2192 `tool_result`.\n *\n * Rebuild triggers: version mismatch, structural invalidity, a shrunk transcript, or a different\n * transcript file (another spelling of the same file resumes); never age. A transcript rewritten to at least its old size is not detected.\n * A rebuild re-reports the whole transcript as growth, so bump the version only when needed.\n */\n\nimport { statSync } from 'node:fs';\nimport { isJsonObject } from '../core/file-utils.js';\nimport { isNonNegativeInteger } from '../core/units.js';\nimport { resumeOffset, transcriptCheckpointStore } from '../session/session-state.js';\nimport type { OpenToolCalls, ToolDuration } from './tool-call-durations.js';\nimport {\n emptyAccumulator, emptyModelTotals, emptyStats, foldTranscriptFrom, TOKEN_TOTAL_FIELDS, USAGE_FIELD_NAMES,\n type Accumulator, type ModelTotals, type ModelTotalsMap, type SessionTokenStats, type UsageHWM,\n} from './transcript-fold.js';\n\nconst CHECKPOINT_FILE = 'token-metrics.json';\n\n/** Incremented when the checkpoint schema changes in a backward-incompatible way; mismatches trigger a one-time full rebuild. */\nconst CHECKPOINT_VERSION = 2;\n\n// --- Types and field tables ---\n\n/** A difference between two `ModelTotals`, never an absolute. */\ntype TotalsDelta = ModelTotals;\n\n/** Growth since the checkpoint; `model` is current, so it stays on `stats`. */\ntype TokenDelta = TotalsDelta & Pick<SessionTokenStats, 'messageCount'>;\n\ninterface TokenExtractionResult {\n stats: SessionTokenStats;\n /** False when nothing new was found, except on a first extraction; a straddled response's later lines set it with a zero `messageCount`. */\n changed: boolean;\n /** For monotonic counters: `stats` there would re-count every earlier turn. */\n delta: TokenDelta;\n /** `delta` split by answering model, models with no growth left out. */\n deltaByModel: Array<[string, TotalsDelta]>;\n /** Independent of `changed`; each execution appears in exactly one extraction, except that a rebuild reports every one again. */\n toolDurations: ToolDuration[];\n}\n\ninterface TokenCheckpoint {\n offset: number;\n stats: SessionTokenStats;\n openToolCalls: OpenToolCalls;\n countedMessages: Array<[string, UsageHWM]>;\n byModel: Array<[string, ModelTotals]>;\n}\n\n// --- Totals arithmetic ---\n\nfunction emptyDelta(): TokenDelta {\n return { ...emptyModelTotals(), messageCount: 0 };\n}\n\n/** Undefined until a line has carried the field, so no reasoning counter is recorded. */\nfunction diffReasoning(current: number | undefined, previous: number | undefined): number | undefined {\n return current === undefined ? undefined : current - (previous ?? 0);\n}\n\nfunction diffTotals(current: ModelTotals, previous: ModelTotals): TotalsDelta {\n const delta = emptyModelTotals();\n for (const field of TOKEN_TOTAL_FIELDS) delta[field] = current[field] - previous[field];\n const reasoning = diffReasoning(current.totalReasoningTokens, previous.totalReasoningTokens);\n if (reasoning !== undefined) delta.totalReasoningTokens = reasoning;\n return delta;\n}\n\nfunction diffStats(current: SessionTokenStats, previous: SessionTokenStats): TokenDelta {\n return {\n ...diffTotals(current, previous),\n messageCount: current.messageCount - previous.messageCount,\n };\n}\n\nfunction hasTotalsGrowth(delta: TotalsDelta): boolean {\n return TOKEN_TOTAL_FIELDS.some((field) => delta[field] !== 0) || (delta.totalReasoningTokens ?? 0) !== 0;\n}\n\nfunction diffModelTotals(current: ModelTotalsMap, previous: ModelTotalsMap): Array<[string, TotalsDelta]> {\n const deltas: Array<[string, TotalsDelta]> = [];\n for (const [model, totals] of current) {\n const delta = diffTotals(totals, previous.get(model) ?? emptyModelTotals());\n if (hasTotalsGrowth(delta)) deltas.push([model, delta]);\n }\n return deltas;\n}\n\n/** A straddled response grows the totals without a new message. A fresh start (no live checkpoint) is always a change, even when empty. */\nfunction isChanged(delta: TokenDelta, fresh: boolean): boolean {\n return delta.messageCount !== 0 || hasTotalsGrowth(delta) || fresh;\n}\n\n// --- Checkpoint validation ---\n\n/** Every `fields` entry is a token count; `optionalField`, a reasoning count absent until a line carries thinking tokens, is one or absent. */\nfunction hasTokenCounts<T>(fields: readonly string[], optionalField: string): (value: unknown) => value is T {\n return (value: unknown): value is T => isJsonObject(value)\n && fields.every((field) => isNonNegativeInteger(value[field]))\n && (value[optionalField] === undefined || isNonNegativeInteger(value[optionalField]));\n}\n\nconst isUsageHWM = hasTokenCounts<UsageHWM>(USAGE_FIELD_NAMES, 'thinking_tokens');\nconst isModelTotals = hasTokenCounts<ModelTotals>(TOKEN_TOTAL_FIELDS, 'totalReasoningTokens');\n\nfunction isValidStats(value: unknown): value is SessionTokenStats {\n if (!isJsonObject(value)) return false;\n const { messageCount, model } = value;\n return isModelTotals(value) && typeof messageCount === 'number' && typeof model === 'string';\n}\n\nfunction isValidEntriesOf<T>(value: unknown, isValidValue: (v: unknown) => v is T): value is Array<[string, T]> {\n if (!Array.isArray(value)) return false;\n return value.every((entry: unknown) =>\n Array.isArray(entry) && entry.length === 2 && typeof entry[0] === 'string' && isValidValue(entry[1])\n );\n}\n\nfunction isValidOpenToolCalls(value: unknown): value is OpenToolCalls {\n return isJsonObject(value) && Object.values(value).every(\n (call) => isJsonObject(call) && typeof call.startMs === 'number' && typeof call.tool === 'string'\n );\n}\n\nconst checkpoints = transcriptCheckpointStore<TokenCheckpoint>({\n file: CHECKPOINT_FILE,\n version: CHECKPOINT_VERSION,\n isValidBody: (value) => isNonNegativeInteger(value.offset)\n && isValidStats(value.stats)\n && isValidOpenToolCalls(value.openToolCalls)\n && isValidEntriesOf(value.countedMessages, isUsageHWM)\n && isValidEntriesOf(value.byModel, isModelTotals),\n});\n\nfunction saveCheckpoint(sessionId: string, transcriptPath: string, offset: number, acc: Accumulator): void {\n checkpoints.save(sessionId, transcriptPath, {\n offset,\n stats: acc.stats,\n openToolCalls: acc.openToolCalls,\n countedMessages: [...acc.countedUsage],\n byModel: [...acc.modelTotals],\n });\n}\n\nfunction resumedAccumulator(resume: TokenCheckpoint | null): Accumulator {\n if (resume === null) return emptyAccumulator();\n // Shallow-copy stats and each model-totals entry: addUsage mutates them in place, and\n // deltasSinceResume compares acc.stats against resume.stats after the walk.\n return {\n stats: { ...resume.stats },\n modelTotals: new Map(resume.byModel.map(([m, t]) => [m, { ...t }])),\n countedUsage: new Map(resume.countedMessages),\n openToolCalls: Object.fromEntries(Object.entries(resume.openToolCalls).map(([id, call]) => [id, { ...call }])),\n toolDurations: [],\n toolCalls: 0,\n };\n}\n\n// --- Entry point ---\n\nfunction deltasSinceResume(acc: Accumulator, resume: TokenCheckpoint | null): Pick<TokenExtractionResult, 'delta' | 'deltaByModel'> {\n const baselineStats = resume?.stats ?? emptyStats();\n const baselineModelTotals: ModelTotalsMap = resume ? new Map(resume.byModel) : new Map<string, ModelTotals>();\n return {\n delta: diffStats(acc.stats, baselineStats),\n deltaByModel: diffModelTotals(acc.modelTotals, baselineModelTotals),\n };\n}\n\n/** Full parse when no valid checkpoint exists, the transcript shrank or it is a different file. */\nexport function extractTokenStats(transcriptPath: string, sessionId: string): TokenExtractionResult | null {\n try {\n const fileSize = statSync(transcriptPath).size;\n const checkpoint = checkpoints.load(sessionId, transcriptPath);\n\n if (fileSize === checkpoint?.offset) {\n return {\n stats: checkpoint.stats,\n changed: false,\n delta: emptyDelta(),\n deltaByModel: [],\n toolDurations: [],\n };\n }\n\n const start = resumeOffset(checkpoint, fileSize);\n const fresh = start === 0;\n const resume = fresh ? null : checkpoint;\n\n const acc = resumedAccumulator(resume);\n const consumed = foldTranscriptFrom(transcriptPath, start, acc);\n const { delta, deltaByModel } = deltasSinceResume(acc, resume);\n saveCheckpoint(sessionId, transcriptPath, consumed, acc);\n\n return {\n stats: acc.stats,\n changed: isChanged(delta, fresh),\n delta,\n deltaByModel,\n toolDurations: acc.toolDurations,\n };\n } catch {\n return null;\n }\n}\n", "/**\n * Token totals and main-loop tool durations from one incremental transcript read\n * (`lib/transcript/token-metrics-checkpoint.ts`). Counters take the per-Stop delta (HRV1);\n * cumulative totals go on the span.\n */\n\nimport { UNITS } from '../lib/core/units.js';\nimport { GENAI_AGENT_ATTRIBUTES, HOOK_NAMES, HOOK_TYPE_ATTR, SESSION_METRICS, TOKEN_ATTRS } from '../lib/otel/attributes.js';\nimport { instrumentHook } from '../lib/otel/otel-monitor.js';\nimport { recordToolDurations, cacheHitRate, recordModelTotals } from '../lib/otel/token-metrics.js';\nimport type { StopHookInput } from '../lib/runtime/hook-input.js';\nimport { extractTokenStats } from '../lib/transcript/token-metrics-checkpoint.js';\nimport { inputTokensIncludingCache } from '../lib/transcript/transcript-entry.js';\n\n/** Input + output tokens a session must pass before its summary metrics are recorded */\nconst SUMMARY_MIN_TOKENS = 1_000;\n\ninterface InputTotals {\n totalInputTokens: number;\n totalCacheCreationTokens: number;\n totalCacheReadTokens: number;\n}\n\nfunction effectiveInput(totals: InputTotals): number {\n return inputTokensIncludingCache(totals.totalInputTokens, totals.totalCacheCreationTokens, totals.totalCacheReadTokens);\n}\n\n/**\n * `gen_ai.execute_tool.duration` here carries no `gen_ai.agent.name`; its absence\n * is how a main-loop sample is told apart from subagent.ts's (OBP9b).\n */\nexport async function handleTokenMetrics(input: StopHookInput): Promise<void> {\n const transcriptPath = input.transcript_path;\n\n await instrumentHook(HOOK_NAMES.TOKEN_METRICS, (ctx) => {\n ctx.logger.debug('Extracting token metrics from transcript', {\n 'integritystudio.transcript.path': transcriptPath,\n });\n\n const result = extractTokenStats(transcriptPath, input.session_id);\n\n // Before the `changed` gate: a turn can pair tool calls without moving the token totals.\n const toolDurations = result?.toolDurations ?? [];\n recordToolDurations(ctx.recordMetric, toolDurations);\n ctx.addAttribute('integritystudio.transcript.tool_durations', toolDurations.length);\n\n if (result && !result.changed) {\n ctx.logger.debug('Transcript unchanged since last extraction');\n ctx.addAttribute(TOKEN_ATTRS.UNCHANGED, true);\n return;\n }\n\n if (!result?.stats.messageCount) {\n ctx.logger.debug('No token data found in transcript');\n ctx.addAttribute(TOKEN_ATTRS.FOUND, false);\n return;\n }\n const { stats } = result;\n\n ctx.addAttributes({\n [TOKEN_ATTRS.FOUND]: true,\n [TOKEN_ATTRS.INPUT]: stats.totalInputTokens,\n [TOKEN_ATTRS.OUTPUT]: stats.totalOutputTokens,\n [TOKEN_ATTRS.CACHE_READ]: stats.totalCacheReadTokens,\n [TOKEN_ATTRS.CACHE_CREATION]: stats.totalCacheCreationTokens,\n [TOKEN_ATTRS.MESSAGES]: stats.messageCount,\n [TOKEN_ATTRS.MODEL]: stats.model,\n });\n\n // Counters take the delta: each Stop is a fresh process adding to a monotonic\n // counter, so the cumulative figure re-summed the session every turn (HRV1).\n const effectiveInputTokens = effectiveInput(stats);\n const { delta } = result;\n const deltaInputTokens = effectiveInput(delta);\n\n // One datapoint set per model that answered since the last Stop: a `/model` switch\n // mid-turn put both models' tokens under the last one's label (TMX1). No per-turn\n // counts as labels: each distinct value opened a new series.\n for (const [model, modelDelta] of result.deltaByModel) {\n recordModelTotals(model, modelDelta, 'session');\n }\n\n ctx.logger.info('Token metrics recorded', {\n 'integritystudio.tokens.effective_input': effectiveInputTokens,\n [TOKEN_ATTRS.OUTPUT]: stats.totalOutputTokens,\n [TOKEN_ATTRS.CACHE_READ]: stats.totalCacheReadTokens,\n 'integritystudio.tokens.delta.input': deltaInputTokens,\n 'integritystudio.tokens.delta.output': delta.totalOutputTokens,\n 'integritystudio.tokens.delta.cache_read': delta.totalCacheReadTokens,\n 'integritystudio.tokens.delta.cache_creation': delta.totalCacheCreationTokens,\n [GENAI_AGENT_ATTRIBUTES.RESPONSE_MODEL]: stats.model,\n [TOKEN_ATTRS.MESSAGES]: stats.messageCount,\n });\n\n if (stats.totalInputTokens + stats.totalOutputTokens > SUMMARY_MIN_TOKENS) {\n const totalTokens = effectiveInputTokens + stats.totalOutputTokens;\n // Cumulative 0\u20131 ratio; user-prompt.ts's per-prompt snapshot is a separate instrument.\n const sessionCacheHitRate = cacheHitRate(stats.totalCacheReadTokens, stats.totalInputTokens) ?? 0;\n\n // No model label: after a `/model` switch a whole-session figure belongs to neither model (TMX1).\n ctx.recordMetric(SESSION_METRICS.TOTAL_TOKENS, totalTokens, {}, { unit: UNITS.TOKEN });\n ctx.recordMetric(SESSION_METRICS.CACHE_HIT_RATE, sessionCacheHitRate, {}, { unit: UNITS.RATIO });\n }\n }, { [HOOK_TYPE_ATTR]: 'token-metrics' });\n}\n", "/**\n * Stop sequencer. Phase order is load-bearing: token metrics (always) \u2192\n * quality-evaluation handoff (sampled sessions; spawns the detached judge, HDF3) \u2192\n * error reminder \u2192 session summary.\n */\n\nimport { errorMessage, writeStderr } from '../lib/core/format-utils.js';\nimport type { StopHookInput } from '../lib/runtime/hook-input.js';\nimport { spawnTelemetryShipper } from '../lib/shipper/telemetry-shipper.js';\nimport { handleErrorReminder } from './stop-error-reminder.js';\nimport { handleQualityEvaluation } from './stop-quality-evaluation.js';\nimport { handleSessionSummary } from './stop-session-summary.js';\nimport { handleTokenMetrics } from './stop-token-metrics.js';\n\nexport async function handleStop(input: StopHookInput, subType?: string): Promise<void> {\n await handleTokenMetrics(input);\n\n // The span records the failure; the judge must never fail the Stop hook.\n await handleQualityEvaluation(input).catch((error: unknown) => {\n writeStderr('[stop] Quality evaluation handoff failed:', errorMessage(error));\n });\n\n // The reminder's additionalContext resumes the session, so it never fires on a\n // hook-caused resume (HSF4).\n if ((!subType || subType === 'error') && !input.stop_hook_active) {\n await handleErrorReminder(input);\n }\n\n await handleSessionSummary(input.session_id);\n\n spawnTelemetryShipper();\n}\n"],
5
+ "mappings": "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",
6
+ "names": ["statSync", "statSync"]
7
+ }
@@ -0,0 +1,116 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ resolveAgentName
5
+ } from "./chunk-LHWRXY2G.js";
6
+ import {
7
+ agentTypeLabels
8
+ } from "./chunk-LBCZAYFR.js";
9
+ import "./chunk-VXFSLM6P.js";
10
+ import "./chunk-LQ2LGUYJ.js";
11
+ import {
12
+ instrumentHook
13
+ } from "./chunk-WU7ANGCW.js";
14
+ import {
15
+ AGENT_ATTRS,
16
+ GENAI_AGENT_ATTRIBUTES,
17
+ GENAI_OPERATION,
18
+ HOOK_NAMES,
19
+ HOOK_TYPE_ATTR
20
+ } from "./chunk-7OM5CYES.js";
21
+ import "./chunk-GG2I4TGI.js";
22
+ import "./chunk-SRMAJQMV.js";
23
+ import "./chunk-YHYDBLVB.js";
24
+ import "./chunk-DNSTWC26.js";
25
+ import "./chunk-52RY6LQT.js";
26
+ import {
27
+ UNITS
28
+ } from "./chunk-RWRGC7ZK.js";
29
+ import "./chunk-7PEOKGYR.js";
30
+ import "./chunk-GNNKUMRF.js";
31
+
32
+ // handlers/subagent.ts
33
+ import { existsSync } from "node:fs";
34
+ var HARNESS_INTERNAL_AGENT_TYPE = "harness-internal";
35
+ var TRANSCRIPT_MEASURED_ATTR = "integritystudio.agent.transcript_measured";
36
+ function agentLabels(input) {
37
+ return agentTypeLabels(resolveAgentName(input) ?? HARNESS_INTERNAL_AGENT_TYPE);
38
+ }
39
+ async function handleSubagentStart(input) {
40
+ await instrumentHook(HOOK_NAMES.SUBAGENT_START, (ctx) => {
41
+ const labels = agentLabels(input);
42
+ ctx.addAttributes({ [AGENT_ATTRS.INSTANCE_ID]: input.agent_id ?? "", ...labels });
43
+ ctx.logger.info("Subagent started", {
44
+ [AGENT_ATTRS.TYPE]: labels[AGENT_ATTRS.TYPE],
45
+ [AGENT_ATTRS.INSTANCE_ID]: input.agent_id ?? ""
46
+ });
47
+ ctx.recordMetric("integritystudio.subagent.starts", 1, labels, { unit: UNITS.INVOCATION });
48
+ }, { [HOOK_TYPE_ATTR]: "agent" });
49
+ }
50
+ async function recordAgentTranscriptMetrics(ctx, transcriptPath, agentName) {
51
+ const [
52
+ { readAgentTranscriptMeasures },
53
+ { recordModelTotals, recordToolDurations }
54
+ ] = await Promise.all([
55
+ import("./agent-transcript-metrics-W5CZZFMI.js"),
56
+ import("./token-metrics-AD2RAFGM.js")
57
+ ]);
58
+ const measures = readAgentTranscriptMeasures(transcriptPath);
59
+ if (!measures) {
60
+ ctx.addAttribute(TRANSCRIPT_MEASURED_ATTR, false);
61
+ return;
62
+ }
63
+ const attrs = {
64
+ [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: agentName,
65
+ ...measures.model ? { [GENAI_AGENT_ATTRIBUTES.RESPONSE_MODEL]: measures.model } : {}
66
+ };
67
+ ctx.recordMetric("gen_ai.invoke_agent.inference_calls", measures.inferenceCalls, attrs, {
68
+ unit: UNITS.INFERENCE_CALL
69
+ });
70
+ ctx.recordMetric("gen_ai.invoke_agent.tool_calls", measures.toolCalls, attrs, {
71
+ unit: UNITS.TOOL_CALL
72
+ });
73
+ recordToolDurations(ctx.recordMetric, measures.toolDurations, {
74
+ [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: agentName
75
+ });
76
+ ctx.addAttributes({
77
+ [TRANSCRIPT_MEASURED_ATTR]: true,
78
+ "integritystudio.agent.inference_calls": measures.inferenceCalls,
79
+ "integritystudio.agent.tool_calls": measures.toolCalls
80
+ });
81
+ for (const [model, totals] of Object.entries(measures.tokenUsageByModel)) {
82
+ recordModelTotals(model, totals, GENAI_OPERATION.INVOKE_AGENT, {
83
+ [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: agentName
84
+ });
85
+ }
86
+ }
87
+ function existingTranscriptPath(path) {
88
+ return path && existsSync(path) ? path : void 0;
89
+ }
90
+ async function handleSubagentStop(input) {
91
+ await instrumentHook(HOOK_NAMES.SUBAGENT_STOP, async (ctx) => {
92
+ const labels = agentLabels(input);
93
+ const transcriptPath = existingTranscriptPath(input.agent_transcript_path);
94
+ ctx.addAttributes({
95
+ [AGENT_ATTRS.INSTANCE_ID]: input.agent_id ?? "",
96
+ ...labels,
97
+ [AGENT_ATTRS.TRANSCRIPT_PATH]: input.agent_transcript_path ?? "",
98
+ [AGENT_ATTRS.HAS_TRANSCRIPT]: transcriptPath !== void 0,
99
+ [AGENT_ATTRS.STOP_HOOK_ACTIVE]: !!input.stop_hook_active,
100
+ [AGENT_ATTRS.LAST_MESSAGE_LENGTH]: (input.last_assistant_message ?? "").length
101
+ });
102
+ ctx.logger.info("Subagent stopped", {
103
+ [AGENT_ATTRS.TYPE]: labels[AGENT_ATTRS.TYPE],
104
+ [AGENT_ATTRS.INSTANCE_ID]: input.agent_id ?? ""
105
+ });
106
+ ctx.recordMetric("integritystudio.subagent.completions", 1, labels, { unit: UNITS.COMPLETION });
107
+ if (transcriptPath && input.agent_type) {
108
+ await recordAgentTranscriptMetrics(ctx, transcriptPath, labels[AGENT_ATTRS.TYPE]);
109
+ }
110
+ }, { [HOOK_TYPE_ATTR]: "agent" });
111
+ }
112
+ export {
113
+ handleSubagentStart,
114
+ handleSubagentStop
115
+ };
116
+ //# sourceMappingURL=subagent-CBCG4OLZ.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../handlers/subagent.ts"],
4
+ "sourcesContent": ["/**\n * SubagentStart / SubagentStop (CCH4): the agent's own lifecycle, as opposed to\n * the dispatch view in pre-tool.ts and the tool-result view in post-tool-agent.ts.\n *\n * Claude Code also fires SubagentStop for its internal background-task\n * sidechains: an agent_id, no agent_type, no SubagentStart, and a transcript\n * path that never exists. Those are labeled `harness-internal` \u2014 a different\n * population, not user agents \u2014 because counting them as completions inflated\n * per-agent stats ~5\u00D7.\n */\n\nimport { existsSync } from 'node:fs';\nimport { UNITS } from '../lib/core/units.js';\nimport { AGENT_ATTRS, GENAI_AGENT_ATTRIBUTES, GENAI_OPERATION, HOOK_NAMES, HOOK_TYPE_ATTR } from '../lib/otel/attributes.js';\nimport { instrumentHook } from '../lib/otel/otel-monitor.js';\nimport type { HookContext } from '../lib/otel/otel-monitor.js';\nimport { agentTypeLabels, type AgentTypeLabels } from '../lib/runtime/categorizers.js';\nimport type { SubagentStartHookInput, SubagentStopHookInput } from '../lib/runtime/hook-input.js';\nimport { resolveAgentName } from '../lib/session/forked-skill.js';\n\nconst HARNESS_INTERNAL_AGENT_TYPE = 'harness-internal';\n\n/** Span flag: whether the agent's transcript was read for the OBP9 metrics. */\nconst TRANSCRIPT_MEASURED_ATTR = 'integritystudio.agent.transcript_measured';\n\nfunction agentLabels(input: SubagentStartHookInput): AgentTypeLabels {\n return agentTypeLabels(resolveAgentName(input) ?? HARNESS_INTERNAL_AGENT_TYPE);\n}\n\nexport async function handleSubagentStart(input: SubagentStartHookInput): Promise<void> {\n await instrumentHook(HOOK_NAMES.SUBAGENT_START, (ctx) => {\n const labels = agentLabels(input);\n\n ctx.addAttributes({ [AGENT_ATTRS.INSTANCE_ID]: input.agent_id ?? '', ...labels });\n\n ctx.logger.info('Subagent started', {\n [AGENT_ATTRS.TYPE]: labels[AGENT_ATTRS.TYPE],\n [AGENT_ATTRS.INSTANCE_ID]: input.agent_id ?? '',\n });\n\n // `subagent.*`, not `agent.*`: `integritystudio.agent.*` are post-tool's per-tool-result metrics.\n ctx.recordMetric('integritystudio.subagent.starts', 1, labels, { unit: UNITS.INVOCATION });\n }, { [HOOK_TYPE_ATTR]: 'agent' });\n}\n\n/**\n * The GenAI agent metrics (OBP9) from one transcript read. `gen_ai.response.model`,\n * not `gen_ai.request.model`, which the spec says SHOULD NOT be set for agents with\n * dynamic model selection. The `execute_tool.duration` samples here carry\n * `gen_ai.agent.name`; main-loop samples (stop-token-metrics.ts, OBP9b) carry none,\n * which is how the two populations are told apart.\n */\nasync function recordAgentTranscriptMetrics(\n ctx: HookContext,\n transcriptPath: string,\n agentName: string\n): Promise<void> {\n // Loaded here, not at module top: SubagentStart and harness-internal stops never reach this branch.\n const [\n { readAgentTranscriptMeasures },\n { recordModelTotals, recordToolDurations },\n ] = await Promise.all([\n import('../lib/transcript/agent-transcript-metrics.js'),\n import('../lib/otel/token-metrics.js'),\n ]);\n const measures = readAgentTranscriptMeasures(transcriptPath);\n // An unreadable or oversized transcript emits no samples, distinguishable from a genuine zero.\n if (!measures) {\n ctx.addAttribute(TRANSCRIPT_MEASURED_ATTR, false);\n return;\n }\n\n const attrs = {\n [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: agentName,\n ...(measures.model ? { [GENAI_AGENT_ATTRIBUTES.RESPONSE_MODEL]: measures.model } : {}),\n };\n\n ctx.recordMetric('gen_ai.invoke_agent.inference_calls', measures.inferenceCalls, attrs, {\n unit: UNITS.INFERENCE_CALL,\n });\n ctx.recordMetric('gen_ai.invoke_agent.tool_calls', measures.toolCalls, attrs, {\n unit: UNITS.TOOL_CALL,\n });\n\n recordToolDurations(ctx.recordMetric, measures.toolDurations, {\n [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: agentName,\n });\n\n ctx.addAttributes({\n [TRANSCRIPT_MEASURED_ATTR]: true,\n 'integritystudio.agent.inference_calls': measures.inferenceCalls,\n 'integritystudio.agent.tool_calls': measures.toolCalls,\n });\n\n // Each datapoint carries its own model, unlike the agent-level signals above (gen-ai-token-metrics.md).\n for (const [model, totals] of Object.entries(measures.tokenUsageByModel)) {\n recordModelTotals(model, totals, GENAI_OPERATION.INVOKE_AGENT, {\n [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: agentName,\n });\n }\n}\n\n/** The transcript path only when the file exists: harness-internal stops carry a path that is never written. */\nfunction existingTranscriptPath(path: string | undefined): string | undefined {\n return path && existsSync(path) ? path : undefined;\n}\n\nexport async function handleSubagentStop(input: SubagentStopHookInput): Promise<void> {\n await instrumentHook(HOOK_NAMES.SUBAGENT_STOP, async (ctx) => {\n const labels = agentLabels(input);\n const transcriptPath = existingTranscriptPath(input.agent_transcript_path);\n\n ctx.addAttributes({\n [AGENT_ATTRS.INSTANCE_ID]: input.agent_id ?? '',\n ...labels,\n [AGENT_ATTRS.TRANSCRIPT_PATH]: input.agent_transcript_path ?? '',\n [AGENT_ATTRS.HAS_TRANSCRIPT]: transcriptPath !== undefined,\n [AGENT_ATTRS.STOP_HOOK_ACTIVE]: !!input.stop_hook_active,\n [AGENT_ATTRS.LAST_MESSAGE_LENGTH]: (input.last_assistant_message ?? '').length,\n });\n\n ctx.logger.info('Subagent stopped', {\n [AGENT_ATTRS.TYPE]: labels[AGENT_ATTRS.TYPE],\n [AGENT_ATTRS.INSTANCE_ID]: input.agent_id ?? '',\n });\n\n ctx.recordMetric('integritystudio.subagent.completions', 1, labels, { unit: UNITS.COMPLETION });\n\n // OBP9: gated on a real agent_type so `harness-internal` never gets a series under a spec metric name.\n if (transcriptPath && input.agent_type) {\n await recordAgentTranscriptMetrics(ctx, transcriptPath, labels[AGENT_ATTRS.TYPE]);\n }\n }, { [HOOK_TYPE_ATTR]: 'agent' });\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,31 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ cacheHitRate,
5
+ recordInferenceCost,
6
+ recordModelTotals,
7
+ recordTokenUsage,
8
+ recordToolDurations,
9
+ waitKindAttributes
10
+ } from "./chunk-FGKYDQHZ.js";
11
+ import "./chunk-VT5T6OEI.js";
12
+ import "./chunk-X7XLMSZX.js";
13
+ import "./chunk-4KWBQTTG.js";
14
+ import "./chunk-7OM5CYES.js";
15
+ import "./chunk-GG2I4TGI.js";
16
+ import "./chunk-SRMAJQMV.js";
17
+ import "./chunk-YHYDBLVB.js";
18
+ import "./chunk-DNSTWC26.js";
19
+ import "./chunk-52RY6LQT.js";
20
+ import "./chunk-RWRGC7ZK.js";
21
+ import "./chunk-7PEOKGYR.js";
22
+ import "./chunk-GNNKUMRF.js";
23
+ export {
24
+ cacheHitRate,
25
+ recordInferenceCost,
26
+ recordModelTotals,
27
+ recordTokenUsage,
28
+ recordToolDurations,
29
+ waitKindAttributes
30
+ };
31
+ //# sourceMappingURL=token-metrics-AD2RAFGM.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": [],
4
+ "sourcesContent": [],
5
+ "mappings": "",
6
+ "names": []
7
+ }