ctxtop 4.0.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 (357) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +81 -57
  4. package/LICENSE +27 -27
  5. package/README.md +385 -330
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ah-statusline.mjs +30 -0
  9. package/bin/ctxtop.mjs +587 -49
  10. package/config/default_flightcheck.json +19 -0
  11. package/config/modelCatalog.json +952 -213
  12. package/hooks/handlers/compact-lifecycle.mjs +323 -8
  13. package/hooks/handlers/config-change.mjs +402 -0
  14. package/hooks/handlers/hookIo.mjs +56 -0
  15. package/hooks/handlers/hookIpcClient.mjs +8 -4
  16. package/hooks/handlers/post-model-switch.mjs +148 -0
  17. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  18. package/hooks/handlers/post-tool-use.mjs +54 -220
  19. package/hooks/handlers/pre-model-switch.mjs +933 -24
  20. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  21. package/hooks/handlers/pre-tool-use.mjs +61 -304
  22. package/hooks/handlers/stop-gate.mjs +310 -12
  23. package/hooks/handlers/user-prompt-submit.mjs +334 -1
  24. package/hooks/hooks.json +50 -0
  25. package/hooks/post_tool_use.mjs +24 -3
  26. package/hooks/pre_tool_use.mjs +84 -54
  27. package/hooks/register.js +48 -9
  28. package/hooks/session_start.mjs +11 -1
  29. package/hooks/stop.mjs +11 -1
  30. package/hooks.json +56 -56
  31. package/package.json +12 -4
  32. package/packages/antigravity/package.json +10 -3
  33. package/packages/antigravity/src/adapter.mjs +109 -0
  34. package/packages/antigravity/src/index.mjs +7 -1
  35. package/packages/claude-code/package.json +10 -3
  36. package/packages/claude-code/src/adapter.mjs +194 -0
  37. package/packages/claude-code/src/index.mjs +8 -2
  38. package/packages/claude-code/src/register.js +726 -0
  39. package/packages/core/package.json +6 -2
  40. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  41. package/packages/core/src/catalog/index.mjs +1 -0
  42. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  43. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  44. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  45. package/packages/core/src/coach/microSkills.mjs +1 -0
  46. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  47. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  48. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  49. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  50. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  51. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  52. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  53. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  54. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  55. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  56. package/packages/core/src/control/callTree.mjs +338 -0
  57. package/packages/core/src/control/coachLatches.mjs +126 -0
  58. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  59. package/packages/core/src/control/index.mjs +49 -0
  60. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  61. package/packages/core/src/control/toolSuspension.mjs +197 -0
  62. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  63. package/packages/core/src/diagnostics/index.mjs +9 -0
  64. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  65. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  66. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  67. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  68. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  69. package/packages/core/src/economics/driftLatency.mjs +433 -0
  70. package/packages/core/src/economics/dualTtl.mjs +198 -0
  71. package/packages/core/src/economics/index.mjs +47 -0
  72. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  73. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  74. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  75. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  76. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  77. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  78. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  79. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  80. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  81. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  82. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  83. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  84. package/packages/core/src/index.js +27 -0
  85. package/packages/core/src/index.mjs +25 -1
  86. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  87. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  88. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  89. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  90. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  91. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  92. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  93. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  94. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  95. package/packages/core/src/ui/modViews.mjs +1558 -0
  96. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  97. package/packages/core/src/ustf/index.mjs +7 -0
  98. package/packages/core/src/ustf/normalizer.mjs +512 -0
  99. package/packages/core/src/ustf/schema.mjs +186 -0
  100. package/packages/core/src/utils/runtime.mjs +962 -0
  101. package/packages/engine-node/package.json +6 -2
  102. package/packages/engine-node/src/db/index.mjs +58 -0
  103. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  104. package/packages/engine-node/src/db/probe.mjs +342 -0
  105. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  106. package/packages/engine-node/src/index.mjs +11 -1
  107. package/packages/engine-node/src/ipc/client.mjs +447 -0
  108. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  109. package/packages/engine-node/src/ipc/index.mjs +24 -0
  110. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  111. package/packages/engine-node/src/ipc/server.mjs +445 -0
  112. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  113. package/packages/engine-node/src/offloader/index.mjs +6 -0
  114. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  115. package/packages/engine-node/src/rsl/index.mjs +3 -0
  116. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  117. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  118. package/packages/engine-node/src/sensors/index.mjs +7 -0
  119. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  120. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  121. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  122. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  123. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  124. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  125. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  126. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  127. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  128. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  129. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  181. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  182. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  183. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  184. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  185. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  186. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  187. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  188. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  189. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  190. package/packages/mcp/package.json +7 -3
  191. package/packages/mcp/src/server.mjs +115 -14
  192. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  193. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  194. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  195. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  196. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  197. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  198. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  199. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  200. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  201. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  202. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  203. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  204. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  256. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  257. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  258. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  259. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  260. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  261. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  262. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  263. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  264. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  265. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  266. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  267. package/packages/pro/package.json +23 -16
  268. package/packages/pro/src/index.mjs +9 -3
  269. package/packages/pro/src/pro_license.mjs +547 -0
  270. package/packages/pro/src/team_finops_pack.mjs +241 -241
  271. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  272. package/plugin.json +1 -1
  273. package/sidecars/horizon-daemon/server.mjs +514 -40
  274. package/skills/handoff/SKILL.md +8 -0
  275. package/src/adapters/antigravity/index.mjs +31 -1
  276. package/src/adapters/claude-code/index.mjs +40 -1
  277. package/src/cli/doctor.mjs +11 -2
  278. package/src/cli/horizon_hud.mjs +283 -65
  279. package/src/cli/init.mjs +46 -13
  280. package/src/config/modelCatalog.json +952 -213
  281. package/src/core/bucket_b_runtime.mjs +1200 -0
  282. package/src/core/classifier.mjs +25 -11
  283. package/src/core/coach/circuit_breakers.mjs +84 -6
  284. package/src/core/coach/task_quota_router.mjs +8 -0
  285. package/src/core/code_fold_lite.mjs +169 -0
  286. package/src/core/config.mjs +44 -0
  287. package/src/core/constants.mjs +365 -15
  288. package/src/core/detectors_det01_to_16.mjs +98 -8
  289. package/src/core/doc_indexer.mjs +338 -0
  290. package/src/core/fts5_output_compressor.mjs +272 -35
  291. package/src/core/horizon_config.mjs +42 -0
  292. package/src/core/layer5_hygiene.mjs +118 -0
  293. package/src/core/parser.mjs +88 -12
  294. package/src/core/paths.mjs +3 -2
  295. package/src/core/pro_license.mjs +174 -12
  296. package/src/core/pruner.mjs +7 -146
  297. package/src/core/quota.mjs +14 -2
  298. package/src/core/rsl_clash_auditor.mjs +423 -0
  299. package/src/core/rsl_distiller.mjs +394 -0
  300. package/src/core/rsl_ledger.mjs +1029 -0
  301. package/src/core/rsl_triage.mjs +1051 -0
  302. package/src/core/session_auditor.mjs +1109 -0
  303. package/src/core/shadow_auto_ledger.mjs +205 -0
  304. package/src/core/shield_manager.mjs +1417 -0
  305. package/src/core/sqlite_client.mjs +10 -4
  306. package/src/core/subagents.mjs +18 -2
  307. package/src/core/task_quota_router.mjs +62 -5
  308. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  309. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +874 -47
  310. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  311. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  312. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  313. package/src/core-isomorphic/coach/ttlWatchdog.mjs +13 -6
  314. package/src/core-isomorphic/config/anthropicModelCatalog.json +405 -1
  315. package/src/core-isomorphic/config/catalogLoader.mjs +549 -46
  316. package/src/core-isomorphic/config/horizonConfig.mjs +47 -1
  317. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +266 -0
  318. package/src/core-isomorphic/economics/cacheGravity.mjs +21 -1
  319. package/src/core-isomorphic/economics/cliffBreaker.mjs +98 -12
  320. package/src/core-isomorphic/economics/driftLatency.mjs +114 -0
  321. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  322. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  323. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  324. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  325. package/src/core-isomorphic/guards/circuitBreakers.mjs +191 -191
  326. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +154 -5
  327. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +103 -11
  328. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +311 -1
  329. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  330. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +16 -0
  331. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  332. package/src/core-isomorphic/index.js +1 -0
  333. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +113 -13
  334. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +684 -363
  335. package/src/core-isomorphic/ui/modViews.mjs +95 -15
  336. package/src/diagnostics/claudeHookCapabilities.mjs +426 -0
  337. package/src/diagnostics/doctorEngine.mjs +122 -4
  338. package/src/engine-node/db/probe.mjs +234 -2
  339. package/src/engine-node/index.mjs +3 -0
  340. package/src/engine-node/ipc/fast_client.mjs +191 -0
  341. package/src/engine-node/ipc/index.mjs +2 -0
  342. package/src/engine-node/multi_host_mcp.mjs +168 -0
  343. package/src/engine-node/sensors/blindspots.mjs +13 -6
  344. package/src/hooks/antigravity_rsl_hook.mjs +272 -0
  345. package/src/hooks/claude_rsl_hook.mjs +308 -0
  346. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  347. package/src/hooks/fast_hook_ipc.mjs +295 -0
  348. package/src/hooks/post_invocation.mjs +37 -405
  349. package/src/hooks/post_invocation_core.mjs +623 -0
  350. package/src/hooks/pre_invocation.mjs +103 -958
  351. package/src/hooks/pre_invocation_core.mjs +1830 -0
  352. package/src/hooks/session_start.mjs +39 -1
  353. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  354. package/src/utils/sessionCalibration.mjs +704 -0
  355. package/src/webview/advanced_view.html +34 -18
  356. package/src/webview/horizon_panel.html +4191 -625
  357. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,251 @@
1
+ /**
2
+ * @file src/core-isomorphic/economics/billingBlocks.mjs
3
+ * Feature 22: 5-Hour Rolling Billing Blocks & Subagent Cost Attribution.
4
+ *
5
+ * Implements:
6
+ * - 18,000,000 ms (5-hour) rolling billing window partitioning
7
+ * - Velocity metrics: burn rate in USD/hour and tokens/min per block
8
+ * - Per-subagent spend and token attribution
9
+ * - Cumulative session cost calculation across active rolling blocks
10
+ * - Clean empty-array handling returning `[]`
11
+ * - Resilient input validation: filters null/undefined events and sanitizes non-numeric costs/tokens
12
+ *
13
+ * Adheres strictly to Claude Mod Laws 1–5: pure ESM, zero `node:*` imports, zero Node globals.
14
+ */
15
+
16
+ export const BILLING_BLOCK_CONSTANTS = Object.freeze({
17
+ BLOCK_DURATION_MS: 5 * 3600 * 1000, // 18,000,000 ms (5 hours)
18
+ BLOCK_DURATION_HOURS: 5.0,
19
+ TOKENS_PER_MIN_DIVISOR: 300 // 5 hours * 60 minutes
20
+ });
21
+
22
+ /**
23
+ * Partitions continuous session token usage events into rolling 5-hour billing blocks.
24
+ *
25
+ * @param {Array<{ timestamp: number, costUsd?: number, tokens?: number, subagentId?: string }>} [usageEvents=[]]
26
+ * @param {number} [blockDurationMs=18000000] Block window in ms (default 5 hours)
27
+ * @returns {Array<{
28
+ * blockIndex: number,
29
+ * startTime: number,
30
+ * endTime: number,
31
+ * totalCostUsd: number,
32
+ * totalTokens: number,
33
+ * eventCount: number,
34
+ * subagentSpend: Record<string, number>,
35
+ * burnRateUsdPerHour: number,
36
+ * tokensPerMin: number
37
+ * }>}
38
+ */
39
+ export function partitionBillingBlocks(
40
+ usageEvents = [],
41
+ blockDurationMs = BILLING_BLOCK_CONSTANTS.BLOCK_DURATION_MS
42
+ ) {
43
+ if (!Array.isArray(usageEvents) || usageEvents.length === 0) {
44
+ return [];
45
+ }
46
+
47
+ // Filter usageEvents to keep only valid non-null object entries
48
+ const validEvents = usageEvents.filter(ev => ev && typeof ev === 'object');
49
+ if (validEvents.length === 0) {
50
+ return [];
51
+ }
52
+
53
+ const duration = Number(blockDurationMs) > 0
54
+ ? Number(blockDurationMs)
55
+ : BILLING_BLOCK_CONSTANTS.BLOCK_DURATION_MS;
56
+
57
+ const sorted = [...validEvents].sort((a, b) => {
58
+ const tsA = Number(a.timestamp) || 0;
59
+ const tsB = Number(b.timestamp) || 0;
60
+ return tsA - tsB;
61
+ });
62
+
63
+ const startTimestamp = Number(sorted[0].timestamp) || 0;
64
+ const blocksMap = new Map();
65
+
66
+ for (const event of sorted) {
67
+ const rawTs = Number(event.timestamp);
68
+ const ts = Number.isFinite(rawTs) ? rawTs : startTimestamp;
69
+ const blockIndex = Math.max(0, Math.floor((ts - startTimestamp) / duration));
70
+
71
+ if (!blocksMap.has(blockIndex)) {
72
+ blocksMap.set(blockIndex, {
73
+ blockIndex,
74
+ startTime: startTimestamp + (blockIndex * duration),
75
+ endTime: startTimestamp + ((blockIndex + 1) * duration),
76
+ totalCostUsd: 0,
77
+ totalTokens: 0,
78
+ eventCount: 0,
79
+ subagentSpend: {}
80
+ });
81
+ }
82
+
83
+ const block = blocksMap.get(blockIndex);
84
+ const cost = Math.max(0, Number(event.costUsd) || 0);
85
+ const tokens = Math.max(0, Number(event.tokens) || 0);
86
+ const agent = String(event.subagentId || 'main');
87
+
88
+ block.totalCostUsd = parseFloat((block.totalCostUsd + cost).toFixed(4));
89
+ block.totalTokens += tokens;
90
+ block.eventCount += 1;
91
+ block.subagentSpend[agent] = parseFloat(((block.subagentSpend[agent] || 0) + cost).toFixed(4));
92
+ }
93
+
94
+ const durationHours = duration / 3600000;
95
+ const durationMins = durationHours * 60;
96
+
97
+ return Array.from(blocksMap.values()).map(b => {
98
+ const burnRateUsdPerHour = durationHours > 0
99
+ ? parseFloat((b.totalCostUsd / durationHours).toFixed(4))
100
+ : 0;
101
+ const tokensPerMin = durationMins > 0
102
+ ? Math.round(b.totalTokens / durationMins)
103
+ : 0;
104
+ return {
105
+ ...b,
106
+ burnRateUsdPerHour,
107
+ tokensPerMin
108
+ };
109
+ });
110
+ }
111
+
112
+ /**
113
+ * Attributes total spend and token consumption across subagent IDs.
114
+ *
115
+ * @param {Array<{ timestamp?: number, costUsd?: number, tokens?: number, subagentId?: string }>} [usageEvents=[]]
116
+ * @returns {Record<string, { costUsd: number, tokens: number, pct: number }>}
117
+ */
118
+ export function attributeSubagentCosts(usageEvents = []) {
119
+ if (!Array.isArray(usageEvents) || usageEvents.length === 0) {
120
+ return {};
121
+ }
122
+
123
+ const validEvents = usageEvents.filter(ev => ev && typeof ev === 'object');
124
+ if (validEvents.length === 0) {
125
+ return {};
126
+ }
127
+
128
+ const result = {};
129
+ let totalCost = 0;
130
+
131
+ for (const ev of validEvents) {
132
+ const agent = String(ev.subagentId || 'main');
133
+ const cost = Math.max(0, Number(ev.costUsd) || 0);
134
+ const tokens = Math.max(0, Number(ev.tokens) || 0);
135
+
136
+ if (!result[agent]) {
137
+ result[agent] = { costUsd: 0, tokens: 0, pct: 0 };
138
+ }
139
+ result[agent].costUsd = parseFloat((result[agent].costUsd + cost).toFixed(4));
140
+ result[agent].tokens += tokens;
141
+ totalCost += cost;
142
+ }
143
+
144
+ for (const agent of Object.keys(result)) {
145
+ result[agent].pct = totalCost > 0
146
+ ? parseFloat(((result[agent].costUsd / totalCost) * 100).toFixed(1))
147
+ : 0;
148
+ }
149
+
150
+ return result;
151
+ }
152
+
153
+ /**
154
+ * Computes aggregate summary metrics across multiple billing blocks.
155
+ *
156
+ * @param {Array<object>} blocks
157
+ * @returns {{
158
+ * blockCount: number,
159
+ * cumulativeCostUsd: number,
160
+ * cumulativeTokens: number,
161
+ * maxBurnRateUsdPerHour: number,
162
+ * avgTokensPerMin: number
163
+ * }}
164
+ */
165
+ export function computeBillingBlockSummary(blocks = []) {
166
+ if (!Array.isArray(blocks) || blocks.length === 0) {
167
+ return {
168
+ blockCount: 0,
169
+ cumulativeCostUsd: 0,
170
+ cumulativeTokens: 0,
171
+ maxBurnRateUsdPerHour: 0,
172
+ avgTokensPerMin: 0
173
+ };
174
+ }
175
+
176
+ const validBlocks = blocks.filter(b => b && typeof b === 'object');
177
+ if (validBlocks.length === 0) {
178
+ return {
179
+ blockCount: 0,
180
+ cumulativeCostUsd: 0,
181
+ cumulativeTokens: 0,
182
+ maxBurnRateUsdPerHour: 0,
183
+ avgTokensPerMin: 0
184
+ };
185
+ }
186
+
187
+ let totalCost = 0;
188
+ let totalTokens = 0;
189
+ let maxBurn = 0;
190
+ let sumTokPerMin = 0;
191
+
192
+ for (const b of validBlocks) {
193
+ const cost = Math.max(0, Number(b.totalCostUsd) || 0);
194
+ const tokens = Math.max(0, Number(b.totalTokens) || 0);
195
+ const burn = Math.max(0, Number(b.burnRateUsdPerHour) || 0);
196
+ const tokPerMin = Math.max(0, Number(b.tokensPerMin) || 0);
197
+
198
+ totalCost += cost;
199
+ totalTokens += tokens;
200
+ if (burn > maxBurn) {
201
+ maxBurn = burn;
202
+ }
203
+ sumTokPerMin += tokPerMin;
204
+ }
205
+
206
+ return {
207
+ blockCount: validBlocks.length,
208
+ cumulativeCostUsd: parseFloat(totalCost.toFixed(4)),
209
+ cumulativeTokens: totalTokens,
210
+ maxBurnRateUsdPerHour: parseFloat(maxBurn.toFixed(4)),
211
+ avgTokensPerMin: Math.round(sumTokPerMin / validBlocks.length)
212
+ };
213
+ }
214
+
215
+ /**
216
+ * Stateful RollingBillingBlockTracker.
217
+ */
218
+ export class RollingBillingBlockTracker {
219
+ constructor(options = {}) {
220
+ const opts = (options && typeof options === 'object') ? options : {};
221
+ this.blockDurationMs = Number(opts.blockDurationMs) > 0
222
+ ? Number(opts.blockDurationMs)
223
+ : BILLING_BLOCK_CONSTANTS.BLOCK_DURATION_MS;
224
+ this.events = [];
225
+ }
226
+
227
+ recordEvent(event = {}) {
228
+ if (!event || typeof event !== 'object') {
229
+ return;
230
+ }
231
+ const rawTs = Number(event.timestamp);
232
+ this.events.push({
233
+ timestamp: Number.isFinite(rawTs) ? rawTs : Date.now(),
234
+ costUsd: Math.max(0, Number(event.costUsd) || 0),
235
+ tokens: Math.max(0, Number(event.tokens) || 0),
236
+ subagentId: String(event.subagentId || 'main')
237
+ });
238
+ }
239
+
240
+ getBlocks() {
241
+ return partitionBillingBlocks(this.events, this.blockDurationMs);
242
+ }
243
+
244
+ getSummary() {
245
+ return computeBillingBlockSummary(this.getBlocks());
246
+ }
247
+
248
+ getSubagentAttribution() {
249
+ return attributeSubagentCosts(this.events);
250
+ }
251
+ }
@@ -0,0 +1,371 @@
1
+ /**
2
+ * @file src/core-isomorphic/economics/cacheGravity.mjs
3
+ * Feature 19: Algebraic C* Break-Even Cache Gravity Router.
4
+ *
5
+ * Implements the exact algebraic cross-model break-even equation:
6
+ * C* = [ O * (P_out,curr - P_out,target) + Delta_uncached * (P_write,curr - P_write,target) ]
7
+ * / [ P_write,target - P_read,curr ]
8
+ *
9
+ * Canonical test values at O = 1,500, Delta = 0:
10
+ * - Opus 5.5 -> Sonnet 5.5: C* = 6,522 tokens
11
+ * - Opus 4.6 -> Sonnet 4.6: C* = 4,615 tokens
12
+ *
13
+ * Boundary rules:
14
+ * - Capability upshift (P_out,curr <= P_out,target): C* = 0, shouldHold = false
15
+ * - Cheaper target write than current read (P_write,target <= P_read,curr): C* = Infinity
16
+ * - Identical models: C* = 0, shouldHold = false
17
+ * - Cold cache (cachedTokens = 0, cacheWarm = false): switch is cheaper if target is cheaper
18
+ * - Warm cache (cachedTokens > C*): shouldHold = true
19
+ *
20
+ * Adheres strictly to Claude Mod Laws 1–5: pure ESM, zero `node:*` imports, zero Node globals.
21
+ */
22
+
23
+ import {
24
+ normalizeModelId,
25
+ computeTotalPromptTokens,
26
+ resolveEffectiveRates
27
+ } from '../config/catalogLoader.mjs';
28
+
29
+ export const DEFAULT_EXPECTED_OUTPUT_TOKENS = 1500;
30
+
31
+ export const EXPECTED_OUTPUT_TOKENS_BY_EFFORT = Object.freeze({
32
+ low: 800,
33
+ medium: 1500,
34
+ high: 3500,
35
+ max: 6000
36
+ });
37
+
38
+ export const FLIGHT_MODES = Object.freeze({
39
+ OFF: 'OFF',
40
+ SILENT: 'SILENT',
41
+ COACH: 'COACH',
42
+ AUTO_PILOT: 'AUTO_PILOT'
43
+ });
44
+
45
+ export const MODEL_BREAK_EVEN_RATES = Object.freeze({
46
+ 'claude-opus-5-5': { output: 20.0, read: 0.2, write5m: 5.0, write1h: 8.0 },
47
+ 'claude-sonnet-5-5': { output: 10.0, read: 0.1, write5m: 2.5, write1h: 4.0 },
48
+ 'claude-opus-4-6': { output: 25.0, read: 0.5, write5m: 6.25, write1h: 10.0 },
49
+ 'claude-sonnet-4-6': { output: 15.0, read: 0.3, write5m: 3.75, write1h: 6.0 },
50
+ 'claude-haiku-5-5': { output: 0.5, read: 0.01, write5m: 0.125, write1h: 0.2 },
51
+ 'claude-haiku-4-5': { output: 5.0, read: 0.10, write5m: 1.25, write1h: 2.0 },
52
+ 'claude-fable-5-2': { output: 40.0, read: 0.20, write5m: 10.0, write1h: 16.0 },
53
+ 'claude-fable-5-1': { output: 50.0, read: 0.25, write5m: 12.5, write1h: 20.0 },
54
+ 'claude-mythos-5-2': { output: 40.0, read: 0.20, write5m: 10.0, write1h: 16.0 },
55
+ 'claude-mythos-5-1': { output: 50.0, read: 0.25, write5m: 12.5, write1h: 20.0 }
56
+ });
57
+
58
+ /**
59
+ * Maps an active model to its natural one-tier downshift peer.
60
+ * @param {string} [modelId='claude-opus-5-5']
61
+ * @returns {string}
62
+ */
63
+ export function resolveNaturalDownshiftPeer(modelId = 'claude-opus-5-5') {
64
+ const norm = normalizeModelId(modelId);
65
+ switch (norm) {
66
+ case 'claude-mythos-5-2':
67
+ case 'claude-mythos-5-1':
68
+ case 'claude-mythos-5':
69
+ case 'claude-fable-5-2':
70
+ case 'claude-fable-5-1':
71
+ case 'claude-fable-5':
72
+ return 'claude-opus-5-5';
73
+ case 'claude-opus-5-5':
74
+ return 'claude-sonnet-5-5';
75
+ case 'claude-opus-5':
76
+ return 'claude-sonnet-5';
77
+ case 'claude-opus-4-8':
78
+ case 'claude-opus-4-7':
79
+ case 'claude-opus-4-6':
80
+ case 'claude-opus-4-5':
81
+ case 'claude-opus-4-1':
82
+ case 'claude-opus-4-0':
83
+ return 'claude-sonnet-4-6';
84
+ case 'claude-sonnet-5-5':
85
+ case 'claude-sonnet-5':
86
+ return 'claude-haiku-5-5';
87
+ case 'claude-sonnet-4-6':
88
+ case 'claude-sonnet-4-5':
89
+ case 'claude-sonnet-4-0':
90
+ return 'claude-haiku-4-5';
91
+ case 'claude-3-7-sonnet':
92
+ case 'claude-3-5-sonnet':
93
+ case 'claude-3-5-haiku':
94
+ return 'claude-3-5-haiku';
95
+ case 'claude-haiku-4-5':
96
+ case 'claude-haiku-5-5':
97
+ return 'claude-haiku-5-5';
98
+ default:
99
+ return 'claude-sonnet-5-5';
100
+ }
101
+ }
102
+
103
+ /**
104
+ * Closed-form break-even equation computation.
105
+ *
106
+ * @param {number} expectedOutputTokens O
107
+ * @param {number} pOutCurr P_out,curr
108
+ * @param {number} pOutTarget P_out,target
109
+ * @param {number} pWriteTarget P_write,target
110
+ * @param {number} pReadCurr P_read,curr
111
+ * @param {number} [uncachedDeltaTokens=0] Delta_uncached
112
+ * @param {number} [pWriteCurr=pWriteTarget] P_write,curr
113
+ * @returns {number} C* (rounded integer, 0 for upshifts, Infinity if write <= read)
114
+ */
115
+ export function computeClosedFormBreakEven(
116
+ expectedOutputTokens,
117
+ pOutCurr,
118
+ pOutTarget,
119
+ pWriteTarget,
120
+ pReadCurr,
121
+ uncachedDeltaTokens = 0,
122
+ pWriteCurr = pWriteTarget
123
+ ) {
124
+ if (pOutCurr <= pOutTarget) {
125
+ return 0; // Capability upshift
126
+ }
127
+
128
+ const numerator =
129
+ expectedOutputTokens * (pOutCurr - pOutTarget) +
130
+ uncachedDeltaTokens * (pWriteCurr - pWriteTarget);
131
+
132
+ const denominator = pWriteTarget - pReadCurr;
133
+
134
+ if (numerator <= 0) {
135
+ return 0;
136
+ }
137
+ if (denominator <= 0) {
138
+ return Infinity;
139
+ }
140
+
141
+ return Math.round(numerator / denominator);
142
+ }
143
+
144
+ /**
145
+ * Calculates the exact algebraic break-even token count C*.
146
+ * Supports invocation via options object or positional arguments.
147
+ *
148
+ * Canonical test values:
149
+ * - Opus 5.5 -> Sonnet 5.5 (default): C* = 6,522
150
+ * - Opus 4.6 -> Sonnet 4.6: C* = 4,615
151
+ *
152
+ * @param {object|number} [optionsOrOutputTokens={}]
153
+ * @param {object} [maybeRatesCurr]
154
+ * @param {object} [maybeRatesTarget]
155
+ * @returns {number}
156
+ */
157
+ export function calculateBreakEvenCStar(optionsOrOutputTokens = {}, maybeRatesCurr, maybeRatesTarget) {
158
+ let expectedOutputTokens = DEFAULT_EXPECTED_OUTPUT_TOKENS;
159
+ let pOutCurr = 20.0;
160
+ let pOutTarget = 10.0;
161
+ let pWrite5mTarget = 2.5;
162
+ let pReadCurr = 0.2;
163
+ let uncachedDeltaTokens = 0;
164
+ let pWriteCurr = 5.0;
165
+
166
+ if (typeof optionsOrOutputTokens === 'number') {
167
+ expectedOutputTokens = Math.max(0, optionsOrOutputTokens);
168
+ if (maybeRatesCurr && typeof maybeRatesCurr === 'object') {
169
+ pOutCurr = Number(maybeRatesCurr.output ?? maybeRatesCurr.outputPer1M ?? maybeRatesCurr.pOut ?? pOutCurr);
170
+ pReadCurr = Number(maybeRatesCurr.read ?? maybeRatesCurr.readPer1M ?? maybeRatesCurr.pRead ?? pReadCurr);
171
+ pWriteCurr = Number(maybeRatesCurr.write5m ?? maybeRatesCurr.write5mPer1M ?? maybeRatesCurr.write ?? pWriteCurr);
172
+ }
173
+ if (maybeRatesTarget && typeof maybeRatesTarget === 'object') {
174
+ pOutTarget = Number(maybeRatesTarget.output ?? maybeRatesTarget.outputPer1M ?? maybeRatesTarget.pOut ?? pOutTarget);
175
+ pWrite5mTarget = Number(
176
+ maybeRatesTarget.write5m ??
177
+ maybeRatesTarget.write5mPer1M ??
178
+ maybeRatesTarget.write ??
179
+ maybeRatesTarget.pWrite5m ??
180
+ pWrite5mTarget
181
+ );
182
+ }
183
+ } else if (typeof optionsOrOutputTokens === 'object' && optionsOrOutputTokens !== null) {
184
+ const opts = optionsOrOutputTokens;
185
+ if (opts.expectedOutputTokens !== undefined || opts.O !== undefined) {
186
+ const rawO = Number(opts.expectedOutputTokens ?? opts.O);
187
+ expectedOutputTokens = Number.isFinite(rawO) ? Math.max(0, rawO) : DEFAULT_EXPECTED_OUTPUT_TOKENS;
188
+ }
189
+ if (opts.uncachedDeltaTokens !== undefined) {
190
+ const rawDelta = Number(opts.uncachedDeltaTokens);
191
+ uncachedDeltaTokens = Number.isFinite(rawDelta) ? Math.max(0, rawDelta) : 0;
192
+ }
193
+
194
+ const curModel = opts.currentModel ? normalizeModelId(opts.currentModel) : null;
195
+ const tgtModel = opts.targetModel ? normalizeModelId(opts.targetModel) : null;
196
+
197
+ if (curModel && MODEL_BREAK_EVEN_RATES[curModel]) {
198
+ const m = MODEL_BREAK_EVEN_RATES[curModel];
199
+ pOutCurr = m.output;
200
+ pReadCurr = m.read;
201
+ pWriteCurr = m.write5m;
202
+ }
203
+ if (tgtModel && MODEL_BREAK_EVEN_RATES[tgtModel]) {
204
+ const m = MODEL_BREAK_EVEN_RATES[tgtModel];
205
+ pOutTarget = m.output;
206
+ pWrite5mTarget = m.write5m;
207
+ }
208
+
209
+ const rc = opts.ratesCurr || opts.currentRates;
210
+ if (rc && typeof rc === 'object') {
211
+ pOutCurr = Number(rc.output ?? rc.outputPer1M ?? rc.pOut ?? pOutCurr);
212
+ pReadCurr = Number(rc.read ?? rc.readPer1M ?? rc.pRead ?? pReadCurr);
213
+ pWriteCurr = Number(rc.write5m ?? rc.write5mPer1M ?? rc.write ?? pWriteCurr);
214
+ }
215
+ const rt = opts.ratesTarget || opts.targetRates;
216
+ if (rt && typeof rt === 'object') {
217
+ pOutTarget = Number(rt.output ?? rt.outputPer1M ?? rt.pOut ?? pOutTarget);
218
+ pWrite5mTarget = Number(
219
+ rt.write5m ??
220
+ rt.write5mPer1M ??
221
+ rt.write ??
222
+ rt.pWrite5m ??
223
+ pWrite5mTarget
224
+ );
225
+ }
226
+
227
+ if (opts.pOutCurr !== undefined) pOutCurr = Number(opts.pOutCurr);
228
+ if (opts.pOutTarget !== undefined) pOutTarget = Number(opts.pOutTarget);
229
+ if (opts.pWrite5mTarget !== undefined) pWrite5mTarget = Number(opts.pWrite5mTarget);
230
+ if (opts.pReadCurr !== undefined) pReadCurr = Number(opts.pReadCurr);
231
+ }
232
+
233
+ return computeClosedFormBreakEven(
234
+ expectedOutputTokens,
235
+ pOutCurr,
236
+ pOutTarget,
237
+ pWrite5mTarget,
238
+ pReadCurr,
239
+ uncachedDeltaTokens,
240
+ pWriteCurr
241
+ );
242
+ }
243
+
244
+ /**
245
+ * Computes exact break-even token thresholds and USD turn costs for staying on current vs switching.
246
+ *
247
+ * @param {object} [params={}]
248
+ * @param {string} [params.currentModel='claude-opus-5-5']
249
+ * @param {string} [params.targetModel='claude-sonnet-5-5']
250
+ * @param {number} [params.expectedOutputTokens=1500]
251
+ * @param {number} [params.cachedTokens=0]
252
+ * @param {number} [params.uncachedDeltaTokens=0]
253
+ * @param {boolean} [params.cacheWarm]
254
+ * @param {'5m'|'1h'} [params.cacheTtlTier='5m']
255
+ * @param {object} [options={}]
256
+ * @returns {object}
257
+ */
258
+ export function computeBreakEvenCachedTokens(params = {}, options = {}) {
259
+ const rawCurrentModel = params.currentModel || 'claude-opus-5-5';
260
+ const rawTargetModel = params.targetModel || 'claude-sonnet-5-5';
261
+ const currentModel = normalizeModelId(rawCurrentModel);
262
+ const targetModel = normalizeModelId(rawTargetModel);
263
+ const rawExpected = Number(params.expectedOutputTokens ?? DEFAULT_EXPECTED_OUTPUT_TOKENS);
264
+ const expectedOutputTokens = Number.isFinite(rawExpected) ? Math.max(0, rawExpected) : DEFAULT_EXPECTED_OUTPUT_TOKENS;
265
+ const rawCached = Number(params.cachedTokens ?? 0);
266
+ const cachedTokens = Number.isFinite(rawCached) ? Math.max(0, rawCached) : 0;
267
+ const rawUncached = Number(params.uncachedDeltaTokens ?? 0);
268
+ const uncachedDeltaTokens = Number.isFinite(rawUncached) ? Math.max(0, rawUncached) : 0;
269
+ const cacheWarm = params.cacheWarm !== undefined ? Boolean(params.cacheWarm) : cachedTokens > 0;
270
+ const ttlTier = params.cacheTtlTier === '1h' ? '1h' : '5m';
271
+
272
+ const totalPromptTokens = Math.max(
273
+ cachedTokens + uncachedDeltaTokens,
274
+ computeTotalPromptTokens(params)
275
+ );
276
+ const currRates = resolveEffectiveRates(rawCurrentModel, totalPromptTokens, options);
277
+ const targetRates = resolveEffectiveRates(rawTargetModel, totalPromptTokens, options);
278
+
279
+ const pOutCurr = currRates.outputPer1M;
280
+ const pOutTarget = targetRates.outputPer1M;
281
+ const pReadCurr = currRates.readPer1M;
282
+ const pWriteCurr = ttlTier === '1h' ? currRates.write1hPer1M : currRates.write5mPer1M;
283
+ const pWriteTarget = ttlTier === '1h' ? targetRates.write1hPer1M : targetRates.write5mPer1M;
284
+
285
+ const isCapabilityUpshift = pOutCurr <= pOutTarget;
286
+
287
+ let breakEvenTokens = 0;
288
+ if (currentModel === targetModel || isCapabilityUpshift) {
289
+ breakEvenTokens = 0;
290
+ } else {
291
+ breakEvenTokens = computeClosedFormBreakEven(
292
+ expectedOutputTokens,
293
+ pOutCurr,
294
+ pOutTarget,
295
+ pWriteTarget,
296
+ pReadCurr,
297
+ uncachedDeltaTokens,
298
+ pWriteCurr
299
+ );
300
+ }
301
+
302
+ // Exact USD turn cost if staying on currentModel
303
+ const stayPrefixCostUSD = cacheWarm
304
+ ? (cachedTokens / 1_000_000) * pReadCurr + (uncachedDeltaTokens / 1_000_000) * pWriteCurr
305
+ : ((cachedTokens + uncachedDeltaTokens) / 1_000_000) * pWriteCurr;
306
+ const stayOutputCostUSD = (expectedOutputTokens / 1_000_000) * pOutCurr;
307
+ const stayOnCurrentModelUSD = stayPrefixCostUSD + stayOutputCostUSD;
308
+
309
+ // Switching to a different model invalidates isolated cache, forcing cold write
310
+ const switchPrefixCostUSD =
311
+ currentModel === targetModel && cacheWarm
312
+ ? stayPrefixCostUSD
313
+ : ((cachedTokens + uncachedDeltaTokens) / 1_000_000) * pWriteTarget;
314
+ const switchOutputCostUSD = (expectedOutputTokens / 1_000_000) * pOutTarget;
315
+ const switchToTargetModelUSD = switchPrefixCostUSD + switchOutputCostUSD;
316
+
317
+ const coldWritePenaltyUSD = Number(
318
+ (switchToTargetModelUSD - stayOnCurrentModelUSD).toFixed(6)
319
+ );
320
+
321
+ const shouldHoldModel = Boolean(
322
+ currentModel !== targetModel &&
323
+ !isCapabilityUpshift &&
324
+ cacheWarm &&
325
+ coldWritePenaltyUSD > 0 &&
326
+ cachedTokens > breakEvenTokens
327
+ );
328
+
329
+ return {
330
+ currentModel,
331
+ targetModel,
332
+ expectedOutputTokens,
333
+ cachedTokens,
334
+ uncachedDeltaTokens,
335
+ totalPromptTokens,
336
+ cacheWarm,
337
+ cacheTtlTier: ttlTier,
338
+ writeMultiplierLabel: ttlTier === '1h' ? '2.0x' : '1.25x',
339
+ isCapabilityUpshift,
340
+ breakEvenTokens,
341
+ rates: {
342
+ currentOutputPer1M: pOutCurr,
343
+ targetOutputPer1M: pOutTarget,
344
+ currentReadPer1M: pReadCurr,
345
+ currentWritePer1M: pWriteCurr,
346
+ targetWritePer1M: pWriteTarget
347
+ },
348
+ stayOnCurrentModelUSD,
349
+ switchToTargetModelUSD,
350
+ coldWritePenaltyUSD,
351
+ shouldHold: shouldHoldModel,
352
+ shouldHoldModel
353
+ };
354
+ }
355
+
356
+ /**
357
+ * Evaluates cache gravity recommendation for flight controller.
358
+ *
359
+ * @param {object} params
360
+ * @param {object} [options={}]
361
+ * @returns {object}
362
+ */
363
+ export function evaluateCacheGravity(params = {}, options = {}) {
364
+ const result = computeBreakEvenCachedTokens(params, options);
365
+ const recommendation = result.shouldHoldModel ? 'STAY_ON_CURRENT' : 'SWITCH_TO_TARGET';
366
+ return {
367
+ ...result,
368
+ recommendation,
369
+ action: result.shouldHoldModel ? 'hold' : 'allow'
370
+ };
371
+ }