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