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,1271 @@
1
+ /**
2
+ * @file src/config/catalogLoader.mjs
3
+ * Unified Anthropic Model Catalog loader, rate card resolver, Haiku 5.5 100k 5x cliff calculator,
4
+ * and customCeilings.json override merger.
5
+ */
6
+
7
+ import {
8
+ path,
9
+ getCwd,
10
+ getHomeDir,
11
+ getNodeIo,
12
+ fileUrlToPathPure,
13
+ readJsonSafe
14
+ } from '../utils/runtime.mjs';
15
+
16
+ export const BUILTIN_CATALOG = {
17
+ schemaVersion: '2026.11.15',
18
+ catalogVersion: '2026-11-15',
19
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models, 2026-11-15) & Claude Code 2.1.325 bakedCatalog',
20
+ dateRead: '2026-11-15',
21
+ defaultModel: 'claude-sonnet-5-5',
22
+ cacheWriteMultipliers: {
23
+ '5m': 1.25,
24
+ '1h': 2.0
25
+ },
26
+ effortExpectedOutputTokens: {
27
+ low: 800,
28
+ medium: 1500,
29
+ high: 3500,
30
+ xhigh: 5000,
31
+ max: 6000
32
+ },
33
+ models: {
34
+ 'claude-fable-5-2': {
35
+ id: 'claude-fable-5-2',
36
+ label: 'Claude Fable 5.2',
37
+ shortLabel: 'Fable 5.2',
38
+ family: 'fable',
39
+ generation: '5.2',
40
+ contextCeiling: 1000000,
41
+ operationalSoftCeiling: 180000,
42
+ ratesPer1M: { input: 8.0, output: 40.0, write5m: 10.0, write1h: 16.0, read: 0.2 },
43
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.025 },
44
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
45
+ dateRead: '2026-11-15',
46
+ pricingCliff: null
47
+ },
48
+ 'claude-fable-5-1': {
49
+ id: 'claude-fable-5-1',
50
+ label: 'Claude Fable 5.1',
51
+ shortLabel: 'Fable 5.1',
52
+ family: 'fable',
53
+ generation: '5.1',
54
+ contextCeiling: 1000000,
55
+ operationalSoftCeiling: 180000,
56
+ ratesPer1M: { input: 10.0, output: 50.0, write5m: 12.5, write1h: 20.0, read: 0.25 },
57
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.025 },
58
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
59
+ dateRead: '2026-11-15',
60
+ pricingCliff: null
61
+ },
62
+ 'claude-fable-5': {
63
+ id: 'claude-fable-5',
64
+ label: 'Claude Fable 5',
65
+ shortLabel: 'Fable 5',
66
+ family: 'fable',
67
+ generation: '5',
68
+ contextCeiling: 1000000,
69
+ operationalSoftCeiling: 180000,
70
+ ratesPer1M: { input: 10.0, output: 50.0, write5m: 12.5, write1h: 20.0, read: 1.0 },
71
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
72
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models) & Claude Code 2.1.325 bakedCatalog (tier_10_50)',
73
+ dateRead: '2026-11-15',
74
+ pricingCliff: null
75
+ },
76
+ 'claude-opus-5-5': {
77
+ id: 'claude-opus-5-5',
78
+ label: 'Claude Opus 5.5',
79
+ shortLabel: 'Opus 5.5',
80
+ family: 'opus',
81
+ generation: '5.5',
82
+ contextCeiling: 1000000,
83
+ operationalSoftCeiling: 180000,
84
+ ratesPer1M: { input: 4.0, output: 20.0, write5m: 5.0, write1h: 8.0, read: 0.2 },
85
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.05 },
86
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
87
+ dateRead: '2026-11-15',
88
+ pricingCliff: null
89
+ },
90
+ 'claude-sonnet-5-5': {
91
+ id: 'claude-sonnet-5-5',
92
+ label: 'Claude Sonnet 5.5',
93
+ shortLabel: 'Sonnet 5.5',
94
+ family: 'sonnet',
95
+ generation: '5.5',
96
+ contextCeiling: 1000000,
97
+ operationalSoftCeiling: 180000,
98
+ ratesPer1M: { input: 2.0, output: 10.0, write5m: 2.5, write1h: 4.0, read: 0.1 },
99
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.05 },
100
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
101
+ dateRead: '2026-11-15',
102
+ pricingCliff: null
103
+ },
104
+ 'claude-haiku-5-5': {
105
+ id: 'claude-haiku-5-5',
106
+ label: 'Claude Haiku 5.5',
107
+ shortLabel: 'Haiku 5.5',
108
+ family: 'haiku',
109
+ generation: '5.5',
110
+ contextCeiling: 1000000,
111
+ operationalSoftCeiling: 90000,
112
+ ratesPer1M: { input: 0.1, output: 0.5, write5m: 0.125, write1h: 0.2, read: 0.01 },
113
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
114
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models) & Claude Code 2.1.325 bakedCatalog (haiku_55)',
115
+ dateRead: '2026-11-15',
116
+ pricingCliff: {
117
+ thresholdTokens: 100000,
118
+ preCliffWarningTokens: 90000,
119
+ multiplier: 5.0,
120
+ ratesPer1MAboveCliff: {
121
+ input: 0.5,
122
+ output: 2.5,
123
+ write5m: 0.625,
124
+ write1h: 1.0,
125
+ read: 0.05
126
+ }
127
+ }
128
+ },
129
+ 'claude-opus-5': {
130
+ id: 'claude-opus-5',
131
+ label: 'Claude Opus 5',
132
+ shortLabel: 'Opus 5',
133
+ family: 'opus',
134
+ generation: '5',
135
+ contextCeiling: 1000000,
136
+ operationalSoftCeiling: 180000,
137
+ ratesPer1M: { input: 5.0, output: 25.0, write5m: 6.25, write1h: 10.0, read: 0.5 },
138
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
139
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
140
+ dateRead: '2026-11-15',
141
+ pricingCliff: null
142
+ },
143
+ 'claude-sonnet-5': {
144
+ id: 'claude-sonnet-5',
145
+ label: 'Claude Sonnet 5',
146
+ shortLabel: 'Sonnet 5',
147
+ family: 'sonnet',
148
+ generation: '5',
149
+ contextCeiling: 1000000,
150
+ operationalSoftCeiling: 180000,
151
+ ratesPer1M: { input: 2.0, output: 10.0, write5m: 2.5, write1h: 4.0, read: 0.2 },
152
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
153
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
154
+ dateRead: '2026-11-15',
155
+ pricingCliff: null
156
+ },
157
+ 'claude-opus-4-8': {
158
+ id: 'claude-opus-4-8',
159
+ label: 'Claude Opus 4.8',
160
+ shortLabel: 'Opus 4.8',
161
+ family: 'opus',
162
+ generation: '4.8',
163
+ contextCeiling: 1000000,
164
+ operationalSoftCeiling: 180000,
165
+ ratesPer1M: { input: 5.0, output: 25.0, write5m: 6.25, write1h: 10.0, read: 0.5 },
166
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
167
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
168
+ dateRead: '2026-11-15',
169
+ pricingCliff: null
170
+ },
171
+ 'claude-opus-4-7': {
172
+ id: 'claude-opus-4-7',
173
+ label: 'Claude Opus 4.7',
174
+ shortLabel: 'Opus 4.7',
175
+ family: 'opus',
176
+ generation: '4.7',
177
+ contextCeiling: 1000000,
178
+ operationalSoftCeiling: 180000,
179
+ ratesPer1M: { input: 5.0, output: 25.0, write5m: 6.25, write1h: 10.0, read: 0.5 },
180
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
181
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
182
+ dateRead: '2026-11-15',
183
+ pricingCliff: null
184
+ },
185
+ 'claude-opus-4-6': {
186
+ id: 'claude-opus-4-6',
187
+ label: 'Claude Opus 4.6',
188
+ shortLabel: 'Opus 4.6',
189
+ family: 'opus',
190
+ generation: '4.6',
191
+ contextCeiling: 200000,
192
+ operationalSoftCeiling: 160000,
193
+ ratesPer1M: { input: 5.0, output: 25.0, write5m: 6.25, write1h: 10.0, read: 0.5 },
194
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
195
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
196
+ dateRead: '2026-11-15',
197
+ pricingCliff: null
198
+ },
199
+ 'claude-opus-4-5': {
200
+ id: 'claude-opus-4-5',
201
+ label: 'Claude Opus 4.5',
202
+ shortLabel: 'Opus 4.5',
203
+ family: 'opus',
204
+ generation: '4.5',
205
+ contextCeiling: 200000,
206
+ operationalSoftCeiling: 160000,
207
+ ratesPer1M: { input: 5.0, output: 25.0, write5m: 6.25, write1h: 10.0, read: 0.5 },
208
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
209
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
210
+ dateRead: '2026-11-15',
211
+ pricingCliff: null
212
+ },
213
+ 'claude-opus-4-1': {
214
+ id: 'claude-opus-4-1',
215
+ label: 'Claude Opus 4.1',
216
+ shortLabel: 'Opus 4.1',
217
+ family: 'opus',
218
+ generation: '4.1',
219
+ contextCeiling: 200000,
220
+ operationalSoftCeiling: 160000,
221
+ ratesPer1M: { input: 15.0, output: 75.0, write5m: 18.75, write1h: 30.0, read: 1.5 },
222
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
223
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
224
+ dateRead: '2026-11-15',
225
+ pricingCliff: null
226
+ },
227
+ 'claude-opus-4-0': {
228
+ id: 'claude-opus-4-0',
229
+ label: 'Claude Opus 4',
230
+ shortLabel: 'Opus 4',
231
+ family: 'opus',
232
+ generation: '4.0',
233
+ contextCeiling: 200000,
234
+ operationalSoftCeiling: 160000,
235
+ ratesPer1M: { input: 15.0, output: 75.0, write5m: 18.75, write1h: 30.0, read: 1.5 },
236
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
237
+ source: 'Claude Code 2.1.325 bakedCatalog (tier_15_75) & OpenRouter /api/v1/models (anthropic/claude-opus-4)',
238
+ dateRead: '2026-11-15',
239
+ pricingCliff: null
240
+ },
241
+ 'claude-sonnet-4-6': {
242
+ id: 'claude-sonnet-4-6',
243
+ label: 'Claude Sonnet 4.6',
244
+ shortLabel: 'Sonnet 4.6',
245
+ family: 'sonnet',
246
+ generation: '4.6',
247
+ contextCeiling: 200000,
248
+ operationalSoftCeiling: 160000,
249
+ ratesPer1M: { input: 3.0, output: 15.0, write5m: 3.75, write1h: 6.0, read: 0.3 },
250
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
251
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
252
+ dateRead: '2026-11-15',
253
+ pricingCliff: null
254
+ },
255
+ 'claude-sonnet-4-5': {
256
+ id: 'claude-sonnet-4-5',
257
+ label: 'Claude Sonnet 4.5',
258
+ shortLabel: 'Sonnet 4.5',
259
+ family: 'sonnet',
260
+ generation: '4.5',
261
+ contextCeiling: 200000,
262
+ operationalSoftCeiling: 160000,
263
+ ratesPer1M: { input: 3.0, output: 15.0, write5m: 3.75, write1h: 6.0, read: 0.3 },
264
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
265
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
266
+ dateRead: '2026-11-15',
267
+ pricingCliff: null
268
+ },
269
+ 'claude-sonnet-4-0': {
270
+ id: 'claude-sonnet-4-0',
271
+ label: 'Claude Sonnet 4',
272
+ shortLabel: 'Sonnet 4',
273
+ family: 'sonnet',
274
+ generation: '4.0',
275
+ contextCeiling: 200000,
276
+ operationalSoftCeiling: 160000,
277
+ ratesPer1M: { input: 3.0, output: 15.0, write5m: 3.75, write1h: 6.0, read: 0.3 },
278
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
279
+ source: 'Claude Code 2.1.325 bakedCatalog (tier_3_15) & OpenRouter /api/v1/models (anthropic/claude-sonnet-4)',
280
+ dateRead: '2026-11-15',
281
+ pricingCliff: null
282
+ },
283
+ 'claude-haiku-4-5': {
284
+ id: 'claude-haiku-4-5',
285
+ label: 'Claude Haiku 4.5',
286
+ shortLabel: 'Haiku 4.5',
287
+ family: 'haiku',
288
+ generation: '4.5',
289
+ contextCeiling: 200000,
290
+ operationalSoftCeiling: 160000,
291
+ ratesPer1M: { input: 1.0, output: 5.0, write5m: 1.25, write1h: 2.0, read: 0.1 },
292
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
293
+ source: 'phase0_capabilities_and_cost_gate.md (OpenRouter /api/v1/models)',
294
+ dateRead: '2026-11-15',
295
+ pricingCliff: null
296
+ },
297
+ 'claude-3-7-sonnet': {
298
+ id: 'claude-3-7-sonnet',
299
+ label: 'Claude Sonnet 3.7',
300
+ shortLabel: 'Sonnet 3.7',
301
+ family: 'sonnet',
302
+ generation: '3.7',
303
+ contextCeiling: 200000,
304
+ operationalSoftCeiling: 160000,
305
+ ratesPer1M: { input: 3.0, output: 15.0, write5m: 3.75, write1h: 6.0, read: 0.3 },
306
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
307
+ source: 'Claude Code 2.1.325 bakedCatalog (tier_3_15) & OpenRouter /api/v1/models (anthropic/claude-3.7-sonnet)',
308
+ dateRead: '2026-11-15',
309
+ pricingCliff: null
310
+ },
311
+ 'claude-3-5-sonnet': {
312
+ id: 'claude-3-5-sonnet',
313
+ label: 'Claude Sonnet 3.5',
314
+ shortLabel: 'Sonnet 3.5',
315
+ family: 'sonnet',
316
+ generation: '3.5',
317
+ contextCeiling: 200000,
318
+ operationalSoftCeiling: 160000,
319
+ ratesPer1M: { input: 3.0, output: 15.0, write5m: 3.75, write1h: 6.0, read: 0.3 },
320
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
321
+ source: 'Claude Code 2.1.325 bakedCatalog (tier_3_15) & OpenRouter /api/v1/models',
322
+ dateRead: '2026-11-15',
323
+ pricingCliff: null
324
+ },
325
+ 'claude-3-5-haiku': {
326
+ id: 'claude-3-5-haiku',
327
+ label: 'Claude Haiku 3.5',
328
+ shortLabel: 'Haiku 3.5',
329
+ family: 'haiku',
330
+ generation: '3.5',
331
+ contextCeiling: 200000,
332
+ operationalSoftCeiling: 160000,
333
+ ratesPer1M: { input: 0.8, output: 4.0, write5m: 1.0, write1h: 1.6, read: 0.08 },
334
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
335
+ source: 'Claude Code 2.1.325 bakedCatalog (haiku_35) & OpenRouter /api/v1/models (anthropic/claude-3.5-haiku)',
336
+ dateRead: '2026-11-15',
337
+ pricingCliff: null
338
+ },
339
+ 'claude-mythos-5': {
340
+ id: 'claude-mythos-5',
341
+ label: 'Claude Mythos 5',
342
+ shortLabel: 'Mythos 5',
343
+ family: 'mythos',
344
+ generation: '5',
345
+ contextCeiling: 1000000,
346
+ operationalSoftCeiling: 180000,
347
+ ratesPer1M: { input: 10.0, output: 50.0, write5m: 12.5, write1h: 20.0, read: 1.0 },
348
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.1 },
349
+ source: 'Claude Code 2.1.325 bakedCatalog (tier_10_50; OpenRouter price unverified)',
350
+ dateRead: '2026-11-15',
351
+ pricingCliff: null
352
+ },
353
+ 'claude-mythos-5-1': {
354
+ id: 'claude-mythos-5-1',
355
+ label: 'Claude Mythos 5.1',
356
+ shortLabel: 'Mythos 5.1',
357
+ family: 'mythos',
358
+ generation: '5.1',
359
+ contextCeiling: 1000000,
360
+ operationalSoftCeiling: 180000,
361
+ ratesPer1M: { input: 10.0, output: 50.0, write5m: 12.5, write1h: 20.0, read: 0.25 },
362
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.025 },
363
+ source: 'Claude Code 2.1.325 bakedCatalog (tier_10_50_cache_read_0_25; OpenRouter price unverified)',
364
+ dateRead: '2026-11-15',
365
+ pricingCliff: null
366
+ },
367
+ 'claude-mythos-5-2': {
368
+ id: 'claude-mythos-5-2',
369
+ label: 'Claude Mythos 5.2',
370
+ shortLabel: 'Mythos 5.2',
371
+ family: 'mythos',
372
+ generation: '5.2',
373
+ contextCeiling: 1000000,
374
+ operationalSoftCeiling: 180000,
375
+ ratesPer1M: { input: 8.0, output: 40.0, write5m: 10.0, write1h: 16.0, read: 0.2 },
376
+ multipliers: { write5m: 1.25, write1h: 2.0, read: 0.025 },
377
+ source: 'Claude Code 2.1.325 bakedCatalog (tier_8_40_cache_read_0_20; OpenRouter price unverified)',
378
+ dateRead: '2026-11-15',
379
+ pricingCliff: null
380
+ }
381
+ }
382
+ };
383
+
384
+ /**
385
+ * Resolves the directory containing this module when Tier-2 Node I/O is active.
386
+ * @param {object} [options={}]
387
+ * @returns {string | null}
388
+ */
389
+ function getModuleDir(options = {}) {
390
+ if (!getNodeIo(options)) return null;
391
+ try {
392
+ const filePath = fileUrlToPathPure(import.meta.url, options);
393
+ return filePath ? path.dirname(filePath) : null;
394
+ } catch (_err) {
395
+ return null;
396
+ }
397
+ }
398
+
399
+ /**
400
+ * Detects whether a raw model identifier or options flag requests a 1,000,000-token
401
+ * extended context window (`[1m]`, `-1m`, `_1m`, or `options.extendedContext1M === true`).
402
+ *
403
+ * @param {string} [rawModelId='']
404
+ * @param {object} [options={}]
405
+ * @returns {boolean}
406
+ */
407
+ export function hasExtended1MHint(rawModelId = '', options = {}) {
408
+ if (options?.extendedContext1M === true) return true;
409
+ const raw = String(rawModelId || '').toLowerCase().trim();
410
+ return /\[1m\]|(?:^|[-_:\s])1m(?:$|[-_:\s\]])/.test(raw);
411
+ }
412
+
413
+ export const UNKNOWN_MODEL_ID = 'unknown';
414
+
415
+ /**
416
+ * Formats a concise, zero-USD advisory for models absent from the price catalog (Item 1.2).
417
+ *
418
+ * @param {string} [rawModelId='']
419
+ * @returns {string}
420
+ */
421
+ export function formatUnknownModelAdvisory(rawModelId = '') {
422
+ const displayId = String(rawModelId || '').trim() || UNKNOWN_MODEL_ID;
423
+ return `Prices for model "${displayId}" are unknown (not in price catalog); dollar figures and price-based holds are disabled.`;
424
+ }
425
+
426
+ const SHORT_MODEL_ALIASES = Object.freeze({
427
+ opus: 'claude-opus-5-5',
428
+ best: 'claude-opus-5-5',
429
+ opusplan: 'claude-opus-5-5',
430
+ sonnet: 'claude-sonnet-5-5',
431
+ haiku: 'claude-haiku-5-5',
432
+ fable: 'claude-fable-5-2',
433
+ mythos: 'claude-mythos-5-2',
434
+ 'claude-opus-4': 'claude-opus-4-0',
435
+ 'claude-sonnet-4': 'claude-sonnet-4-0',
436
+ 'claude-3-5-sonnet-v2': 'claude-3-5-sonnet'
437
+ });
438
+
439
+ /**
440
+ * Canonicalizes a raw model identifier syntax (provider prefixes, `[1m]`, dates, version dots)
441
+ * without guessing unknown model families or falling back to a default model.
442
+ *
443
+ * @param {string} [rawModelId='']
444
+ * @returns {string}
445
+ */
446
+ function canonicalizeModelToken(rawModelId = '') {
447
+ let s = String(rawModelId || '')
448
+ .toLowerCase()
449
+ .trim()
450
+ .replace(/\[[12]m\]/gi, '')
451
+ .replace(/[-_:\s]+1m$/g, '')
452
+ .replace(/\s*\((?:xhigh|extra[\s-]*high|high|medium|med|low|max|minimal|auto|fast|thinking|standard|extended[\s-]*thinking)(?:\s*[,/|]\s*(?:xhigh|extra[\s-]*high|high|medium|med|low|max|minimal|auto|fast|thinking|standard|extended[\s-]*thinking))*\)\s*$/gi, '')
453
+ .trim()
454
+ .replace(/\s+/g, '-');
455
+
456
+ if (!s) return '';
457
+
458
+ // Strip provider prefixes (e.g. openrouter/anthropic/, anthropic/, us.anthropic.)
459
+ const slashIdx = s.lastIndexOf('/');
460
+ if (slashIdx !== -1) {
461
+ const providerPart = s.slice(0, slashIdx);
462
+ const tail = s.slice(slashIdx + 1);
463
+ if (providerPart === 'anthropic' || providerPart.endsWith('/anthropic')) {
464
+ s = tail;
465
+ } else {
466
+ // Non-Anthropic provider prefix (e.g. google/gemini-2.5-pro, openai/gpt-5) stays intact
467
+ return s.replace(/\./g, '-');
468
+ }
469
+ }
470
+
471
+ const bedrockMatch = s.match(/^(?:[a-z-]+\.)?anthropic\.(claude-.*)$/);
472
+ if (bedrockMatch) {
473
+ s = bedrockMatch[1];
474
+ }
475
+
476
+ s = s.replace(/\./g, '-');
477
+ // Strip Bedrock version tag (-v1:0 / -v2), date trailer (-20251001 / @20251001), or tier/effort tag (:batch is NOT stripped as base rate)
478
+ s = s
479
+ .replace(/-v\d+(?::\d+)?$/i, '')
480
+ .replace(/[@-]\d{8}$/i, '')
481
+ .replace(/-(?:thinking|fast|latest|xhigh|extra-high|high|medium|med|low)$/i, '');
482
+
483
+ // Handle alternate ordering like claude-4-6-sonnet -> claude-sonnet-4-6 (4.x+ only; 3.x is claude-3-x-family)
484
+ const altOrder = s.match(/^claude-([4-9]\d*-\d+)-(opus|sonnet|haiku|fable|mythos)$/);
485
+ if (altOrder) {
486
+ s = `claude-${altOrder[2]}-${altOrder[1]}`;
487
+ }
488
+ const threeXOrder = s.match(/^claude-(haiku|sonnet)-(3-[57])$/);
489
+ if (threeXOrder) {
490
+ s = `claude-${threeXOrder[2]}-${threeXOrder[1]}`;
491
+ }
492
+
493
+ if (Object.prototype.hasOwnProperty.call(SHORT_MODEL_ALIASES, s)) {
494
+ return SHORT_MODEL_ALIASES[s];
495
+ }
496
+ if (/^(?:opus|sonnet|haiku|fable|mythos)-/.test(s) && !s.startsWith('claude-')) {
497
+ return `claude-${s}`;
498
+ }
499
+
500
+ return s;
501
+ }
502
+
503
+ /**
504
+ * Checks whether a raw model identifier resolves to a known Anthropic catalog model
505
+ * (or an explicit custom rate card in `customCeilings.json`), returning `false` for
506
+ * unrecognized model IDs (including uncatalogued Claude or third-party slugs).
507
+ *
508
+ * @param {string} [rawModelId='']
509
+ * @param {object} [options={}]
510
+ * @returns {boolean}
511
+ */
512
+ export function isKnownCatalogModel(rawModelId = '', options = {}) {
513
+ const raw = String(rawModelId || '').trim();
514
+ if (!raw || raw.toLowerCase() === UNKNOWN_MODEL_ID) return false;
515
+
516
+ const cleaned = canonicalizeModelToken(raw);
517
+ if (!cleaned) return false;
518
+
519
+ const catalog = options.catalog || loadModelCatalog(options);
520
+ if (catalog?.models && Object.prototype.hasOwnProperty.call(catalog.models, cleaned)) {
521
+ return true;
522
+ }
523
+
524
+ const customCeilings = options.customCeilings !== undefined ? options.customCeilings : loadCustomCeilings(options);
525
+ if (customCeilings && typeof customCeilings === 'object') {
526
+ const sourceMap =
527
+ customCeilings.models && typeof customCeilings.models === 'object'
528
+ ? customCeilings.models
529
+ : customCeilings.ceilings && typeof customCeilings.ceilings === 'object'
530
+ ? customCeilings.ceilings
531
+ : customCeilings;
532
+ for (const [key, val] of Object.entries(sourceMap)) {
533
+ if (
534
+ (key === raw || canonicalizeModelToken(key) === cleaned) &&
535
+ val &&
536
+ typeof val === 'object' &&
537
+ val.ratesPer1M &&
538
+ typeof val.ratesPer1M === 'object'
539
+ ) {
540
+ return true;
541
+ }
542
+ }
543
+ }
544
+
545
+ return false;
546
+ }
547
+
548
+ /**
549
+ * Normalizes a raw Anthropic model string or official Claude Code alias to its canonical catalog ID.
550
+ * Returns `BUILTIN_CATALOG.defaultModel` (`'claude-sonnet-5-5'`) only when `rawModelId` is empty/omitted;
551
+ * returns `'unknown'` (`UNKNOWN_MODEL_ID`) for any unrecognized non-empty model identifier.
552
+ *
553
+ * @param {string} [rawModelId='']
554
+ * @param {object} [options={}]
555
+ * @returns {string}
556
+ */
557
+ export function normalizeModelId(rawModelId = '', options = {}) {
558
+ const raw = String(rawModelId || '').trim();
559
+ if (!raw) return BUILTIN_CATALOG.defaultModel;
560
+
561
+ const cleaned = canonicalizeModelToken(raw);
562
+ if (!cleaned) return BUILTIN_CATALOG.defaultModel;
563
+
564
+ const catalog = options.catalog || BUILTIN_CATALOG;
565
+ if (catalog?.models && Object.prototype.hasOwnProperty.call(catalog.models, cleaned)) {
566
+ return cleaned;
567
+ }
568
+
569
+ if (options.customCeilings && isKnownCatalogModel(raw, options)) {
570
+ return cleaned;
571
+ }
572
+
573
+ return UNKNOWN_MODEL_ID;
574
+ }
575
+
576
+ /**
577
+ * Discovers and reads customCeilings.json from options or standard workspace/user paths.
578
+ * @param {object} [options={}]
579
+ * @returns {object | null}
580
+ */
581
+ export function loadCustomCeilings(options = {}) {
582
+ if (options.customCeilings && typeof options.customCeilings === 'object') {
583
+ return options.customCeilings;
584
+ }
585
+
586
+ if (!getNodeIo(options)) return null;
587
+
588
+ const candidatePaths = [];
589
+ if (typeof options.customCeilingsPath === 'string' && options.customCeilingsPath.trim()) {
590
+ candidatePaths.push(options.customCeilingsPath.trim());
591
+ }
592
+
593
+ const cwd = options.cwd || getCwd(options);
594
+ if (cwd && cwd !== '.') {
595
+ candidatePaths.push(path.join(cwd, '.claude', 'attention-horizon', 'customCeilings.json'));
596
+ candidatePaths.push(path.join(cwd, 'customCeilings.json'));
597
+ candidatePaths.push(path.join(cwd, '.claude', 'customCeilings.json'));
598
+ }
599
+
600
+ const modDir = getModuleDir(options);
601
+ if (modDir) {
602
+ candidatePaths.push(path.join(modDir, 'customCeilings.json'));
603
+ }
604
+
605
+ const homeDir = getHomeDir(options);
606
+ if (homeDir) {
607
+ candidatePaths.push(path.join(homeDir, '.claude', 'attention-horizon', 'customCeilings.json'));
608
+ candidatePaths.push(path.join(homeDir, '.claude', 'customCeilings.json'));
609
+ }
610
+
611
+ for (const candidate of candidatePaths) {
612
+ const parsed = readJsonSafe(candidate, null, options);
613
+ if (parsed && typeof parsed === 'object') {
614
+ return parsed;
615
+ }
616
+ }
617
+
618
+ return null;
619
+ }
620
+
621
+ /**
622
+ * Resolves an explicit user ceiling override (in tokens) for `modelId` from `customCeilings.json`
623
+ * or `options.customCeilings`, returning `null` when no custom ceiling override applies (`ISS-005`).
624
+ *
625
+ * @param {string} [modelId='']
626
+ * @param {object} [options={}]
627
+ * @returns {number | null}
628
+ */
629
+ export function resolveCustomCeilingForModel(modelId = '', options = {}) {
630
+ const customCeilings = loadCustomCeilings(options);
631
+ if (!customCeilings || typeof customCeilings !== 'object') {
632
+ return null;
633
+ }
634
+
635
+ const sourceMap =
636
+ customCeilings.models && typeof customCeilings.models === 'object'
637
+ ? customCeilings.models
638
+ : customCeilings.ceilings && typeof customCeilings.ceilings === 'object'
639
+ ? customCeilings.ceilings
640
+ : customCeilings;
641
+
642
+ const extractCeilingNumber = (val) => {
643
+ if (typeof val === 'number' && val > 0) return val;
644
+ if (val && typeof val === 'object') {
645
+ if (typeof val.contextCeiling === 'number' && val.contextCeiling > 0) {
646
+ return val.contextCeiling;
647
+ }
648
+ if (typeof val.ceiling === 'number' && val.ceiling > 0) {
649
+ return val.ceiling;
650
+ }
651
+ }
652
+ return null;
653
+ };
654
+
655
+ const normId = normalizeModelId(modelId, options);
656
+ const cleanedRaw = canonicalizeModelToken(modelId);
657
+ if (modelId && Object.prototype.hasOwnProperty.call(sourceMap, modelId)) {
658
+ const direct = extractCeilingNumber(sourceMap[modelId]);
659
+ if (direct !== null) return direct;
660
+ }
661
+
662
+ for (const [rawKey, overrideVal] of Object.entries(sourceMap)) {
663
+ if (rawKey === '*' || rawKey === 'schemaVersion') continue;
664
+ const keyMatched =
665
+ (cleanedRaw && (rawKey === cleanedRaw || canonicalizeModelToken(rawKey) === cleanedRaw)) ||
666
+ (normId !== UNKNOWN_MODEL_ID && (rawKey === normId || normalizeModelId(rawKey, options) === normId));
667
+ if (keyMatched) {
668
+ const matched = extractCeilingNumber(overrideVal);
669
+ if (matched !== null) return matched;
670
+ }
671
+ }
672
+
673
+ if (Object.prototype.hasOwnProperty.call(sourceMap, '*')) {
674
+ return extractCeilingNumber(sourceMap['*']);
675
+ }
676
+
677
+ return null;
678
+ }
679
+
680
+ /**
681
+ * Applies custom ceiling overrides to a cloned catalog object.
682
+ * @param {object} catalog
683
+ * @param {object | null} customCeilings
684
+ * @returns {object}
685
+ */
686
+ function applyCeilingOverrides(catalog, customCeilings) {
687
+ if (!customCeilings || typeof customCeilings !== 'object') {
688
+ return catalog;
689
+ }
690
+
691
+ const sourceMap =
692
+ customCeilings.models && typeof customCeilings.models === 'object'
693
+ ? customCeilings.models
694
+ : customCeilings.ceilings && typeof customCeilings.ceilings === 'object'
695
+ ? customCeilings.ceilings
696
+ : customCeilings;
697
+
698
+ // Global wildcard override if present
699
+ if (typeof sourceMap['*'] === 'number' && sourceMap['*'] > 0) {
700
+ for (const modelSpec of Object.values(catalog.models)) {
701
+ modelSpec.contextCeiling = sourceMap['*'];
702
+ }
703
+ } else if (sourceMap['*'] && typeof sourceMap['*'] === 'object') {
704
+ for (const modelSpec of Object.values(catalog.models)) {
705
+ if (typeof sourceMap['*'].contextCeiling === 'number') {
706
+ modelSpec.contextCeiling = sourceMap['*'].contextCeiling;
707
+ }
708
+ if (typeof sourceMap['*'].operationalSoftCeiling === 'number') {
709
+ modelSpec.operationalSoftCeiling = sourceMap['*'].operationalSoftCeiling;
710
+ }
711
+ }
712
+ }
713
+
714
+ for (const [rawKey, overrideVal] of Object.entries(sourceMap)) {
715
+ if (rawKey === '*' || rawKey === 'schemaVersion') continue;
716
+ const cleanedKey = canonicalizeModelToken(rawKey);
717
+ const normId = catalog.models[rawKey]
718
+ ? rawKey
719
+ : catalog.models[cleanedKey]
720
+ ? cleanedKey
721
+ : normalizeModelId(rawKey, { catalog });
722
+ let target = normId !== UNKNOWN_MODEL_ID ? catalog.models[normId] : null;
723
+ if (!target && overrideVal && typeof overrideVal === 'object' && overrideVal.ratesPer1M) {
724
+ const customId = cleanedKey || rawKey;
725
+ target = {
726
+ id: customId,
727
+ label: overrideVal.label || customId,
728
+ shortLabel: overrideVal.shortLabel || overrideVal.label || customId,
729
+ family: overrideVal.family || 'custom',
730
+ generation: overrideVal.generation || null,
731
+ contextCeiling: Number(overrideVal.contextCeiling || overrideVal.ceiling || 200000),
732
+ operationalSoftCeiling: Number(overrideVal.operationalSoftCeiling || 160000),
733
+ ratesPer1M: { ...overrideVal.ratesPer1M },
734
+ multipliers: overrideVal.multipliers || { write5m: 1.25, write1h: 2.0, read: 0.1 },
735
+ source: overrideVal.source || 'customCeilings.json',
736
+ dateRead: overrideVal.dateRead || null,
737
+ pricingCliff: overrideVal.pricingCliff || null
738
+ };
739
+ catalog.models[customId] = target;
740
+ continue;
741
+ }
742
+ if (!target) continue;
743
+
744
+ if (typeof overrideVal === 'number' && overrideVal > 0) {
745
+ target.contextCeiling = overrideVal;
746
+ } else if (overrideVal && typeof overrideVal === 'object') {
747
+ if (typeof overrideVal.contextCeiling === 'number' && overrideVal.contextCeiling > 0) {
748
+ target.contextCeiling = overrideVal.contextCeiling;
749
+ }
750
+ if (typeof overrideVal.ceiling === 'number' && overrideVal.ceiling > 0) {
751
+ target.contextCeiling = overrideVal.ceiling;
752
+ }
753
+ if (typeof overrideVal.operationalSoftCeiling === 'number' && overrideVal.operationalSoftCeiling > 0) {
754
+ target.operationalSoftCeiling = overrideVal.operationalSoftCeiling;
755
+ }
756
+ if (overrideVal.ratesPer1M && typeof overrideVal.ratesPer1M === 'object') {
757
+ target.ratesPer1M = { ...target.ratesPer1M, ...overrideVal.ratesPer1M };
758
+ }
759
+ }
760
+ }
761
+
762
+ return catalog;
763
+ }
764
+
765
+ /**
766
+ * Loads the unified Anthropic Model Catalog and merges any user `customCeilings.json` overrides.
767
+ * @param {object} [options={}]
768
+ * @returns {object}
769
+ */
770
+ export function loadModelCatalog(options = {}) {
771
+ let baseCatalog = BUILTIN_CATALOG;
772
+ const modDir = getModuleDir(options);
773
+ if (modDir) {
774
+ const jsonPath = path.join(modDir, 'anthropicModelCatalog.json');
775
+ const diskCatalog = readJsonSafe(jsonPath, null, options);
776
+ if (diskCatalog && diskCatalog.models) {
777
+ baseCatalog = diskCatalog;
778
+ }
779
+ }
780
+
781
+ const cloned = JSON.parse(JSON.stringify(baseCatalog));
782
+ const customCeilings = loadCustomCeilings(options);
783
+ return applyCeilingOverrides(cloned, customCeilings);
784
+ }
785
+
786
+ /**
787
+ * Retrieves the model specification for a given model ID.
788
+ * Empty/omitted `modelId` uses `catalog.defaultModel` (`claude-sonnet-5-5`).
789
+ * Any non-empty unrecognized model ID returns an explicit `{ id: 'unknown', unknownModel: true, ratesPer1M: null }`
790
+ * state rather than silently falling back to `claude-sonnet-5-5` (Item 1.2).
791
+ * Honors `[1m]` / `-1m` / `options.extendedContext1M` 1M context windows on Claude 4.x models (`ISS-002`).
792
+ *
793
+ * @param {string} [modelId='']
794
+ * @param {object} [options={}]
795
+ * @returns {object}
796
+ */
797
+ export function getModelSpec(modelId = '', options = {}) {
798
+ const catalog = options.catalog || loadModelCatalog(options);
799
+ const rawTrimmed = String(modelId || '').trim();
800
+ if (!rawTrimmed) {
801
+ const fallbackSpec =
802
+ catalog.models[catalog.defaultModel] || BUILTIN_CATALOG.models['claude-sonnet-5-5'];
803
+ if (
804
+ hasExtended1MHint(modelId, options) &&
805
+ resolveCustomCeilingForModel(fallbackSpec.id, options) === null &&
806
+ fallbackSpec.contextCeiling < 1000000
807
+ ) {
808
+ return {
809
+ ...fallbackSpec,
810
+ contextCeiling: 1000000,
811
+ operationalSoftCeiling: 800000,
812
+ unknownModel: false
813
+ };
814
+ }
815
+ return { ...fallbackSpec, unknownModel: false };
816
+ }
817
+
818
+ const cleaned = canonicalizeModelToken(rawTrimmed);
819
+ const normId = normalizeModelId(rawTrimmed, { ...options, catalog });
820
+ const directCustomSpec =
821
+ catalog.models[cleaned] ||
822
+ (normId !== UNKNOWN_MODEL_ID ? catalog.models[normId] : null);
823
+
824
+ if (!directCustomSpec || normId === UNKNOWN_MODEL_ID) {
825
+ const customCeiling = resolveCustomCeilingForModel(rawTrimmed, options);
826
+ const defaultCeiling = hasExtended1MHint(rawTrimmed, options) ? 1000000 : 200000;
827
+ const contextCeiling = Number(customCeiling || defaultCeiling);
828
+ return {
829
+ id: UNKNOWN_MODEL_ID,
830
+ rawModelId: rawTrimmed,
831
+ unknownModel: true,
832
+ label: `Unknown Model (${rawTrimmed})`,
833
+ shortLabel: 'Unknown Model',
834
+ family: 'unknown',
835
+ generation: null,
836
+ contextCeiling,
837
+ operationalSoftCeiling: Math.round(contextCeiling * 0.8),
838
+ ratesPer1M: null,
839
+ multipliers: null,
840
+ source: null,
841
+ dateRead: null,
842
+ pricingCliff: null,
843
+ advisory: formatUnknownModelAdvisory(rawTrimmed)
844
+ };
845
+ }
846
+
847
+ if (
848
+ (normId === 'claude-opus-4-6' ||
849
+ normId === 'claude-sonnet-4-6' ||
850
+ normId === 'claude-opus-4-5' ||
851
+ normId === 'claude-sonnet-4-5') &&
852
+ hasExtended1MHint(modelId, options) &&
853
+ resolveCustomCeilingForModel(modelId, options) === null
854
+ ) {
855
+ return {
856
+ ...directCustomSpec,
857
+ contextCeiling: 1000000,
858
+ operationalSoftCeiling: 800000,
859
+ unknownModel: false
860
+ };
861
+ }
862
+
863
+ return { ...directCustomSpec, unknownModel: false };
864
+ }
865
+
866
+ /**
867
+ * Extracts normalized prompt & output token counts across all flat, camelCase, snake_case,
868
+ * and nested Anthropic `cache_creation.ephemeral_*` usage formats without double-counting (`ISS-003`, `ISS-004`).
869
+ *
870
+ * @param {object} [usage={}]
871
+ * @returns {{
872
+ * uncachedInputTokens: number,
873
+ * cacheReadTokens: number,
874
+ * write5mTokens: number,
875
+ * write1hTokens: number,
876
+ * remainingGenericWriteTokens: number,
877
+ * effectiveWrite5mTokens: number,
878
+ * effectiveWrite1hTokens: number,
879
+ * totalCacheWriteTokens: number,
880
+ * outputTokens: number,
881
+ * thinkingTokens: number
882
+ * }}
883
+ */
884
+ export function extractNormalizedTokenBreakdown(usage = {}) {
885
+ if (!usage || typeof usage !== 'object') {
886
+ return {
887
+ uncachedInputTokens: 0,
888
+ cacheReadTokens: 0,
889
+ write5mTokens: 0,
890
+ write1hTokens: 0,
891
+ remainingGenericWriteTokens: 0,
892
+ effectiveWrite5mTokens: 0,
893
+ effectiveWrite1hTokens: 0,
894
+ totalCacheWriteTokens: 0,
895
+ outputTokens: 0,
896
+ thinkingTokens: 0
897
+ };
898
+ }
899
+
900
+ const uncachedInputTokens = Math.max(
901
+ 0,
902
+ Number(
903
+ usage.uncachedInputTokens ??
904
+ usage.freshInputTokens ??
905
+ usage.inputTokens ??
906
+ usage.input_tokens ??
907
+ 0
908
+ )
909
+ );
910
+ const cacheReadTokens = Math.max(
911
+ 0,
912
+ Number(
913
+ usage.cacheReadTokens ??
914
+ usage.cacheReadInputTokens ??
915
+ usage.cache_read_input_tokens ??
916
+ 0
917
+ )
918
+ );
919
+
920
+ const nestedCreation =
921
+ usage.cache_creation && typeof usage.cache_creation === 'object'
922
+ ? usage.cache_creation
923
+ : null;
924
+
925
+ const write5mTokens = Math.max(
926
+ 0,
927
+ Number(
928
+ usage.cacheWrite5mTokens ??
929
+ usage.cache_write_5m_tokens ??
930
+ nestedCreation?.ephemeral_5m_input_tokens ??
931
+ 0
932
+ )
933
+ );
934
+ const write1hTokens = Math.max(
935
+ 0,
936
+ Number(
937
+ usage.cacheWrite1hTokens ??
938
+ usage.cache_write_1h_tokens ??
939
+ nestedCreation?.ephemeral_1h_input_tokens ??
940
+ 0
941
+ )
942
+ );
943
+ const genericWriteTokens = Math.max(
944
+ 0,
945
+ Number(
946
+ usage.cacheWriteTokens ??
947
+ usage.cacheCreationInputTokens ??
948
+ usage.cache_creation_input_tokens ??
949
+ usage.lastWriteTokens ??
950
+ 0
951
+ )
952
+ );
953
+
954
+ const remainingGenericWriteTokens = Math.max(
955
+ 0,
956
+ genericWriteTokens - (write5mTokens + write1hTokens)
957
+ );
958
+
959
+ const defaultTier =
960
+ usage.cacheTtlTier === '1h' || usage.ttlTier === '1h' ? '1h' : '5m';
961
+ const effectiveWrite5mTokens =
962
+ write5mTokens + (defaultTier === '5m' ? remainingGenericWriteTokens : 0);
963
+ const effectiveWrite1hTokens =
964
+ write1hTokens + (defaultTier === '1h' ? remainingGenericWriteTokens : 0);
965
+ const totalCacheWriteTokens = effectiveWrite5mTokens + effectiveWrite1hTokens;
966
+
967
+ const outputTokens = Math.max(
968
+ 0,
969
+ Number(usage.outputTokens ?? usage.output_tokens ?? usage.lastOutputTokens ?? 0)
970
+ );
971
+ const thinkingTokens = Math.max(
972
+ 0,
973
+ Number(
974
+ usage.thinkingTokens ??
975
+ usage.thinking_tokens ??
976
+ usage.reasoning_tokens ??
977
+ nestedCreation?.thinking_tokens ??
978
+ usage.lastThinkingTokens ??
979
+ 0
980
+ )
981
+ );
982
+
983
+ return {
984
+ uncachedInputTokens,
985
+ cacheReadTokens,
986
+ write5mTokens,
987
+ write1hTokens,
988
+ remainingGenericWriteTokens,
989
+ effectiveWrite5mTokens,
990
+ effectiveWrite1hTokens,
991
+ totalCacheWriteTokens,
992
+ outputTokens,
993
+ thinkingTokens
994
+ };
995
+ }
996
+
997
+ /**
998
+ * Computes the exact single-turn total prompt token envelope
999
+ * (`uncachedInputTokens + cacheReadTokens + write5mTokens + write1hTokens + remainingGenericWriteTokens`),
1000
+ * honoring an optional explicit single-turn `usage.turnPromptTokens` override while never inflating
1001
+ * a single turn with multi-turn cumulative sums (`ISS-003`, `ISS-004`).
1002
+ *
1003
+ * @param {object} [usage={}]
1004
+ * @returns {number}
1005
+ */
1006
+ export function computeTotalPromptTokens(usage = {}) {
1007
+ if (!usage || typeof usage !== 'object') return 0;
1008
+
1009
+ if (usage.turnPromptTokens !== undefined && usage.turnPromptTokens !== null) {
1010
+ const breakdown = extractNormalizedTokenBreakdown(usage);
1011
+ const splitSum =
1012
+ breakdown.uncachedInputTokens +
1013
+ breakdown.cacheReadTokens +
1014
+ breakdown.totalCacheWriteTokens;
1015
+ return Math.max(splitSum, Math.max(0, Number(usage.turnPromptTokens)));
1016
+ }
1017
+
1018
+ const breakdown = extractNormalizedTokenBreakdown(usage);
1019
+ const hasExplicitCacheRead =
1020
+ usage.cacheReadTokens !== undefined ||
1021
+ usage.cacheReadInputTokens !== undefined ||
1022
+ usage.cache_read_input_tokens !== undefined;
1023
+ const unattributedCached = !hasExplicitCacheRead
1024
+ ? Math.max(
1025
+ 0,
1026
+ Number(usage.cachedTokens ?? usage.cached_tokens ?? 0) - breakdown.totalCacheWriteTokens
1027
+ )
1028
+ : 0;
1029
+
1030
+ const computedPromptTokens =
1031
+ breakdown.uncachedInputTokens +
1032
+ breakdown.cacheReadTokens +
1033
+ breakdown.totalCacheWriteTokens +
1034
+ unattributedCached;
1035
+
1036
+ const hasExplicitUncached =
1037
+ usage.uncachedInputTokens !== undefined ||
1038
+ usage.freshInputTokens !== undefined ||
1039
+ usage.inputTokens !== undefined ||
1040
+ usage.input_tokens !== undefined;
1041
+
1042
+ if (hasExplicitUncached && (hasExplicitCacheRead || breakdown.totalCacheWriteTokens > 0)) {
1043
+ return computedPromptTokens;
1044
+ }
1045
+
1046
+ const explicitSingleTurnTotal = Math.max(
1047
+ 0,
1048
+ Number(
1049
+ usage.totalPromptTokens ?? usage.totalInputTokens ?? usage.total_input_tokens ?? 0
1050
+ )
1051
+ );
1052
+
1053
+ return Math.max(computedPromptTokens, explicitSingleTurnTotal);
1054
+ }
1055
+
1056
+ /**
1057
+ * Resolves the effective USD per 1M token rate card for a model at a given prompt token volume.
1058
+ * Enforces the Claude Haiku 5.5 100,000-token 5x price cliff across all token categories.
1059
+ *
1060
+ * @param {string} [modelId='claude-sonnet-5-5']
1061
+ * @param {number} [totalPromptTokens=0]
1062
+ * @param {object} [options={}]
1063
+ * @returns {{
1064
+ * modelId: string,
1065
+ * label: string,
1066
+ * shortLabel: string,
1067
+ * family: string,
1068
+ * contextCeiling: number,
1069
+ * operationalSoftCeiling: number,
1070
+ * inputPer1M: number,
1071
+ * outputPer1M: number,
1072
+ * write5mPer1M: number,
1073
+ * write1hPer1M: number,
1074
+ * readPer1M: number,
1075
+ * multipliers: { write5m: number, write1h: number, read: number },
1076
+ * cliffTriggered: boolean,
1077
+ * preCliffWarningTriggered: boolean,
1078
+ * cliffThresholdTokens: number | null,
1079
+ * cliffMultiplier: number
1080
+ * }}
1081
+ */
1082
+ export function resolveEffectiveRates(modelId = 'claude-sonnet-5-5', totalPromptTokens = 0, options = {}) {
1083
+ const spec = getModelSpec(modelId, options);
1084
+ const promptTokens = Math.max(0, Number(totalPromptTokens || 0));
1085
+
1086
+ if (spec.unknownModel) {
1087
+ return {
1088
+ modelId: UNKNOWN_MODEL_ID,
1089
+ rawModelId: spec.rawModelId || String(modelId || '').trim(),
1090
+ unknownModel: true,
1091
+ label: spec.label,
1092
+ shortLabel: spec.shortLabel || 'Unknown Model',
1093
+ family: 'unknown',
1094
+ contextCeiling: spec.contextCeiling,
1095
+ operationalSoftCeiling: spec.operationalSoftCeiling,
1096
+ inputPer1M: null,
1097
+ outputPer1M: null,
1098
+ write5mPer1M: null,
1099
+ write1hPer1M: null,
1100
+ readPer1M: null,
1101
+ multipliers: null,
1102
+ source: null,
1103
+ dateRead: null,
1104
+ cliffTriggered: false,
1105
+ preCliffWarningTriggered: false,
1106
+ cliffThresholdTokens: null,
1107
+ cliffMultiplier: 1.0,
1108
+ advisory: spec.advisory || formatUnknownModelAdvisory(modelId)
1109
+ };
1110
+ }
1111
+
1112
+ const cliff = spec.pricingCliff || null;
1113
+ const cliffTriggered = Boolean(cliff && promptTokens > cliff.thresholdTokens);
1114
+ const preCliffWarningTriggered = Boolean(
1115
+ cliff && promptTokens >= (cliff.preCliffWarningTokens || cliff.thresholdTokens * 0.9)
1116
+ );
1117
+
1118
+ const activeRates = cliffTriggered && cliff.ratesPer1MAboveCliff
1119
+ ? cliff.ratesPer1MAboveCliff
1120
+ : spec.ratesPer1M;
1121
+
1122
+ return {
1123
+ modelId: spec.id,
1124
+ unknownModel: false,
1125
+ label: spec.label,
1126
+ shortLabel: spec.shortLabel || spec.label,
1127
+ family: spec.family,
1128
+ contextCeiling: spec.contextCeiling,
1129
+ operationalSoftCeiling: spec.operationalSoftCeiling,
1130
+ inputPer1M: activeRates.input,
1131
+ outputPer1M: activeRates.output,
1132
+ write5mPer1M: activeRates.write5m,
1133
+ write1hPer1M: activeRates.write1h,
1134
+ readPer1M: activeRates.read,
1135
+ multipliers: { ...spec.multipliers },
1136
+ source: spec.source || null,
1137
+ dateRead: spec.dateRead || null,
1138
+ cliffTriggered,
1139
+ preCliffWarningTriggered,
1140
+ cliffThresholdTokens: cliff ? cliff.thresholdTokens : null,
1141
+ cliffMultiplier: cliffTriggered ? cliff.multiplier : 1.0
1142
+ };
1143
+ }
1144
+
1145
+ /**
1146
+ * Computes exact USD turn cost and uncached equivalent baseline for a single turn.
1147
+ *
1148
+ * @param {object} [usage={}]
1149
+ * @param {string} [usage.model='claude-sonnet-5-5']
1150
+ * @param {number} [usage.inputTokens=0] - Uncached input tokens
1151
+ * @param {number} [usage.outputTokens=0] - Output tokens
1152
+ * @param {number} [usage.thinkingTokens=0] - Extended thinking tokens (billed at output rate)
1153
+ * @param {number} [usage.cacheWriteTokens=0] - Cache write tokens (uses cacheTtlTier if 5m/1h not split)
1154
+ * @param {number} [usage.cacheWrite5mTokens=0] - Explicit 5-minute cache write tokens
1155
+ * @param {number} [usage.cacheWrite1hTokens=0] - Explicit 1-hour cache write tokens
1156
+ * @param {number} [usage.cacheReadTokens=0] - Cache read tokens
1157
+ * @param {number} [usage.turnPromptTokens] - Optional explicit single-turn prompt size for cliff evaluation
1158
+ * @param {number} [usage.totalPromptTokens] - Optional explicit single-turn prompt size for cliff evaluation
1159
+ * @param {'5m'|'1h'} [usage.cacheTtlTier='5m'] - Default TTL tier when cacheWriteTokens is unsplit
1160
+ * @param {object} [options={}]
1161
+ */
1162
+ export function calculateTurnCostUSD(usage = {}, options = {}) {
1163
+ const breakdown = extractNormalizedTokenBreakdown(usage);
1164
+ const uncachedInput = breakdown.uncachedInputTokens;
1165
+ const outputTokens = breakdown.outputTokens;
1166
+ const thinkingTokens = breakdown.thinkingTokens;
1167
+ const cacheReadTokens = breakdown.cacheReadTokens;
1168
+ const write5mTokens = breakdown.effectiveWrite5mTokens;
1169
+ const write1hTokens = breakdown.effectiveWrite1hTokens;
1170
+ const totalCacheWriteTokens = breakdown.totalCacheWriteTokens;
1171
+ const totalPromptTokens = computeTotalPromptTokens(usage);
1172
+
1173
+ const rawModel = usage.model || usage.modelId || 'claude-sonnet-5-5';
1174
+ const rates = resolveEffectiveRates(rawModel, totalPromptTokens, options);
1175
+
1176
+ if (rates.unknownModel) {
1177
+ return {
1178
+ modelId: UNKNOWN_MODEL_ID,
1179
+ rawModelId: rates.rawModelId || String(rawModel),
1180
+ unknownModel: true,
1181
+ advisory: rates.advisory,
1182
+ rates,
1183
+ tokens: {
1184
+ uncachedInput,
1185
+ cacheWrite5m: write5mTokens,
1186
+ cacheWrite1h: write1hTokens,
1187
+ totalCacheWrite: totalCacheWriteTokens,
1188
+ cacheRead: cacheReadTokens,
1189
+ totalPrompt: totalPromptTokens,
1190
+ output: outputTokens,
1191
+ thinking: thinkingTokens,
1192
+ totalOutput: outputTokens + thinkingTokens
1193
+ },
1194
+ costsUSD: {
1195
+ uncachedInput: null,
1196
+ write5m: null,
1197
+ write1h: null,
1198
+ cacheRead: null,
1199
+ output: null,
1200
+ actualCacheSpendUSD: null,
1201
+ uncachedCacheEquivalentUSD: null,
1202
+ totalActualSpendUSD: null,
1203
+ totalUncachedEquivalentUSD: null,
1204
+ netCacheSavingsUSD: null
1205
+ },
1206
+ cliffTriggered: false,
1207
+ preCliffWarningTriggered: false
1208
+ };
1209
+ }
1210
+
1211
+ const inputCostUSD = (uncachedInput / 1_000_000) * rates.inputPer1M;
1212
+ const write5mCostUSD = (write5mTokens / 1_000_000) * rates.write5mPer1M;
1213
+ const write1hCostUSD = (write1hTokens / 1_000_000) * rates.write1hPer1M;
1214
+ const readCostUSD = (cacheReadTokens / 1_000_000) * rates.readPer1M;
1215
+ const outputCostUSD = ((outputTokens + thinkingTokens) / 1_000_000) * rates.outputPer1M;
1216
+
1217
+ const actualCacheSpendUSD = write5mCostUSD + write1hCostUSD + readCostUSD;
1218
+ const uncachedCacheEquivalentUSD = ((totalCacheWriteTokens + cacheReadTokens) / 1_000_000) * rates.inputPer1M;
1219
+
1220
+ const totalActualSpendUSD = inputCostUSD + actualCacheSpendUSD + outputCostUSD;
1221
+ const totalUncachedEquivalentUSD = inputCostUSD + uncachedCacheEquivalentUSD + outputCostUSD;
1222
+ const netCacheSavingsUSD = totalUncachedEquivalentUSD - totalActualSpendUSD;
1223
+
1224
+ return {
1225
+ modelId: rates.modelId,
1226
+ unknownModel: false,
1227
+ rates,
1228
+ tokens: {
1229
+ uncachedInput,
1230
+ cacheWrite5m: write5mTokens,
1231
+ cacheWrite1h: write1hTokens,
1232
+ totalCacheWrite: totalCacheWriteTokens,
1233
+ cacheRead: cacheReadTokens,
1234
+ totalPrompt: totalPromptTokens,
1235
+ output: outputTokens,
1236
+ thinking: thinkingTokens,
1237
+ totalOutput: outputTokens + thinkingTokens
1238
+ },
1239
+ costsUSD: {
1240
+ uncachedInput: Number(inputCostUSD.toFixed(6)),
1241
+ write5m: Number(write5mCostUSD.toFixed(6)),
1242
+ write1h: Number(write1hCostUSD.toFixed(6)),
1243
+ cacheRead: Number(readCostUSD.toFixed(6)),
1244
+ output: Number(outputCostUSD.toFixed(6)),
1245
+ actualCacheSpendUSD: Number(actualCacheSpendUSD.toFixed(6)),
1246
+ uncachedCacheEquivalentUSD: Number(uncachedCacheEquivalentUSD.toFixed(6)),
1247
+ totalActualSpendUSD: Number(totalActualSpendUSD.toFixed(6)),
1248
+ totalUncachedEquivalentUSD: Number(totalUncachedEquivalentUSD.toFixed(6)),
1249
+ netCacheSavingsUSD: Number(netCacheSavingsUSD.toFixed(6))
1250
+ },
1251
+ cliffTriggered: rates.cliffTriggered,
1252
+ preCliffWarningTriggered: rates.preCliffWarningTriggered
1253
+ };
1254
+ }
1255
+
1256
+ export default {
1257
+ BUILTIN_CATALOG,
1258
+ UNKNOWN_MODEL_ID,
1259
+ formatUnknownModelAdvisory,
1260
+ hasExtended1MHint,
1261
+ isKnownCatalogModel,
1262
+ normalizeModelId,
1263
+ loadCustomCeilings,
1264
+ resolveCustomCeilingForModel,
1265
+ loadModelCatalog,
1266
+ getModelSpec,
1267
+ extractNormalizedTokenBreakdown,
1268
+ computeTotalPromptTokens,
1269
+ resolveEffectiveRates,
1270
+ calculateTurnCostUSD
1271
+ };