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
@@ -9,8 +9,6 @@
9
9
  */
10
10
 
11
11
  import { MicroIpcClient } from '../../src/engine-node/ipc/client.mjs';
12
- import { runPreToolUseHook } from './pre-tool-use.mjs';
13
- import { runPostToolUseHook } from './post-tool-use.mjs';
14
12
 
15
13
  let sharedClient = null;
16
14
 
@@ -43,7 +41,10 @@ export async function dispatchPreToolUseWithFallback(payload, options = {}) {
43
41
  return client.callWithFallback(
44
42
  'hook.preToolUse',
45
43
  payload,
46
- async (p) => runPreToolUseHook(p, options),
44
+ async (p) => {
45
+ const { runPreToolUseHook } = await import('./pre-tool-use-core.mjs');
46
+ return runPreToolUseHook(p, options);
47
+ },
47
48
  {
48
49
  connectTimeoutMs: options.connectTimeoutMs ?? 15,
49
50
  requestTimeoutMs: options.requestTimeoutMs ?? 600000
@@ -63,7 +64,10 @@ export async function dispatchPostToolUseWithFallback(payload, options = {}) {
63
64
  return client.callWithFallback(
64
65
  'hook.postToolUse',
65
66
  payload,
66
- async (p) => runPostToolUseHook(p, options),
67
+ async (p) => {
68
+ const { runPostToolUseHook } = await import('./post-tool-use-core.mjs');
69
+ return runPostToolUseHook(p, options);
70
+ },
67
71
  { connectTimeoutMs: options.connectTimeoutMs ?? 15 }
68
72
  );
69
73
  }
@@ -12,6 +12,7 @@ import {
12
12
  readBreakerStateSnapshot,
13
13
  writeBreakerStateSnapshot
14
14
  } from '../../src/core-isomorphic/guards/circuitBreakers.mjs';
15
+ import { recordShadowAutoMiss } from '../../src/core/shadow_auto_ledger.mjs';
15
16
  import { isCliEntrypoint, readStdinJsonAsync, exitPassThrough } from './hookIo.mjs';
16
17
 
17
18
  /**
@@ -46,15 +47,50 @@ export function runPostModelSwitchHook(event = {}, options = {}) {
46
47
  }
47
48
 
48
49
  // Item 4.4: Clear pending_downshift once the model switch actually executes
50
+ // Option A Shadow Auto: Promote confirmed warm-cache switches into shadow_auto_ledger.jsonl
49
51
  const shouldPersistBreaker =
50
52
  options.persistState !== false &&
51
- Boolean(event.cwd || options.cwd || options.breakerStatePath || options.cliInvocation);
53
+ Boolean(
54
+ options.persistState === true ||
55
+ event.cwd ||
56
+ options.cwd ||
57
+ options.breakerStatePath ||
58
+ options.cliInvocation
59
+ );
52
60
  if (shouldPersistBreaker) {
53
61
  try {
54
62
  const sessionId = event.session_id || event.sessionId || 'default';
55
63
  const cwdOptions = event.cwd && !options.cwd ? { ...options, cwd: event.cwd } : options;
56
64
  const snap = readBreakerStateSnapshot(sessionId, cwdOptions);
57
- if (snap && (snap.pending_downshift || snap.pendingDownshiftModel || snap.justCompacted)) {
65
+ if (snap?.pendingShadowSwitchMiss) {
66
+ const miss = snap.pendingShadowSwitchMiss;
67
+ recordShadowAutoMiss(
68
+ {
69
+ sessionId,
70
+ workspacePath: event.cwd || options.cwd || '',
71
+ harness: 'claude-code',
72
+ effectiveMode: miss.effectiveMode || 'COACH',
73
+ category: 'WARM_SWITCH_BUST',
74
+ detectorId: miss.detectorId || 'DET-08',
75
+ turnKey: miss.turnKey,
76
+ wastedTokens: miss.wastedTokens,
77
+ missedUsd: miss.missedUsd,
78
+ avoidedPrompts: 1,
79
+ detail: `Model switch ${miss.currentModel} -> ${miss.targetModel} on warm cache`
80
+ },
81
+ {
82
+ ...cwdOptions,
83
+ ...(event.shadowLedgerPath ? { shadowLedgerPath: event.shadowLedgerPath } : {})
84
+ }
85
+ );
86
+ }
87
+ if (
88
+ snap &&
89
+ (snap.pending_downshift ||
90
+ snap.pendingDownshiftModel ||
91
+ snap.justCompacted ||
92
+ snap.pendingShadowSwitchMiss)
93
+ ) {
58
94
  writeBreakerStateSnapshot(
59
95
  sessionId,
60
96
  {
@@ -62,6 +98,7 @@ export function runPostModelSwitchHook(event = {}, options = {}) {
62
98
  updatedAt: Date.now(),
63
99
  pending_downshift: null,
64
100
  pendingDownshiftModel: null,
101
+ pendingShadowSwitchMiss: null,
65
102
  justCompacted: false
66
103
  },
67
104
  cwdOptions
@@ -0,0 +1,394 @@
1
+ /**
2
+ * @file hooks/handlers/post-tool-use-core.mjs
3
+ * Full evaluation engine for `PostToolUse` (`Bash|PowerShell|Grep|Glob|Task|Agent|WebFetch|mcp__.*`).
4
+ * Runs lossless output sanitization, 100% critical error-line recovery,
5
+ * >4,000 token programmatic artifact offloading (excluding workspace `Read`),
6
+ * and `DET-19` subagent IPI boundary & Unicode tag stripping (`ISS-034`, `ISS-053`).
7
+ */
8
+
9
+ import { createRequire } from 'node:module';
10
+ import { sanitizePostToolOutput } from '../../src/core-isomorphic/guards/losslessPostSanitizer.mjs';
11
+ import {
12
+ CircuitBreakerEngine,
13
+ evaluateDet19SubagentIpiSanitizer,
14
+ readBreakerStateSnapshot,
15
+ writeBreakerStateSnapshot
16
+ } from '../../src/core-isomorphic/guards/circuitBreakers.mjs';
17
+ import { loadHorizonConfig, resolveDetectorOverride } from '../../src/core-isomorphic/config/horizonConfig.mjs';
18
+ import { evaluateTaskBoundaryTurn } from '../../src/core-isomorphic/coach/smartCompactAdvisor.mjs';
19
+ import { runBucketBPostToolPass } from '../../src/core/bucket_b_runtime.mjs';
20
+
21
+ const requireFromHere = createRequire(import.meta.url);
22
+ const AUTO_MODE_ALIAS_RE = /^(?:AUTO_PILOT|AUTOPILOT|AUTO|AUTO-PILOT)$/i;
23
+ const RSL_MUTATING_OR_EXEC_TOOL_RE =
24
+ /^(?:Bash|PowerShell|Edit|MultiEdit|Write|NotebookEdit|run_command|execute_bash|bash|powershell|edit_file|write_file|write_to_file|replace_file_content|multi_replace_file_content|edit|multiedit|multi_edit|write|notebookedit)$/i;
25
+
26
+ let _proLicenseMod = null;
27
+ function getProLicenseMod() {
28
+ if (!_proLicenseMod) _proLicenseMod = requireFromHere('../../src/core/pro_license.mjs');
29
+ return _proLicenseMod;
30
+ }
31
+
32
+ let _microSkillsMod = null;
33
+ function getMicroSkillsMod() {
34
+ if (!_microSkillsMod) _microSkillsMod = requireFromHere('../../src/core-isomorphic/coach/microSkills.mjs');
35
+ return _microSkillsMod;
36
+ }
37
+
38
+ let _savedQuotaMod = null;
39
+ function getSavedQuotaMod() {
40
+ if (!_savedQuotaMod) _savedQuotaMod = requireFromHere('../../src/core-isomorphic/coach/savedQuotaLedger.mjs');
41
+ return _savedQuotaMod;
42
+ }
43
+
44
+ let _telemetryMod = null;
45
+ function getTelemetryMod() {
46
+ if (!_telemetryMod) _telemetryMod = requireFromHere('../../src/core-isomorphic/telemetry/telemetryBridge.mjs');
47
+ return _telemetryMod;
48
+ }
49
+
50
+ let _catalogMod = null;
51
+ function getCatalogMod() {
52
+ if (!_catalogMod) _catalogMod = requireFromHere('../../src/core-isomorphic/config/catalogLoader.mjs');
53
+ return _catalogMod;
54
+ }
55
+
56
+ let _claudeRslMod = null;
57
+ function getClaudeRslMod() {
58
+ if (!_claudeRslMod) _claudeRslMod = requireFromHere('../../src/hooks/claude_rsl_hook.mjs');
59
+ return _claudeRslMod;
60
+ }
61
+
62
+ function resolveSimpleFlightMode(rawMode = 'COACH') {
63
+ const upper = String(rawMode || 'COACH').trim().toUpperCase();
64
+ if (upper === 'OFF' || upper === 'DISABLED') return 'OFF';
65
+ if (upper === 'SILENT') return 'SILENT';
66
+ return 'COACH';
67
+ }
68
+
69
+ /**
70
+ * Extracts text from a string or structured `tool_response` object.
71
+ * @param {object} event
72
+ * @returns {string}
73
+ */
74
+ function extractPostToolText(event = {}) {
75
+ const resp = event.tool_response ?? event.tool_output ?? event.toolOutput ?? event.output;
76
+ if (typeof resp === 'string') return resp;
77
+ if (resp && typeof resp === 'object') {
78
+ const parts = [resp.stdout, resp.stderr, resp.output, resp.content, resp.error]
79
+ .filter((x) => typeof x === 'string' && x.length > 0);
80
+ if (parts.length > 0) return parts.join('\n');
81
+ return '';
82
+ }
83
+ return resp !== undefined && resp !== null ? String(resp) : '';
84
+ }
85
+
86
+ /**
87
+ * Determines whether a completed tool call failed (`is_error`, non-zero `exit_code`, etc.).
88
+ * @param {object} event
89
+ * @returns {boolean}
90
+ */
91
+ function didToolExecutionFail(event = {}) {
92
+ if (
93
+ event.is_error === true ||
94
+ event.isError === true ||
95
+ event.succeeded === false ||
96
+ Boolean(event.tool_error || event.error) ||
97
+ (typeof event.exit_code === 'number' && event.exit_code !== 0) ||
98
+ (typeof event.exitCode === 'number' && event.exitCode !== 0)
99
+ ) {
100
+ return true;
101
+ }
102
+ const resp = event.tool_response;
103
+ if (resp && typeof resp === 'object') {
104
+ if (
105
+ resp.is_error === true ||
106
+ resp.isError === true ||
107
+ resp.succeeded === false ||
108
+ resp.status === 'error' ||
109
+ resp.status === 'failed' ||
110
+ Boolean(resp.error) ||
111
+ (typeof resp.exit_code === 'number' && resp.exit_code !== 0) ||
112
+ (typeof resp.exitCode === 'number' && resp.exitCode !== 0) ||
113
+ (typeof resp.returncode === 'number' && resp.returncode !== 0)
114
+ ) {
115
+ return true;
116
+ }
117
+ }
118
+ return false;
119
+ }
120
+
121
+ /**
122
+ * Evaluates a `PostToolUse` hook payload and returns the contract response.
123
+ * @param {object} event
124
+ * @param {object} [options={}]
125
+ */
126
+ export function runPostToolUseHook(event = {}, options = {}) {
127
+ const toolName = String(event.tool_name || event.toolName || 'Bash');
128
+ const rawOutput = extractPostToolText(event);
129
+ const tier1Active = Boolean(
130
+ options.tier1ModActive ||
131
+ event.tier1ModActive ||
132
+ globalThis.process?.env?.AH_TIER1_MOD_ACTIVE === '1'
133
+ );
134
+ if (tier1Active && /^(Grep|Glob)$/i.test(toolName) && rawOutput.length < 16000 && !didToolExecutionFail(event)) {
135
+ return {
136
+ exitCode: 0,
137
+ stdout: '',
138
+ stderr: '',
139
+ fastPath: 'tier1_mod_active',
140
+ sanitized: { modified: false, offloaded: false }
141
+ };
142
+ }
143
+ const sessionId = event.session_id || event.sessionId || 'default';
144
+ const cwdOptions = event.cwd && !options.cwd ? { ...options, cwd: event.cwd } : options;
145
+ const horizonConfig = options.horizonConfig || loadHorizonConfig(cwdOptions);
146
+ const rawMode = event.mode || options.mode || horizonConfig.flightMode || 'COACH';
147
+ const effectiveMode = AUTO_MODE_ALIAS_RE.test(String(rawMode || '').trim())
148
+ ? getProLicenseMod().resolveEffectiveAutoFlightMode(rawMode, {
149
+ licensePath: options.licensePath || event.licensePath,
150
+ homeDir: options.homeDir || event.homeDir,
151
+ nowMs: options.nowMs,
152
+ strict: Boolean(options.strict ?? event.strict)
153
+ }).effectiveFlightMode
154
+ : resolveSimpleFlightMode(rawMode);
155
+
156
+ const hasExplicitCwd = Boolean(event.cwd || options.cwd);
157
+ let loadedPriorSnap = null;
158
+ const shouldPersistState =
159
+ options.persistState !== false &&
160
+ Boolean(event.cwd || options.cwd || options.breakerStatePath || options.persistState);
161
+
162
+ if (shouldPersistState) {
163
+ if (hasExplicitCwd && options.enableRsl !== false && RSL_MUTATING_OR_EXEC_TOOL_RE.test(toolName)) {
164
+ try {
165
+ getClaudeRslMod().handleClaudeRslHook(event, { ...cwdOptions, event: 'PostToolUse' });
166
+ } catch {
167
+ // Fail open for RSL step telemetry
168
+ }
169
+ }
170
+ const failed = didToolExecutionFail(event);
171
+ const priorSnap = readBreakerStateSnapshot(sessionId, cwdOptions);
172
+ loadedPriorSnap = priorSnap;
173
+ const engine = new CircuitBreakerEngine({
174
+ ...cwdOptions,
175
+ horizonConfig,
176
+ mode: effectiveMode,
177
+ initialState: priorSnap
178
+ });
179
+ const toolInput = event.tool_input || event.toolInput || {};
180
+ const cmdStr = String(toolInput.command || toolInput.cmd || event.command || '');
181
+ const rawExit =
182
+ event.exit_code ??
183
+ event.exitCode ??
184
+ event.tool_response?.exit_code ??
185
+ event.tool_response?.exitCode;
186
+ engine.recordToolOutcome(!failed, toolName);
187
+ if (/^(Bash|PowerShell|pwsh|cmd|sh|run_command|execute_bash)$/i.test(toolName)) {
188
+ engine.recordVerificationOutcome({
189
+ succeeded: !failed,
190
+ command: cmdStr,
191
+ outputText: rawOutput
192
+ });
193
+ }
194
+ if (failed && engine.modifiedFilesInTurn.size > 0) {
195
+ // If a test command failed, code edits remain unverified
196
+ engine.codeEditedSinceLastTest = true;
197
+ }
198
+ const editedPath = String(
199
+ event.tool_input?.file_path ||
200
+ event.tool_input?.Path ||
201
+ event.tool_input?.path ||
202
+ event.tool_input?.TargetFile ||
203
+ ''
204
+ );
205
+ const boundaryEval = evaluateTaskBoundaryTurn(
206
+ {
207
+ toolName,
208
+ command: cmdStr,
209
+ filePath: editedPath,
210
+ failed,
211
+ exitCode: typeof rawExit === 'number' ? rawExit : (failed ? 1 : 0)
212
+ },
213
+ engine.taskBoundaryState
214
+ );
215
+ engine.taskBoundaryState = {
216
+ openFailure: boundaryEval.openFailure,
217
+ editsSinceBoundary: boundaryEval.editsSinceBoundary,
218
+ lastBoundarySuggestedTurn: engine.taskBoundaryState?.lastBoundarySuggestedTurn ?? null
219
+ };
220
+ const nextTurnBoundaryReached =
221
+ boundaryEval.detectorState === 'mid_debug'
222
+ ? false
223
+ : boundaryEval.boundaryDetected
224
+ ? true
225
+ : boundaryEval.editsSinceBoundary > 0 && priorSnap?.turnBoundaryReached
226
+ ? false
227
+ : Boolean(priorSnap?.turnBoundaryReached);
228
+ const nextTurnMidDebug =
229
+ boundaryEval.detectorState === 'mid_debug'
230
+ ? true
231
+ : boundaryEval.boundaryDetected
232
+ ? false
233
+ : Boolean(priorSnap?.turnMidDebug);
234
+ if (Array.isArray(event.active_background_tasks || event.activeBackgroundTasks)) {
235
+ engine.activeBackgroundTasks = (event.active_background_tasks || event.activeBackgroundTasks)
236
+ .filter(Boolean)
237
+ .map((t) => (typeof t === 'string' ? t : String(t?.id || t?.command || 'bg_task')));
238
+ }
239
+ writeBreakerStateSnapshot(
240
+ sessionId,
241
+ {
242
+ ...engine.exportStateSnapshot(),
243
+ turnBoundaryReached: nextTurnBoundaryReached,
244
+ turnMidDebug: nextTurnMidDebug
245
+ },
246
+ cwdOptions
247
+ );
248
+
249
+ // RSI-04 ('micro-skills'): Capture shell failure -> recovery pairs within <= 3 turns
250
+ if (/^(Bash|PowerShell|pwsh|cmd|sh)$/i.test(toolName) && resolveDetectorOverride('micro-skills', horizonConfig) !== 'off') {
251
+ if (cmdStr) {
252
+ getMicroSkillsMod().recordWorkspaceShellOutcome(
253
+ {
254
+ command: cmdStr,
255
+ exitCode: typeof rawExit === 'number' ? rawExit : (failed ? 1 : 0),
256
+ turn: Number(event.turnId ?? event.turn_id ?? event.turn ?? 1),
257
+ sessionId: String(sessionId),
258
+ confirmSessions: Number(horizonConfig.thresholds?.microSkillConfirmSessions ?? 2)
259
+ },
260
+ cwdOptions
261
+ );
262
+ }
263
+ }
264
+ }
265
+
266
+ if (!loadedPriorSnap && options.bucketBShadow !== false && hasExplicitCwd && /^(?:Grep|Glob)$/i.test(toolName)) {
267
+ loadedPriorSnap = readBreakerStateSnapshot(sessionId, cwdOptions);
268
+ }
269
+ const bAlphaPost =
270
+ options.bucketBShadow === false
271
+ ? { triggered: false, updatedOutput: rawOutput, savedTokens: 0 }
272
+ : runBucketBPostToolPass({
273
+ platform: 'claude',
274
+ sessionId,
275
+ cwd: event.cwd || options.cwd || '',
276
+ hasExplicitCwd,
277
+ toolName,
278
+ toolInput: event.tool_input || event.toolInput || {},
279
+ rawOutput,
280
+ lastUserPrompt: event.prompt || loadedPriorSnap?.lastUserPrompt || '',
281
+ activeFiles: event.activeFiles || loadedPriorSnap?.modifiedFilesInTurn || [],
282
+ dirtyFiles: event.dirtyFiles || [],
283
+ lastEditedFile:
284
+ event.lastEditedFile || (loadedPriorSnap?.modifiedFilesInTurn || []).slice(-1)[0] || '',
285
+ webFetchesInTurn: Number(event.webFetchesInTurn || 1),
286
+ options: {
287
+ ...options,
288
+ mode: effectiveMode,
289
+ horizonConfig
290
+ }
291
+ });
292
+
293
+ const effectiveRawOutput = bAlphaPost.triggered ? bAlphaPost.updatedOutput : rawOutput;
294
+
295
+ const sanitized = sanitizePostToolOutput(
296
+ {
297
+ toolName,
298
+ toolOutput: effectiveRawOutput
299
+ },
300
+ cwdOptions
301
+ );
302
+
303
+ let finalOutput = sanitized.updatedToolOutput;
304
+ let wasModified = sanitized.sanitized || Boolean(bAlphaPost.triggered);
305
+
306
+ // Apply DET-19 IPI sanitizer if output comes from a subagent (Task/Agent/agentId) or external WebFetch/MCP tool
307
+ const isSubagentSource =
308
+ Boolean(event.agentId || event.subagentId) || /^(Task|Agent)$/i.test(toolName);
309
+ const isUntrustedSource =
310
+ isSubagentSource || /^(WebFetch|mcp__.+)$/i.test(toolName);
311
+
312
+ if (
313
+ isUntrustedSource &&
314
+ finalOutput &&
315
+ resolveDetectorOverride('DET-19', horizonConfig) !== 'off'
316
+ ) {
317
+ const ipi = evaluateDet19SubagentIpiSanitizer({
318
+ text: finalOutput,
319
+ wrapUntrusted: isSubagentSource
320
+ });
321
+ if (ipi.triggered || isSubagentSource) {
322
+ finalOutput = ipi.sanitizedText;
323
+ wasModified = true;
324
+ }
325
+ }
326
+
327
+ const totalSavedTokens = sanitized.savedTokens + Number(bAlphaPost.savedTokens || 0);
328
+ if (
329
+ totalSavedTokens > 0 &&
330
+ options.recordLedger !== false &&
331
+ (sanitized.savedTokens > 0 || hasExplicitCwd || options.ledgerPath || options.recordLedger === true)
332
+ ) {
333
+ const liveState = options.telemetryState || getTelemetryMod().readLiveStateSnapshot(sessionId, cwdOptions);
334
+ const rawEventModel =
335
+ typeof event.model === 'string'
336
+ ? event.model
337
+ : event.model?.id || event.model?.model_id || event.modelId || event.model_id;
338
+ const modelId = rawEventModel || liveState?.modelId || 'claude-sonnet-5-5';
339
+ const usageSource =
340
+ event.usage || event.context_window?.current_usage || liveState?.contextWindow || {};
341
+ const { computeTotalPromptTokens, resolveEffectiveRates } = getCatalogMod();
342
+ const totalPromptTokens = computeTotalPromptTokens(usageSource);
343
+ const rates = resolveEffectiveRates(modelId, totalPromptTokens, cwdOptions);
344
+ const computedSavedUSD =
345
+ rates && !rates.unknownModel && Number.isFinite(rates.inputPer1M)
346
+ ? Number(((totalSavedTokens / 1_000_000) * rates.inputPer1M).toFixed(6))
347
+ : 0;
348
+
349
+ getSavedQuotaMod().recordSavingsReceipt(
350
+ {
351
+ sessionId,
352
+ modelId: rates.unknownModel ? (rates.rawModelId || modelId) : rates.modelId,
353
+ category: sanitized.offloaded
354
+ ? 'ARTIFACT_OFFLOAD_4K'
355
+ : sanitized.savedTokens > 0
356
+ ? 'LOSSLESS_POST_SANITIZER'
357
+ : bAlphaPost.code || 'BUCKET_B_POST_SHIELD',
358
+ savedTokens: totalSavedTokens,
359
+ savedUSD: computedSavedUSD,
360
+ detail: `${toolName} output compressed (+${totalSavedTokens} tokens saved)`
361
+ },
362
+ cwdOptions
363
+ );
364
+ }
365
+
366
+ if (!wasModified) {
367
+ return {
368
+ exitCode: 0,
369
+ stdout: '',
370
+ stderr: '',
371
+ sanitized
372
+ };
373
+ }
374
+
375
+ // ISS-034: updatedMCPToolOutput applies strictly to MCP tools; built-in tools use additionalContext!
376
+ const isMcpTool = /^mcp__/i.test(toolName);
377
+ const hookSpecificOutput = isMcpTool
378
+ ? {
379
+ hookEventName: 'PostToolUse',
380
+ updatedMCPToolOutput: finalOutput
381
+ }
382
+ : {
383
+ hookEventName: 'PostToolUse',
384
+ additionalContext: finalOutput
385
+ };
386
+
387
+ return {
388
+ exitCode: 0,
389
+ stdout: JSON.stringify({ hookSpecificOutput }),
390
+ stderr: '',
391
+ sanitized,
392
+ hookSpecificOutput
393
+ };
394
+ }