xithead 1.5.0 → 1.5.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 (649) hide show
  1. package/design-system/README.md +80 -0
  2. package/package.json +20 -1
  3. package/public/apple-touch-icon.png +0 -0
  4. package/public/logo-transparent.png +0 -0
  5. package/public/xithead.ps1 +937 -0
  6. package/scripts/README.md +77 -0
  7. package/scripts/audit_wheel_glibc_symbols.py +217 -0
  8. package/scripts/build-master-design-system.cjs +33 -0
  9. package/scripts/build_rust_extension.sh +58 -0
  10. package/scripts/changelog-gen.py +203 -0
  11. package/scripts/eval_output_shaper.py +235 -0
  12. package/scripts/export_kompress_v2_onnx.py +267 -0
  13. package/scripts/fixtures/anthropic_replay_body.json +133 -0
  14. package/scripts/fixtures/codex_response_create_frame.json +52 -0
  15. package/scripts/install-git-hooks.sh +104 -0
  16. package/scripts/install.ps1 +1809 -0
  17. package/scripts/install.sh +1673 -0
  18. package/scripts/pr-governance.py +297 -0
  19. package/scripts/record_fixtures.py +59 -0
  20. package/scripts/refresh_model_limits.sh +48 -0
  21. package/scripts/replay_codex_ws_load.py +445 -0
  22. package/scripts/repro_codex_replay.py +699 -0
  23. package/scripts/smoke_issue_327.py +233 -0
  24. package/scripts/sync-plugin-versions.py +116 -0
  25. package/scripts/tests/test_changelog_gen.py +302 -0
  26. package/scripts/tests/test_pr_governance.py +163 -0
  27. package/scripts/tests/test_pr_health_labels.py +94 -0
  28. package/scripts/tests/test_pr_health_workflow.py +14 -0
  29. package/scripts/tests/test_sync_plugin_versions.py +131 -0
  30. package/scripts/tests/test_version_sync.py +291 -0
  31. package/scripts/validate-workflows.sh +39 -0
  32. package/scripts/verify-versions.py +106 -0
  33. package/scripts/version-sync.py +207 -0
  34. package/tailwind.config.js +31 -0
  35. package/tsconfig.json +84 -0
  36. package/.actrc +0 -14
  37. package/.actrc.local.example +0 -15
  38. package/.changelog.md +0 -2
  39. package/.claude/agents/academic-anthropologist.md +0 -125
  40. package/.claude/agents/academic-geographer.md +0 -127
  41. package/.claude/agents/academic-historian.md +0 -123
  42. package/.claude/agents/academic-narratologist.md +0 -118
  43. package/.claude/agents/academic-psychologist.md +0 -118
  44. package/.claude/agents/academic-statistician.md +0 -144
  45. package/.claude/agents/accounts-payable-agent.md +0 -205
  46. package/.claude/agents/agentic-identity-trust.md +0 -394
  47. package/.claude/agents/agents-orchestrator.md +0 -367
  48. package/.claude/agents/automation-governance-architect.md +0 -216
  49. package/.claude/agents/blender-addon-engineer.md +0 -243
  50. package/.claude/agents/business-strategist.md +0 -488
  51. package/.claude/agents/change-management-consultant.md +0 -497
  52. package/.claude/agents/chief-financial-officer.md +0 -388
  53. package/.claude/agents/corporate-training-designer.md +0 -192
  54. package/.claude/agents/customer-service.md +0 -398
  55. package/.claude/agents/customer-success-manager.md +0 -460
  56. package/.claude/agents/data-consolidation-agent.md +0 -60
  57. package/.claude/agents/data-privacy-officer.md +0 -412
  58. package/.claude/agents/design-brand-guardian.md +0 -322
  59. package/.claude/agents/design-image-prompt-engineer.md +0 -236
  60. package/.claude/agents/design-inclusive-visuals-specialist.md +0 -73
  61. package/.claude/agents/design-persona-walkthrough.md +0 -272
  62. package/.claude/agents/design-ui-designer.md +0 -386
  63. package/.claude/agents/design-ui-finish-gate-reviewer.md +0 -217
  64. package/.claude/agents/design-ux-architect.md +0 -482
  65. package/.claude/agents/design-ux-researcher.md +0 -329
  66. package/.claude/agents/design-visual-storyteller.md +0 -149
  67. package/.claude/agents/design-whimsy-injector.md +0 -460
  68. package/.claude/agents/economy-designer.md +0 -156
  69. package/.claude/agents/engineering-ai-data-remediation-engineer.md +0 -211
  70. package/.claude/agents/engineering-ai-engineer.md +0 -146
  71. package/.claude/agents/engineering-api-platform-engineer.md +0 -181
  72. package/.claude/agents/engineering-ats-validator-architect.md +0 -383
  73. package/.claude/agents/engineering-autonomous-optimization-architect.md +0 -121
  74. package/.claude/agents/engineering-backend-architect.md +0 -255
  75. package/.claude/agents/engineering-china-network-engineer.md +0 -252
  76. package/.claude/agents/engineering-cms-developer.md +0 -536
  77. package/.claude/agents/engineering-code-reviewer.md +0 -76
  78. package/.claude/agents/engineering-codebase-onboarding-engineer.md +0 -173
  79. package/.claude/agents/engineering-data-engineer.md +0 -349
  80. package/.claude/agents/engineering-data-visualization-engineer.md +0 -151
  81. package/.claude/agents/engineering-database-optimizer.md +0 -188
  82. package/.claude/agents/engineering-database-reliability-engineer.md +0 -201
  83. package/.claude/agents/engineering-desktop-app-engineer.md +0 -209
  84. package/.claude/agents/engineering-developer-tooling-engineer.md +0 -153
  85. package/.claude/agents/engineering-devops-automator.md +0 -385
  86. package/.claude/agents/engineering-drupal-performance.md +0 -347
  87. package/.claude/agents/engineering-drupal-shopping-cart.md +0 -360
  88. package/.claude/agents/engineering-electrical-engineer.md +0 -575
  89. package/.claude/agents/engineering-email-intelligence-engineer.md +0 -390
  90. package/.claude/agents/engineering-embedded-firmware-engineer.md +0 -196
  91. package/.claude/agents/engineering-feishu-integration-developer.md +0 -606
  92. package/.claude/agents/engineering-filament-optimization-specialist.md +0 -283
  93. package/.claude/agents/engineering-finops-engineer.md +0 -164
  94. package/.claude/agents/engineering-frontend-developer.md +0 -257
  95. package/.claude/agents/engineering-gaussdb-expert.md +0 -334
  96. package/.claude/agents/engineering-git-workflow-master.md +0 -98
  97. package/.claude/agents/engineering-i18n-engineer.md +0 -214
  98. package/.claude/agents/engineering-identity-access-engineer.md +0 -217
  99. package/.claude/agents/engineering-incident-response-commander.md +0 -444
  100. package/.claude/agents/engineering-iot-fleet-engineer.md +0 -148
  101. package/.claude/agents/engineering-it-service-manager.md +0 -561
  102. package/.claude/agents/engineering-knowledge-graph-engineer.md +0 -372
  103. package/.claude/agents/engineering-llm-post-training-engineer.md +0 -166
  104. package/.claude/agents/engineering-minimal-change-engineer.md +0 -207
  105. package/.claude/agents/engineering-mobile-app-builder.md +0 -493
  106. package/.claude/agents/engineering-mobile-release-engineer.md +0 -164
  107. package/.claude/agents/engineering-multi-agent-systems-architect.md +0 -600
  108. package/.claude/agents/engineering-network-engineer.md +0 -245
  109. package/.claude/agents/engineering-orgscript-engineer.md +0 -113
  110. package/.claude/agents/engineering-payments-billing-engineer.md +0 -228
  111. package/.claude/agents/engineering-pdf-engine-architect.md +0 -696
  112. package/.claude/agents/engineering-platform-engineer.md +0 -270
  113. package/.claude/agents/engineering-privacy-engineer.md +0 -152
  114. package/.claude/agents/engineering-prompt-engineer.md +0 -209
  115. package/.claude/agents/engineering-rag-pipeline-engineer.md +0 -450
  116. package/.claude/agents/engineering-rapid-prototyper.md +0 -466
  117. package/.claude/agents/engineering-realtime-collaboration-engineer.md +0 -200
  118. package/.claude/agents/engineering-rust-refactoring-specialist.md +0 -313
  119. package/.claude/agents/engineering-search-relevance-engineer.md +0 -237
  120. package/.claude/agents/engineering-section-508-specialist.md +0 -339
  121. package/.claude/agents/engineering-senior-developer.md +0 -176
  122. package/.claude/agents/engineering-servicenow-developer-mentor.md +0 -180
  123. package/.claude/agents/engineering-software-architect.md +0 -112
  124. package/.claude/agents/engineering-solidity-smart-contract-engineer.md +0 -522
  125. package/.claude/agents/engineering-sre.md +0 -90
  126. package/.claude/agents/engineering-technical-writer.md +0 -393
  127. package/.claude/agents/engineering-universal-document-compiler.md +0 -370
  128. package/.claude/agents/engineering-uswds-developer.md +0 -340
  129. package/.claude/agents/engineering-video-streaming-engineer.md +0 -151
  130. package/.claude/agents/engineering-voice-ai-integration-engineer.md +0 -584
  131. package/.claude/agents/engineering-webassembly-engineer.md +0 -153
  132. package/.claude/agents/engineering-wechat-mini-program-developer.md +0 -356
  133. package/.claude/agents/engineering-wordpress-performance.md +0 -346
  134. package/.claude/agents/engineering-wordpress-shopping-cart.md +0 -346
  135. package/.claude/agents/esg-sustainability-officer.md +0 -396
  136. package/.claude/agents/finance-bookkeeper-controller.md +0 -260
  137. package/.claude/agents/finance-financial-analyst.md +0 -234
  138. package/.claude/agents/finance-fpa-analyst.md +0 -263
  139. package/.claude/agents/finance-investment-researcher.md +0 -272
  140. package/.claude/agents/finance-tax-strategist.md +0 -239
  141. package/.claude/agents/game-audio-engineer.md +0 -264
  142. package/.claude/agents/game-designer.md +0 -167
  143. package/.claude/agents/gis-3d-scene-developer.md +0 -111
  144. package/.claude/agents/gis-analyst.md +0 -91
  145. package/.claude/agents/gis-bim-specialist.md +0 -108
  146. package/.claude/agents/gis-cartography-designer.md +0 -150
  147. package/.claude/agents/gis-drone-reality-mapping.md +0 -120
  148. package/.claude/agents/gis-geoai-ml-engineer.md +0 -105
  149. package/.claude/agents/gis-geoprocessing-specialist.md +0 -97
  150. package/.claude/agents/gis-qa-engineer.md +0 -133
  151. package/.claude/agents/gis-solution-engineer.md +0 -101
  152. package/.claude/agents/gis-spatial-data-engineer.md +0 -97
  153. package/.claude/agents/gis-spatial-data-scientist.md +0 -111
  154. package/.claude/agents/gis-technical-consultant.md +0 -86
  155. package/.claude/agents/gis-web-gis-developer.md +0 -108
  156. package/.claude/agents/godot-gameplay-scripter.md +0 -338
  157. package/.claude/agents/godot-multiplayer-engineer.md +0 -301
  158. package/.claude/agents/godot-shader-developer.md +0 -267
  159. package/.claude/agents/government-digital-presales-consultant.md +0 -363
  160. package/.claude/agents/grant-writer.md +0 -511
  161. package/.claude/agents/healthcare-aging-parent-care-companion.md +0 -414
  162. package/.claude/agents/healthcare-clinical-evidence-agent.md +0 -231
  163. package/.claude/agents/healthcare-customer-service.md +0 -389
  164. package/.claude/agents/healthcare-innovation-strategist.md +0 -433
  165. package/.claude/agents/healthcare-marketing-compliance.md +0 -395
  166. package/.claude/agents/healthcare-sovereign-health-systems-agent.md +0 -312
  167. package/.claude/agents/hospitality-guest-services.md +0 -603
  168. package/.claude/agents/hr-onboarding.md +0 -451
  169. package/.claude/agents/identity-graph-operator.md +0 -303
  170. package/.claude/agents/language-translator.md +0 -264
  171. package/.claude/agents/legal-billing-time-tracking.md +0 -569
  172. package/.claude/agents/legal-client-intake.md +0 -492
  173. package/.claude/agents/legal-document-review.md +0 -454
  174. package/.claude/agents/level-designer.md +0 -208
  175. package/.claude/agents/loan-officer-assistant.md +0 -555
  176. package/.claude/agents/lsp-index-engineer.md +0 -320
  177. package/.claude/agents/ma-integration-manager.md +0 -427
  178. package/.claude/agents/macos-spatial-metal-engineer.md +0 -337
  179. package/.claude/agents/marketing-aeo-foundations.md +0 -264
  180. package/.claude/agents/marketing-agentic-search-optimizer.md +0 -279
  181. package/.claude/agents/marketing-ai-citation-strategist.md +0 -172
  182. package/.claude/agents/marketing-app-store-optimizer.md +0 -321
  183. package/.claude/agents/marketing-baidu-seo-specialist.md +0 -226
  184. package/.claude/agents/marketing-bilibili-content-strategist.md +0 -199
  185. package/.claude/agents/marketing-book-co-author.md +0 -110
  186. package/.claude/agents/marketing-carousel-growth-engine.md +0 -204
  187. package/.claude/agents/marketing-china-ecommerce-operator.md +0 -283
  188. package/.claude/agents/marketing-china-market-localization-strategist.md +0 -283
  189. package/.claude/agents/marketing-content-creator.md +0 -54
  190. package/.claude/agents/marketing-cross-border-ecommerce.md +0 -259
  191. package/.claude/agents/marketing-developer-community-builder.md +0 -285
  192. package/.claude/agents/marketing-douyin-strategist.md +0 -149
  193. package/.claude/agents/marketing-email-strategist.md +0 -249
  194. package/.claude/agents/marketing-global-podcast-strategist.md +0 -206
  195. package/.claude/agents/marketing-growth-hacker.md +0 -54
  196. package/.claude/agents/marketing-instagram-curator.md +0 -113
  197. package/.claude/agents/marketing-kuaishou-strategist.md +0 -223
  198. package/.claude/agents/marketing-linkedin-content-creator.md +0 -214
  199. package/.claude/agents/marketing-livestream-commerce-coach.md +0 -305
  200. package/.claude/agents/marketing-multi-platform-publisher.md +0 -217
  201. package/.claude/agents/marketing-podcast-strategist.md +0 -277
  202. package/.claude/agents/marketing-pr-communications-manager.md +0 -473
  203. package/.claude/agents/marketing-private-domain-operator.md +0 -308
  204. package/.claude/agents/marketing-reddit-community-builder.md +0 -123
  205. package/.claude/agents/marketing-seo-specialist.md +0 -370
  206. package/.claude/agents/marketing-short-video-editing-coach.md +0 -412
  207. package/.claude/agents/marketing-social-media-strategist.md +0 -125
  208. package/.claude/agents/marketing-tiktok-strategist.md +0 -125
  209. package/.claude/agents/marketing-twitter-engager.md +0 -126
  210. package/.claude/agents/marketing-video-optimization-specialist.md +0 -119
  211. package/.claude/agents/marketing-wechat-official-account.md +0 -145
  212. package/.claude/agents/marketing-weibo-strategist.md +0 -240
  213. package/.claude/agents/marketing-x-twitter-intelligence-analyst.md +0 -161
  214. package/.claude/agents/marketing-xiaohongshu-specialist.md +0 -138
  215. package/.claude/agents/marketing-zhihu-strategist.md +0 -162
  216. package/.claude/agents/medical-billing-coding-specialist.md +0 -491
  217. package/.claude/agents/narrative-designer.md +0 -243
  218. package/.claude/agents/operations-manager.md +0 -399
  219. package/.claude/agents/organizational-psychologist.md +0 -391
  220. package/.claude/agents/paid-media-auditor.md +0 -71
  221. package/.claude/agents/paid-media-creative-strategist.md +0 -71
  222. package/.claude/agents/paid-media-paid-social-strategist.md +0 -71
  223. package/.claude/agents/paid-media-ppc-strategist.md +0 -71
  224. package/.claude/agents/paid-media-programmatic-buyer.md +0 -71
  225. package/.claude/agents/paid-media-search-query-analyst.md +0 -71
  226. package/.claude/agents/paid-media-tracking-specialist.md +0 -71
  227. package/.claude/agents/personal-growth-mentor.md +0 -159
  228. package/.claude/agents/product-behavioral-nudge-engine.md +0 -83
  229. package/.claude/agents/product-dx-engineer.md +0 -332
  230. package/.claude/agents/product-feedback-synthesizer.md +0 -119
  231. package/.claude/agents/product-manager.md +0 -469
  232. package/.claude/agents/product-sprint-prioritizer.md +0 -154
  233. package/.claude/agents/product-trend-researcher.md +0 -159
  234. package/.claude/agents/project-management-experiment-tracker.md +0 -198
  235. package/.claude/agents/project-management-jira-workflow-steward.md +0 -233
  236. package/.claude/agents/project-management-meeting-notes-specialist.md +0 -95
  237. package/.claude/agents/project-management-project-shepherd.md +0 -194
  238. package/.claude/agents/project-management-studio-operations.md +0 -200
  239. package/.claude/agents/project-management-studio-producer.md +0 -203
  240. package/.claude/agents/project-manager-senior.md +0 -135
  241. package/.claude/agents/real-estate-buyer-seller.md +0 -596
  242. package/.claude/agents/recruitment-specialist.md +0 -515
  243. package/.claude/agents/report-distribution-agent.md +0 -65
  244. package/.claude/agents/research-synthesist.md +0 -136
  245. package/.claude/agents/resume-tailor.md +0 -230
  246. package/.claude/agents/retail-customer-returns.md +0 -566
  247. package/.claude/agents/roblox-avatar-creator.md +0 -297
  248. package/.claude/agents/roblox-experience-designer.md +0 -306
  249. package/.claude/agents/roblox-systems-scripter.md +0 -332
  250. package/.claude/agents/sales-account-strategist.md +0 -227
  251. package/.claude/agents/sales-coach.md +0 -271
  252. package/.claude/agents/sales-data-extraction-agent.md +0 -67
  253. package/.claude/agents/sales-deal-strategist.md +0 -180
  254. package/.claude/agents/sales-discovery-coach.md +0 -225
  255. package/.claude/agents/sales-engineer.md +0 -182
  256. package/.claude/agents/sales-offer-lead-gen-strategist.md +0 -257
  257. package/.claude/agents/sales-outbound-strategist.md +0 -201
  258. package/.claude/agents/sales-outreach.md +0 -425
  259. package/.claude/agents/sales-pipeline-analyst.md +0 -267
  260. package/.claude/agents/sales-proposal-strategist.md +0 -217
  261. package/.claude/agents/security-ai-generated-code-auditor.md +0 -207
  262. package/.claude/agents/security-appsec-engineer.md +0 -536
  263. package/.claude/agents/security-architect.md +0 -307
  264. package/.claude/agents/security-blockchain-security-auditor.md +0 -482
  265. package/.claude/agents/security-cloud-security-architect.md +0 -576
  266. package/.claude/agents/security-compliance-auditor.md +0 -158
  267. package/.claude/agents/security-incident-responder.md +0 -450
  268. package/.claude/agents/security-penetration-tester.md +0 -399
  269. package/.claude/agents/security-secrets-credential-engineer.md +0 -189
  270. package/.claude/agents/security-senior-secops.md +0 -760
  271. package/.claude/agents/security-threat-detection-engineer.md +0 -553
  272. package/.claude/agents/security-threat-intelligence-analyst.md +0 -661
  273. package/.claude/agents/specialized-chief-of-staff.md +0 -279
  274. package/.claude/agents/specialized-civil-engineer.md +0 -356
  275. package/.claude/agents/specialized-codebase-archaeologist.md +0 -341
  276. package/.claude/agents/specialized-cultural-intelligence-strategist.md +0 -88
  277. package/.claude/agents/specialized-developer-advocate.md +0 -317
  278. package/.claude/agents/specialized-document-generator.md +0 -55
  279. package/.claude/agents/specialized-fedramp-rmf-compliance.md +0 -378
  280. package/.claude/agents/specialized-focus-music-architect.md +0 -175
  281. package/.claude/agents/specialized-french-consulting-market.md +0 -194
  282. package/.claude/agents/specialized-korean-business-navigator.md +0 -216
  283. package/.claude/agents/specialized-master-plan-architect.md +0 -157
  284. package/.claude/agents/specialized-mcp-builder.md +0 -260
  285. package/.claude/agents/specialized-model-qa.md +0 -528
  286. package/.claude/agents/specialized-pricing-analyst.md +0 -243
  287. package/.claude/agents/specialized-salesforce-architect.md +0 -182
  288. package/.claude/agents/specialized-strategy-duel-agent.md +0 -130
  289. package/.claude/agents/specialized-workflow-architect.md +0 -597
  290. package/.claude/agents/study-abroad-advisor.md +0 -282
  291. package/.claude/agents/supply-chain-strategist.md +0 -591
  292. package/.claude/agents/support-analytics-reporter.md +0 -387
  293. package/.claude/agents/support-executive-summary-generator.md +0 -212
  294. package/.claude/agents/support-finance-tracker.md +0 -480
  295. package/.claude/agents/support-infrastructure-maintainer.md +0 -628
  296. package/.claude/agents/support-legal-compliance-checker.md +0 -591
  297. package/.claude/agents/support-support-responder.md +0 -607
  298. package/.claude/agents/technical-artist.md +0 -233
  299. package/.claude/agents/terminal-integration-specialist.md +0 -70
  300. package/.claude/agents/testing-accessibility-auditor.md +0 -327
  301. package/.claude/agents/testing-api-tester.md +0 -334
  302. package/.claude/agents/testing-evidence-collector.md +0 -210
  303. package/.claude/agents/testing-performance-benchmarker.md +0 -283
  304. package/.claude/agents/testing-reality-checker.md +0 -249
  305. package/.claude/agents/testing-test-automation-engineer.md +0 -196
  306. package/.claude/agents/testing-test-results-analyzer.md +0 -330
  307. package/.claude/agents/testing-tool-evaluator.md +0 -416
  308. package/.claude/agents/testing-workflow-optimizer.md +0 -463
  309. package/.claude/agents/unity-architect.md +0 -271
  310. package/.claude/agents/unity-editor-tool-developer.md +0 -310
  311. package/.claude/agents/unity-multiplayer-engineer.md +0 -323
  312. package/.claude/agents/unity-shader-graph-artist.md +0 -269
  313. package/.claude/agents/unreal-multiplayer-architect.md +0 -364
  314. package/.claude/agents/unreal-systems-engineer.md +0 -322
  315. package/.claude/agents/unreal-technical-artist.md +0 -256
  316. package/.claude/agents/unreal-world-builder.md +0 -273
  317. package/.claude/agents/visionos-spatial-engineer.md +0 -54
  318. package/.claude/agents/xr-cockpit-interaction-specialist.md +0 -32
  319. package/.claude/agents/xr-immersive-developer.md +0 -32
  320. package/.claude/agents/xr-interface-architect.md +0 -32
  321. package/.claude/agents/zk-steward.md +0 -211
  322. package/.claude-plugin/marketplace.json +0 -30
  323. package/.commitlintrc.json +0 -26
  324. package/.devcontainer/Dockerfile +0 -24
  325. package/.devcontainer/devcontainer.json +0 -70
  326. package/.devcontainer/docker-compose.memory.yml +0 -42
  327. package/.devcontainer/memory-stack/devcontainer.json +0 -84
  328. package/.devcontainer/post-create.sh +0 -83
  329. package/.dockerignore +0 -23
  330. package/.env.act.example +0 -15
  331. package/.env.example +0 -171
  332. package/.eslintrc.json +0 -16
  333. package/.git-blame-ignore-revs +0 -10
  334. package/.gitattributes +0 -2
  335. package/.gitguardian.yaml +0 -50
  336. package/.githooks/pre-commit +0 -6
  337. package/.pre-commit-config.yaml +0 -30
  338. package/.release-please-config-xithead.json +0 -22
  339. package/.release-please-config.json +0 -44
  340. package/.release-please-manifest-xithead.json +0 -3
  341. package/.release-please-manifest.json +0 -3
  342. package/CODE_OF_CONDUCT.md +0 -133
  343. package/CONTRIBUTING.md +0 -133
  344. package/Cargo.lock +0 -5557
  345. package/Cargo.toml +0 -121
  346. package/Dockerfile +0 -38
  347. package/Dockerfile.proxy +0 -48
  348. package/ENTERPRISE.md +0 -5
  349. package/FEATURES_ADVANCED.md +0 -311
  350. package/Headroom-2.gif +0 -0
  351. package/HeadroomDemo-Fast.gif +0 -0
  352. package/MANIFEST.in +0 -4
  353. package/MODERNIZATION_GUIDE.md +0 -358
  354. package/Makefile +0 -140
  355. package/NOTICE +0 -43
  356. package/NPM_TOKEN_SETUP.md +0 -81
  357. package/PR.md +0 -170
  358. package/PUBLISH.md +0 -77
  359. package/README_FRONTEND.md +0 -196
  360. package/REALIGNMENT/00-overview.md +0 -53
  361. package/REALIGNMENT/01-bug-list.md +0 -421
  362. package/REALIGNMENT/02-architecture.md +0 -322
  363. package/REALIGNMENT/03-phase-A-lockdown.md +0 -420
  364. package/REALIGNMENT/04-phase-B-live-zone.md +0 -470
  365. package/REALIGNMENT/05-phase-C-rust-proxy.md +0 -329
  366. package/REALIGNMENT/06-phase-D-bedrock-vertex.md +0 -222
  367. package/REALIGNMENT/07-phase-E-cache-stabilization.md +0 -338
  368. package/REALIGNMENT/08-phase-F-auth-mode.md +0 -254
  369. package/REALIGNMENT/09-phase-G-rtk-observability.md +0 -194
  370. package/REALIGNMENT/10-phase-H-python-retirement.md +0 -214
  371. package/REALIGNMENT/11-phase-I-test-infra.md +0 -385
  372. package/REALIGNMENT/12-decisions-needed.md +0 -196
  373. package/REALIGNMENT/INDEX.md +0 -82
  374. package/REFACTORING_CAMPAIGN.md +0 -277
  375. package/RESTRUCTURE_PLAN.md +0 -100
  376. package/RUST_DEV.md +0 -361
  377. package/SECURITY.md +0 -65
  378. package/SETUP_AUTO_PUBLISH.md +0 -164
  379. package/TESTING-copilot-subscription.md +0 -153
  380. package/codecov.yml +0 -34
  381. package/crates/headroom-core/Cargo.toml +0 -165
  382. package/crates/headroom-core/benches/auth_mode.rs +0 -74
  383. package/crates/headroom-core/benches/ccr_store.rs +0 -224
  384. package/crates/headroom-core/benches/tokenizer.rs +0 -52
  385. package/crates/headroom-core/config/pipeline.toml +0 -151
  386. package/crates/headroom-core/proptest-regressions/transforms/tag_protector.txt +0 -9
  387. package/crates/headroom-core/src/auth_mode.rs +0 -250
  388. package/crates/headroom-core/src/cache_control.rs +0 -414
  389. package/crates/headroom-core/src/ccr/backends/in_memory.rs +0 -317
  390. package/crates/headroom-core/src/ccr/backends/mod.rs +0 -152
  391. package/crates/headroom-core/src/ccr/backends/redis.rs +0 -146
  392. package/crates/headroom-core/src/ccr/backends/sqlite.rs +0 -205
  393. package/crates/headroom-core/src/ccr/mod.rs +0 -119
  394. package/crates/headroom-core/src/compression_policy.rs +0 -505
  395. package/crates/headroom-core/src/lib.rs +0 -33
  396. package/crates/headroom-core/src/relevance/base.rs +0 -139
  397. package/crates/headroom-core/src/relevance/bm25.rs +0 -385
  398. package/crates/headroom-core/src/relevance/embedding.rs +0 -354
  399. package/crates/headroom-core/src/relevance/hybrid.rs +0 -364
  400. package/crates/headroom-core/src/relevance/mod.rs +0 -64
  401. package/crates/headroom-core/src/signals/keyword_detector.rs +0 -433
  402. package/crates/headroom-core/src/signals/line_importance.rs +0 -84
  403. package/crates/headroom-core/src/signals/mod.rs +0 -61
  404. package/crates/headroom-core/src/signals/tiered.rs +0 -141
  405. package/crates/headroom-core/src/tokenizer/estimator.rs +0 -152
  406. package/crates/headroom-core/src/tokenizer/hf_impl.rs +0 -314
  407. package/crates/headroom-core/src/tokenizer/mod.rs +0 -56
  408. package/crates/headroom-core/src/tokenizer/registry.rs +0 -342
  409. package/crates/headroom-core/src/tokenizer/tiktoken_impl.rs +0 -265
  410. package/crates/headroom-core/src/transforms/adaptive_sizer.rs +0 -610
  411. package/crates/headroom-core/src/transforms/anchor_selector.rs +0 -1189
  412. package/crates/headroom-core/src/transforms/content_detector.rs +0 -769
  413. package/crates/headroom-core/src/transforms/detection.rs +0 -222
  414. package/crates/headroom-core/src/transforms/diff_compressor.rs +0 -1685
  415. package/crates/headroom-core/src/transforms/live_zone.rs +0 -2967
  416. package/crates/headroom-core/src/transforms/log_compressor.rs +0 -1295
  417. package/crates/headroom-core/src/transforms/magika_detector.rs +0 -395
  418. package/crates/headroom-core/src/transforms/mod.rs +0 -64
  419. package/crates/headroom-core/src/transforms/pipeline/config.rs +0 -331
  420. package/crates/headroom-core/src/transforms/pipeline/mod.rs +0 -103
  421. package/crates/headroom-core/src/transforms/pipeline/offloads/diff_noise.rs +0 -524
  422. package/crates/headroom-core/src/transforms/pipeline/offloads/diff_offload.rs +0 -279
  423. package/crates/headroom-core/src/transforms/pipeline/offloads/json_offload.rs +0 -400
  424. package/crates/headroom-core/src/transforms/pipeline/offloads/log_offload.rs +0 -284
  425. package/crates/headroom-core/src/transforms/pipeline/offloads/mod.rs +0 -34
  426. package/crates/headroom-core/src/transforms/pipeline/offloads/search_offload.rs +0 -331
  427. package/crates/headroom-core/src/transforms/pipeline/orchestrator.rs +0 -848
  428. package/crates/headroom-core/src/transforms/pipeline/reformats/json_minifier.rs +0 -175
  429. package/crates/headroom-core/src/transforms/pipeline/reformats/log_template.rs +0 -545
  430. package/crates/headroom-core/src/transforms/pipeline/reformats/mod.rs +0 -12
  431. package/crates/headroom-core/src/transforms/pipeline/traits.rs +0 -338
  432. package/crates/headroom-core/src/transforms/recommendations.rs +0 -329
  433. package/crates/headroom-core/src/transforms/safety.rs +0 -215
  434. package/crates/headroom-core/src/transforms/search_compressor.rs +0 -902
  435. package/crates/headroom-core/src/transforms/smart_crusher/analyzer.rs +0 -1262
  436. package/crates/headroom-core/src/transforms/smart_crusher/anchors.rs +0 -407
  437. package/crates/headroom-core/src/transforms/smart_crusher/builder.rs +0 -263
  438. package/crates/headroom-core/src/transforms/smart_crusher/classifier.rs +0 -214
  439. package/crates/headroom-core/src/transforms/smart_crusher/compaction/classifier.rs +0 -283
  440. package/crates/headroom-core/src/transforms/smart_crusher/compaction/compactor.rs +0 -733
  441. package/crates/headroom-core/src/transforms/smart_crusher/compaction/formatter.rs +0 -961
  442. package/crates/headroom-core/src/transforms/smart_crusher/compaction/ir.rs +0 -252
  443. package/crates/headroom-core/src/transforms/smart_crusher/compaction/mod.rs +0 -127
  444. package/crates/headroom-core/src/transforms/smart_crusher/compaction/walker.rs +0 -397
  445. package/crates/headroom-core/src/transforms/smart_crusher/config.rs +0 -173
  446. package/crates/headroom-core/src/transforms/smart_crusher/constraints.rs +0 -159
  447. package/crates/headroom-core/src/transforms/smart_crusher/crusher.rs +0 -1665
  448. package/crates/headroom-core/src/transforms/smart_crusher/crushers.rs +0 -865
  449. package/crates/headroom-core/src/transforms/smart_crusher/error_keywords.rs +0 -77
  450. package/crates/headroom-core/src/transforms/smart_crusher/field_detect.rs +0 -393
  451. package/crates/headroom-core/src/transforms/smart_crusher/hashing.rs +0 -72
  452. package/crates/headroom-core/src/transforms/smart_crusher/mod.rs +0 -81
  453. package/crates/headroom-core/src/transforms/smart_crusher/observer.rs +0 -66
  454. package/crates/headroom-core/src/transforms/smart_crusher/orchestration.rs +0 -459
  455. package/crates/headroom-core/src/transforms/smart_crusher/outliers.rs +0 -507
  456. package/crates/headroom-core/src/transforms/smart_crusher/planning.rs +0 -904
  457. package/crates/headroom-core/src/transforms/smart_crusher/statistics.rs +0 -510
  458. package/crates/headroom-core/src/transforms/smart_crusher/stats_math.rs +0 -287
  459. package/crates/headroom-core/src/transforms/smart_crusher/traits.rs +0 -203
  460. package/crates/headroom-core/src/transforms/smart_crusher/types.rs +0 -263
  461. package/crates/headroom-core/src/transforms/tag_protector.rs +0 -1272
  462. package/crates/headroom-core/src/transforms/unidiff_detector.rs +0 -232
  463. package/crates/headroom-parity/Cargo.toml +0 -26
  464. package/crates/headroom-parity/examples/diff_fixture.rs +0 -66
  465. package/crates/headroom-parity/src/bin/parity_run.rs +0 -78
  466. package/crates/headroom-parity/src/lib.rs +0 -613
  467. package/crates/headroom-proxy/Cargo.toml +0 -119
  468. package/crates/headroom-proxy/data/model_prices_and_context_window.json +0 -39767
  469. package/crates/headroom-proxy/src/bedrock/auth_mode_layer.rs +0 -192
  470. package/crates/headroom-proxy/src/bedrock/envelope.rs +0 -239
  471. package/crates/headroom-proxy/src/bedrock/eventstream.rs +0 -769
  472. package/crates/headroom-proxy/src/bedrock/eventstream_to_sse.rs +0 -459
  473. package/crates/headroom-proxy/src/bedrock/invoke.rs +0 -735
  474. package/crates/headroom-proxy/src/bedrock/invoke_streaming.rs +0 -1098
  475. package/crates/headroom-proxy/src/bedrock/mod.rs +0 -66
  476. package/crates/headroom-proxy/src/bedrock/sigv4.rs +0 -324
  477. package/crates/headroom-proxy/src/bedrock/vendor.rs +0 -82
  478. package/crates/headroom-proxy/src/cache_stabilization/anthropic_cache_control.rs +0 -698
  479. package/crates/headroom-proxy/src/cache_stabilization/drift_detector.rs +0 -683
  480. package/crates/headroom-proxy/src/cache_stabilization/mod.rs +0 -61
  481. package/crates/headroom-proxy/src/cache_stabilization/openai_cache_key.rs +0 -600
  482. package/crates/headroom-proxy/src/cache_stabilization/tool_def_normalize.rs +0 -514
  483. package/crates/headroom-proxy/src/cache_stabilization/volatile_detector.rs +0 -720
  484. package/crates/headroom-proxy/src/compression/anthropic.rs +0 -92
  485. package/crates/headroom-proxy/src/compression/live_zone_anthropic.rs +0 -1311
  486. package/crates/headroom-proxy/src/compression/live_zone_openai.rs +0 -660
  487. package/crates/headroom-proxy/src/compression/live_zone_responses.rs +0 -678
  488. package/crates/headroom-proxy/src/compression/mod.rs +0 -127
  489. package/crates/headroom-proxy/src/compression/model_limits.rs +0 -211
  490. package/crates/headroom-proxy/src/config.rs +0 -646
  491. package/crates/headroom-proxy/src/error.rs +0 -69
  492. package/crates/headroom-proxy/src/handlers/chat_completions.rs +0 -100
  493. package/crates/headroom-proxy/src/handlers/conversations.rs +0 -241
  494. package/crates/headroom-proxy/src/handlers/mod.rs +0 -13
  495. package/crates/headroom-proxy/src/handlers/responses.rs +0 -256
  496. package/crates/headroom-proxy/src/headers.rs +0 -288
  497. package/crates/headroom-proxy/src/health.rs +0 -41
  498. package/crates/headroom-proxy/src/lib.rs +0 -21
  499. package/crates/headroom-proxy/src/main.rs +0 -141
  500. package/crates/headroom-proxy/src/observability/cache_hit_rate.rs +0 -340
  501. package/crates/headroom-proxy/src/observability/compression_ratio.rs +0 -158
  502. package/crates/headroom-proxy/src/observability/metric_names.rs +0 -174
  503. package/crates/headroom-proxy/src/observability/mod.rs +0 -68
  504. package/crates/headroom-proxy/src/observability/prometheus.rs +0 -394
  505. package/crates/headroom-proxy/src/observability/proxy_metrics.rs +0 -368
  506. package/crates/headroom-proxy/src/proxy.rs +0 -1619
  507. package/crates/headroom-proxy/src/responses_items.rs +0 -565
  508. package/crates/headroom-proxy/src/sse/anthropic.rs +0 -415
  509. package/crates/headroom-proxy/src/sse/framing.rs +0 -366
  510. package/crates/headroom-proxy/src/sse/mod.rs +0 -40
  511. package/crates/headroom-proxy/src/sse/openai_chat.rs +0 -231
  512. package/crates/headroom-proxy/src/sse/openai_responses.rs +0 -458
  513. package/crates/headroom-proxy/src/vertex/adc.rs +0 -315
  514. package/crates/headroom-proxy/src/vertex/envelope.rs +0 -167
  515. package/crates/headroom-proxy/src/vertex/mod.rs +0 -277
  516. package/crates/headroom-proxy/src/vertex/raw_predict.rs +0 -490
  517. package/crates/headroom-proxy/src/vertex/stream_raw_predict.rs +0 -49
  518. package/crates/headroom-proxy/src/websocket.rs +0 -246
  519. package/crates/headroom-py/Cargo.toml +0 -37
  520. package/crates/headroom-py/build.rs +0 -77
  521. package/crates/headroom-py/glibc_compat.c +0 -170
  522. package/crates/headroom-py/src/lib.rs +0 -1655
  523. package/deny.toml +0 -32
  524. package/docker/differential-network-capture/Dockerfile.runner +0 -14
  525. package/docker/differential-network-capture/docker-compose.yml +0 -142
  526. package/docker/differential-network-capture/run-claude-lane.sh +0 -24
  527. package/docker/docker-compose.native.yml +0 -44
  528. package/docker-bake.hcl +0 -88
  529. package/docker-compose.yml +0 -80
  530. package/e2e/_lib/make_shim.ps1 +0 -24
  531. package/e2e/_lib/make_shim.sh +0 -28
  532. package/e2e/docker-native-install.sh +0 -120
  533. package/e2e/init/Dockerfile +0 -79
  534. package/e2e/wrap/Dockerfile +0 -115
  535. package/examples/07-context-compression.ipynb +0 -279
  536. package/examples/deployment/macos-launchagent/com.headroom.proxy.plist.template +0 -65
  537. package/examples/deployment/macos-launchagent/install.sh +0 -227
  538. package/examples/deployment/macos-launchagent/shell-integration.sh +0 -74
  539. package/examples/deployment/macos-launchagent/uninstall.sh +0 -145
  540. package/headroom-savings.png +0 -0
  541. package/headroom_learn.gif +0 -0
  542. package/llms.txt +0 -67
  543. package/mkdocs.yml +0 -136
  544. package/npm/bin/xithead.js +0 -366
  545. package/npm/bin/xtream-head.js +0 -366
  546. package/npm/index.d.ts +0 -57
  547. package/npm/index.js +0 -139
  548. package/npm/package.json +0 -55
  549. package/npm/postinstall.js +0 -43
  550. package/plugins/headroom-agent-hooks/.claude-plugin/plugin.json +0 -17
  551. package/plugins/headroom-agent-hooks/hooks/hooks.json +0 -29
  552. package/plugins/headroom-oauth2/LICENSE +0 -3
  553. package/plugins/headroom-oauth2/SPEC.md +0 -115
  554. package/plugins/headroom-oauth2/pyproject.toml +0 -48
  555. package/plugins/hermes/headroom_retrieve/plugin.yaml +0 -6
  556. package/plugins/openclaw/hook-shim/HOOK.md +0 -21
  557. package/plugins/openclaw/hook-shim/handler.js +0 -3
  558. package/plugins/openclaw/openclaw.plugin.json +0 -98
  559. package/plugins/openclaw/package-lock.json +0 -2692
  560. package/plugins/openclaw/package.json +0 -54
  561. package/plugins/openclaw/prepare-dist.mjs +0 -56
  562. package/plugins/openclaw/src/convert.ts +0 -418
  563. package/plugins/openclaw/src/engine.ts +0 -284
  564. package/plugins/openclaw/src/gateway-config.ts +0 -143
  565. package/plugins/openclaw/src/index.ts +0 -11
  566. package/plugins/openclaw/src/plugin/index.ts +0 -98
  567. package/plugins/openclaw/src/proxy-manager.ts +0 -477
  568. package/plugins/openclaw/src/tools/headroom-retrieve.ts +0 -76
  569. package/plugins/openclaw/test/convert.test.ts +0 -96
  570. package/plugins/openclaw/test/engine-normalization.test.ts +0 -21
  571. package/plugins/openclaw/test/engine.test.ts +0 -101
  572. package/plugins/openclaw/test/gateway-config.test.ts +0 -278
  573. package/plugins/openclaw/test/plugin-runtime-routing.test.ts +0 -141
  574. package/plugins/openclaw/test/proxy-manager.test.ts +0 -343
  575. package/plugins/openclaw/tsup.config.ts +0 -9
  576. package/pyproject.toml +0 -438
  577. package/rust-toolchain.toml +0 -16
  578. package/sdk/typescript/examples/basic-compress.ts +0 -64
  579. package/sdk/typescript/examples/ccr-retrieve.ts +0 -80
  580. package/sdk/typescript/examples/hooks-custom-compression.ts +0 -117
  581. package/sdk/typescript/examples/middleware-composition.ts +0 -59
  582. package/sdk/typescript/examples/multi-provider.ts +0 -53
  583. package/sdk/typescript/examples/openai-anthropic-adapters.ts +0 -73
  584. package/sdk/typescript/examples/shared-context-multi-agent.ts +0 -74
  585. package/sdk/typescript/examples/simulation-dry-run.ts +0 -80
  586. package/sdk/typescript/examples/streaming-chat.ts +0 -71
  587. package/sdk/typescript/examples/structured-output.ts +0 -99
  588. package/sdk/typescript/examples/tool-calling-agent.ts +0 -86
  589. package/sdk/typescript/examples/with-headroom-vercel.ts +0 -57
  590. package/sdk/typescript/package-lock.json +0 -3437
  591. package/sdk/typescript/package.json +0 -108
  592. package/sdk/typescript/src/adapters/anthropic.ts +0 -218
  593. package/sdk/typescript/src/adapters/gemini.ts +0 -83
  594. package/sdk/typescript/src/adapters/openai.ts +0 -77
  595. package/sdk/typescript/src/adapters/vercel-ai.ts +0 -131
  596. package/sdk/typescript/src/client.ts +0 -632
  597. package/sdk/typescript/src/compress.ts +0 -87
  598. package/sdk/typescript/src/errors.ts +0 -114
  599. package/sdk/typescript/src/hooks.ts +0 -113
  600. package/sdk/typescript/src/index.ts +0 -140
  601. package/sdk/typescript/src/paths.ts +0 -272
  602. package/sdk/typescript/src/shared-context.ts +0 -188
  603. package/sdk/typescript/src/simulate.ts +0 -52
  604. package/sdk/typescript/src/types/config.ts +0 -183
  605. package/sdk/typescript/src/types/models.ts +0 -314
  606. package/sdk/typescript/src/types.ts +0 -139
  607. package/sdk/typescript/src/utils/case.ts +0 -34
  608. package/sdk/typescript/src/utils/format.ts +0 -480
  609. package/sdk/typescript/src/utils/stream.ts +0 -50
  610. package/sdk/typescript/test/adapters/anthropic.test.ts +0 -217
  611. package/sdk/typescript/test/adapters/gemini.test.ts +0 -131
  612. package/sdk/typescript/test/adapters/openai.test.ts +0 -174
  613. package/sdk/typescript/test/adapters/vercel-ai.test.ts +0 -306
  614. package/sdk/typescript/test/client-expanded.test.ts +0 -333
  615. package/sdk/typescript/test/client.test.ts +0 -266
  616. package/sdk/typescript/test/compress.test.ts +0 -118
  617. package/sdk/typescript/test/config.test.ts +0 -275
  618. package/sdk/typescript/test/errors.test.ts +0 -169
  619. package/sdk/typescript/test/format-integration.test.ts +0 -252
  620. package/sdk/typescript/test/hooks.test.ts +0 -265
  621. package/sdk/typescript/test/integration.test.ts +0 -249
  622. package/sdk/typescript/test/mdx-examples.test.ts +0 -253
  623. package/sdk/typescript/test/models.test.ts +0 -318
  624. package/sdk/typescript/test/parity.test.ts +0 -337
  625. package/sdk/typescript/test/paths.test.ts +0 -447
  626. package/sdk/typescript/test/shared-context.test.ts +0 -245
  627. package/sdk/typescript/test/simulate.test.ts +0 -84
  628. package/sdk/typescript/test/types.test.ts +0 -244
  629. package/sdk/typescript/test/utils/case.test.ts +0 -129
  630. package/sdk/typescript/test/utils/detect-format.test.ts +0 -133
  631. package/sdk/typescript/test/utils/format.test.ts +0 -434
  632. package/sdk/typescript/test/vercel-ai-e2e.test.ts +0 -179
  633. package/sdk/typescript/tsup.config.ts +0 -17
  634. package/uv.lock +0 -6951
  635. package/xithead.egg-info/PKG-INFO +0 -22
  636. package/xithead.egg-info/SOURCES.txt +0 -16
  637. package/xithead.egg-info/dependency_links.txt +0 -1
  638. package/xithead.egg-info/entry_points.txt +0 -2
  639. package/xithead.egg-info/requires.txt +0 -10
  640. package/xithead.egg-info/top_level.txt +0 -2
  641. package/xithead.ps1 +0 -136
  642. package/xithead.sh +0 -129
  643. package/xithead_dist/pyproject.toml +0 -39
  644. package/xithead_dist/xithead.egg-info/PKG-INFO +0 -22
  645. package/xithead_dist/xithead.egg-info/SOURCES.txt +0 -16
  646. package/xithead_dist/xithead.egg-info/dependency_links.txt +0 -1
  647. package/xithead_dist/xithead.egg-info/entry_points.txt +0 -3
  648. package/xithead_dist/xithead.egg-info/requires.txt +0 -10
  649. package/xithead_dist/xithead.egg-info/top_level.txt +0 -2
@@ -1,340 +0,0 @@
1
- //! Per-session cache-hit-rate observability — Phase G PR-G3.
2
- //!
3
- //! # The H-blocker metric
4
- //!
5
- //! Phase H ("retire the Python proxy") depends on this metric to
6
- //! confirm parity between the Rust proxy and the soon-to-retire
7
- //! Python proxy during canary. The acceptance gate in
8
- //! `REALIGNMENT/10-phase-H-python-retirement.md:11-12` reads
9
- //! `cache_hit_rate ≥ Python baseline; no 5xx regressions in 24h`.
10
- //! That assertion is meaningless without this histogram.
11
- //!
12
- //! # Definition
13
- //!
14
- //! For every completed request session we observe one sample on the
15
- //! `proxy_cache_hit_rate_per_session` histogram whose value is:
16
- //!
17
- //! ```text
18
- //! cache_read_input_tokens
19
- //! ───────────────────────
20
- //! total_input_tokens
21
- //! ```
22
- //!
23
- //! `total_input_tokens` is the full denominator each provider
24
- //! exposes on the `usage` payload (input + cache_read +
25
- //! cache_creation), NOT the "billable" input that excludes cache
26
- //! hits. Defining the denominator this way means the metric stays
27
- //! meaningful across providers and stays in [0, 1].
28
- //!
29
- //! # When called
30
- //!
31
- //! - Anthropic: at `message_delta` (which carries the final `usage`).
32
- //! - OpenAI Chat: on the final usage chunk (when
33
- //! `stream_options.include_usage = true`; otherwise no sample is
34
- //! emitted — the absence is itself a signal).
35
- //! - OpenAI Responses: at `response.completed`.
36
- //!
37
- //! # Cardinality
38
- //!
39
- //! One label only: `provider ∈ {anthropic, openai_chat, openai_responses}`.
40
- //! The metric is *intentionally* low-cardinality — the H1 canary
41
- //! looks at fleet-wide hit rate, not per-model. Per-model breakdown
42
- //! lives in the per-provider info logs we already emit.
43
- //!
44
- //! # Bucket selection
45
- //!
46
- //! Bucket boundaries are picked so the histogram discriminates the
47
- //! "no cache" → "cache landed" transition with high resolution near
48
- //! 0 and the "high-hit-rate" regime (where cache is paying for
49
- //! itself) with high resolution near 1. The middle is coarser because
50
- //! ~50% hit-rate is operationally uninteresting — either the cache
51
- //! is working or it isn't.
52
-
53
- use std::sync::OnceLock;
54
-
55
- use prometheus::{HistogramOpts, HistogramVec, Registry};
56
-
57
- use super::metric_names::{
58
- LABEL_PROVIDER, METRIC_PROXY_CACHE_HIT_RATE_PER_SESSION,
59
- METRIC_PROXY_CACHE_HIT_RATE_PER_SESSION_HELP,
60
- };
61
-
62
- /// Histogram buckets in [0, 1]. Tighter near 0 (so a "barely any
63
- /// cache hit" stays distinguishable from a true zero) and near 1
64
- /// (so a "near-perfect cache" stays distinguishable from a real
65
- /// 100% hit). The middle band is intentionally coarser.
66
- pub(super) const CACHE_HIT_RATE_BUCKETS: &[f64] =
67
- &[0.0, 0.01, 0.05, 0.1, 0.25, 0.5, 0.75, 0.9, 0.95, 0.99, 1.0];
68
-
69
- /// Provider label vocabulary. Kept here (rather than scattered
70
- /// across emit sites) so the cardinality budget is reviewable in one
71
- /// place per realignment build-constraint "configurable + scalable".
72
- pub mod provider {
73
- pub const ANTHROPIC: &str = "anthropic";
74
- pub const OPENAI_CHAT: &str = "openai_chat";
75
- pub const OPENAI_RESPONSES: &str = "openai_responses";
76
- }
77
-
78
- /// `proxy_cache_hit_rate_per_session{provider}` — initialised on
79
- /// first call from `register_in`.
80
- pub fn histogram(registry: &Registry) -> &'static HistogramVec {
81
- static HIST: OnceLock<HistogramVec> = OnceLock::new();
82
- HIST.get_or_init(|| {
83
- let opts = HistogramOpts::new(
84
- METRIC_PROXY_CACHE_HIT_RATE_PER_SESSION,
85
- METRIC_PROXY_CACHE_HIT_RATE_PER_SESSION_HELP,
86
- )
87
- .buckets(CACHE_HIT_RATE_BUCKETS.to_vec());
88
- let hist = HistogramVec::new(opts, &[LABEL_PROVIDER])
89
- .expect("proxy_cache_hit_rate_per_session descriptor is well-formed");
90
- registry
91
- .register(Box::new(hist.clone()))
92
- .expect("proxy_cache_hit_rate_per_session registers exactly once");
93
- hist
94
- })
95
- }
96
-
97
- /// Compute the per-session cache hit rate given the three counters
98
- /// most providers expose on `usage`. Returns `None` when the
99
- /// denominator is zero (no input tokens at all — typically a
100
- /// degenerate request such as an empty messages array), so callers
101
- /// can choose to skip the observation rather than divide-by-zero.
102
- ///
103
- /// Per realignment build-constraint "no silent fallbacks", a
104
- /// zero-denominator request is *NOT* coerced to `0.0`; it returns
105
- /// `None` so the emit-site can log + skip instead of polluting the
106
- /// histogram with synthesised samples.
107
- pub fn compute_hit_rate(
108
- input_tokens: u64,
109
- cache_read_input_tokens: u64,
110
- cache_creation_input_tokens: u64,
111
- ) -> Option<f64> {
112
- let denom = input_tokens
113
- .saturating_add(cache_read_input_tokens)
114
- .saturating_add(cache_creation_input_tokens);
115
- if denom == 0 {
116
- return None;
117
- }
118
- Some(cache_read_input_tokens as f64 / denom as f64)
119
- }
120
-
121
- /// H2 gate: should we observe a cache-hit-rate sample for this
122
- /// Anthropic session?
123
- ///
124
- /// Returns `Some(rate)` ONLY when the stream completed cleanly
125
- /// (`state.status == MessageStop`) AND the denominator is non-zero.
126
- /// A client disconnect mid-stream closes the channel too — without
127
- /// this gate we'd observe a half-finished session that has only
128
- /// `message_start` usage and pollute the histogram with garbage.
129
- ///
130
- /// Extracted from `proxy.rs::run_sse_state_machine` so the H2
131
- /// contract is unit-testable independent of the global Prometheus
132
- /// registry (which parallel tests share).
133
- pub fn compute_anthropic_session_hit_rate(
134
- state: &crate::sse::anthropic::AnthropicStreamState,
135
- ) -> Option<f64> {
136
- if state.status != crate::sse::anthropic::StreamStatus::MessageStop {
137
- return None;
138
- }
139
- compute_hit_rate(
140
- state.usage.input_tokens,
141
- state.usage.cache_read_input_tokens,
142
- state.usage.cache_creation_input_tokens,
143
- )
144
- }
145
-
146
- /// Observe one per-session sample.
147
- ///
148
- /// `provider` MUST be one of the [`provider`] constants — callers
149
- /// from the SSE state machine pass the matching string verbatim. We
150
- /// do not validate the label here because the cardinality is bounded
151
- /// by the static call sites; an invalid label would be a bug, not a
152
- /// runtime mismatch.
153
- ///
154
- /// M3 fix: NaN / non-finite inputs are loud-skipped instead of
155
- /// silently observed. `f64::clamp(0.0, 1.0)` returns NaN when the
156
- /// input is NaN, so the prior implementation could pollute the
157
- /// histogram with NaN samples in release builds (the debug_assert
158
- /// was compiled out). Per "no silent fallbacks", an unexpected NaN
159
- /// surfaces in the logs rather than getting eaten.
160
- pub fn observe(provider: &'static str, request_id: &str, hit_rate: f64) {
161
- if !hit_rate.is_finite() {
162
- tracing::warn!(
163
- event = "cache_hit_rate_non_finite",
164
- metric = METRIC_PROXY_CACHE_HIT_RATE_PER_SESSION,
165
- provider = provider,
166
- request_id = %request_id,
167
- hit_rate = hit_rate,
168
- "refusing to observe a non-finite cache hit rate; this is a caller bug"
169
- );
170
- return;
171
- }
172
- debug_assert!(
173
- (0.0..=1.0).contains(&hit_rate),
174
- "cache hit rate must be in [0.0, 1.0]; got {hit_rate}"
175
- );
176
- // After the is_finite guard, clamp can only normalise legitimate
177
- // edge-of-range floats (1.0 + epsilon etc.) and never produces NaN.
178
- let clamped = hit_rate.clamp(0.0, 1.0);
179
- histogram(super::prometheus::registry())
180
- .with_label_values(&[provider])
181
- .observe(clamped);
182
- tracing::debug!(
183
- event = "metric_recorded",
184
- metric = METRIC_PROXY_CACHE_HIT_RATE_PER_SESSION,
185
- provider = provider,
186
- request_id = %request_id,
187
- hit_rate = clamped,
188
- "observed proxy_cache_hit_rate_per_session"
189
- );
190
- }
191
-
192
- #[cfg(test)]
193
- mod tests {
194
- use super::*;
195
-
196
- #[test]
197
- fn hit_rate_zero_when_no_cache_reads() {
198
- let r = compute_hit_rate(100, 0, 0).unwrap();
199
- assert!((r - 0.0).abs() < f64::EPSILON);
200
- }
201
-
202
- #[test]
203
- fn hit_rate_one_when_all_reads_are_cache_hits() {
204
- // Edge case: input_tokens == 0 means upstream charged us
205
- // nothing new — every input came from cache.
206
- let r = compute_hit_rate(0, 1000, 0).unwrap();
207
- assert!((r - 1.0).abs() < f64::EPSILON);
208
- }
209
-
210
- #[test]
211
- fn hit_rate_split_three_ways() {
212
- // 50 fresh input, 50 cache_read, 50 cache_creation → 50/150.
213
- let r = compute_hit_rate(50, 50, 50).unwrap();
214
- assert!((r - (1.0 / 3.0)).abs() < 1e-9);
215
- }
216
-
217
- #[test]
218
- fn hit_rate_none_on_empty_request() {
219
- // Degenerate: no tokens at all. Caller should skip the
220
- // observation, not coerce to 0.0.
221
- assert!(compute_hit_rate(0, 0, 0).is_none());
222
- }
223
-
224
- #[test]
225
- fn observe_nan_skipped_loudly() {
226
- // M3: a NaN input must NOT reach the histogram. The
227
- // pre-fix code clamped via `f64::clamp(0.0, 1.0)` which
228
- // returns NaN for NaN input — a NaN sample in release
229
- // builds was the bug. After the fix we log + skip.
230
- // The histogram count for this synthetic provider stays
231
- // at whatever it was before the call.
232
- let label = "test_nan_provider_v1";
233
- // Drive a guaranteed-clean session count via a real
234
- // observation, then push a NaN and assert no count move.
235
- observe(label, "req-nan-baseline", 0.5);
236
- let before = histogram(super::super::prometheus::registry())
237
- .with_label_values(&[label])
238
- .get_sample_count();
239
- observe(label, "req-nan-attempt", f64::NAN);
240
- let after = histogram(super::super::prometheus::registry())
241
- .with_label_values(&[label])
242
- .get_sample_count();
243
- assert_eq!(
244
- before, after,
245
- "NaN must not be observed; expected count unchanged from {before} to {after}"
246
- );
247
- }
248
-
249
- #[test]
250
- fn h2_aborted_anthropic_stream_returns_none() {
251
- // H2: a stream that closes without `message_stop` (Open
252
- // state) MUST NOT produce a sample, regardless of usage
253
- // values.
254
- use crate::sse::anthropic::{AnthropicStreamState, StreamStatus, UsageBuilder};
255
- let state = AnthropicStreamState {
256
- status: StreamStatus::Open,
257
- usage: UsageBuilder {
258
- input_tokens: 800,
259
- cache_read_input_tokens: 200,
260
- output_tokens: 50,
261
- cache_creation_input_tokens: 0,
262
- },
263
- ..Default::default()
264
- };
265
- assert!(
266
- compute_anthropic_session_hit_rate(&state).is_none(),
267
- "H2 gate must skip emission for non-completed stream"
268
- );
269
- }
270
-
271
- #[test]
272
- fn h2_errored_anthropic_stream_returns_none() {
273
- // H2: an Errored stream is also not "completed cleanly" —
274
- // skip the observation.
275
- use crate::sse::anthropic::{AnthropicStreamState, StreamStatus, UsageBuilder};
276
- let state = AnthropicStreamState {
277
- status: StreamStatus::Errored,
278
- usage: UsageBuilder {
279
- input_tokens: 800,
280
- cache_read_input_tokens: 200,
281
- output_tokens: 50,
282
- cache_creation_input_tokens: 0,
283
- },
284
- ..Default::default()
285
- };
286
- assert!(
287
- compute_anthropic_session_hit_rate(&state).is_none(),
288
- "H2 gate must skip emission for errored stream"
289
- );
290
- }
291
-
292
- #[test]
293
- fn h2_completed_anthropic_stream_returns_rate() {
294
- // H2 positive case: MessageStop + non-zero usage → return
295
- // the rate so the caller can observe it.
296
- use crate::sse::anthropic::{AnthropicStreamState, StreamStatus, UsageBuilder};
297
- let state = AnthropicStreamState {
298
- status: StreamStatus::MessageStop,
299
- usage: UsageBuilder {
300
- input_tokens: 800,
301
- cache_read_input_tokens: 200,
302
- output_tokens: 50,
303
- cache_creation_input_tokens: 0,
304
- },
305
- ..Default::default()
306
- };
307
- let rate = compute_anthropic_session_hit_rate(&state).expect("completed stream emits");
308
- // 200 / (800 + 200 + 0) = 0.2
309
- assert!((rate - 0.2).abs() < 1e-9);
310
- }
311
-
312
- #[test]
313
- fn h2_completed_but_zero_denominator_returns_none() {
314
- // Even on a completed stream, a zero-token request returns
315
- // None — per "no silent fallbacks", no synthesised 0.0.
316
- use crate::sse::anthropic::{AnthropicStreamState, StreamStatus, UsageBuilder};
317
- let state = AnthropicStreamState {
318
- status: StreamStatus::MessageStop,
319
- usage: UsageBuilder::default(),
320
- ..Default::default()
321
- };
322
- assert!(compute_anthropic_session_hit_rate(&state).is_none());
323
- }
324
-
325
- #[test]
326
- fn observe_infinity_skipped_loudly() {
327
- // Same contract for +/- infinity.
328
- let label = "test_inf_provider_v1";
329
- observe(label, "req-inf-baseline", 0.5);
330
- let before = histogram(super::super::prometheus::registry())
331
- .with_label_values(&[label])
332
- .get_sample_count();
333
- observe(label, "req-pos-inf", f64::INFINITY);
334
- observe(label, "req-neg-inf", f64::NEG_INFINITY);
335
- let after = histogram(super::super::prometheus::registry())
336
- .with_label_values(&[label])
337
- .get_sample_count();
338
- assert_eq!(before, after);
339
- }
340
- }
@@ -1,158 +0,0 @@
1
- //! Per-block compression-ratio observability — Phase G PR-G3.
2
- //!
3
- //! # Definition
4
- //!
5
- //! For every block the live-zone dispatcher successfully shrinks, we
6
- //! observe one sample on the `proxy_compression_ratio_by_strategy`
7
- //! histogram. The sample value is the ratio
8
- //! `compressed_tokens / original_tokens` (in [0, 1)), so smaller =
9
- //! better. The metric is labelled by:
10
- //!
11
- //! - `strategy` — the compressor identifier (`smart_crusher`,
12
- //! `log_compressor`, `search_compressor`, `diff_compressor`,
13
- //! `e3_anthropic_cache_control`, `e1_tool_array_sort`, …). The
14
- //! label vocabulary is bounded by the static `&'static str` set
15
- //! the compressors return on their `BlockAction::Compressed`
16
- //! manifests — never a customer-controlled value.
17
- //! - `content_type` — the detection-tier output for the block
18
- //! (`source_code`, `log`, `search_output`, `diff`, `text`, …).
19
- //! Cardinality bounded by `headroom_core::transforms::ContentType`.
20
- //!
21
- //! Counter twin: `proxy_compression_rejected_by_token_check_total{strategy}`
22
- //! captures the "compressor ran but didn't shrink the token count"
23
- //! case so dashboards can attribute the absence of histogram samples
24
- //! to legitimate rejection rather than to a missing call site.
25
- //!
26
- //! # Bucket selection
27
- //!
28
- //! Buckets are tighter near 0 (the "aggressive shrink" tail dashboard
29
- //! operators care about), wider in the middle. Anything above 1 would
30
- //! be a tokenizer regression — `BlockAction::Compressed` enforces
31
- //! `compressed_tokens < original_tokens`, so the histogram should
32
- //! never see a sample > 0.99 in practice.
33
-
34
- use std::sync::OnceLock;
35
-
36
- use prometheus::{HistogramOpts, HistogramVec, IntCounterVec, Opts, Registry};
37
-
38
- use super::metric_names::{
39
- LABEL_CONTENT_TYPE, LABEL_STRATEGY, METRIC_PROXY_COMPRESSION_RATIO_BY_STRATEGY,
40
- METRIC_PROXY_COMPRESSION_RATIO_BY_STRATEGY_HELP,
41
- METRIC_PROXY_COMPRESSION_REJECTED_BY_TOKEN_CHECK_TOTAL,
42
- METRIC_PROXY_COMPRESSION_REJECTED_BY_TOKEN_CHECK_TOTAL_HELP,
43
- };
44
-
45
- /// Histogram buckets in [0, 1). Tight at the aggressive end (≤0.25
46
- /// means we kept ≤25% of the original tokens), coarser at the upper
47
- /// end where a measurement is operationally indistinguishable from
48
- /// "barely any shrink".
49
- pub(super) const COMPRESSION_RATIO_BUCKETS: &[f64] =
50
- &[0.05, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.75, 0.9, 0.99];
51
-
52
- /// `proxy_compression_ratio_by_strategy{strategy, content_type}`.
53
- pub fn ratio_histogram(registry: &Registry) -> &'static HistogramVec {
54
- static HIST: OnceLock<HistogramVec> = OnceLock::new();
55
- HIST.get_or_init(|| {
56
- let opts = HistogramOpts::new(
57
- METRIC_PROXY_COMPRESSION_RATIO_BY_STRATEGY,
58
- METRIC_PROXY_COMPRESSION_RATIO_BY_STRATEGY_HELP,
59
- )
60
- .buckets(COMPRESSION_RATIO_BUCKETS.to_vec());
61
- let hist = HistogramVec::new(opts, &[LABEL_STRATEGY, LABEL_CONTENT_TYPE])
62
- .expect("proxy_compression_ratio_by_strategy descriptor is well-formed");
63
- registry
64
- .register(Box::new(hist.clone()))
65
- .expect("proxy_compression_ratio_by_strategy registers exactly once");
66
- hist
67
- })
68
- }
69
-
70
- /// `proxy_compression_rejected_by_token_check_total{strategy}`.
71
- pub fn rejected_counter(registry: &Registry) -> &'static IntCounterVec {
72
- static COUNTER: OnceLock<IntCounterVec> = OnceLock::new();
73
- COUNTER.get_or_init(|| {
74
- let opts = Opts::new(
75
- METRIC_PROXY_COMPRESSION_REJECTED_BY_TOKEN_CHECK_TOTAL,
76
- METRIC_PROXY_COMPRESSION_REJECTED_BY_TOKEN_CHECK_TOTAL_HELP,
77
- );
78
- let counter = IntCounterVec::new(opts, &[LABEL_STRATEGY])
79
- .expect("proxy_compression_rejected_by_token_check_total descriptor is well-formed");
80
- registry
81
- .register(Box::new(counter.clone()))
82
- .expect("proxy_compression_rejected_by_token_check_total registers exactly once");
83
- counter
84
- })
85
- }
86
-
87
- /// Observe one compression-ratio sample. `strategy` and `content_type`
88
- /// must be `&'static str` (bounded by compiler-known compressor +
89
- /// content-type enum sets).
90
- pub fn observe_ratio(
91
- strategy: &'static str,
92
- content_type: &str,
93
- original_tokens: usize,
94
- compressed_tokens: usize,
95
- ) {
96
- if original_tokens == 0 {
97
- // Per realignment build-constraint "no silent fallbacks": a
98
- // zero-denominator block would synthesise a `NaN` sample we
99
- // can't observe meaningfully. Loud-log and skip.
100
- tracing::warn!(
101
- event = "compression_ratio_zero_denominator",
102
- strategy = strategy,
103
- content_type = %content_type,
104
- compressed_tokens = compressed_tokens,
105
- "skipping proxy_compression_ratio_by_strategy observation: \
106
- original_tokens == 0 (would divide by zero)"
107
- );
108
- return;
109
- }
110
- let ratio = (compressed_tokens as f64) / (original_tokens as f64);
111
- ratio_histogram(super::prometheus::registry())
112
- .with_label_values(&[strategy, content_type])
113
- .observe(ratio);
114
- tracing::debug!(
115
- event = "metric_recorded",
116
- metric = METRIC_PROXY_COMPRESSION_RATIO_BY_STRATEGY,
117
- strategy = strategy,
118
- content_type = %content_type,
119
- original_tokens = original_tokens,
120
- compressed_tokens = compressed_tokens,
121
- ratio = ratio,
122
- "observed proxy_compression_ratio_by_strategy"
123
- );
124
- }
125
-
126
- /// Increment the rejection counter for a compressor that ran but did
127
- /// not produce a token-smaller output.
128
- pub fn record_rejected_by_token_check(strategy: &'static str) {
129
- rejected_counter(super::prometheus::registry())
130
- .with_label_values(&[strategy])
131
- .inc();
132
- tracing::debug!(
133
- event = "metric_recorded",
134
- metric = METRIC_PROXY_COMPRESSION_REJECTED_BY_TOKEN_CHECK_TOTAL,
135
- strategy = strategy,
136
- "incremented proxy_compression_rejected_by_token_check_total"
137
- );
138
- }
139
-
140
- #[cfg(test)]
141
- mod tests {
142
- use super::*;
143
-
144
- #[test]
145
- fn zero_original_tokens_skips_observation() {
146
- // Calling observe with original_tokens=0 must not panic and
147
- // must not divide-by-zero; the warn log is sufficient.
148
- observe_ratio("smart_crusher", "text", 0, 0);
149
- }
150
-
151
- #[test]
152
- fn ratio_50_percent_recorded() {
153
- // Drive the metric so the family appears in scrapes; we
154
- // exercise the path here, not the value (which is asserted
155
- // via integration tests).
156
- observe_ratio("test_strategy_50pct", "text", 200, 100);
157
- }
158
- }
@@ -1,174 +0,0 @@
1
- //! Centralised metric-name + label-key constants — Phase G PR-G3.
2
- //!
3
- //! Realignment build-constraint "configurable: every metric name + label
4
- //! vocabulary defined in one place" applies here. The Bedrock D3
5
- //! metrics in [`super::prometheus`] predate this module; they keep
6
- //! their inline literals (a churn-cost decision documented in the
7
- //! PR-G3 commit) but every PR-G3 metric and its labels live here.
8
- //!
9
- //! # Naming convention
10
- //!
11
- //! - `METRIC_*` — the wire-name string. Prometheus convention:
12
- //! `_total` for counters, `_seconds` / no suffix for histograms.
13
- //! - `METRIC_*_HELP` — the HELP-line text used at registration. Kept
14
- //! alongside the wire name so a rename catches both in one diff.
15
- //! - `LABEL_*` — the label-key string. Reuse across metrics where
16
- //! the dimension is the same (`provider`, `strategy`, …).
17
-
18
- // ---------- proxy_cache_hit_rate_per_session ----------
19
-
20
- pub const METRIC_PROXY_CACHE_HIT_RATE_PER_SESSION: &str = "proxy_cache_hit_rate_per_session";
21
- pub const METRIC_PROXY_CACHE_HIT_RATE_PER_SESSION_HELP: &str =
22
- "Per-session cache hit rate observed at the Rust proxy from \
23
- usage.cache_read_input_tokens / (input + cache_read + cache_creation). \
24
- Phase H canary gate: parity with the Python proxy baseline.";
25
-
26
- // ---------- proxy_compression_ratio_by_strategy ----------
27
-
28
- pub const METRIC_PROXY_COMPRESSION_RATIO_BY_STRATEGY: &str = "proxy_compression_ratio_by_strategy";
29
- pub const METRIC_PROXY_COMPRESSION_RATIO_BY_STRATEGY_HELP: &str =
30
- "Compression ratio (compressed_tokens / original_tokens) observed \
31
- per block that was actually shrunk by the live-zone dispatcher. \
32
- Labelled by strategy (smart_crusher/log_compressor/…) and \
33
- detected content_type.";
34
-
35
- // ---------- proxy_compression_rejected_by_token_check_total ----------
36
-
37
- pub const METRIC_PROXY_COMPRESSION_REJECTED_BY_TOKEN_CHECK_TOTAL: &str =
38
- "proxy_compression_rejected_by_token_check_total";
39
- pub const METRIC_PROXY_COMPRESSION_REJECTED_BY_TOKEN_CHECK_TOTAL_HELP: &str =
40
- "Count of compressor runs whose output failed the tokenizer-validated \
41
- shrink check (compressed_tokens >= original_tokens). Surfaces 'we ran \
42
- but kept the original' cases that would otherwise be invisible.";
43
-
44
- // ---------- proxy_passthrough_bytes_modified_total ----------
45
-
46
- pub const METRIC_PROXY_PASSTHROUGH_BYTES_MODIFIED_TOTAL: &str =
47
- "proxy_passthrough_bytes_modified_total";
48
- pub const METRIC_PROXY_PASSTHROUGH_BYTES_MODIFIED_TOTAL_HELP: &str =
49
- "Bytes modified on a path that is supposed to passthrough verbatim. \
50
- MUST stay 0 outside the compression-on hot path. Any non-zero rate \
51
- fires the cache-safety alarm.";
52
-
53
- // ---------- proxy_rate_limit_remaining_* ----------
54
-
55
- pub const METRIC_PROXY_RATE_LIMIT_REMAINING_REQUESTS: &str = "proxy_rate_limit_remaining_requests";
56
- pub const METRIC_PROXY_RATE_LIMIT_REMAINING_REQUESTS_HELP: &str =
57
- "Upstream-reported remaining requests for the current window, \
58
- extracted from rate-limit response headers (anthropic-ratelimit-* \
59
- or x-ratelimit-*). Per-provider, per-window-bucket gauge.";
60
-
61
- pub const METRIC_PROXY_RATE_LIMIT_REMAINING_TOKENS: &str = "proxy_rate_limit_remaining_tokens";
62
- pub const METRIC_PROXY_RATE_LIMIT_REMAINING_TOKENS_HELP: &str =
63
- "Upstream-reported remaining tokens for the current window, extracted \
64
- from rate-limit response headers (anthropic-ratelimit-*-tokens or \
65
- x-ratelimit-remaining-tokens).";
66
-
67
- pub const METRIC_PROXY_RATE_LIMIT_REMAINING_INPUT_TOKENS: &str =
68
- "proxy_rate_limit_remaining_input_tokens";
69
- pub const METRIC_PROXY_RATE_LIMIT_REMAINING_INPUT_TOKENS_HELP: &str =
70
- "Upstream-reported remaining INPUT tokens for the current window. \
71
- Anthropic separates input and output token budgets in its \
72
- ratelimit headers; this gauge tracks the input bucket.";
73
-
74
- pub const METRIC_PROXY_RATE_LIMIT_REMAINING_OUTPUT_TOKENS: &str =
75
- "proxy_rate_limit_remaining_output_tokens";
76
- pub const METRIC_PROXY_RATE_LIMIT_REMAINING_OUTPUT_TOKENS_HELP: &str =
77
- "Upstream-reported remaining OUTPUT tokens for the current window. \
78
- Anthropic-only header on present providers.";
79
-
80
- // ---------- proxy_service_tier_count_total ----------
81
-
82
- pub const METRIC_PROXY_SERVICE_TIER_COUNT_TOTAL: &str = "proxy_service_tier_count_total";
83
- pub const METRIC_PROXY_SERVICE_TIER_COUNT_TOTAL_HELP: &str =
84
- "Count of requests/responses observed at the proxy, labelled by the \
85
- OpenAI Responses service_tier the request resolved into (auto, \
86
- default, flex, on_demand, priority).";
87
-
88
- // ---------- proxy_response_status_count_total ----------
89
-
90
- pub const METRIC_PROXY_RESPONSE_STATUS_COUNT_TOTAL: &str = "proxy_response_status_count_total";
91
- pub const METRIC_PROXY_RESPONSE_STATUS_COUNT_TOTAL_HELP: &str =
92
- "Count of OpenAI Responses outcomes labelled by terminal status \
93
- (completed, incomplete, failed, cancelled, in_progress). \
94
- 'incomplete' detail lands in the structured log paired with each \
95
- increment.";
96
-
97
- // Phase G PR-G3 remediation (C3 + C4): the metric-name constants
98
- // for `proxy_image_generation_call_log_redacted_total`,
99
- // `wrap_rtk_invocations_total`, and `wrap_rtk_tokens_saved_per_session`
100
- // were removed because the underlying counters had no production
101
- // emit site on the Rust side. The same metrics are exported by the
102
- // Python proxy (`headroom/proxy/prometheus_metrics.py`) which is the
103
- // natural owner: image redaction is a Python-proxy operation and RTK
104
- // invocation tracking lives in the wrap CLI, both Python-side
105
- // surfaces. See `docs/observability.md`.
106
-
107
- // ---------- shared label keys ----------
108
-
109
- pub const LABEL_PROVIDER: &str = "provider";
110
- pub const LABEL_STRATEGY: &str = "strategy";
111
- pub const LABEL_CONTENT_TYPE: &str = "content_type";
112
- pub const LABEL_PATH: &str = "path";
113
- pub const LABEL_TIER: &str = "tier";
114
- pub const LABEL_STATUS: &str = "status";
115
-
116
- // ---------- bounded label vocabularies ----------
117
-
118
- /// OpenAI service-tier values per the Responses API spec
119
- /// (`service_tier` field on the response object). The metric label
120
- /// vocabulary is **strictly** this set plus a `"scale"` value
121
- /// (documented in OpenAI's tier-pricing page) and a sentinel
122
- /// `"other"` bucket for anything else, so a malicious client posting
123
- /// `{"service_tier":"<random>"}` per request cannot blow up
124
- /// cardinality.
125
- pub mod service_tier {
126
- pub const AUTO: &str = "auto";
127
- pub const DEFAULT: &str = "default";
128
- pub const FLEX: &str = "flex";
129
- pub const ON_DEMAND: &str = "on_demand";
130
- pub const PRIORITY: &str = "priority";
131
- pub const SCALE: &str = "scale";
132
- /// Sentinel for any unknown / unrecognised tier value. Prevents
133
- /// label-cardinality DoS from arbitrary inbound JSON.
134
- pub const OTHER: &str = "other";
135
-
136
- /// Validate an inbound `service_tier` string against the bounded
137
- /// vocabulary. Returns the matching `&'static` constant or
138
- /// [`OTHER`] for any unrecognised value (with a tracing::warn so
139
- /// wire-format drift is loud rather than silently bucketed).
140
- ///
141
- /// The matching is case-sensitive — the OpenAI spec is
142
- /// case-sensitive on these strings; a case-different value is
143
- /// treated as drift, not as the same tier.
144
- pub fn validate(raw: &str) -> &'static str {
145
- match raw {
146
- AUTO => AUTO,
147
- DEFAULT => DEFAULT,
148
- FLEX => FLEX,
149
- ON_DEMAND => ON_DEMAND,
150
- PRIORITY => PRIORITY,
151
- SCALE => SCALE,
152
- _ => {
153
- tracing::warn!(
154
- event = "service_tier_unknown",
155
- raw = %raw,
156
- bucket = OTHER,
157
- "unknown service_tier value bucketed to 'other' to bound cardinality"
158
- );
159
- OTHER
160
- }
161
- }
162
- }
163
- }
164
-
165
- /// OpenAI Responses terminal-status vocabulary. `in_progress` is the
166
- /// non-terminal entry — included so observers see a request that
167
- /// closed mid-stream (we increment on the last status seen).
168
- pub mod response_status {
169
- pub const COMPLETED: &str = "completed";
170
- pub const INCOMPLETE: &str = "incomplete";
171
- pub const FAILED: &str = "failed";
172
- pub const CANCELLED: &str = "cancelled";
173
- pub const IN_PROGRESS: &str = "in_progress";
174
- }