ctxtop 4.1.0 → 4.1.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 (318) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +51 -44
  4. package/LICENSE +27 -27
  5. package/README.md +90 -56
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ctxtop.mjs +267 -54
  9. package/config/modelCatalog.json +847 -273
  10. package/hooks/handlers/hookIpcClient.mjs +8 -4
  11. package/hooks/handlers/post-model-switch.mjs +39 -2
  12. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  13. package/hooks/handlers/post-tool-use.mjs +54 -321
  14. package/hooks/handlers/pre-model-switch.mjs +115 -5
  15. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  16. package/hooks/handlers/pre-tool-use.mjs +61 -571
  17. package/hooks/handlers/stop-gate.mjs +20 -8
  18. package/hooks/handlers/user-prompt-submit.mjs +111 -2
  19. package/hooks/post_tool_use.mjs +17 -4
  20. package/hooks/pre_tool_use.mjs +84 -54
  21. package/hooks.json +56 -56
  22. package/package.json +4 -3
  23. package/packages/antigravity/package.json +10 -3
  24. package/packages/antigravity/src/adapter.mjs +109 -0
  25. package/packages/antigravity/src/index.mjs +7 -1
  26. package/packages/claude-code/package.json +10 -3
  27. package/packages/claude-code/src/adapter.mjs +194 -0
  28. package/packages/claude-code/src/index.mjs +8 -2
  29. package/packages/claude-code/src/register.js +726 -0
  30. package/packages/core/package.json +6 -2
  31. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  32. package/packages/core/src/catalog/index.mjs +1 -0
  33. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  34. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  35. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  36. package/packages/core/src/coach/microSkills.mjs +1 -0
  37. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  38. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  39. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  40. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  41. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  42. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  43. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  44. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  45. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  46. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  47. package/packages/core/src/control/callTree.mjs +338 -0
  48. package/packages/core/src/control/coachLatches.mjs +126 -0
  49. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  50. package/packages/core/src/control/index.mjs +49 -0
  51. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  52. package/packages/core/src/control/toolSuspension.mjs +197 -0
  53. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  54. package/packages/core/src/diagnostics/index.mjs +9 -0
  55. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  56. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  57. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  58. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  59. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  60. package/packages/core/src/economics/driftLatency.mjs +433 -0
  61. package/packages/core/src/economics/dualTtl.mjs +198 -0
  62. package/packages/core/src/economics/index.mjs +47 -0
  63. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  64. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  65. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  66. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  67. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  68. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  69. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  70. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  71. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  72. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  73. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  74. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  75. package/packages/core/src/index.js +27 -0
  76. package/packages/core/src/index.mjs +25 -1
  77. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  78. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  79. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  80. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  81. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  82. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  83. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  84. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  85. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  86. package/packages/core/src/ui/modViews.mjs +1558 -0
  87. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  88. package/packages/core/src/ustf/index.mjs +7 -0
  89. package/packages/core/src/ustf/normalizer.mjs +512 -0
  90. package/packages/core/src/ustf/schema.mjs +186 -0
  91. package/packages/core/src/utils/runtime.mjs +962 -0
  92. package/packages/engine-node/package.json +6 -2
  93. package/packages/engine-node/src/db/index.mjs +58 -0
  94. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  95. package/packages/engine-node/src/db/probe.mjs +342 -0
  96. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  97. package/packages/engine-node/src/index.mjs +11 -1
  98. package/packages/engine-node/src/ipc/client.mjs +447 -0
  99. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  100. package/packages/engine-node/src/ipc/index.mjs +24 -0
  101. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  102. package/packages/engine-node/src/ipc/server.mjs +445 -0
  103. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  104. package/packages/engine-node/src/offloader/index.mjs +6 -0
  105. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  106. package/packages/engine-node/src/rsl/index.mjs +3 -0
  107. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  108. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  109. package/packages/engine-node/src/sensors/index.mjs +7 -0
  110. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  111. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  112. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  113. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  114. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  115. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  116. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  117. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  118. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  119. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  120. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  121. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  122. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  123. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  124. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  125. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  126. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  127. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  128. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  129. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  181. package/packages/mcp/package.json +7 -3
  182. package/packages/mcp/src/server.mjs +115 -14
  183. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  184. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  185. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  186. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  187. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  188. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  189. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  190. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  191. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  192. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  193. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  194. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  195. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  196. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  197. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  198. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  199. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  200. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  201. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  202. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  203. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  204. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  256. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  257. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  258. package/packages/pro/package.json +23 -16
  259. package/packages/pro/src/index.mjs +9 -3
  260. package/packages/pro/src/pro_license.mjs +547 -0
  261. package/packages/pro/src/team_finops_pack.mjs +241 -241
  262. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  263. package/plugin.json +1 -1
  264. package/sidecars/horizon-daemon/server.mjs +482 -44
  265. package/src/cli/doctor.mjs +11 -2
  266. package/src/cli/horizon_hud.mjs +31 -15
  267. package/src/cli/init.mjs +46 -13
  268. package/src/config/modelCatalog.json +886 -231
  269. package/src/core/classifier.mjs +25 -11
  270. package/src/core/coach/circuit_breakers.mjs +84 -6
  271. package/src/core/coach/task_quota_router.mjs +8 -0
  272. package/src/core/code_fold_lite.mjs +169 -0
  273. package/src/core/config.mjs +44 -0
  274. package/src/core/constants.mjs +175 -12
  275. package/src/core/detectors_det01_to_16.mjs +44 -3
  276. package/src/core/fts5_output_compressor.mjs +272 -35
  277. package/src/core/horizon_config.mjs +42 -0
  278. package/src/core/parser.mjs +86 -11
  279. package/src/core/pro_license.mjs +174 -12
  280. package/src/core/pruner.mjs +7 -146
  281. package/src/core/quota.mjs +14 -2
  282. package/src/core/rsl_distiller.mjs +31 -9
  283. package/src/core/rsl_ledger.mjs +66 -6
  284. package/src/core/rsl_triage.mjs +159 -17
  285. package/src/core/session_auditor.mjs +476 -25
  286. package/src/core/shadow_auto_ledger.mjs +205 -0
  287. package/src/core/sqlite_client.mjs +10 -4
  288. package/src/core/subagents.mjs +18 -2
  289. package/src/core/task_quota_router.mjs +61 -4
  290. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  291. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  292. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +54 -20
  293. package/src/core-isomorphic/config/anthropicModelCatalog.json +1 -0
  294. package/src/core-isomorphic/config/catalogLoader.mjs +6 -3
  295. package/src/core-isomorphic/config/horizonConfig.mjs +1 -1
  296. package/src/core-isomorphic/economics/cacheGravity.mjs +3 -1
  297. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  298. package/src/core-isomorphic/guards/bucketBGamma.mjs +1 -1
  299. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +77 -1
  300. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +395 -130
  301. package/src/core-isomorphic/ui/modViews.mjs +62 -8
  302. package/src/diagnostics/claudeHookCapabilities.mjs +32 -2
  303. package/src/diagnostics/doctorEngine.mjs +28 -2
  304. package/src/engine-node/ipc/fast_client.mjs +191 -0
  305. package/src/engine-node/ipc/index.mjs +2 -0
  306. package/src/engine-node/multi_host_mcp.mjs +168 -0
  307. package/src/hooks/antigravity_rsl_hook.mjs +24 -2
  308. package/src/hooks/claude_rsl_hook.mjs +22 -2
  309. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  310. package/src/hooks/fast_hook_ipc.mjs +295 -0
  311. package/src/hooks/post_invocation.mjs +37 -597
  312. package/src/hooks/post_invocation_core.mjs +623 -0
  313. package/src/hooks/pre_invocation.mjs +103 -1668
  314. package/src/hooks/pre_invocation_core.mjs +1830 -0
  315. package/src/utils/sessionCalibration.mjs +52 -5
  316. package/src/webview/advanced_view.html +34 -18
  317. package/src/webview/horizon_panel.html +3233 -675
  318. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,1232 @@
1
+ /**
2
+ * @file src/telemetry/telemetryBridge.mjs
3
+ * Dual-Source Telemetry Engine for Claude Code Highbeam.
4
+ * Ingests live token/cache telemetry from:
5
+ * 1. In-process Mod `turn.step` / `turn.complete` (`result.usage` + `e.agentId`)
6
+ * 2. CLI `statusLine` stdin JSON (`context_window`, `prompt_cache`, `rate_limits`)
7
+ * Never sums raw JSONL `usage.input_tokens` placeholders.
8
+ * Computes exact USD Cache ROI and persists atomic bridge snapshots to
9
+ * `.claude/cache/ah_live_state_<sessionId>.json`.
10
+ */
11
+
12
+ import { path, getCwd, writeJsonAtomic, readJsonSafe } from '../utils/runtime.mjs';
13
+ import {
14
+ normalizeModelId,
15
+ resolveCustomCeilingForModel,
16
+ extractNormalizedTokenBreakdown,
17
+ computeTotalPromptTokens,
18
+ resolveEffectiveRates,
19
+ calculateTurnCostUSD
20
+ } from '../config/catalogLoader.mjs';
21
+ import { exportOtelTelemetry } from './otelExporter.mjs';
22
+ import { applySubagentLifecycle } from './swarmTopology.mjs';
23
+ import {
24
+ createInitialPrefixRetention,
25
+ createInitialThinkingDrift,
26
+ applyPrefixRetentionRequest,
27
+ applyThinkingDriftEvent
28
+ } from './sprintMetrics.mjs';
29
+ import {
30
+ createInitialEffortTrackingState,
31
+ extractEventEffortObservation,
32
+ applyTurnEffortObservation
33
+ } from '../coach/effortShiftDetector.mjs';
34
+
35
+ export const SESSION_FIVE_MIN_ROI_TARGET = 1.39;
36
+
37
+ /**
38
+ * Computes dynamic single-write USD break-even read/write ratio `(mWrite - 1) / (1 - mRead)`
39
+ * from model rate multipliers, weighting 5m and 1h writes when both are present (`ISS-006`).
40
+ *
41
+ * @param {object} rates
42
+ * @param {number} [write5mTokens=0]
43
+ * @param {number} [write1hTokens=0]
44
+ * @param {'5m'|'1h'} [ttlTier='5m']
45
+ * @returns {number}
46
+ */
47
+ function computeBreakEvenRatioFromRates(
48
+ rates,
49
+ write5mTokens = 0,
50
+ write1hTokens = 0,
51
+ ttlTier = '5m'
52
+ ) {
53
+ if (rates?.unknownModel) return null;
54
+ const mults = rates?.multipliers || { write5m: 1.25, write1h: 2.0, read: 0.05 };
55
+ const w5 = Math.max(0, Number(write5mTokens || 0));
56
+ const w1 = Math.max(0, Number(write1hTokens || 0));
57
+ const totalW = w5 + w1;
58
+ const mWrite =
59
+ totalW > 0
60
+ ? (w5 * mults.write5m + w1 * mults.write1h) / totalW
61
+ : ttlTier === '1h'
62
+ ? mults.write1h
63
+ : mults.write5m;
64
+ const mRead = Number(mults.read ?? 0.05);
65
+ const denom = 1 - mRead;
66
+ if (denom <= 0) return Infinity;
67
+ return Number((Math.max(0, mWrite - 1) / denom).toFixed(3));
68
+ }
69
+
70
+ /**
71
+ * Sanitizes a session ID for safe filesystem paths.
72
+ * @param {string} [sessionId='default']
73
+ * @returns {string}
74
+ */
75
+ export function sanitizeSessionId(sessionId = 'default') {
76
+ const cleaned = String(sessionId || 'default')
77
+ .trim()
78
+ .replace(/[^a-zA-Z0-9_-]/g, '_');
79
+ return cleaned || 'default';
80
+ }
81
+
82
+ /**
83
+ * Resolves the atomic bridge file path `.claude/cache/ah_live_state_<sessionId>.json`.
84
+ * @param {string} [sessionId='default']
85
+ * @param {object} [options={}]
86
+ * @returns {string}
87
+ */
88
+ export function getLiveStateBridgePath(sessionId = 'default', options = {}) {
89
+ const cwd = getCwd(options);
90
+ const safeId = sanitizeSessionId(sessionId);
91
+ return path.join(cwd, '.claude', 'cache', `ah_live_state_${safeId}.json`);
92
+ }
93
+
94
+ /**
95
+ * Computes exact USD Cache ROI and break-even read/write ratio for a model and token distribution.
96
+ * Flags Negative Cache ROI strictly when `ActualCacheSpendUSD > UncachedEquivalentUSD`
97
+ * (i.e. `reads / write < (M_write - 1) / (1 - M_read)`, which is `0.263` for 5m Opus/Sonnet 5.5
98
+ * and `1.053` for 1h writes).
99
+ *
100
+ * @param {object} [params={}]
101
+ * @param {string} [params.model='claude-sonnet-5-5']
102
+ * @param {number} [params.cacheWriteTokens=0]
103
+ * @param {number} [params.cacheWrite5mTokens=0]
104
+ * @param {number} [params.cacheWrite1hTokens=0]
105
+ * @param {number} [params.cacheReadTokens=0]
106
+ * @param {number} [params.uncachedInputTokens=0]
107
+ * @param {number} [params.outputTokens=0]
108
+ * @param {number} [params.thinkingTokens=0]
109
+ * @param {number} [params.totalPromptTokens]
110
+ * @param {'5m'|'1h'} [params.cacheTtlTier='5m']
111
+ * @param {object} [options={}]
112
+ */
113
+ export function computeCacheRoi(params = {}, options = {}) {
114
+ const ttlTier = params.cacheTtlTier === '1h' ? '1h' : '5m';
115
+ const turnCalc = calculateTurnCostUSD(
116
+ {
117
+ ...params,
118
+ model: params.model || 'claude-sonnet-5-5',
119
+ inputTokens:
120
+ params.uncachedInputTokens ?? params.freshInputTokens ?? params.inputTokens ?? params.input_tokens ?? 0,
121
+ outputTokens: params.outputTokens ?? params.output_tokens ?? 0,
122
+ thinkingTokens: params.thinkingTokens ?? params.thinking_tokens ?? 0,
123
+ cacheWriteTokens:
124
+ params.cacheWriteTokens ?? params.cacheCreationInputTokens ?? params.cache_creation_input_tokens ?? 0,
125
+ cacheWrite5mTokens: params.cacheWrite5mTokens ?? params.cache_write_5m_tokens ?? 0,
126
+ cacheWrite1hTokens: params.cacheWrite1hTokens ?? params.cache_write_1h_tokens ?? 0,
127
+ cacheReadTokens:
128
+ params.cacheReadTokens ?? params.cacheReadInputTokens ?? params.cache_read_input_tokens ?? 0,
129
+ totalPromptTokens: params.totalPromptTokens,
130
+ cacheTtlTier: ttlTier
131
+ },
132
+ options
133
+ );
134
+
135
+ const rates = turnCalc.rates;
136
+ const { cacheWrite5m, cacheWrite1h, totalCacheWrite, cacheRead, uncachedInput, totalPrompt } =
137
+ turnCalc.tokens;
138
+ const {
139
+ actualCacheSpendUSD,
140
+ uncachedCacheEquivalentUSD,
141
+ totalActualSpendUSD,
142
+ totalUncachedEquivalentUSD,
143
+ netCacheSavingsUSD
144
+ } = turnCalc.costsUSD;
145
+
146
+ const breakEvenReadsPerWrite = computeBreakEvenRatioFromRates(
147
+ rates,
148
+ cacheWrite5m,
149
+ cacheWrite1h,
150
+ ttlTier
151
+ );
152
+
153
+ const readsPerWriteRatio =
154
+ totalCacheWrite > 0
155
+ ? Number((cacheRead / totalCacheWrite).toFixed(4))
156
+ : cacheRead > 0
157
+ ? Infinity
158
+ : 0;
159
+
160
+ const negativeCacheRoi = Boolean(
161
+ totalCacheWrite > 0 && actualCacheSpendUSD > uncachedCacheEquivalentUSD + 1e-9
162
+ );
163
+
164
+ const cacheHitRatio =
165
+ totalPrompt > 0 ? Number((cacheRead / totalPrompt).toFixed(4)) : 0;
166
+
167
+ return {
168
+ modelId: rates.modelId,
169
+ cacheTtlTier: ttlTier,
170
+ actualCacheSpendUSD,
171
+ actualSpendUSD: actualCacheSpendUSD,
172
+ uncachedEquivalentUSD: uncachedCacheEquivalentUSD,
173
+ uncachedBaselineUSD: uncachedCacheEquivalentUSD,
174
+ totalActualSpendUSD,
175
+ totalUncachedEquivalentUSD,
176
+ netCacheSavingsUSD,
177
+ negativeCacheRoi,
178
+ readsPerWriteRatio,
179
+ breakEvenReadsPerWrite,
180
+ sessionFiveMinRoiTarget: SESSION_FIVE_MIN_ROI_TARGET,
181
+ cacheHitRatio,
182
+ cliffTriggered: rates.cliffTriggered,
183
+ preCliffWarningTriggered: rates.preCliffWarningTriggered,
184
+ tokens: {
185
+ uncachedInput,
186
+ cacheWrite: totalCacheWrite,
187
+ cacheRead,
188
+ totalPrompt
189
+ }
190
+ };
191
+ }
192
+
193
+ /**
194
+ * Computes session-wide Cache ROI directly from accumulated per-turn USD spend in `state.cumulative`,
195
+ * never retroactively re-pricing multi-turn cumulative token sums against single-turn 5x cliffs (`ISS-003`).
196
+ *
197
+ * @param {object} state
198
+ * @param {object} currentRates
199
+ * @returns {object}
200
+ */
201
+ function buildCumulativeCacheRoi(state, currentRates) {
202
+ const ttlTier = state.promptCache?.ttlTier === '1h' ? '1h' : '5m';
203
+ const cum = state.cumulative || {};
204
+ const write5m = Math.max(0, Number(cum.cacheWrite5mTokens || 0));
205
+ const write1h = Math.max(0, Number(cum.cacheWrite1hTokens || 0));
206
+ const totalCacheWrite = write5m + write1h;
207
+ const cacheRead = Math.max(0, Number(cum.cacheReadTokens || 0));
208
+ const uncachedInput = Math.max(0, Number(cum.uncachedInputTokens || 0));
209
+ const totalPrompt = uncachedInput + totalCacheWrite + cacheRead;
210
+
211
+ const actualCacheSpendUSD = Number((cum.actualCacheSpendUSD || 0).toFixed(6));
212
+ const uncachedEquivalentUSD = Number(
213
+ (cum.uncachedEquivalentUSD ?? cum.uncachedBaselineUSD ?? 0).toFixed(6)
214
+ );
215
+ const totalActualSpendUSD = Number((cum.totalActualSpendUSD || 0).toFixed(6));
216
+ const totalUncachedEquivalentUSD = Number((cum.totalUncachedEquivalentUSD || 0).toFixed(6));
217
+ const netCacheSavingsUSD = Number((uncachedEquivalentUSD - actualCacheSpendUSD).toFixed(6));
218
+
219
+ const breakEvenReadsPerWrite = computeBreakEvenRatioFromRates(
220
+ currentRates,
221
+ write5m,
222
+ write1h,
223
+ ttlTier
224
+ );
225
+ const readsPerWriteRatio =
226
+ totalCacheWrite > 0
227
+ ? Number((cacheRead / totalCacheWrite).toFixed(4))
228
+ : cacheRead > 0
229
+ ? Infinity
230
+ : 0;
231
+ const negativeCacheRoi = Boolean(
232
+ totalCacheWrite > 0 && actualCacheSpendUSD > uncachedEquivalentUSD + 1e-9
233
+ );
234
+ const cacheHitRatio =
235
+ totalPrompt > 0 ? Number((cacheRead / totalPrompt).toFixed(4)) : 0;
236
+
237
+ return {
238
+ modelId: currentRates.modelId,
239
+ cacheTtlTier: ttlTier,
240
+ actualCacheSpendUSD,
241
+ actualSpendUSD: actualCacheSpendUSD,
242
+ uncachedEquivalentUSD,
243
+ uncachedBaselineUSD: uncachedEquivalentUSD,
244
+ totalActualSpendUSD,
245
+ totalUncachedEquivalentUSD,
246
+ netCacheSavingsUSD,
247
+ negativeCacheRoi,
248
+ readsPerWriteRatio,
249
+ breakEvenReadsPerWrite,
250
+ sessionFiveMinRoiTarget: SESSION_FIVE_MIN_ROI_TARGET,
251
+ cacheHitRatio,
252
+ cliffTriggered: Boolean(currentRates.cliffTriggered),
253
+ preCliffWarningTriggered: Boolean(currentRates.preCliffWarningTriggered),
254
+ tokens: {
255
+ uncachedInput,
256
+ cacheWrite: totalCacheWrite,
257
+ cacheRead,
258
+ totalPrompt
259
+ }
260
+ };
261
+ }
262
+
263
+ /**
264
+ * Adds a single turn's (or positive step delta's) priced token & USD breakdown into `state.cumulative`.
265
+ * @param {object} cumulative
266
+ * @param {object} turnCost
267
+ */
268
+ function addTurnCostToCumulative(cumulative, turnCost) {
269
+ const { uncachedInput, cacheWrite5m, cacheWrite1h, cacheRead, output, thinking } =
270
+ turnCost.tokens;
271
+ cumulative.uncachedInputTokens += uncachedInput;
272
+ cumulative.cacheWrite5mTokens += cacheWrite5m;
273
+ cumulative.cacheWrite1hTokens += cacheWrite1h;
274
+ cumulative.cacheReadTokens += cacheRead;
275
+ cumulative.outputTokens += output;
276
+ cumulative.thinkingTokens += thinking;
277
+
278
+ if (turnCost.unknownModel || turnCost.costsUSD?.totalActualSpendUSD === null) {
279
+ cumulative.hasUnknownModelCost = true;
280
+ return;
281
+ }
282
+
283
+ const {
284
+ actualCacheSpendUSD,
285
+ uncachedCacheEquivalentUSD,
286
+ totalActualSpendUSD,
287
+ totalUncachedEquivalentUSD
288
+ } = turnCost.costsUSD;
289
+
290
+ cumulative.actualCacheSpendUSD = Number(
291
+ (cumulative.actualCacheSpendUSD + actualCacheSpendUSD).toFixed(6)
292
+ );
293
+ cumulative.uncachedEquivalentUSD = Number(
294
+ (cumulative.uncachedEquivalentUSD + uncachedCacheEquivalentUSD).toFixed(6)
295
+ );
296
+ cumulative.uncachedBaselineUSD = cumulative.uncachedEquivalentUSD;
297
+ cumulative.totalActualSpendUSD = Number(
298
+ (cumulative.totalActualSpendUSD + totalActualSpendUSD).toFixed(6)
299
+ );
300
+ cumulative.totalUncachedEquivalentUSD = Number(
301
+ (cumulative.totalUncachedEquivalentUSD + totalUncachedEquivalentUSD).toFixed(6)
302
+ );
303
+ cumulative.netCacheSavingsUSD = Number(
304
+ (cumulative.uncachedEquivalentUSD - cumulative.actualCacheSpendUSD).toFixed(6)
305
+ );
306
+ }
307
+
308
+ /**
309
+ * Creates a clean initial session telemetry state object.
310
+ * @param {string} [sessionId='default']
311
+ * @param {string} [model='claude-sonnet-5-5']
312
+ * @returns {object}
313
+ */
314
+ export function createInitialTelemetryState(sessionId = 'default', model = 'claude-sonnet-5-5') {
315
+ const normModel = normalizeModelId(model);
316
+ const rates = resolveEffectiveRates(model, 0);
317
+ const initialBreakEven = computeBreakEvenRatioFromRates(rates, 0, 0, '5m');
318
+ return {
319
+ schemaVersion: '2026.11.1',
320
+ sessionId: sanitizeSessionId(sessionId),
321
+ modelId: normModel,
322
+ rawModelId: String(model || normModel),
323
+ modelLabel: rates.label,
324
+ contextCeiling: rates.contextCeiling,
325
+ steps: 0,
326
+ turnsCompleted: 0,
327
+ lastUpdatedAt: Date.now(),
328
+ lastSource: 'init',
329
+ lastAgentId: null,
330
+ contextWindow: {
331
+ totalInputTokens: 0,
332
+ uncachedInputTokens: 0,
333
+ cachedTokens: 0,
334
+ cacheReadTokens: 0,
335
+ cacheWriteTokens: 0,
336
+ warmPrefixTokens: 0,
337
+ lastWriteTokens: 0,
338
+ lastOutputTokens: 0,
339
+ lastThinkingTokens: 0,
340
+ systemAndMcpTokens: 0,
341
+ distractorTokens: 0,
342
+ customCeiling: null,
343
+ contextCeiling: rates.contextCeiling
344
+ },
345
+ cumulative: {
346
+ uncachedInputTokens: 0,
347
+ cacheWrite5mTokens: 0,
348
+ cacheWrite1hTokens: 0,
349
+ cacheReadTokens: 0,
350
+ outputTokens: 0,
351
+ thinkingTokens: 0,
352
+ actualCacheSpendUSD: 0,
353
+ uncachedEquivalentUSD: 0,
354
+ uncachedBaselineUSD: 0,
355
+ totalActualSpendUSD: 0,
356
+ totalUncachedEquivalentUSD: 0,
357
+ netCacheSavingsUSD: 0
358
+ },
359
+ promptCache: {
360
+ warm: false,
361
+ ttlTier: '5m',
362
+ ttlSeconds: 300,
363
+ expiresAt: null,
364
+ lastMissCause: null
365
+ },
366
+ cacheRoi: {
367
+ actualCacheSpendUSD: 0,
368
+ actualSpendUSD: 0,
369
+ uncachedEquivalentUSD: 0,
370
+ uncachedBaselineUSD: 0,
371
+ netCacheSavingsUSD: 0,
372
+ negativeCacheRoi: false,
373
+ readsPerWriteRatio: 0,
374
+ breakEvenReadsPerWrite: initialBreakEven,
375
+ sessionFiveMinRoiTarget: SESSION_FIVE_MIN_ROI_TARGET,
376
+ cacheHitRatio: 0
377
+ },
378
+ rateLimits: {
379
+ fiveHour: null,
380
+ sevenDay: null,
381
+ spendLimit: null
382
+ },
383
+ subagents: {},
384
+ inFlightTurn: null,
385
+ subagentInFlightTurns: {},
386
+ lastCompletedTurnId: null,
387
+ lastStatusTurnId: null,
388
+ lastReportedStatusCostUSD: null,
389
+ lastStatusLineEnvelopeSig: null,
390
+ cliffTriggered: false,
391
+ preCliffWarningTriggered: false,
392
+ prefixRetention: createInitialPrefixRetention(),
393
+ thinkingDrift: createInitialThinkingDrift(),
394
+ effortTracking: createInitialEffortTrackingState(),
395
+ lastTurn: null
396
+ };
397
+ }
398
+
399
+ /**
400
+ * Normalizes a TTL value from `statusLine` or Mod payload into `{ ttlTier: '5m'|'1h', ttlSeconds: number }`.
401
+ * Explicit `0` / `'0s'` / negative values return `ttlSeconds: 0` (`ISS-027`).
402
+ * @param {string|number|undefined} rawTtl
403
+ * @returns {{ ttlTier: '5m'|'1h', ttlSeconds: number }}
404
+ */
405
+ function parseTtlInfo(rawTtl) {
406
+ if (rawTtl === 0 || rawTtl === '0' || rawTtl === '0s' || (typeof rawTtl === 'number' && rawTtl <= 0)) {
407
+ return { ttlTier: '5m', ttlSeconds: 0 };
408
+ }
409
+ if (typeof rawTtl === 'string') {
410
+ const trimmed = rawTtl.trim().toLowerCase();
411
+ if (trimmed === '1h') return { ttlTier: '1h', ttlSeconds: 3600 };
412
+ if (trimmed === '5m') return { ttlTier: '5m', ttlSeconds: 300 };
413
+ const secMatch = trimmed.match(/^(-?\d+(?:\.\d+)?)s?$/);
414
+ if (secMatch) {
415
+ const parsedSec = Number(secMatch[1]);
416
+ if (parsedSec <= 0) return { ttlTier: '5m', ttlSeconds: 0 };
417
+ if (parsedSec > 300) return { ttlTier: '1h', ttlSeconds: parsedSec };
418
+ return { ttlTier: '5m', ttlSeconds: parsedSec };
419
+ }
420
+ }
421
+ if (Number(rawTtl) > 300) {
422
+ return {
423
+ ttlTier: '1h',
424
+ ttlSeconds: typeof rawTtl === 'number' ? rawTtl : 3600
425
+ };
426
+ }
427
+ return {
428
+ ttlTier: '5m',
429
+ ttlSeconds: typeof rawTtl === 'number' && rawTtl > 0 ? rawTtl : 300
430
+ };
431
+ }
432
+
433
+ /**
434
+ * Normalizes `expires_at` (ISO string or epoch ms/seconds) to epoch milliseconds.
435
+ * @param {string|number|null|undefined} rawExpiresAt
436
+ * @param {number} fallbackNowMs
437
+ * @param {number} ttlSeconds
438
+ * @param {boolean} isWarm
439
+ * @returns {number | null}
440
+ */
441
+ function normalizeExpiresAtMs(rawExpiresAt, fallbackNowMs, ttlSeconds, isWarm) {
442
+ if (typeof rawExpiresAt === 'number' && Number.isFinite(rawExpiresAt)) {
443
+ return rawExpiresAt < 1e11 ? rawExpiresAt * 1000 : rawExpiresAt;
444
+ }
445
+ if (typeof rawExpiresAt === 'string' && rawExpiresAt.trim()) {
446
+ const parsed = Date.parse(rawExpiresAt);
447
+ if (!Number.isNaN(parsed)) return parsed;
448
+ }
449
+ if (isWarm && ttlSeconds > 0) {
450
+ return fallbackNowMs + ttlSeconds * 1000;
451
+ }
452
+ return null;
453
+ }
454
+
455
+ /**
456
+ * Computes strictly non-negative token delta between two token breakdown snapshots (`ISS-027`).
457
+ * @param {object} current
458
+ * @param {object} baseline
459
+ */
460
+ function computePositiveTokenDelta(current, baseline) {
461
+ if (!baseline) return { ...current };
462
+ return {
463
+ uncachedInputTokens: Math.max(
464
+ 0,
465
+ current.uncachedInputTokens - (baseline.uncachedInputTokens || 0)
466
+ ),
467
+ effectiveWrite5mTokens: Math.max(
468
+ 0,
469
+ current.effectiveWrite5mTokens - (baseline.effectiveWrite5mTokens || 0)
470
+ ),
471
+ effectiveWrite1hTokens: Math.max(
472
+ 0,
473
+ current.effectiveWrite1hTokens - (baseline.effectiveWrite1hTokens || 0)
474
+ ),
475
+ cacheReadTokens: Math.max(0, current.cacheReadTokens - (baseline.cacheReadTokens || 0)),
476
+ outputTokens: Math.max(0, current.outputTokens - (baseline.outputTokens || 0)),
477
+ thinkingTokens: Math.max(0, current.thinkingTokens - (baseline.thinkingTokens || 0))
478
+ };
479
+ }
480
+
481
+ function hasAnyPositiveTokens(delta) {
482
+ return (
483
+ delta.uncachedInputTokens +
484
+ delta.effectiveWrite5mTokens +
485
+ delta.effectiveWrite1hTokens +
486
+ delta.cacheReadTokens +
487
+ delta.outputTokens +
488
+ delta.thinkingTokens >
489
+ 0
490
+ );
491
+ }
492
+
493
+ /**
494
+ * Ingests a Mod `turn.step` or `turn.complete` event into the session telemetry state.
495
+ * Deduplicates `turn.step` + `turn.complete` per turn so `state.cumulative` commits 1x,
496
+ * and isolates subagent turns from overwriting the main `state.contextWindow` (`ISS-027`).
497
+ *
498
+ * @param {object} currentState
499
+ * @param {object} event
500
+ * @param {object} [options={}]
501
+ * @returns {object} Updated state
502
+ */
503
+ export function ingestModTurnEvent(currentState, event = {}, options = {}) {
504
+ const nowMs = options.nowMs || Date.now();
505
+ const sessionId = event.sessionId || event.session_id || currentState?.sessionId || 'default';
506
+ const rawEventModel = event.model || event.result?.model || null;
507
+ const fallbackModel = currentState?.rawModelId || currentState?.modelId || 'claude-sonnet-5-5';
508
+ const priorModelId = currentState?.rawModelId || currentState?.modelId || null;
509
+ const priorWarmPrefixTokens = Math.max(
510
+ 0,
511
+ Number(currentState?.contextWindow?.warmPrefixTokens || currentState?.contextWindow?.cachedTokens || 0)
512
+ );
513
+ const priorCacheWarm = Boolean(currentState?.promptCache?.warm);
514
+ const priorTurnsCompleted = Math.max(0, Number(currentState?.turnsCompleted || 0));
515
+ const state = currentState
516
+ ? JSON.parse(JSON.stringify(currentState))
517
+ : createInitialTelemetryState(sessionId, rawEventModel || fallbackModel);
518
+
519
+ state.sessionId = sanitizeSessionId(sessionId);
520
+ state.lastUpdatedAt = nowMs;
521
+ state.lastSource = event.type === 'turn.complete' ? 'mod.turn.complete' : 'mod.turn.step';
522
+ if (!state.subagentInFlightTurns || typeof state.subagentInFlightTurns !== 'object') {
523
+ state.subagentInFlightTurns = {};
524
+ }
525
+
526
+ const subagentId =
527
+ event.subagentId ||
528
+ event.subagent_id ||
529
+ (event.agentId && event.agentId !== 'main' ? event.agentId : null) ||
530
+ (event.agent_id && event.agent_id !== 'main' ? event.agent_id : null) ||
531
+ null;
532
+ const isSubagent = Boolean(
533
+ event.isSubagent || subagentId || event.parentSessionId || event.parent_session_id
534
+ );
535
+ const agentKey = isSubagent
536
+ ? subagentId || String(event.parentSessionId || event.parent_session_id || 'subagent')
537
+ : null;
538
+ state.lastAgentId = agentKey;
539
+
540
+ const turnId = event.turnId || event.turn_id || event.result?.turn_id || null;
541
+ const messageId =
542
+ event.messageId ||
543
+ event.message_id ||
544
+ event.message?.id ||
545
+ event.result?.id ||
546
+ event.result?.message?.id ||
547
+ null;
548
+
549
+ if (!isSubagent && event.type === 'turn.complete' && turnId && state.lastCompletedTurnId === turnId) {
550
+ return state;
551
+ }
552
+
553
+ const effectiveTurnModelRaw = isSubagent
554
+ ? rawEventModel || fallbackModel
555
+ : rawEventModel || fallbackModel;
556
+
557
+ if (!isSubagent && rawEventModel) {
558
+ state.rawModelId = String(rawEventModel);
559
+ state.modelId = normalizeModelId(rawEventModel);
560
+ }
561
+
562
+ const usage = event.result?.usage || event.usage || null;
563
+ if (!usage) {
564
+ if (event.type === 'turn.complete') {
565
+ if (!isSubagent) {
566
+ state.turnsCompleted += 1;
567
+ state.inFlightTurn = null;
568
+ if (turnId) state.lastCompletedTurnId = turnId;
569
+ } else if (agentKey) {
570
+ delete state.subagentInFlightTurns[agentKey];
571
+ if (state.subagents && state.subagents[agentKey]) {
572
+ applySubagentLifecycle(state.subagents[agentKey], event, { nowMs, eventType: 'turn.complete' });
573
+ }
574
+ }
575
+ }
576
+ return state;
577
+ }
578
+
579
+ const priorTtlTier = state.promptCache?.ttlTier === '1h' ? '1h' : '5m';
580
+ const initialBreakdown = extractNormalizedTokenBreakdown({ ...usage, cacheTtlTier: priorTtlTier });
581
+ const ttlTier =
582
+ !isSubagent && initialBreakdown.write1hTokens > 0 ? '1h' : priorTtlTier;
583
+ if (!isSubagent && ttlTier === '1h' && state.promptCache) {
584
+ state.promptCache.ttlTier = '1h';
585
+ }
586
+ const breakdown =
587
+ ttlTier === priorTtlTier
588
+ ? initialBreakdown
589
+ : extractNormalizedTokenBreakdown({ ...usage, cacheTtlTier: ttlTier });
590
+ const uncachedInput = breakdown.uncachedInputTokens;
591
+ const write5mTokens = breakdown.effectiveWrite5mTokens;
592
+ const write1hTokens = breakdown.effectiveWrite1hTokens;
593
+ const totalWriteTokens = breakdown.totalCacheWriteTokens;
594
+ const cacheReadTokens = breakdown.cacheReadTokens;
595
+ const outputTokens = breakdown.outputTokens;
596
+ const thinkingTokens = breakdown.thinkingTokens;
597
+ const totalPromptTokens = uncachedInput + totalWriteTokens + cacheReadTokens;
598
+
599
+ // Determine in-flight turn tracker (main vs isolated subagent) to prevent 2x double-counting
600
+ const activeTracker = isSubagent
601
+ ? state.subagentInFlightTurns[agentKey] || null
602
+ : state.inFlightTurn || null;
603
+
604
+ const sameTurn =
605
+ activeTracker &&
606
+ (!turnId || !activeTracker.turnId || turnId === activeTracker.turnId);
607
+
608
+ let deltaBreakdown = breakdown;
609
+ if (event.type === 'turn.complete') {
610
+ if (sameTurn) {
611
+ const compareBaseline =
612
+ messageId && activeTracker.lastMessageId && messageId === activeTracker.lastMessageId
613
+ ? activeTracker.lastStepTokens
614
+ : activeTracker.committedTokens;
615
+ deltaBreakdown = computePositiveTokenDelta(breakdown, compareBaseline);
616
+ }
617
+ if (isSubagent) {
618
+ delete state.subagentInFlightTurns[agentKey];
619
+ } else {
620
+ state.inFlightTurn = null;
621
+ if (turnId) state.lastCompletedTurnId = turnId;
622
+ }
623
+ } else {
624
+ // turn.step
625
+ state.steps += 1;
626
+ let updatedTracker;
627
+ if (sameTurn) {
628
+ if (messageId && activeTracker.lastMessageId && messageId === activeTracker.lastMessageId) {
629
+ // Streaming chunk update for the same message.id
630
+ deltaBreakdown = computePositiveTokenDelta(breakdown, activeTracker.lastStepTokens);
631
+ updatedTracker = {
632
+ turnId: turnId || activeTracker.turnId || null,
633
+ lastMessageId: messageId,
634
+ lastStepTokens: { ...breakdown },
635
+ committedTokens: {
636
+ uncachedInputTokens:
637
+ activeTracker.committedTokens.uncachedInputTokens + deltaBreakdown.uncachedInputTokens,
638
+ effectiveWrite5mTokens:
639
+ activeTracker.committedTokens.effectiveWrite5mTokens +
640
+ deltaBreakdown.effectiveWrite5mTokens,
641
+ effectiveWrite1hTokens:
642
+ activeTracker.committedTokens.effectiveWrite1hTokens +
643
+ deltaBreakdown.effectiveWrite1hTokens,
644
+ cacheReadTokens:
645
+ activeTracker.committedTokens.cacheReadTokens + deltaBreakdown.cacheReadTokens,
646
+ outputTokens: activeTracker.committedTokens.outputTokens + deltaBreakdown.outputTokens,
647
+ thinkingTokens:
648
+ activeTracker.committedTokens.thinkingTokens + deltaBreakdown.thinkingTokens
649
+ }
650
+ };
651
+ } else {
652
+ // Distinct step within the same open turn
653
+ deltaBreakdown = { ...breakdown };
654
+ updatedTracker = {
655
+ turnId: turnId || activeTracker.turnId || null,
656
+ lastMessageId: messageId || activeTracker.lastMessageId || null,
657
+ lastStepTokens: { ...breakdown },
658
+ committedTokens: {
659
+ uncachedInputTokens:
660
+ activeTracker.committedTokens.uncachedInputTokens + breakdown.uncachedInputTokens,
661
+ effectiveWrite5mTokens:
662
+ activeTracker.committedTokens.effectiveWrite5mTokens + breakdown.effectiveWrite5mTokens,
663
+ effectiveWrite1hTokens:
664
+ activeTracker.committedTokens.effectiveWrite1hTokens + breakdown.effectiveWrite1hTokens,
665
+ cacheReadTokens:
666
+ activeTracker.committedTokens.cacheReadTokens + breakdown.cacheReadTokens,
667
+ outputTokens: activeTracker.committedTokens.outputTokens + breakdown.outputTokens,
668
+ thinkingTokens: activeTracker.committedTokens.thinkingTokens + breakdown.thinkingTokens
669
+ }
670
+ };
671
+ }
672
+ } else {
673
+ deltaBreakdown = { ...breakdown };
674
+ updatedTracker = {
675
+ turnId: turnId || null,
676
+ lastMessageId: messageId || null,
677
+ lastStepTokens: { ...breakdown },
678
+ committedTokens: { ...breakdown }
679
+ };
680
+ }
681
+
682
+ if (isSubagent) {
683
+ state.subagentInFlightTurns[agentKey] = updatedTracker;
684
+ } else {
685
+ state.inFlightTurn = updatedTracker;
686
+ }
687
+ }
688
+
689
+ // Subagent attribution (`ISS-027`: never overwrite main contextWindow, even if main is 0!)
690
+ if (isSubagent && agentKey) {
691
+ const existingSub = state.subagents[agentKey] || {
692
+ agentId: agentKey,
693
+ turns: 0,
694
+ totalInputTokens: 0,
695
+ totalOutputTokens: 0,
696
+ totalTokens: 0,
697
+ lastActiveAt: nowMs
698
+ };
699
+ const deltaSubPrompt =
700
+ deltaBreakdown.uncachedInputTokens +
701
+ deltaBreakdown.effectiveWrite5mTokens +
702
+ deltaBreakdown.effectiveWrite1hTokens +
703
+ deltaBreakdown.cacheReadTokens;
704
+ const deltaSubOut = deltaBreakdown.outputTokens + deltaBreakdown.thinkingTokens;
705
+ if (!sameTurn || event.type !== 'turn.complete') {
706
+ existingSub.turns += 1;
707
+ }
708
+ existingSub.totalInputTokens += deltaSubPrompt;
709
+ existingSub.totalOutputTokens += deltaSubOut;
710
+ existingSub.totalTokens = existingSub.totalInputTokens + existingSub.totalOutputTokens;
711
+ existingSub.lastActiveAt = nowMs;
712
+ applySubagentLifecycle(existingSub, event, { nowMs, eventType: event.type });
713
+ state.subagents[agentKey] = existingSub;
714
+ }
715
+
716
+ // Full single-turn cost snapshot for `lastTurn` and main window metadata
717
+ const fullTurnCost = calculateTurnCostUSD(
718
+ {
719
+ model: effectiveTurnModelRaw,
720
+ inputTokens: uncachedInput,
721
+ outputTokens,
722
+ thinkingTokens,
723
+ cacheWrite5mTokens: write5mTokens,
724
+ cacheWrite1hTokens: write1hTokens,
725
+ cacheReadTokens,
726
+ turnPromptTokens: totalPromptTokens,
727
+ cacheTtlTier: ttlTier
728
+ },
729
+ options
730
+ );
731
+
732
+ // Delta cost committed to `state.cumulative` (priced at this turn's `totalPromptTokens` cliff tier)
733
+ if (hasAnyPositiveTokens(deltaBreakdown)) {
734
+ const deltaTurnCost = calculateTurnCostUSD(
735
+ {
736
+ model: effectiveTurnModelRaw,
737
+ inputTokens: deltaBreakdown.uncachedInputTokens,
738
+ outputTokens: deltaBreakdown.outputTokens,
739
+ thinkingTokens: deltaBreakdown.thinkingTokens,
740
+ cacheWrite5mTokens: deltaBreakdown.effectiveWrite5mTokens,
741
+ cacheWrite1hTokens: deltaBreakdown.effectiveWrite1hTokens,
742
+ cacheReadTokens: deltaBreakdown.cacheReadTokens,
743
+ turnPromptTokens: totalPromptTokens,
744
+ cacheTtlTier: ttlTier
745
+ },
746
+ options
747
+ );
748
+ addTurnCostToCumulative(state.cumulative, deltaTurnCost);
749
+ }
750
+
751
+ if (event.type === 'turn.complete' && !isSubagent) {
752
+ state.turnsCompleted += 1;
753
+ if (!sameTurn) {
754
+ state.steps += 1;
755
+ }
756
+ }
757
+
758
+ if (!isSubagent) {
759
+ const customCeiling = resolveCustomCeilingForModel(effectiveTurnModelRaw, options);
760
+ const resolvedCeiling = Number(customCeiling || fullTurnCost.rates.contextCeiling);
761
+ state.modelLabel = fullTurnCost.rates.label;
762
+ state.contextCeiling = resolvedCeiling;
763
+ state.cliffTriggered = fullTurnCost.cliffTriggered;
764
+ state.preCliffWarningTriggered = fullTurnCost.preCliffWarningTriggered;
765
+
766
+ state.contextWindow.totalInputTokens = totalPromptTokens;
767
+ state.contextWindow.uncachedInputTokens = uncachedInput;
768
+ state.contextWindow.cacheReadTokens = cacheReadTokens;
769
+ state.contextWindow.cacheWriteTokens = totalWriteTokens;
770
+ state.contextWindow.warmPrefixTokens = cacheReadTokens + totalWriteTokens;
771
+ state.contextWindow.cachedTokens = cacheReadTokens + totalWriteTokens;
772
+ state.contextWindow.lastWriteTokens = totalWriteTokens;
773
+ state.contextWindow.lastOutputTokens = outputTokens;
774
+ state.contextWindow.lastThinkingTokens = thinkingTokens;
775
+ state.contextWindow.customCeiling = customCeiling || null;
776
+ state.contextWindow.contextCeiling = resolvedCeiling;
777
+
778
+ const isWarm = cacheReadTokens > 0 || totalWriteTokens > 0;
779
+ if (isWarm) {
780
+ state.promptCache.warm = true;
781
+ const ttlSeconds = state.promptCache.ttlTier === '1h' ? 3600 : 300;
782
+ state.promptCache.ttlSeconds = ttlSeconds;
783
+ state.promptCache.expiresAt = nowMs + ttlSeconds * 1000;
784
+ }
785
+ }
786
+
787
+ const activeMainRates = resolveEffectiveRates(
788
+ state.rawModelId || state.modelId,
789
+ state.contextWindow.totalInputTokens,
790
+ options
791
+ );
792
+ state.cacheRoi = buildCumulativeCacheRoi(state, activeMainRates);
793
+ state.lastTurn = fullTurnCost;
794
+
795
+ // Sprint 1 Metrics Wedge. Retention is scored once per distinct API request (prompt-side
796
+ // usage is final on the first chunk of a message); streaming re-sends of the same
797
+ // message.id and turn.complete re-reports of an already-tracked turn are skipped.
798
+ const isNewRequest =
799
+ event.type === 'turn.complete'
800
+ ? !sameTurn
801
+ : !(sameTurn && messageId && activeTracker.lastMessageId && messageId === activeTracker.lastMessageId);
802
+ if (isNewRequest) {
803
+ state.prefixRetention = applyPrefixRetentionRequest(state.prefixRetention, {
804
+ streamKey: isSubagent ? agentKey || 'subagent' : 'main',
805
+ modelId: normalizeModelId(effectiveTurnModelRaw),
806
+ uncachedInputTokens: uncachedInput,
807
+ cacheReadTokens,
808
+ cacheWriteTokens: totalWriteTokens,
809
+ nowMs,
810
+ ttlSeconds: ttlTier === '1h' ? 3600 : 300,
811
+ inputPer1M: fullTurnCost.rates.inputPer1M ?? 0,
812
+ readPer1M: fullTurnCost.rates.readPer1M ?? 0
813
+ });
814
+ }
815
+ if (!isSubagent) {
816
+ state.thinkingDrift = applyThinkingDriftEvent(state.thinkingDrift, {
817
+ eventType: event.type === 'turn.complete' ? 'turn.complete' : 'turn.step',
818
+ thinkingTokens: deltaBreakdown.thinkingTokens,
819
+ outputTokens: deltaBreakdown.outputTokens,
820
+ nowMs,
821
+ turnStartedAtMs: normalizeEventTimestampMs(
822
+ event.turnStartedAt ?? event.turn_started_at ?? event.result?.started_at ?? null
823
+ ),
824
+ ttftMs: Number(event.ttftMs ?? event.ttft_ms ?? event.result?.ttft_ms ?? 0) || null,
825
+ turnMutations: Number(event.turnMutations ?? 0) || 0
826
+ });
827
+ if (event.type === 'turn.complete' || isNewRequest) {
828
+ const effortObs = extractEventEffortObservation(event);
829
+ state.effortTracking = applyTurnEffortObservation(
830
+ state.effortTracking,
831
+ {
832
+ modelId: state.modelId,
833
+ rawModelId: effectiveTurnModelRaw,
834
+ observedEffort: effortObs.effortLevel,
835
+ observedThinkingBudget: effortObs.thinkingBudget,
836
+ turnIndex: state.turnsCompleted || priorTurnsCompleted + 1,
837
+ priorTurnsCompleted,
838
+ priorModelId,
839
+ priorWarmPrefixTokens,
840
+ priorCacheWarm,
841
+ cacheReadTokens,
842
+ cacheWriteTokens: totalWriteTokens,
843
+ outputTokens,
844
+ thinkingTokens,
845
+ hasTurnUsage: true,
846
+ turnMutations: Number(event.turnMutations ?? 0) || 0,
847
+ ttlTier
848
+ },
849
+ options
850
+ );
851
+ }
852
+ }
853
+
854
+ exportOtelTelemetry(state, options);
855
+
856
+ return state;
857
+ }
858
+
859
+ /**
860
+ * Normalizes an ISO string or epoch (s/ms) timestamp to epoch milliseconds, or `null`.
861
+ * @param {string|number|null|undefined} raw
862
+ * @returns {number|null}
863
+ */
864
+ function normalizeEventTimestampMs(raw) {
865
+ if (typeof raw === 'number' && Number.isFinite(raw) && raw > 0) {
866
+ return raw < 1e11 ? raw * 1000 : raw;
867
+ }
868
+ if (typeof raw === 'string' && raw.trim()) {
869
+ const parsed = Date.parse(raw);
870
+ return Number.isNaN(parsed) ? null : parsed;
871
+ }
872
+ return null;
873
+ }
874
+
875
+ /**
876
+ * Ingests a `statusLine` stdin JSON payload into the session telemetry state.
877
+ * Honors `customCeilings.json` ahead of `context_window_size` (`ISS-005`), tracks Turn-1 cold
878
+ * `cacheReadTokens` separately from `cacheWriteTokens` (`ISS-006`), increments `state.steps`
879
+ * on distinct turn envelopes (`ISS-003`), and prevents `WARM | 00:00 (0s)` (`ISS-027`).
880
+ *
881
+ * @param {object} currentState
882
+ * @param {object} statusPayload
883
+ * @param {object} [options={}]
884
+ * @returns {object} Updated state
885
+ */
886
+ export function ingestStatusLinePayload(currentState, statusPayload = {}, options = {}) {
887
+ const nowMs = options.nowMs || Date.now();
888
+ const sessionId =
889
+ statusPayload.session_id ||
890
+ statusPayload.sessionId ||
891
+ currentState?.sessionId ||
892
+ 'default';
893
+ const rawPayloadModel =
894
+ statusPayload.model?.id ||
895
+ (typeof statusPayload.model === 'string' ? statusPayload.model : null);
896
+ const rawModel =
897
+ rawPayloadModel ||
898
+ currentState?.rawModelId ||
899
+ currentState?.modelId ||
900
+ 'claude-sonnet-5-5';
901
+
902
+ const prevSource = currentState?.lastSource || 'init';
903
+ const priorModelId = currentState?.rawModelId || currentState?.modelId || null;
904
+ const priorWarmPrefixTokens = Math.max(
905
+ 0,
906
+ Number(currentState?.contextWindow?.warmPrefixTokens || currentState?.contextWindow?.cachedTokens || 0)
907
+ );
908
+ const priorCacheWarm = Boolean(currentState?.promptCache?.warm);
909
+ const priorTurnsCompleted = Math.max(0, Number(currentState?.turnsCompleted || 0));
910
+ const state = currentState
911
+ ? JSON.parse(JSON.stringify(currentState))
912
+ : createInitialTelemetryState(sessionId, rawModel);
913
+
914
+ state.sessionId = sanitizeSessionId(sessionId);
915
+ state.rawModelId = String(rawModel);
916
+ state.modelId = normalizeModelId(rawModel);
917
+ state.lastUpdatedAt = nowMs;
918
+ state.lastSource = 'statusLine';
919
+
920
+ const cw = statusPayload.context_window || {};
921
+ const currentUsage = cw.current_usage || {};
922
+ const pc = statusPayload.prompt_cache || {};
923
+ const rl = statusPayload.rate_limits || {};
924
+
925
+ let ttlInfo = parseTtlInfo(pc.ttl ?? state.promptCache.ttlTier);
926
+ state.promptCache.ttlTier = ttlInfo.ttlTier;
927
+
928
+ const hasCurrentUsage =
929
+ Boolean(currentUsage && typeof currentUsage === 'object') &&
930
+ (currentUsage.input_tokens !== undefined ||
931
+ currentUsage.inputTokens !== undefined ||
932
+ currentUsage.uncachedInputTokens !== undefined ||
933
+ currentUsage.freshInputTokens !== undefined ||
934
+ currentUsage.cache_read_input_tokens !== undefined ||
935
+ currentUsage.cacheReadTokens !== undefined ||
936
+ currentUsage.cacheReadInputTokens !== undefined ||
937
+ currentUsage.cache_creation_input_tokens !== undefined ||
938
+ currentUsage.cacheWriteTokens !== undefined ||
939
+ currentUsage.cacheWrite5mTokens !== undefined ||
940
+ currentUsage.cacheWrite1hTokens !== undefined ||
941
+ currentUsage.cache_creation !== undefined);
942
+
943
+ let breakdown = extractNormalizedTokenBreakdown({
944
+ ...currentUsage,
945
+ cacheTtlTier: state.promptCache.ttlTier
946
+ });
947
+ if (pc.ttl === undefined && breakdown.write1hTokens > 0 && state.promptCache.ttlTier !== '1h') {
948
+ state.promptCache.ttlTier = '1h';
949
+ ttlInfo = { ttlTier: '1h', ttlSeconds: 3600 };
950
+ breakdown = extractNormalizedTokenBreakdown({
951
+ ...currentUsage,
952
+ cacheTtlTier: '1h'
953
+ });
954
+ }
955
+ const uncachedInput = breakdown.uncachedInputTokens;
956
+ const write5mTokens = breakdown.effectiveWrite5mTokens;
957
+ const write1hTokens = breakdown.effectiveWrite1hTokens;
958
+ const cacheWrite = breakdown.totalCacheWriteTokens;
959
+ const cacheRead = breakdown.cacheReadTokens;
960
+ const outputTokens = breakdown.outputTokens;
961
+ const thinkingTokens = breakdown.thinkingTokens;
962
+
963
+ const singleTurnUsagePrompt = uncachedInput + cacheWrite + cacheRead;
964
+ const reportedTotalInput = Math.max(
965
+ 0,
966
+ Number(cw.total_input_tokens ?? singleTurnUsagePrompt)
967
+ );
968
+ // Single-turn prompt token count for cliff check (never inflated by multi-turn cumulative sums)
969
+ const turnCliffPromptTokens = hasCurrentUsage ? singleTurnUsagePrompt : reportedTotalInput;
970
+
971
+ const customCeiling = resolveCustomCeilingForModel(rawModel, options);
972
+ const rates = resolveEffectiveRates(rawModel, turnCliffPromptTokens, options);
973
+ state.modelLabel = statusPayload.model?.display_name || rates.label;
974
+ state.contextCeiling = Number(customCeiling || cw.context_window_size || rates.contextCeiling);
975
+ state.cliffTriggered = rates.cliffTriggered;
976
+ state.preCliffWarningTriggered = rates.preCliffWarningTriggered;
977
+
978
+ state.contextWindow.totalInputTokens = reportedTotalInput;
979
+ state.contextWindow.customCeiling = customCeiling || null;
980
+ state.contextWindow.contextCeiling = state.contextCeiling;
981
+ if (hasCurrentUsage) {
982
+ state.contextWindow.uncachedInputTokens = uncachedInput;
983
+ state.contextWindow.cacheReadTokens = cacheRead;
984
+ state.contextWindow.cacheWriteTokens = cacheWrite;
985
+ state.contextWindow.warmPrefixTokens = cacheRead + cacheWrite;
986
+ state.contextWindow.cachedTokens = cacheRead + cacheWrite;
987
+ state.contextWindow.lastWriteTokens = cacheWrite;
988
+ state.contextWindow.lastOutputTokens = outputTokens;
989
+ state.contextWindow.lastThinkingTokens = thinkingTokens;
990
+ }
991
+
992
+ if (typeof cw.system_tokens === 'number' || typeof cw.mcp_tokens === 'number') {
993
+ state.contextWindow.systemAndMcpTokens =
994
+ Math.max(0, Number(cw.system_tokens || 0)) + Math.max(0, Number(cw.mcp_tokens || 0));
995
+ }
996
+ if (typeof cw.distractor_tokens === 'number') {
997
+ state.contextWindow.distractorTokens = Math.max(0, Number(cw.distractor_tokens || 0));
998
+ }
999
+
1000
+ const parsedExpiresAt = normalizeExpiresAtMs(pc.expires_at, nowMs, ttlInfo.ttlSeconds, false);
1001
+ const explicitlyExpired =
1002
+ (pc.ttl !== undefined && ttlInfo.ttlSeconds <= 0) ||
1003
+ (parsedExpiresAt !== null && parsedExpiresAt <= nowMs);
1004
+ const rawWarm =
1005
+ typeof pc.warm === 'boolean' ? pc.warm : state.contextWindow.cachedTokens > 0;
1006
+ const isWarm = explicitlyExpired ? false : Boolean(rawWarm && ttlInfo.ttlSeconds > 0);
1007
+ state.promptCache.warm = isWarm;
1008
+ state.promptCache.ttlSeconds = isWarm ? ttlInfo.ttlSeconds : explicitlyExpired ? 0 : ttlInfo.ttlSeconds;
1009
+ state.promptCache.expiresAt = isWarm
1010
+ ? parsedExpiresAt ?? nowMs + ttlInfo.ttlSeconds * 1000
1011
+ : null;
1012
+
1013
+ if (pc.last_miss_cause !== undefined) {
1014
+ state.promptCache.lastMissCause = pc.last_miss_cause;
1015
+ }
1016
+
1017
+ if (rl.five_hour) state.rateLimits.fiveHour = { ...rl.five_hour };
1018
+ if (rl.seven_day) state.rateLimits.sevenDay = { ...rl.seven_day };
1019
+ if (rl.spend_limit) state.rateLimits.spendLimit = { ...rl.spend_limit };
1020
+
1021
+ // Detect distinct turn envelope / cost delta on standalone statusLine ticks (`ISS-003`)
1022
+ const statusTurnId =
1023
+ statusPayload.turn_id ||
1024
+ statusPayload.turnId ||
1025
+ cw.turn_id ||
1026
+ currentUsage.message_id ||
1027
+ currentUsage.id ||
1028
+ null;
1029
+ const rawReportedCost = statusPayload.cost?.total_cost_usd;
1030
+ const hasReportedCost = typeof rawReportedCost === 'number' && Number.isFinite(rawReportedCost);
1031
+ const costChanged =
1032
+ hasReportedCost &&
1033
+ (state.lastReportedStatusCostUSD === null ||
1034
+ Math.abs(rawReportedCost - state.lastReportedStatusCostUSD) > 1e-9);
1035
+ const envelopeSig = `${state.modelId}:${uncachedInput}:${write5mTokens}:${write1hTokens}:${cacheRead}:${outputTokens}:${thinkingTokens}`;
1036
+
1037
+ const alreadyCommittedByMod =
1038
+ prevSource.startsWith('mod.turn') &&
1039
+ state.lastTurn?.tokens &&
1040
+ state.lastTurn.tokens.uncachedInput === uncachedInput &&
1041
+ state.lastTurn.tokens.totalCacheWrite === cacheWrite &&
1042
+ state.lastTurn.tokens.cacheRead === cacheRead &&
1043
+ state.lastTurn.tokens.output === outputTokens;
1044
+
1045
+ const isDuplicateStatusEnvelope =
1046
+ (statusTurnId && state.lastStatusTurnId === statusTurnId) ||
1047
+ (hasReportedCost && !costChanged && state.lastStatusLineEnvelopeSig === envelopeSig);
1048
+
1049
+ const isDistinctStatusTurn = Boolean(
1050
+ hasCurrentUsage && !alreadyCommittedByMod && !isDuplicateStatusEnvelope
1051
+ );
1052
+
1053
+ if (isDistinctStatusTurn) {
1054
+ const turnCost = calculateTurnCostUSD(
1055
+ {
1056
+ model: rawModel,
1057
+ inputTokens: uncachedInput,
1058
+ outputTokens,
1059
+ thinkingTokens,
1060
+ cacheWrite5mTokens: write5mTokens,
1061
+ cacheWrite1hTokens: write1hTokens,
1062
+ cacheReadTokens: cacheRead,
1063
+ turnPromptTokens: turnCliffPromptTokens,
1064
+ cacheTtlTier: state.promptCache.ttlTier
1065
+ },
1066
+ options
1067
+ );
1068
+ addTurnCostToCumulative(state.cumulative, turnCost);
1069
+ state.steps += 1;
1070
+ state.lastTurn = turnCost;
1071
+ state.lastStatusLineEnvelopeSig = envelopeSig;
1072
+ if (statusTurnId) state.lastStatusTurnId = statusTurnId;
1073
+ if (hasReportedCost) state.lastReportedStatusCostUSD = rawReportedCost;
1074
+ } else if (!hasCurrentUsage && costChanged && rawReportedCost > (state.lastReportedStatusCostUSD || 0)) {
1075
+ state.steps += 1;
1076
+ state.lastReportedStatusCostUSD = rawReportedCost;
1077
+ }
1078
+
1079
+ const statusEffortObs = extractEventEffortObservation(statusPayload);
1080
+ if (statusEffortObs.effortLevel !== null || isDistinctStatusTurn) {
1081
+ state.effortTracking = applyTurnEffortObservation(
1082
+ state.effortTracking,
1083
+ {
1084
+ modelId: state.modelId,
1085
+ rawModelId: rawModel,
1086
+ observedEffort: statusEffortObs.effortLevel,
1087
+ observedThinkingBudget: statusEffortObs.thinkingBudget,
1088
+ turnIndex: Math.max(1, state.turnsCompleted || state.steps || 1),
1089
+ priorTurnsCompleted: Math.max(0, priorTurnsCompleted || (state.steps > 0 ? state.steps - 1 : 0)),
1090
+ priorModelId,
1091
+ priorWarmPrefixTokens,
1092
+ priorCacheWarm,
1093
+ cacheReadTokens: cacheRead,
1094
+ cacheWriteTokens: cacheWrite,
1095
+ outputTokens,
1096
+ thinkingTokens,
1097
+ hasTurnUsage: isDistinctStatusTurn,
1098
+ evaluateThinkingSpike: isDistinctStatusTurn,
1099
+ turnMutations: Number(statusPayload.turnMutations ?? statusPayload.turn_mutations ?? 0) || 0,
1100
+ ttlTier: state.promptCache.ttlTier
1101
+ },
1102
+ options
1103
+ );
1104
+ }
1105
+
1106
+ if (
1107
+ state.steps > 0 ||
1108
+ state.cumulative.cacheWrite5mTokens +
1109
+ state.cumulative.cacheWrite1hTokens +
1110
+ state.cumulative.cacheReadTokens >
1111
+ 0
1112
+ ) {
1113
+ state.cacheRoi = buildCumulativeCacheRoi(state, rates);
1114
+ }
1115
+
1116
+ return state;
1117
+ }
1118
+
1119
+ /**
1120
+ * Atomically writes the telemetry state snapshot to `.claude/cache/ah_live_state_<sessionId>.json`
1121
+ * and updates `.claude/cache/ah_live_state.json`.
1122
+ *
1123
+ * @param {string} sessionId
1124
+ * @param {object} state
1125
+ * @param {object} [options={}]
1126
+ * @returns {{ ok: boolean, sessionPath: string }}
1127
+ */
1128
+ export function writeLiveStateSnapshot(sessionId, state, options = {}) {
1129
+ const safeId = sanitizeSessionId(sessionId || state?.sessionId || 'default');
1130
+ const sessionPath = getLiveStateBridgePath(safeId, options);
1131
+ const okSession = writeJsonAtomic(sessionPath, state, options);
1132
+
1133
+ const cwd = getCwd(options);
1134
+ const defaultPath = path.join(cwd, '.claude', 'cache', 'ah_live_state.json');
1135
+ writeJsonAtomic(defaultPath, state, options);
1136
+
1137
+ return { ok: okSession, sessionPath };
1138
+ }
1139
+
1140
+ /**
1141
+ * Reads the live telemetry state snapshot from `.claude/cache/ah_live_state_<sessionId>.json`.
1142
+ * Falls back to `.claude/cache/ah_live_state.json` or a clean initial state.
1143
+ *
1144
+ * @param {string} [sessionId='default']
1145
+ * @param {object} [options={}]
1146
+ * @returns {object}
1147
+ */
1148
+ export function readLiveStateSnapshot(sessionId = 'default', options = {}) {
1149
+ const safeId = sanitizeSessionId(sessionId);
1150
+ const sessionPath = getLiveStateBridgePath(safeId, options);
1151
+ const fromSession = readJsonSafe(sessionPath, null, options);
1152
+ if (fromSession && typeof fromSession === 'object') {
1153
+ return fromSession;
1154
+ }
1155
+
1156
+ const cwd = getCwd(options);
1157
+ const defaultPath = path.join(cwd, '.claude', 'cache', 'ah_live_state.json');
1158
+ const fromDefault = readJsonSafe(defaultPath, null, options);
1159
+ if (fromDefault && typeof fromDefault === 'object') {
1160
+ return fromDefault;
1161
+ }
1162
+
1163
+ return createInitialTelemetryState(safeId, options.defaultModel || 'claude-sonnet-5-5');
1164
+ }
1165
+
1166
+ /**
1167
+ * Stateful Dual-Source Telemetry Bridge controller.
1168
+ */
1169
+ export class TelemetryBridge {
1170
+ /**
1171
+ * @param {object} [options={}]
1172
+ */
1173
+ constructor(options = {}) {
1174
+ this.options = options;
1175
+ this.sessionId = sanitizeSessionId(options.sessionId || 'default');
1176
+ this.state =
1177
+ options.initialState ||
1178
+ createInitialTelemetryState(this.sessionId, options.defaultModel || 'claude-sonnet-5-5');
1179
+ }
1180
+
1181
+ /**
1182
+ * Processes a Mod `turn.step` or `turn.complete` event and optionally persists to disk.
1183
+ * @param {object} event
1184
+ * @param {object} [callOptions={}]
1185
+ * @returns {object}
1186
+ */
1187
+ handleModEvent(event = {}, callOptions = {}) {
1188
+ const mergedOpts = { ...this.options, ...callOptions };
1189
+ this.state = ingestModTurnEvent(this.state, event, mergedOpts);
1190
+ this.sessionId = this.state.sessionId;
1191
+ if (mergedOpts.persist !== false) {
1192
+ writeLiveStateSnapshot(this.sessionId, this.state, mergedOpts);
1193
+ }
1194
+ return this.state;
1195
+ }
1196
+
1197
+ /**
1198
+ * Processes a `statusLine` JSON payload and optionally persists to disk.
1199
+ * @param {object} statusPayload
1200
+ * @param {object} [callOptions={}]
1201
+ * @returns {object}
1202
+ */
1203
+ handleStatusLine(statusPayload = {}, callOptions = {}) {
1204
+ const mergedOpts = { ...this.options, ...callOptions };
1205
+ this.state = ingestStatusLinePayload(this.state, statusPayload, mergedOpts);
1206
+ this.sessionId = this.state.sessionId;
1207
+ if (mergedOpts.persist !== false) {
1208
+ writeLiveStateSnapshot(this.sessionId, this.state, mergedOpts);
1209
+ }
1210
+ return this.state;
1211
+ }
1212
+
1213
+ /**
1214
+ * Returns current session state.
1215
+ * @returns {object}
1216
+ */
1217
+ getState() {
1218
+ return this.state;
1219
+ }
1220
+ }
1221
+
1222
+ export default {
1223
+ sanitizeSessionId,
1224
+ getLiveStateBridgePath,
1225
+ computeCacheRoi,
1226
+ createInitialTelemetryState,
1227
+ ingestModTurnEvent,
1228
+ ingestStatusLinePayload,
1229
+ writeLiveStateSnapshot,
1230
+ readLiveStateSnapshot,
1231
+ TelemetryBridge
1232
+ };