xithead 1.4.0 → 1.5.0
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/.actrc +14 -0
- package/.actrc.local.example +15 -0
- package/.changelog.md +2 -0
- package/.claude/agents/academic-anthropologist.md +125 -0
- package/.claude/agents/academic-geographer.md +127 -0
- package/.claude/agents/academic-historian.md +123 -0
- package/.claude/agents/academic-narratologist.md +118 -0
- package/.claude/agents/academic-psychologist.md +118 -0
- package/.claude/agents/academic-statistician.md +144 -0
- package/.claude/agents/accounts-payable-agent.md +205 -0
- package/.claude/agents/agentic-identity-trust.md +394 -0
- package/.claude/agents/agents-orchestrator.md +367 -0
- package/.claude/agents/automation-governance-architect.md +216 -0
- package/.claude/agents/blender-addon-engineer.md +243 -0
- package/.claude/agents/business-strategist.md +488 -0
- package/.claude/agents/change-management-consultant.md +497 -0
- package/.claude/agents/chief-financial-officer.md +388 -0
- package/.claude/agents/corporate-training-designer.md +192 -0
- package/.claude/agents/customer-service.md +398 -0
- package/.claude/agents/customer-success-manager.md +460 -0
- package/.claude/agents/data-consolidation-agent.md +60 -0
- package/.claude/agents/data-privacy-officer.md +412 -0
- package/.claude/agents/design-brand-guardian.md +322 -0
- package/.claude/agents/design-image-prompt-engineer.md +236 -0
- package/.claude/agents/design-inclusive-visuals-specialist.md +73 -0
- package/.claude/agents/design-persona-walkthrough.md +272 -0
- package/.claude/agents/design-ui-designer.md +386 -0
- package/.claude/agents/design-ui-finish-gate-reviewer.md +217 -0
- package/.claude/agents/design-ux-architect.md +482 -0
- package/.claude/agents/design-ux-researcher.md +329 -0
- package/.claude/agents/design-visual-storyteller.md +149 -0
- package/.claude/agents/design-whimsy-injector.md +460 -0
- package/.claude/agents/economy-designer.md +156 -0
- package/.claude/agents/engineering-ai-data-remediation-engineer.md +211 -0
- package/.claude/agents/engineering-ai-engineer.md +146 -0
- package/.claude/agents/engineering-api-platform-engineer.md +181 -0
- package/.claude/agents/engineering-ats-validator-architect.md +383 -0
- package/.claude/agents/engineering-autonomous-optimization-architect.md +121 -0
- package/.claude/agents/engineering-backend-architect.md +255 -0
- package/.claude/agents/engineering-china-network-engineer.md +252 -0
- package/.claude/agents/engineering-cms-developer.md +536 -0
- package/.claude/agents/engineering-code-reviewer.md +76 -0
- package/.claude/agents/engineering-codebase-onboarding-engineer.md +173 -0
- package/.claude/agents/engineering-data-engineer.md +349 -0
- package/.claude/agents/engineering-data-visualization-engineer.md +151 -0
- package/.claude/agents/engineering-database-optimizer.md +188 -0
- package/.claude/agents/engineering-database-reliability-engineer.md +201 -0
- package/.claude/agents/engineering-desktop-app-engineer.md +209 -0
- package/.claude/agents/engineering-developer-tooling-engineer.md +153 -0
- package/.claude/agents/engineering-devops-automator.md +385 -0
- package/.claude/agents/engineering-drupal-performance.md +347 -0
- package/.claude/agents/engineering-drupal-shopping-cart.md +360 -0
- package/.claude/agents/engineering-electrical-engineer.md +575 -0
- package/.claude/agents/engineering-email-intelligence-engineer.md +390 -0
- package/.claude/agents/engineering-embedded-firmware-engineer.md +196 -0
- package/.claude/agents/engineering-feishu-integration-developer.md +606 -0
- package/.claude/agents/engineering-filament-optimization-specialist.md +283 -0
- package/.claude/agents/engineering-finops-engineer.md +164 -0
- package/.claude/agents/engineering-frontend-developer.md +257 -0
- package/.claude/agents/engineering-gaussdb-expert.md +334 -0
- package/.claude/agents/engineering-git-workflow-master.md +98 -0
- package/.claude/agents/engineering-i18n-engineer.md +214 -0
- package/.claude/agents/engineering-identity-access-engineer.md +217 -0
- package/.claude/agents/engineering-incident-response-commander.md +444 -0
- package/.claude/agents/engineering-iot-fleet-engineer.md +148 -0
- package/.claude/agents/engineering-it-service-manager.md +561 -0
- package/.claude/agents/engineering-knowledge-graph-engineer.md +372 -0
- package/.claude/agents/engineering-llm-post-training-engineer.md +166 -0
- package/.claude/agents/engineering-minimal-change-engineer.md +207 -0
- package/.claude/agents/engineering-mobile-app-builder.md +493 -0
- package/.claude/agents/engineering-mobile-release-engineer.md +164 -0
- package/.claude/agents/engineering-multi-agent-systems-architect.md +600 -0
- package/.claude/agents/engineering-network-engineer.md +245 -0
- package/.claude/agents/engineering-orgscript-engineer.md +113 -0
- package/.claude/agents/engineering-payments-billing-engineer.md +228 -0
- package/.claude/agents/engineering-pdf-engine-architect.md +696 -0
- package/.claude/agents/engineering-platform-engineer.md +270 -0
- package/.claude/agents/engineering-privacy-engineer.md +152 -0
- package/.claude/agents/engineering-prompt-engineer.md +209 -0
- package/.claude/agents/engineering-rag-pipeline-engineer.md +450 -0
- package/.claude/agents/engineering-rapid-prototyper.md +466 -0
- package/.claude/agents/engineering-realtime-collaboration-engineer.md +200 -0
- package/.claude/agents/engineering-rust-refactoring-specialist.md +313 -0
- package/.claude/agents/engineering-search-relevance-engineer.md +237 -0
- package/.claude/agents/engineering-section-508-specialist.md +339 -0
- package/.claude/agents/engineering-senior-developer.md +176 -0
- package/.claude/agents/engineering-servicenow-developer-mentor.md +180 -0
- package/.claude/agents/engineering-software-architect.md +112 -0
- package/.claude/agents/engineering-solidity-smart-contract-engineer.md +522 -0
- package/.claude/agents/engineering-sre.md +90 -0
- package/.claude/agents/engineering-technical-writer.md +393 -0
- package/.claude/agents/engineering-universal-document-compiler.md +370 -0
- package/.claude/agents/engineering-uswds-developer.md +340 -0
- package/.claude/agents/engineering-video-streaming-engineer.md +151 -0
- package/.claude/agents/engineering-voice-ai-integration-engineer.md +584 -0
- package/.claude/agents/engineering-webassembly-engineer.md +153 -0
- package/.claude/agents/engineering-wechat-mini-program-developer.md +356 -0
- package/.claude/agents/engineering-wordpress-performance.md +346 -0
- package/.claude/agents/engineering-wordpress-shopping-cart.md +346 -0
- package/.claude/agents/esg-sustainability-officer.md +396 -0
- package/.claude/agents/finance-bookkeeper-controller.md +260 -0
- package/.claude/agents/finance-financial-analyst.md +234 -0
- package/.claude/agents/finance-fpa-analyst.md +263 -0
- package/.claude/agents/finance-investment-researcher.md +272 -0
- package/.claude/agents/finance-tax-strategist.md +239 -0
- package/.claude/agents/game-audio-engineer.md +264 -0
- package/.claude/agents/game-designer.md +167 -0
- package/.claude/agents/gis-3d-scene-developer.md +111 -0
- package/.claude/agents/gis-analyst.md +91 -0
- package/.claude/agents/gis-bim-specialist.md +108 -0
- package/.claude/agents/gis-cartography-designer.md +150 -0
- package/.claude/agents/gis-drone-reality-mapping.md +120 -0
- package/.claude/agents/gis-geoai-ml-engineer.md +105 -0
- package/.claude/agents/gis-geoprocessing-specialist.md +97 -0
- package/.claude/agents/gis-qa-engineer.md +133 -0
- package/.claude/agents/gis-solution-engineer.md +101 -0
- package/.claude/agents/gis-spatial-data-engineer.md +97 -0
- package/.claude/agents/gis-spatial-data-scientist.md +111 -0
- package/.claude/agents/gis-technical-consultant.md +86 -0
- package/.claude/agents/gis-web-gis-developer.md +108 -0
- package/.claude/agents/godot-gameplay-scripter.md +338 -0
- package/.claude/agents/godot-multiplayer-engineer.md +301 -0
- package/.claude/agents/godot-shader-developer.md +267 -0
- package/.claude/agents/government-digital-presales-consultant.md +363 -0
- package/.claude/agents/grant-writer.md +511 -0
- package/.claude/agents/healthcare-aging-parent-care-companion.md +414 -0
- package/.claude/agents/healthcare-clinical-evidence-agent.md +231 -0
- package/.claude/agents/healthcare-customer-service.md +389 -0
- package/.claude/agents/healthcare-innovation-strategist.md +433 -0
- package/.claude/agents/healthcare-marketing-compliance.md +395 -0
- package/.claude/agents/healthcare-sovereign-health-systems-agent.md +312 -0
- package/.claude/agents/hospitality-guest-services.md +603 -0
- package/.claude/agents/hr-onboarding.md +451 -0
- package/.claude/agents/identity-graph-operator.md +303 -0
- package/.claude/agents/language-translator.md +264 -0
- package/.claude/agents/legal-billing-time-tracking.md +569 -0
- package/.claude/agents/legal-client-intake.md +492 -0
- package/.claude/agents/legal-document-review.md +454 -0
- package/.claude/agents/level-designer.md +208 -0
- package/.claude/agents/loan-officer-assistant.md +555 -0
- package/.claude/agents/lsp-index-engineer.md +320 -0
- package/.claude/agents/ma-integration-manager.md +427 -0
- package/.claude/agents/macos-spatial-metal-engineer.md +337 -0
- package/.claude/agents/marketing-aeo-foundations.md +264 -0
- package/.claude/agents/marketing-agentic-search-optimizer.md +279 -0
- package/.claude/agents/marketing-ai-citation-strategist.md +172 -0
- package/.claude/agents/marketing-app-store-optimizer.md +321 -0
- package/.claude/agents/marketing-baidu-seo-specialist.md +226 -0
- package/.claude/agents/marketing-bilibili-content-strategist.md +199 -0
- package/.claude/agents/marketing-book-co-author.md +110 -0
- package/.claude/agents/marketing-carousel-growth-engine.md +204 -0
- package/.claude/agents/marketing-china-ecommerce-operator.md +283 -0
- package/.claude/agents/marketing-china-market-localization-strategist.md +283 -0
- package/.claude/agents/marketing-content-creator.md +54 -0
- package/.claude/agents/marketing-cross-border-ecommerce.md +259 -0
- package/.claude/agents/marketing-developer-community-builder.md +285 -0
- package/.claude/agents/marketing-douyin-strategist.md +149 -0
- package/.claude/agents/marketing-email-strategist.md +249 -0
- package/.claude/agents/marketing-global-podcast-strategist.md +206 -0
- package/.claude/agents/marketing-growth-hacker.md +54 -0
- package/.claude/agents/marketing-instagram-curator.md +113 -0
- package/.claude/agents/marketing-kuaishou-strategist.md +223 -0
- package/.claude/agents/marketing-linkedin-content-creator.md +214 -0
- package/.claude/agents/marketing-livestream-commerce-coach.md +305 -0
- package/.claude/agents/marketing-multi-platform-publisher.md +217 -0
- package/.claude/agents/marketing-podcast-strategist.md +277 -0
- package/.claude/agents/marketing-pr-communications-manager.md +473 -0
- package/.claude/agents/marketing-private-domain-operator.md +308 -0
- package/.claude/agents/marketing-reddit-community-builder.md +123 -0
- package/.claude/agents/marketing-seo-specialist.md +370 -0
- package/.claude/agents/marketing-short-video-editing-coach.md +412 -0
- package/.claude/agents/marketing-social-media-strategist.md +125 -0
- package/.claude/agents/marketing-tiktok-strategist.md +125 -0
- package/.claude/agents/marketing-twitter-engager.md +126 -0
- package/.claude/agents/marketing-video-optimization-specialist.md +119 -0
- package/.claude/agents/marketing-wechat-official-account.md +145 -0
- package/.claude/agents/marketing-weibo-strategist.md +240 -0
- package/.claude/agents/marketing-x-twitter-intelligence-analyst.md +161 -0
- package/.claude/agents/marketing-xiaohongshu-specialist.md +138 -0
- package/.claude/agents/marketing-zhihu-strategist.md +162 -0
- package/.claude/agents/medical-billing-coding-specialist.md +491 -0
- package/.claude/agents/narrative-designer.md +243 -0
- package/.claude/agents/operations-manager.md +399 -0
- package/.claude/agents/organizational-psychologist.md +391 -0
- package/.claude/agents/paid-media-auditor.md +71 -0
- package/.claude/agents/paid-media-creative-strategist.md +71 -0
- package/.claude/agents/paid-media-paid-social-strategist.md +71 -0
- package/.claude/agents/paid-media-ppc-strategist.md +71 -0
- package/.claude/agents/paid-media-programmatic-buyer.md +71 -0
- package/.claude/agents/paid-media-search-query-analyst.md +71 -0
- package/.claude/agents/paid-media-tracking-specialist.md +71 -0
- package/.claude/agents/personal-growth-mentor.md +159 -0
- package/.claude/agents/product-behavioral-nudge-engine.md +83 -0
- package/.claude/agents/product-dx-engineer.md +332 -0
- package/.claude/agents/product-feedback-synthesizer.md +119 -0
- package/.claude/agents/product-manager.md +469 -0
- package/.claude/agents/product-sprint-prioritizer.md +154 -0
- package/.claude/agents/product-trend-researcher.md +159 -0
- package/.claude/agents/project-management-experiment-tracker.md +198 -0
- package/.claude/agents/project-management-jira-workflow-steward.md +233 -0
- package/.claude/agents/project-management-meeting-notes-specialist.md +95 -0
- package/.claude/agents/project-management-project-shepherd.md +194 -0
- package/.claude/agents/project-management-studio-operations.md +200 -0
- package/.claude/agents/project-management-studio-producer.md +203 -0
- package/.claude/agents/project-manager-senior.md +135 -0
- package/.claude/agents/real-estate-buyer-seller.md +596 -0
- package/.claude/agents/recruitment-specialist.md +515 -0
- package/.claude/agents/report-distribution-agent.md +65 -0
- package/.claude/agents/research-synthesist.md +136 -0
- package/.claude/agents/resume-tailor.md +230 -0
- package/.claude/agents/retail-customer-returns.md +566 -0
- package/.claude/agents/roblox-avatar-creator.md +297 -0
- package/.claude/agents/roblox-experience-designer.md +306 -0
- package/.claude/agents/roblox-systems-scripter.md +332 -0
- package/.claude/agents/sales-account-strategist.md +227 -0
- package/.claude/agents/sales-coach.md +271 -0
- package/.claude/agents/sales-data-extraction-agent.md +67 -0
- package/.claude/agents/sales-deal-strategist.md +180 -0
- package/.claude/agents/sales-discovery-coach.md +225 -0
- package/.claude/agents/sales-engineer.md +182 -0
- package/.claude/agents/sales-offer-lead-gen-strategist.md +257 -0
- package/.claude/agents/sales-outbound-strategist.md +201 -0
- package/.claude/agents/sales-outreach.md +425 -0
- package/.claude/agents/sales-pipeline-analyst.md +267 -0
- package/.claude/agents/sales-proposal-strategist.md +217 -0
- package/.claude/agents/security-ai-generated-code-auditor.md +207 -0
- package/.claude/agents/security-appsec-engineer.md +536 -0
- package/.claude/agents/security-architect.md +307 -0
- package/.claude/agents/security-blockchain-security-auditor.md +482 -0
- package/.claude/agents/security-cloud-security-architect.md +576 -0
- package/.claude/agents/security-compliance-auditor.md +158 -0
- package/.claude/agents/security-incident-responder.md +450 -0
- package/.claude/agents/security-penetration-tester.md +399 -0
- package/.claude/agents/security-secrets-credential-engineer.md +189 -0
- package/.claude/agents/security-senior-secops.md +760 -0
- package/.claude/agents/security-threat-detection-engineer.md +553 -0
- package/.claude/agents/security-threat-intelligence-analyst.md +661 -0
- package/.claude/agents/specialized-chief-of-staff.md +279 -0
- package/.claude/agents/specialized-civil-engineer.md +356 -0
- package/.claude/agents/specialized-codebase-archaeologist.md +341 -0
- package/.claude/agents/specialized-cultural-intelligence-strategist.md +88 -0
- package/.claude/agents/specialized-developer-advocate.md +317 -0
- package/.claude/agents/specialized-document-generator.md +55 -0
- package/.claude/agents/specialized-fedramp-rmf-compliance.md +378 -0
- package/.claude/agents/specialized-focus-music-architect.md +175 -0
- package/.claude/agents/specialized-french-consulting-market.md +194 -0
- package/.claude/agents/specialized-korean-business-navigator.md +216 -0
- package/.claude/agents/specialized-master-plan-architect.md +157 -0
- package/.claude/agents/specialized-mcp-builder.md +260 -0
- package/.claude/agents/specialized-model-qa.md +528 -0
- package/.claude/agents/specialized-pricing-analyst.md +243 -0
- package/.claude/agents/specialized-salesforce-architect.md +182 -0
- package/.claude/agents/specialized-strategy-duel-agent.md +130 -0
- package/.claude/agents/specialized-workflow-architect.md +597 -0
- package/.claude/agents/study-abroad-advisor.md +282 -0
- package/.claude/agents/supply-chain-strategist.md +591 -0
- package/.claude/agents/support-analytics-reporter.md +387 -0
- package/.claude/agents/support-executive-summary-generator.md +212 -0
- package/.claude/agents/support-finance-tracker.md +480 -0
- package/.claude/agents/support-infrastructure-maintainer.md +628 -0
- package/.claude/agents/support-legal-compliance-checker.md +591 -0
- package/.claude/agents/support-support-responder.md +607 -0
- package/.claude/agents/technical-artist.md +233 -0
- package/.claude/agents/terminal-integration-specialist.md +70 -0
- package/.claude/agents/testing-accessibility-auditor.md +327 -0
- package/.claude/agents/testing-api-tester.md +334 -0
- package/.claude/agents/testing-evidence-collector.md +210 -0
- package/.claude/agents/testing-performance-benchmarker.md +283 -0
- package/.claude/agents/testing-reality-checker.md +249 -0
- package/.claude/agents/testing-test-automation-engineer.md +196 -0
- package/.claude/agents/testing-test-results-analyzer.md +330 -0
- package/.claude/agents/testing-tool-evaluator.md +416 -0
- package/.claude/agents/testing-workflow-optimizer.md +463 -0
- package/.claude/agents/unity-architect.md +271 -0
- package/.claude/agents/unity-editor-tool-developer.md +310 -0
- package/.claude/agents/unity-multiplayer-engineer.md +323 -0
- package/.claude/agents/unity-shader-graph-artist.md +269 -0
- package/.claude/agents/unreal-multiplayer-architect.md +364 -0
- package/.claude/agents/unreal-systems-engineer.md +322 -0
- package/.claude/agents/unreal-technical-artist.md +256 -0
- package/.claude/agents/unreal-world-builder.md +273 -0
- package/.claude/agents/visionos-spatial-engineer.md +54 -0
- package/.claude/agents/xr-cockpit-interaction-specialist.md +32 -0
- package/.claude/agents/xr-immersive-developer.md +32 -0
- package/.claude/agents/xr-interface-architect.md +32 -0
- package/.claude/agents/zk-steward.md +211 -0
- package/.claude-plugin/marketplace.json +30 -0
- package/.commitlintrc.json +26 -0
- package/.devcontainer/Dockerfile +24 -0
- package/.devcontainer/devcontainer.json +70 -0
- package/.devcontainer/docker-compose.memory.yml +42 -0
- package/.devcontainer/memory-stack/devcontainer.json +84 -0
- package/.devcontainer/post-create.sh +83 -0
- package/.dockerignore +23 -0
- package/.env.act.example +15 -0
- package/.env.example +171 -0
- package/.eslintrc.json +16 -0
- package/.git-blame-ignore-revs +10 -0
- package/.gitattributes +2 -0
- package/.gitguardian.yaml +50 -0
- package/.githooks/pre-commit +6 -0
- package/.pre-commit-config.yaml +30 -0
- package/.release-please-config-xithead.json +22 -0
- package/.release-please-config.json +44 -0
- package/.release-please-manifest-xithead.json +3 -0
- package/.release-please-manifest.json +3 -0
- package/CODE_OF_CONDUCT.md +133 -0
- package/CONTRIBUTING.md +133 -0
- package/Cargo.lock +5557 -0
- package/Cargo.toml +121 -0
- package/Dockerfile +38 -0
- package/Dockerfile.proxy +48 -0
- package/ENTERPRISE.md +5 -0
- package/FEATURES_ADVANCED.md +311 -0
- package/Headroom-2.gif +0 -0
- package/HeadroomDemo-Fast.gif +0 -0
- package/MANIFEST.in +4 -0
- package/MODERNIZATION_GUIDE.md +358 -0
- package/Makefile +140 -0
- package/NOTICE +43 -0
- package/NPM_TOKEN_SETUP.md +81 -0
- package/PR.md +170 -0
- package/PUBLISH.md +77 -0
- package/README.md +108 -72
- package/README_FRONTEND.md +196 -0
- package/REALIGNMENT/00-overview.md +53 -0
- package/REALIGNMENT/01-bug-list.md +421 -0
- package/REALIGNMENT/02-architecture.md +322 -0
- package/REALIGNMENT/03-phase-A-lockdown.md +420 -0
- package/REALIGNMENT/04-phase-B-live-zone.md +470 -0
- package/REALIGNMENT/05-phase-C-rust-proxy.md +329 -0
- package/REALIGNMENT/06-phase-D-bedrock-vertex.md +222 -0
- package/REALIGNMENT/07-phase-E-cache-stabilization.md +338 -0
- package/REALIGNMENT/08-phase-F-auth-mode.md +254 -0
- package/REALIGNMENT/09-phase-G-rtk-observability.md +194 -0
- package/REALIGNMENT/10-phase-H-python-retirement.md +214 -0
- package/REALIGNMENT/11-phase-I-test-infra.md +385 -0
- package/REALIGNMENT/12-decisions-needed.md +196 -0
- package/REALIGNMENT/INDEX.md +82 -0
- package/REFACTORING_CAMPAIGN.md +277 -0
- package/RESTRUCTURE_PLAN.md +100 -0
- package/RUST_DEV.md +361 -0
- package/SECURITY.md +65 -0
- package/SETUP_AUTO_PUBLISH.md +164 -0
- package/TESTING-copilot-subscription.md +153 -0
- package/app/api/config/route.ts +22 -0
- package/app/api/export/route.ts +83 -0
- package/app/api/models/route.ts +12 -0
- package/app/api/stats/route.ts +46 -0
- package/app/dashboard/page.tsx +445 -0
- package/app/globals.css +35 -0
- package/app/installation/page.tsx +293 -0
- package/app/layout.tsx +35 -0
- package/app/master-design-system.css +2076 -0
- package/app/master-design-system.source.css +8 -0
- package/app/page.tsx +187 -0
- package/app/rechtliches/agb/page.tsx +165 -0
- package/app/rechtliches/datenschutz/page.tsx +128 -0
- package/app/rechtliches/impressum/page.tsx +122 -0
- package/app/rechtliches/widerruf/page.tsx +185 -0
- package/bin/xithead.js +264 -0
- package/codecov.yml +34 -0
- package/components/layout/AppShell.tsx +25 -0
- package/components/layout/Footer.tsx +120 -0
- package/components/layout/Header.tsx +145 -0
- package/components/marketing/LegalHighlights.tsx +45 -0
- package/components/marketing/LegalPageShell.tsx +49 -0
- package/components/marketing/LegalPanel.tsx +41 -0
- package/components/marketing/index.ts +3 -0
- package/crates/headroom-core/Cargo.toml +165 -0
- package/crates/headroom-core/benches/auth_mode.rs +74 -0
- package/crates/headroom-core/benches/ccr_store.rs +224 -0
- package/crates/headroom-core/benches/tokenizer.rs +52 -0
- package/crates/headroom-core/config/pipeline.toml +151 -0
- package/crates/headroom-core/proptest-regressions/transforms/tag_protector.txt +9 -0
- package/crates/headroom-core/src/auth_mode.rs +250 -0
- package/crates/headroom-core/src/cache_control.rs +414 -0
- package/crates/headroom-core/src/ccr/backends/in_memory.rs +317 -0
- package/crates/headroom-core/src/ccr/backends/mod.rs +152 -0
- package/crates/headroom-core/src/ccr/backends/redis.rs +146 -0
- package/crates/headroom-core/src/ccr/backends/sqlite.rs +205 -0
- package/crates/headroom-core/src/ccr/mod.rs +119 -0
- package/crates/headroom-core/src/compression_policy.rs +505 -0
- package/crates/headroom-core/src/lib.rs +33 -0
- package/crates/headroom-core/src/relevance/base.rs +139 -0
- package/crates/headroom-core/src/relevance/bm25.rs +385 -0
- package/crates/headroom-core/src/relevance/embedding.rs +354 -0
- package/crates/headroom-core/src/relevance/hybrid.rs +364 -0
- package/crates/headroom-core/src/relevance/mod.rs +64 -0
- package/crates/headroom-core/src/signals/keyword_detector.rs +433 -0
- package/crates/headroom-core/src/signals/line_importance.rs +84 -0
- package/crates/headroom-core/src/signals/mod.rs +61 -0
- package/crates/headroom-core/src/signals/tiered.rs +141 -0
- package/crates/headroom-core/src/tokenizer/estimator.rs +152 -0
- package/crates/headroom-core/src/tokenizer/hf_impl.rs +314 -0
- package/crates/headroom-core/src/tokenizer/mod.rs +56 -0
- package/crates/headroom-core/src/tokenizer/registry.rs +342 -0
- package/crates/headroom-core/src/tokenizer/tiktoken_impl.rs +265 -0
- package/crates/headroom-core/src/transforms/adaptive_sizer.rs +610 -0
- package/crates/headroom-core/src/transforms/anchor_selector.rs +1189 -0
- package/crates/headroom-core/src/transforms/content_detector.rs +769 -0
- package/crates/headroom-core/src/transforms/detection.rs +222 -0
- package/crates/headroom-core/src/transforms/diff_compressor.rs +1685 -0
- package/crates/headroom-core/src/transforms/live_zone.rs +2967 -0
- package/crates/headroom-core/src/transforms/log_compressor.rs +1295 -0
- package/crates/headroom-core/src/transforms/magika_detector.rs +395 -0
- package/crates/headroom-core/src/transforms/mod.rs +64 -0
- package/crates/headroom-core/src/transforms/pipeline/config.rs +331 -0
- package/crates/headroom-core/src/transforms/pipeline/mod.rs +103 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/diff_noise.rs +524 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/diff_offload.rs +279 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/json_offload.rs +400 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/log_offload.rs +284 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/mod.rs +34 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/search_offload.rs +331 -0
- package/crates/headroom-core/src/transforms/pipeline/orchestrator.rs +848 -0
- package/crates/headroom-core/src/transforms/pipeline/reformats/json_minifier.rs +175 -0
- package/crates/headroom-core/src/transforms/pipeline/reformats/log_template.rs +545 -0
- package/crates/headroom-core/src/transforms/pipeline/reformats/mod.rs +12 -0
- package/crates/headroom-core/src/transforms/pipeline/traits.rs +338 -0
- package/crates/headroom-core/src/transforms/recommendations.rs +329 -0
- package/crates/headroom-core/src/transforms/safety.rs +215 -0
- package/crates/headroom-core/src/transforms/search_compressor.rs +902 -0
- package/crates/headroom-core/src/transforms/smart_crusher/analyzer.rs +1262 -0
- package/crates/headroom-core/src/transforms/smart_crusher/anchors.rs +407 -0
- package/crates/headroom-core/src/transforms/smart_crusher/builder.rs +263 -0
- package/crates/headroom-core/src/transforms/smart_crusher/classifier.rs +214 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/classifier.rs +283 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/compactor.rs +733 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/formatter.rs +961 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/ir.rs +252 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/mod.rs +127 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/walker.rs +397 -0
- package/crates/headroom-core/src/transforms/smart_crusher/config.rs +173 -0
- package/crates/headroom-core/src/transforms/smart_crusher/constraints.rs +159 -0
- package/crates/headroom-core/src/transforms/smart_crusher/crusher.rs +1665 -0
- package/crates/headroom-core/src/transforms/smart_crusher/crushers.rs +865 -0
- package/crates/headroom-core/src/transforms/smart_crusher/error_keywords.rs +77 -0
- package/crates/headroom-core/src/transforms/smart_crusher/field_detect.rs +393 -0
- package/crates/headroom-core/src/transforms/smart_crusher/hashing.rs +72 -0
- package/crates/headroom-core/src/transforms/smart_crusher/mod.rs +81 -0
- package/crates/headroom-core/src/transforms/smart_crusher/observer.rs +66 -0
- package/crates/headroom-core/src/transforms/smart_crusher/orchestration.rs +459 -0
- package/crates/headroom-core/src/transforms/smart_crusher/outliers.rs +507 -0
- package/crates/headroom-core/src/transforms/smart_crusher/planning.rs +904 -0
- package/crates/headroom-core/src/transforms/smart_crusher/statistics.rs +510 -0
- package/crates/headroom-core/src/transforms/smart_crusher/stats_math.rs +287 -0
- package/crates/headroom-core/src/transforms/smart_crusher/traits.rs +203 -0
- package/crates/headroom-core/src/transforms/smart_crusher/types.rs +263 -0
- package/crates/headroom-core/src/transforms/tag_protector.rs +1272 -0
- package/crates/headroom-core/src/transforms/unidiff_detector.rs +232 -0
- package/crates/headroom-parity/Cargo.toml +26 -0
- package/crates/headroom-parity/examples/diff_fixture.rs +66 -0
- package/crates/headroom-parity/src/bin/parity_run.rs +78 -0
- package/crates/headroom-parity/src/lib.rs +613 -0
- package/crates/headroom-proxy/Cargo.toml +119 -0
- package/crates/headroom-proxy/data/model_prices_and_context_window.json +39767 -0
- package/crates/headroom-proxy/src/bedrock/auth_mode_layer.rs +192 -0
- package/crates/headroom-proxy/src/bedrock/envelope.rs +239 -0
- package/crates/headroom-proxy/src/bedrock/eventstream.rs +769 -0
- package/crates/headroom-proxy/src/bedrock/eventstream_to_sse.rs +459 -0
- package/crates/headroom-proxy/src/bedrock/invoke.rs +735 -0
- package/crates/headroom-proxy/src/bedrock/invoke_streaming.rs +1098 -0
- package/crates/headroom-proxy/src/bedrock/mod.rs +66 -0
- package/crates/headroom-proxy/src/bedrock/sigv4.rs +324 -0
- package/crates/headroom-proxy/src/bedrock/vendor.rs +82 -0
- package/crates/headroom-proxy/src/cache_stabilization/anthropic_cache_control.rs +698 -0
- package/crates/headroom-proxy/src/cache_stabilization/drift_detector.rs +683 -0
- package/crates/headroom-proxy/src/cache_stabilization/mod.rs +61 -0
- package/crates/headroom-proxy/src/cache_stabilization/openai_cache_key.rs +600 -0
- package/crates/headroom-proxy/src/cache_stabilization/tool_def_normalize.rs +514 -0
- package/crates/headroom-proxy/src/cache_stabilization/volatile_detector.rs +720 -0
- package/crates/headroom-proxy/src/compression/anthropic.rs +92 -0
- package/crates/headroom-proxy/src/compression/live_zone_anthropic.rs +1311 -0
- package/crates/headroom-proxy/src/compression/live_zone_openai.rs +660 -0
- package/crates/headroom-proxy/src/compression/live_zone_responses.rs +678 -0
- package/crates/headroom-proxy/src/compression/mod.rs +127 -0
- package/crates/headroom-proxy/src/compression/model_limits.rs +211 -0
- package/crates/headroom-proxy/src/config.rs +646 -0
- package/crates/headroom-proxy/src/error.rs +69 -0
- package/crates/headroom-proxy/src/handlers/chat_completions.rs +100 -0
- package/crates/headroom-proxy/src/handlers/conversations.rs +241 -0
- package/crates/headroom-proxy/src/handlers/mod.rs +13 -0
- package/crates/headroom-proxy/src/handlers/responses.rs +256 -0
- package/crates/headroom-proxy/src/headers.rs +288 -0
- package/crates/headroom-proxy/src/health.rs +41 -0
- package/crates/headroom-proxy/src/lib.rs +21 -0
- package/crates/headroom-proxy/src/main.rs +141 -0
- package/crates/headroom-proxy/src/observability/cache_hit_rate.rs +340 -0
- package/crates/headroom-proxy/src/observability/compression_ratio.rs +158 -0
- package/crates/headroom-proxy/src/observability/metric_names.rs +174 -0
- package/crates/headroom-proxy/src/observability/mod.rs +68 -0
- package/crates/headroom-proxy/src/observability/prometheus.rs +394 -0
- package/crates/headroom-proxy/src/observability/proxy_metrics.rs +368 -0
- package/crates/headroom-proxy/src/proxy.rs +1619 -0
- package/crates/headroom-proxy/src/responses_items.rs +565 -0
- package/crates/headroom-proxy/src/sse/anthropic.rs +415 -0
- package/crates/headroom-proxy/src/sse/framing.rs +366 -0
- package/crates/headroom-proxy/src/sse/mod.rs +40 -0
- package/crates/headroom-proxy/src/sse/openai_chat.rs +231 -0
- package/crates/headroom-proxy/src/sse/openai_responses.rs +458 -0
- package/crates/headroom-proxy/src/vertex/adc.rs +315 -0
- package/crates/headroom-proxy/src/vertex/envelope.rs +167 -0
- package/crates/headroom-proxy/src/vertex/mod.rs +277 -0
- package/crates/headroom-proxy/src/vertex/raw_predict.rs +490 -0
- package/crates/headroom-proxy/src/vertex/stream_raw_predict.rs +49 -0
- package/crates/headroom-proxy/src/websocket.rs +246 -0
- package/crates/headroom-py/Cargo.toml +37 -0
- package/crates/headroom-py/build.rs +77 -0
- package/crates/headroom-py/glibc_compat.c +170 -0
- package/crates/headroom-py/src/lib.rs +1655 -0
- package/deny.toml +32 -0
- package/design-system/base.css +127 -0
- package/design-system/components.css +1943 -0
- package/design-system/fonts.css +17 -0
- package/design-system/tailwind-preset.js +95 -0
- package/design-system/tokens.css +48 -0
- package/design-system/utilities.css +53 -0
- package/docker/differential-network-capture/Dockerfile.runner +14 -0
- package/docker/differential-network-capture/docker-compose.yml +142 -0
- package/docker/differential-network-capture/run-claude-lane.sh +24 -0
- package/docker/docker-compose.native.yml +44 -0
- package/docker-bake.hcl +88 -0
- package/docker-compose.yml +80 -0
- package/e2e/_lib/make_shim.ps1 +24 -0
- package/e2e/_lib/make_shim.sh +28 -0
- package/e2e/docker-native-install.sh +120 -0
- package/e2e/init/Dockerfile +79 -0
- package/e2e/wrap/Dockerfile +115 -0
- package/examples/07-context-compression.ipynb +279 -0
- package/examples/deployment/macos-launchagent/com.headroom.proxy.plist.template +65 -0
- package/examples/deployment/macos-launchagent/install.sh +227 -0
- package/examples/deployment/macos-launchagent/shell-integration.sh +74 -0
- package/examples/deployment/macos-launchagent/uninstall.sh +145 -0
- package/headroom-savings.png +0 -0
- package/headroom_learn.gif +0 -0
- package/lib/config/index.ts +12 -0
- package/lib/hooks/index.ts +4 -0
- package/lib/hooks/use-mounted.ts +13 -0
- package/lib/hooks/use-session.ts +34 -0
- package/lib/hooks/use-settings.ts +49 -0
- package/lib/utils/index.ts +1 -0
- package/lib/utils/settings.ts +162 -0
- package/lib/utils/utils.ts +6 -0
- package/llms.txt +67 -0
- package/middleware.ts +26 -0
- package/mkdocs.yml +136 -0
- package/next-env.d.ts +7 -0
- package/next.config.ts +12 -0
- package/npm/bin/xithead.js +366 -366
- package/npm/bin/xtream-head.js +366 -0
- package/npm/index.d.ts +57 -57
- package/npm/index.js +139 -139
- package/npm/package.json +55 -54
- package/npm/postinstall.js +43 -43
- package/package.json +58 -36
- package/plugins/headroom-agent-hooks/.claude-plugin/plugin.json +17 -0
- package/plugins/headroom-agent-hooks/hooks/hooks.json +29 -0
- package/plugins/headroom-oauth2/LICENSE +3 -0
- package/plugins/headroom-oauth2/SPEC.md +115 -0
- package/plugins/headroom-oauth2/pyproject.toml +48 -0
- package/plugins/hermes/headroom_retrieve/plugin.yaml +6 -0
- package/plugins/openclaw/hook-shim/HOOK.md +21 -0
- package/plugins/openclaw/hook-shim/handler.js +3 -0
- package/plugins/openclaw/openclaw.plugin.json +98 -0
- package/plugins/openclaw/package-lock.json +2692 -0
- package/plugins/openclaw/package.json +54 -0
- package/plugins/openclaw/prepare-dist.mjs +56 -0
- package/plugins/openclaw/src/convert.ts +418 -0
- package/plugins/openclaw/src/engine.ts +284 -0
- package/plugins/openclaw/src/gateway-config.ts +143 -0
- package/plugins/openclaw/src/index.ts +11 -0
- package/plugins/openclaw/src/plugin/index.ts +98 -0
- package/plugins/openclaw/src/proxy-manager.ts +477 -0
- package/plugins/openclaw/src/tools/headroom-retrieve.ts +76 -0
- package/plugins/openclaw/test/convert.test.ts +96 -0
- package/plugins/openclaw/test/engine-normalization.test.ts +21 -0
- package/plugins/openclaw/test/engine.test.ts +101 -0
- package/plugins/openclaw/test/gateway-config.test.ts +278 -0
- package/plugins/openclaw/test/plugin-runtime-routing.test.ts +141 -0
- package/plugins/openclaw/test/proxy-manager.test.ts +343 -0
- package/plugins/openclaw/tsup.config.ts +9 -0
- package/postcss.config.mjs +7 -0
- package/pyproject.toml +438 -0
- package/rust-toolchain.toml +16 -0
- package/sdk/typescript/examples/basic-compress.ts +64 -0
- package/sdk/typescript/examples/ccr-retrieve.ts +80 -0
- package/sdk/typescript/examples/hooks-custom-compression.ts +117 -0
- package/sdk/typescript/examples/middleware-composition.ts +59 -0
- package/sdk/typescript/examples/multi-provider.ts +53 -0
- package/sdk/typescript/examples/openai-anthropic-adapters.ts +73 -0
- package/sdk/typescript/examples/shared-context-multi-agent.ts +74 -0
- package/sdk/typescript/examples/simulation-dry-run.ts +80 -0
- package/sdk/typescript/examples/streaming-chat.ts +71 -0
- package/sdk/typescript/examples/structured-output.ts +99 -0
- package/sdk/typescript/examples/tool-calling-agent.ts +86 -0
- package/sdk/typescript/examples/with-headroom-vercel.ts +57 -0
- package/sdk/typescript/package-lock.json +3437 -0
- package/sdk/typescript/package.json +108 -0
- package/sdk/typescript/src/adapters/anthropic.ts +218 -0
- package/sdk/typescript/src/adapters/gemini.ts +83 -0
- package/sdk/typescript/src/adapters/openai.ts +77 -0
- package/sdk/typescript/src/adapters/vercel-ai.ts +131 -0
- package/sdk/typescript/src/client.ts +632 -0
- package/sdk/typescript/src/compress.ts +87 -0
- package/sdk/typescript/src/errors.ts +114 -0
- package/sdk/typescript/src/hooks.ts +113 -0
- package/sdk/typescript/src/index.ts +140 -0
- package/sdk/typescript/src/paths.ts +272 -0
- package/sdk/typescript/src/shared-context.ts +188 -0
- package/sdk/typescript/src/simulate.ts +52 -0
- package/sdk/typescript/src/types/config.ts +183 -0
- package/sdk/typescript/src/types/models.ts +314 -0
- package/sdk/typescript/src/types.ts +139 -0
- package/sdk/typescript/src/utils/case.ts +34 -0
- package/sdk/typescript/src/utils/format.ts +480 -0
- package/sdk/typescript/src/utils/stream.ts +50 -0
- package/sdk/typescript/test/adapters/anthropic.test.ts +217 -0
- package/sdk/typescript/test/adapters/gemini.test.ts +131 -0
- package/sdk/typescript/test/adapters/openai.test.ts +174 -0
- package/sdk/typescript/test/adapters/vercel-ai.test.ts +306 -0
- package/sdk/typescript/test/client-expanded.test.ts +333 -0
- package/sdk/typescript/test/client.test.ts +266 -0
- package/sdk/typescript/test/compress.test.ts +118 -0
- package/sdk/typescript/test/config.test.ts +275 -0
- package/sdk/typescript/test/errors.test.ts +169 -0
- package/sdk/typescript/test/format-integration.test.ts +252 -0
- package/sdk/typescript/test/hooks.test.ts +265 -0
- package/sdk/typescript/test/integration.test.ts +249 -0
- package/sdk/typescript/test/mdx-examples.test.ts +253 -0
- package/sdk/typescript/test/models.test.ts +318 -0
- package/sdk/typescript/test/parity.test.ts +337 -0
- package/sdk/typescript/test/paths.test.ts +447 -0
- package/sdk/typescript/test/shared-context.test.ts +245 -0
- package/sdk/typescript/test/simulate.test.ts +84 -0
- package/sdk/typescript/test/types.test.ts +244 -0
- package/sdk/typescript/test/utils/case.test.ts +129 -0
- package/sdk/typescript/test/utils/detect-format.test.ts +133 -0
- package/sdk/typescript/test/utils/format.test.ts +434 -0
- package/sdk/typescript/test/vercel-ai-e2e.test.ts +179 -0
- package/sdk/typescript/tsup.config.ts +17 -0
- package/tailwind.master.config.cjs +47 -0
- package/types/api.ts +12 -0
- package/types/config.ts +9 -0
- package/types/index.ts +2 -0
- package/uv.lock +6951 -0
- package/xithead.egg-info/PKG-INFO +22 -0
- package/xithead.egg-info/SOURCES.txt +16 -0
- package/xithead.egg-info/dependency_links.txt +1 -0
- package/xithead.egg-info/entry_points.txt +2 -0
- package/xithead.egg-info/requires.txt +10 -0
- package/xithead.egg-info/top_level.txt +2 -0
- package/xithead.ps1 +136 -0
- package/xithead.sh +129 -0
- package/xithead_dist/pyproject.toml +39 -0
- package/xithead_dist/xithead.egg-info/PKG-INFO +22 -0
- package/xithead_dist/xithead.egg-info/SOURCES.txt +16 -0
- package/xithead_dist/xithead.egg-info/dependency_links.txt +1 -0
- package/xithead_dist/xithead.egg-info/entry_points.txt +3 -0
- package/xithead_dist/xithead.egg-info/requires.txt +10 -0
- package/xithead_dist/xithead.egg-info/top_level.txt +2 -0
|
@@ -0,0 +1,224 @@
|
|
|
1
|
+
//! CCR store throughput benchmark — single-threaded and multi-threaded.
|
|
2
|
+
//!
|
|
3
|
+
//! Pins the win from PR9: replacing the single-`Mutex<HashMap>` design
|
|
4
|
+
//! with a `DashMap`-backed sharded store. The single-threaded numbers
|
|
5
|
+
//! should be roughly comparable (DashMap has a small per-op shard-hash
|
|
6
|
+
//! overhead vs a raw Mutex), but the multi-threaded numbers should
|
|
7
|
+
//! diverge sharply — distinct keys hit distinct shards and never
|
|
8
|
+
//! contend.
|
|
9
|
+
//!
|
|
10
|
+
//! Run with:
|
|
11
|
+
//! cargo bench -p headroom-core --bench ccr_store
|
|
12
|
+
//!
|
|
13
|
+
//! The critical numbers to watch are the `mt/N=8` rows: with the
|
|
14
|
+
//! Mutex design, all 8 threads serialize on one lock, so throughput
|
|
15
|
+
//! is ~1× the single-threaded figure. With DashMap, throughput should
|
|
16
|
+
//! scale near-linearly with cores.
|
|
17
|
+
|
|
18
|
+
use std::collections::{HashMap, VecDeque};
|
|
19
|
+
use std::sync::{Arc, Mutex};
|
|
20
|
+
use std::thread;
|
|
21
|
+
use std::time::{Duration, Instant};
|
|
22
|
+
|
|
23
|
+
use criterion::{black_box, criterion_group, criterion_main, Criterion, Throughput};
|
|
24
|
+
use headroom_core::ccr::{CcrStore, InMemoryCcrStore};
|
|
25
|
+
|
|
26
|
+
// ─── Baseline: the old single-Mutex<HashMap> design ────────────────
|
|
27
|
+
//
|
|
28
|
+
// Inlined here so the bench is self-contained and shows the
|
|
29
|
+
// before/after gap directly. Same trait, same semantics; the only
|
|
30
|
+
// difference is "all ops serialize on one Mutex" vs "DashMap-sharded".
|
|
31
|
+
|
|
32
|
+
struct LegacyMutexStore {
|
|
33
|
+
inner: Mutex<LegacyInner>,
|
|
34
|
+
ttl: Duration,
|
|
35
|
+
capacity: usize,
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
struct LegacyInner {
|
|
39
|
+
map: HashMap<String, LegacyEntry>,
|
|
40
|
+
order: VecDeque<String>,
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
struct LegacyEntry {
|
|
44
|
+
payload: String,
|
|
45
|
+
inserted: Instant,
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
impl LegacyMutexStore {
|
|
49
|
+
fn new(capacity: usize, ttl: Duration) -> Self {
|
|
50
|
+
Self {
|
|
51
|
+
inner: Mutex::new(LegacyInner {
|
|
52
|
+
map: HashMap::new(),
|
|
53
|
+
order: VecDeque::new(),
|
|
54
|
+
}),
|
|
55
|
+
ttl,
|
|
56
|
+
capacity,
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
impl CcrStore for LegacyMutexStore {
|
|
62
|
+
fn put(&self, hash: &str, payload: &str) {
|
|
63
|
+
let mut g = self.inner.lock().unwrap();
|
|
64
|
+
if g.map.contains_key(hash) {
|
|
65
|
+
g.map.insert(
|
|
66
|
+
hash.to_string(),
|
|
67
|
+
LegacyEntry {
|
|
68
|
+
payload: payload.to_string(),
|
|
69
|
+
inserted: Instant::now(),
|
|
70
|
+
},
|
|
71
|
+
);
|
|
72
|
+
return;
|
|
73
|
+
}
|
|
74
|
+
while g.map.len() >= self.capacity {
|
|
75
|
+
let Some(oldest) = g.order.pop_front() else {
|
|
76
|
+
break;
|
|
77
|
+
};
|
|
78
|
+
g.map.remove(&oldest);
|
|
79
|
+
}
|
|
80
|
+
g.map.insert(
|
|
81
|
+
hash.to_string(),
|
|
82
|
+
LegacyEntry {
|
|
83
|
+
payload: payload.to_string(),
|
|
84
|
+
inserted: Instant::now(),
|
|
85
|
+
},
|
|
86
|
+
);
|
|
87
|
+
g.order.push_back(hash.to_string());
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
fn get(&self, hash: &str) -> Option<String> {
|
|
91
|
+
let mut g = self.inner.lock().unwrap();
|
|
92
|
+
let expired = match g.map.get(hash) {
|
|
93
|
+
Some(e) => e.inserted.elapsed() > self.ttl,
|
|
94
|
+
None => return None,
|
|
95
|
+
};
|
|
96
|
+
if expired {
|
|
97
|
+
g.map.remove(hash);
|
|
98
|
+
return None;
|
|
99
|
+
}
|
|
100
|
+
g.map.get(hash).map(|e| e.payload.clone())
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
fn len(&self) -> usize {
|
|
104
|
+
self.inner.lock().unwrap().map.len()
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
fn bench_put_single_threaded(c: &mut Criterion) {
|
|
109
|
+
let store = InMemoryCcrStore::new();
|
|
110
|
+
let payload = "x".repeat(512); // typical CCR payload size
|
|
111
|
+
|
|
112
|
+
let mut group = c.benchmark_group("ccr_store/put_st");
|
|
113
|
+
group.throughput(Throughput::Elements(1));
|
|
114
|
+
group.bench_function("new_keys", |b| {
|
|
115
|
+
let mut i = 0u64;
|
|
116
|
+
b.iter(|| {
|
|
117
|
+
let key = format!("k{i:012x}");
|
|
118
|
+
store.put(black_box(&key), black_box(&payload));
|
|
119
|
+
i += 1;
|
|
120
|
+
});
|
|
121
|
+
});
|
|
122
|
+
group.bench_function("same_key_overwrite", |b| {
|
|
123
|
+
b.iter(|| {
|
|
124
|
+
store.put(black_box("hot_key"), black_box(&payload));
|
|
125
|
+
});
|
|
126
|
+
});
|
|
127
|
+
group.finish();
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
fn bench_get_single_threaded(c: &mut Criterion) {
|
|
131
|
+
let store = InMemoryCcrStore::new();
|
|
132
|
+
let payload = "y".repeat(512);
|
|
133
|
+
for i in 0..1000u32 {
|
|
134
|
+
let key = format!("k{i:08x}");
|
|
135
|
+
store.put(&key, &payload);
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
let mut group = c.benchmark_group("ccr_store/get_st");
|
|
139
|
+
group.throughput(Throughput::Elements(1));
|
|
140
|
+
group.bench_function("hit", |b| {
|
|
141
|
+
let mut i = 0u32;
|
|
142
|
+
b.iter(|| {
|
|
143
|
+
let key = format!("k{:08x}", i % 1000);
|
|
144
|
+
let _ = black_box(store.get(black_box(&key)));
|
|
145
|
+
i = i.wrapping_add(1);
|
|
146
|
+
});
|
|
147
|
+
});
|
|
148
|
+
group.bench_function("miss", |b| {
|
|
149
|
+
let mut i = 0u32;
|
|
150
|
+
b.iter(|| {
|
|
151
|
+
let key = format!("absent_{i}");
|
|
152
|
+
let _ = black_box(store.get(black_box(&key)));
|
|
153
|
+
i = i.wrapping_add(1);
|
|
154
|
+
});
|
|
155
|
+
});
|
|
156
|
+
group.finish();
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
fn run_mt_workload(store: Arc<dyn CcrStore>, threads: usize, n: u64) -> Duration {
|
|
160
|
+
const ITERS_PER_THREAD: usize = 200;
|
|
161
|
+
let payload = Arc::new("z".repeat(256));
|
|
162
|
+
for i in 0..256u32 {
|
|
163
|
+
store.put(&format!("warm_{i:08x}"), &payload);
|
|
164
|
+
}
|
|
165
|
+
let start = Instant::now();
|
|
166
|
+
for _ in 0..n {
|
|
167
|
+
thread::scope(|scope| {
|
|
168
|
+
for tid in 0..threads {
|
|
169
|
+
let s = store.clone();
|
|
170
|
+
let p = payload.clone();
|
|
171
|
+
scope.spawn(move || {
|
|
172
|
+
for i in 0..ITERS_PER_THREAD {
|
|
173
|
+
if i & 1 == 0 {
|
|
174
|
+
let k = format!("t{tid}_k{i:08x}");
|
|
175
|
+
s.put(&k, &p);
|
|
176
|
+
} else {
|
|
177
|
+
let k = format!("warm_{:08x}", i % 256);
|
|
178
|
+
let _ = s.get(&k);
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
});
|
|
182
|
+
}
|
|
183
|
+
});
|
|
184
|
+
}
|
|
185
|
+
start.elapsed()
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
/// Multi-threaded mixed put/get — direct A/B between the legacy
|
|
189
|
+
/// `Mutex<HashMap>` design and the new DashMap-backed store. The
|
|
190
|
+
/// legacy version serializes every op on one lock; the new version
|
|
191
|
+
/// shards across keys so distinct hashes never contend.
|
|
192
|
+
fn bench_mixed_multi_threaded(c: &mut Criterion) {
|
|
193
|
+
let mut group = c.benchmark_group("ccr_store/mt_mixed");
|
|
194
|
+
group.throughput(Throughput::Elements(1));
|
|
195
|
+
|
|
196
|
+
for &threads in &[1usize, 2, 4, 8] {
|
|
197
|
+
// DashMap-backed (current design).
|
|
198
|
+
let label = format!("dashmap/threads={threads}");
|
|
199
|
+
group.bench_function(&label, |b| {
|
|
200
|
+
b.iter_custom(|n| {
|
|
201
|
+
let store: Arc<dyn CcrStore> = Arc::new(InMemoryCcrStore::new());
|
|
202
|
+
run_mt_workload(store, threads, n)
|
|
203
|
+
});
|
|
204
|
+
});
|
|
205
|
+
// Legacy Mutex<HashMap> (the design PR9 replaces).
|
|
206
|
+
let label = format!("legacy_mutex/threads={threads}");
|
|
207
|
+
group.bench_function(&label, |b| {
|
|
208
|
+
b.iter_custom(|n| {
|
|
209
|
+
let store: Arc<dyn CcrStore> =
|
|
210
|
+
Arc::new(LegacyMutexStore::new(1000, Duration::from_secs(300)));
|
|
211
|
+
run_mt_workload(store, threads, n)
|
|
212
|
+
});
|
|
213
|
+
});
|
|
214
|
+
}
|
|
215
|
+
group.finish();
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
criterion_group!(
|
|
219
|
+
benches,
|
|
220
|
+
bench_put_single_threaded,
|
|
221
|
+
bench_get_single_threaded,
|
|
222
|
+
bench_mixed_multi_threaded,
|
|
223
|
+
);
|
|
224
|
+
criterion_main!(benches);
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
//! Throughput benchmark for `headroom_core::tokenizer`.
|
|
2
|
+
//!
|
|
3
|
+
//! Measures the tiktoken-rs–backed counter on a small / medium / large input.
|
|
4
|
+
//! Used as a baseline; future stages can compare against this to catch
|
|
5
|
+
//! regressions when we change tokenizer backends or add caching layers.
|
|
6
|
+
|
|
7
|
+
use criterion::{black_box, criterion_group, criterion_main, BatchSize, Criterion, Throughput};
|
|
8
|
+
use headroom_core::tokenizer::{TiktokenCounter, Tokenizer};
|
|
9
|
+
|
|
10
|
+
fn bench_count_text(c: &mut Criterion) {
|
|
11
|
+
let counter = TiktokenCounter::for_model("gpt-4o-mini").expect("init");
|
|
12
|
+
|
|
13
|
+
// Small: a typical short prompt.
|
|
14
|
+
let small = "Reply with exactly: PONG";
|
|
15
|
+
// Medium: a typical chat turn (~1KB).
|
|
16
|
+
let medium = "the quick brown fox jumps over the lazy dog\n".repeat(25);
|
|
17
|
+
// Large: a long context (~64KB) — stresses BPE inner loops.
|
|
18
|
+
let large = "the quick brown fox jumps over the lazy dog\n".repeat(1500);
|
|
19
|
+
|
|
20
|
+
let mut group = c.benchmark_group("tokenizer/count_text");
|
|
21
|
+
group.throughput(Throughput::Bytes(small.len() as u64));
|
|
22
|
+
group.bench_function("small", |b| {
|
|
23
|
+
b.iter_batched(
|
|
24
|
+
|| small,
|
|
25
|
+
|s| black_box(counter.count_text(s)),
|
|
26
|
+
BatchSize::SmallInput,
|
|
27
|
+
)
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
group.throughput(Throughput::Bytes(medium.len() as u64));
|
|
31
|
+
group.bench_function("medium", |b| {
|
|
32
|
+
b.iter_batched(
|
|
33
|
+
|| medium.as_str(),
|
|
34
|
+
|s| black_box(counter.count_text(s)),
|
|
35
|
+
BatchSize::SmallInput,
|
|
36
|
+
)
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
group.throughput(Throughput::Bytes(large.len() as u64));
|
|
40
|
+
group.bench_function("large", |b| {
|
|
41
|
+
b.iter_batched(
|
|
42
|
+
|| large.as_str(),
|
|
43
|
+
|s| black_box(counter.count_text(s)),
|
|
44
|
+
BatchSize::SmallInput,
|
|
45
|
+
)
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
group.finish();
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
criterion_group!(benches, bench_count_text);
|
|
52
|
+
criterion_main!(benches);
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
# Compression pipeline default configuration.
|
|
2
|
+
#
|
|
3
|
+
# This file is embedded into the headroom-core binary via `include_str!`
|
|
4
|
+
# at build time, so a stock binary needs no external file. Production
|
|
5
|
+
# deployments override these defaults by loading their own TOML at
|
|
6
|
+
# startup via `PipelineConfig::from_str` or `from_file`.
|
|
7
|
+
#
|
|
8
|
+
# All thresholds chosen CONSERVATIVELY. The pipeline is on the hot
|
|
9
|
+
# path of every Claude Code / Codex / agent tool-call response — bias
|
|
10
|
+
# toward "don't fire CCR unless we're sure" to avoid forcing
|
|
11
|
+
# unnecessary retrieval round trips. A retrieval round trip costs
|
|
12
|
+
# tokens (the marker text), latency (the tool call), and risk (the
|
|
13
|
+
# LLM might not retrieve when it should).
|
|
14
|
+
|
|
15
|
+
[pipeline]
|
|
16
|
+
# Below this fraction of input bytes (after reformat), we consider
|
|
17
|
+
# the reformat phase to have "succeeded" and skip offloads UNLESS the
|
|
18
|
+
# bloat estimator demands them. 0.5 = "if reformat shrunk us to half
|
|
19
|
+
# the original, that's enough for now."
|
|
20
|
+
reformat_target_ratio = 0.5
|
|
21
|
+
|
|
22
|
+
# Bloat threshold above which we ALWAYS run the offload, regardless
|
|
23
|
+
# of reformat success. 0.5 = "if a domain-specific estimator says
|
|
24
|
+
# half this content is bloat, CCR offload is worth the retrieval
|
|
25
|
+
# cost." Conservative — most real-world tool outputs sit below 0.5.
|
|
26
|
+
bloat_threshold = 0.5
|
|
27
|
+
|
|
28
|
+
# After reformat, if (output_len / input_len) > this, we run offload
|
|
29
|
+
# transforms even if their bloat estimate is below `bloat_threshold`.
|
|
30
|
+
# Captures the "reformat barely helped, content might still be
|
|
31
|
+
# salvageable via offload" case. 0.85 = "if reformat saved less than
|
|
32
|
+
# 15% of bytes, try offload as a fallback."
|
|
33
|
+
offload_fallback_ratio = 0.85
|
|
34
|
+
|
|
35
|
+
# ─── Per-domain bloat estimator config ──────────────────────────────
|
|
36
|
+
#
|
|
37
|
+
# Each domain has its own structural-only signal for "this content
|
|
38
|
+
# would benefit from CCR offload." The estimators MUST be cheap (no
|
|
39
|
+
# full compression pass) so they run in parallel with the reformat
|
|
40
|
+
# phase via rayon::join.
|
|
41
|
+
|
|
42
|
+
[bloat.log]
|
|
43
|
+
# Inputs shorter than this in lines never trigger offload; the
|
|
44
|
+
# overhead of CCR retrieval would outweigh any savings. Matches
|
|
45
|
+
# LogCompressorConfig::min_lines_for_ccr.
|
|
46
|
+
min_lines = 50
|
|
47
|
+
# How many lines to sample when scoring importance density on long
|
|
48
|
+
# logs. Sampling beats full-scan because per-line keyword detection
|
|
49
|
+
# costs aho-corasick + word-boundary checks per call. 100 samples
|
|
50
|
+
# on a 10k-line log gives <1% error vs full scan.
|
|
51
|
+
sample_size = 100
|
|
52
|
+
# Lines with priority strictly above this are "high-priority" — the
|
|
53
|
+
# rest count as dilution. Calibrated against the signals trait's
|
|
54
|
+
# priority scale (errors return ~0.9, warnings ~0.7, info ~0.0).
|
|
55
|
+
high_priority_threshold = 0.4
|
|
56
|
+
# Weighted combination of two signals, summing to ≤ 1.0. The repetition
|
|
57
|
+
# weight catches "log full of identical INFO heartbeats"; the priority
|
|
58
|
+
# dilution weight catches "log full of unique-but-irrelevant lines
|
|
59
|
+
# burying a few errors." Production tuning may shift these.
|
|
60
|
+
uniqueness_weight = 0.5
|
|
61
|
+
priority_dilution_weight = 0.5
|
|
62
|
+
|
|
63
|
+
[bloat.diff]
|
|
64
|
+
# Inputs shorter than this in lines never trigger offload.
|
|
65
|
+
min_lines = 50
|
|
66
|
+
# Below this context-to-change ratio, we consider the diff dense and
|
|
67
|
+
# don't offload. Above, the diff is mostly context — high bloat.
|
|
68
|
+
# 0.6 = "60% of relevant lines are context" is the threshold.
|
|
69
|
+
normal_context_ratio = 0.6
|
|
70
|
+
|
|
71
|
+
[bloat.search]
|
|
72
|
+
# Inputs with fewer matches never trigger offload.
|
|
73
|
+
min_matches = 10
|
|
74
|
+
# Average matches per file at which we hit "fully clustered"
|
|
75
|
+
# bloat = 1.0. 10 matches/file means the result set is mostly
|
|
76
|
+
# repeated hits in the same files — ideal CCR candidate.
|
|
77
|
+
cluster_threshold = 10.0
|
|
78
|
+
|
|
79
|
+
# ─── Reformat configs ───────────────────────────────────────────────
|
|
80
|
+
#
|
|
81
|
+
# Reformats pack input denser without losing information. Configs here
|
|
82
|
+
# tune the structural-only knobs each reformat exposes.
|
|
83
|
+
|
|
84
|
+
[reformat.log_template]
|
|
85
|
+
# Don't bother template-mining inputs shorter than this. The cost of
|
|
86
|
+
# the bucket walk + table emission isn't worth it on small logs.
|
|
87
|
+
min_lines = 20
|
|
88
|
+
# Minimum consecutive lines that share a template before we collapse
|
|
89
|
+
# them into a "[Template: ...] (Nx)" block + variant table. Smaller
|
|
90
|
+
# values catch more — but 3 is the floor below which the dedup overhead
|
|
91
|
+
# (template header + brackets) exceeds the savings.
|
|
92
|
+
min_run = 3
|
|
93
|
+
# Two lines are "same template" if at least this fraction of their
|
|
94
|
+
# tokens match positionally (after token-count match). 0.4 = Drain's
|
|
95
|
+
# published default — matches `<TS> INFO worker-<N> processing job <N>`
|
|
96
|
+
# style families (where 3 of 6 tokens are constants) while rejecting
|
|
97
|
+
# genuinely different shapes. Pairs with `min_constant_tokens` so a
|
|
98
|
+
# template with too few anchor tokens won't be promoted regardless of
|
|
99
|
+
# how high the similarity score happens to land.
|
|
100
|
+
similarity_threshold = 0.4
|
|
101
|
+
# Floor on the number of constant tokens a template must have. A
|
|
102
|
+
# "template" of all-`<*>` tokens carries no readable signal — emit
|
|
103
|
+
# verbatim instead. 2 = "must share at least 2 anchor tokens."
|
|
104
|
+
min_constant_tokens = 2
|
|
105
|
+
|
|
106
|
+
# ─── JSON-array offload config (SmartCrusher wrapper) ─────────────
|
|
107
|
+
#
|
|
108
|
+
# JsonOffload wraps SmartCrusher: a JSON array of dicts (rows) with
|
|
109
|
+
# repeated schema is highly bloaty — most fields repeat their keys per
|
|
110
|
+
# row. SmartCrusher dedups, drops near-duplicate rows, and emits a CCR
|
|
111
|
+
# marker for retrieval. The bloat estimator below cheaply spots the
|
|
112
|
+
# "array-of-dicts shape with N+ rows" signal without parsing JSON.
|
|
113
|
+
|
|
114
|
+
[offload.json]
|
|
115
|
+
# Don't fire below this many detected row separators (`},{` boundaries
|
|
116
|
+
# scaled across the input). 5 = "less than 5 rows isn't worth it."
|
|
117
|
+
min_array_rows = 5
|
|
118
|
+
# At this row count, the bloat score saturates to 1.0. Tabular inputs
|
|
119
|
+
# with this many rows are reliably bloat-heavy candidates for CCR.
|
|
120
|
+
saturation_rows = 50
|
|
121
|
+
|
|
122
|
+
# ─── Diff-noise offload config ─────────────────────────────────────
|
|
123
|
+
#
|
|
124
|
+
# Drop hunks for files that match these glob-like suffixes (literal
|
|
125
|
+
# filename-suffix match, no globbing). Lockfiles dominate diff size in
|
|
126
|
+
# JS/Python/Ruby/Go projects but carry near-zero semantic value for
|
|
127
|
+
# LLM consumption — the version bump in the manifest already captures
|
|
128
|
+
# what the LLM needs to know.
|
|
129
|
+
|
|
130
|
+
[offload.diff_noise]
|
|
131
|
+
# Inputs shorter than this never trigger noise offload.
|
|
132
|
+
min_lines = 30
|
|
133
|
+
# Lockfile filename suffixes (case-sensitive). Match is "path ENDS
|
|
134
|
+
# WITH this suffix and the next char is `/` or start-of-path." Add
|
|
135
|
+
# project-specific lock files here without code changes.
|
|
136
|
+
lockfile_suffixes = [
|
|
137
|
+
"Cargo.lock",
|
|
138
|
+
"package-lock.json",
|
|
139
|
+
"yarn.lock",
|
|
140
|
+
"pnpm-lock.yaml",
|
|
141
|
+
"poetry.lock",
|
|
142
|
+
"Pipfile.lock",
|
|
143
|
+
"Gemfile.lock",
|
|
144
|
+
"go.sum",
|
|
145
|
+
"composer.lock",
|
|
146
|
+
]
|
|
147
|
+
# Drop hunks where every change is whitespace-only (added/removed
|
|
148
|
+
# blank lines, trailing whitespace, indentation-only changes). These
|
|
149
|
+
# show up in formatter / linter commits and carry no signal the LLM
|
|
150
|
+
# needs to reason about.
|
|
151
|
+
drop_whitespace_only_hunks = true
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Seeds for failure cases proptest has generated in the past. It is
|
|
2
|
+
# automatically read and these particular cases re-run before any
|
|
3
|
+
# novel cases are generated.
|
|
4
|
+
#
|
|
5
|
+
# It is recommended to check this file in to source control so that
|
|
6
|
+
# everyone who runs the test benefits from these saved cases.
|
|
7
|
+
cc 8fbea33614d948018222b12893746cadfc057a807a80f3e8b63af540614d1eb0 # shrinks to content = "<a>"
|
|
8
|
+
cc e499bfe23a63b8a21d0d8105141c83e83a7f3a1484c19bcf5be0732c7c1bd9c3 # shrinks to content = "</"
|
|
9
|
+
cc 70ba971eb9c85e814763d0af359de0a4a967e8947caf837d4efe751a37292659 # shrinks to content = "</", compressed = ""
|
|
@@ -0,0 +1,250 @@
|
|
|
1
|
+
//! Auth-mode classifier — Phase F PR-F1.
|
|
2
|
+
//!
|
|
3
|
+
//! A single pure function turns the inbound request `HeaderMap` into one
|
|
4
|
+
//! of three classes that drive every downstream compression / cache /
|
|
5
|
+
//! header policy decision:
|
|
6
|
+
//!
|
|
7
|
+
//! - [`AuthMode::Payg`]: caller pays per token (Anthropic API key,
|
|
8
|
+
//! OpenAI `sk-...`, Gemini `x-goog-api-key`, x-api-key). Aggressive
|
|
9
|
+
//! compression saves them money — turn it all on.
|
|
10
|
+
//! - [`AuthMode::OAuth`]: caller is on a fixed-cost subscription / IAM
|
|
11
|
+
//! plan (Claude Pro OAuth, Codex Enterprise, Cursor Pro, Bedrock
|
|
12
|
+
//! IAM-signed downstream, Vertex ADC). Per-token cost is opaque to
|
|
13
|
+
//! them; cache-safety is paramount because OAuth scopes pin to
|
|
14
|
+
//! `(account, model, session)` and beta-header drift voids them.
|
|
15
|
+
//! - [`AuthMode::Subscription`]: caller is a UX-bound CLI / IDE
|
|
16
|
+
//! (Claude Code, ChatGPT Plus, Cursor, Copilot, Antigravity).
|
|
17
|
+
//! Provider rate-limits by request count; programmatic-fingerprint
|
|
18
|
+
//! detection means we MUST look like the upstream agent (preserve
|
|
19
|
+
//! `User-Agent`, never inject `X-Headroom-*`, never strip
|
|
20
|
+
//! `accept-encoding`).
|
|
21
|
+
//!
|
|
22
|
+
//! See `~/.claude/projects/.../memory/project_auth_mode_compression_nuances.md`
|
|
23
|
+
//! for the user-decision rationale (2026-05-01).
|
|
24
|
+
//!
|
|
25
|
+
//! The classifier is **pure** (no I/O, no allocation beyond a single
|
|
26
|
+
//! lowercase copy of the User-Agent), runs in <10us per call, and
|
|
27
|
+
//! NEVER panics on malformed headers — non-UTF-8 values fall through to
|
|
28
|
+
//! the safe default [`AuthMode::Payg`] with a `tracing::warn!` event so
|
|
29
|
+
//! operators can spot bad clients in the log stream without taking the
|
|
30
|
+
//! proxy down.
|
|
31
|
+
|
|
32
|
+
use http::HeaderMap;
|
|
33
|
+
|
|
34
|
+
/// Three auth-mode classes Headroom routes compression policy through.
|
|
35
|
+
///
|
|
36
|
+
/// `Copy` because the value is passed through dozens of compression
|
|
37
|
+
/// decisions per request; cloning a 1-byte enum is cheaper than holding
|
|
38
|
+
/// a reference across `await` points. `Hash + Eq` so it can key the
|
|
39
|
+
/// per-tenant TOIN aggregation map (Phase F PR-F3).
|
|
40
|
+
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
41
|
+
pub enum AuthMode {
|
|
42
|
+
/// Pay-as-you-go API key. Aggressive live-zone compression OK.
|
|
43
|
+
Payg,
|
|
44
|
+
/// OAuth bearer / Bedrock IAM / Vertex ADC. Passthrough-prefer:
|
|
45
|
+
/// no auto-`cache_control`, no auto-`prompt_cache_key`, no lossy
|
|
46
|
+
/// compressors. Lossless-only path.
|
|
47
|
+
OAuth,
|
|
48
|
+
/// Subscription-bound CLI / IDE. Stealth: same as OAuth +
|
|
49
|
+
/// preserve `accept-encoding`, never strip; never inject
|
|
50
|
+
/// `X-Headroom-*`; never mutate `User-Agent`.
|
|
51
|
+
Subscription,
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
impl AuthMode {
|
|
55
|
+
/// Lower-snake-case label suitable for structured-log fields and
|
|
56
|
+
/// metric labels. Stable wire format — Python parity tests check
|
|
57
|
+
/// this exact string.
|
|
58
|
+
pub fn as_str(self) -> &'static str {
|
|
59
|
+
match self {
|
|
60
|
+
AuthMode::Payg => "payg",
|
|
61
|
+
AuthMode::OAuth => "oauth",
|
|
62
|
+
AuthMode::Subscription => "subscription",
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/// User-Agent prefixes that identify a UX-bound CLI / IDE.
|
|
68
|
+
///
|
|
69
|
+
/// Lives at module scope (not inside `classify`) so:
|
|
70
|
+
/// 1. The compiler can constant-fold the slice into the rodata segment.
|
|
71
|
+
/// 2. A future PR can swap this for a configurable list (Phase F
|
|
72
|
+
/// follow-up) without touching the function body.
|
|
73
|
+
/// 3. Adding a new client = one-line edit here, no logic change.
|
|
74
|
+
///
|
|
75
|
+
/// Match is `str::contains` against a lowercased copy of the UA — so
|
|
76
|
+
/// the prefix can appear anywhere in the value (Anthropic CLIs prefix
|
|
77
|
+
/// their own UA with the parent agent's UA in some cases).
|
|
78
|
+
const SUBSCRIPTION_UA_PREFIXES: &[&str] = &[
|
|
79
|
+
"claude-cli/",
|
|
80
|
+
"claude-code/",
|
|
81
|
+
"codex-cli/",
|
|
82
|
+
"cursor/",
|
|
83
|
+
"claude-vscode/",
|
|
84
|
+
"github-copilot/",
|
|
85
|
+
"anthropic-cli/",
|
|
86
|
+
"antigravity/",
|
|
87
|
+
];
|
|
88
|
+
|
|
89
|
+
/// Classify the auth mode of an inbound request from its headers.
|
|
90
|
+
///
|
|
91
|
+
/// Decision order (most-specific signal wins):
|
|
92
|
+
///
|
|
93
|
+
/// 1. **Subscription UA prefix** → [`AuthMode::Subscription`].
|
|
94
|
+
/// The CLI's own auth-mode wins over the bearer token shape it
|
|
95
|
+
/// happens to be carrying — a Claude Code session uses a
|
|
96
|
+
/// `sk-ant-oat-*` token but is a subscription client, not OAuth.
|
|
97
|
+
/// 2. **`Authorization: Bearer sk-ant-oat-*`** → [`AuthMode::OAuth`]
|
|
98
|
+
/// (Claude Pro / Max OAuth). Checked before the broader `sk-` PAYG
|
|
99
|
+
/// rule because `sk-ant-oat-` shares the `sk-` prefix.
|
|
100
|
+
/// 3. **`Authorization: Bearer sk-ant-api*` or `Bearer sk-*`** →
|
|
101
|
+
/// [`AuthMode::Payg`] (Anthropic / OpenAI API key).
|
|
102
|
+
/// 4. **`Authorization: Bearer <jwt>`** (3 dot-separated segments) →
|
|
103
|
+
/// [`AuthMode::OAuth`] (Codex / Cursor / Copilot OAuth).
|
|
104
|
+
/// 5. **`Authorization` present but not `Bearer ...`** →
|
|
105
|
+
/// [`AuthMode::OAuth`] (AWS SigV4 `AWS4-HMAC-SHA256 ...` →
|
|
106
|
+
/// Bedrock; any other non-Bearer scheme is presumed
|
|
107
|
+
/// passthrough-prefer too).
|
|
108
|
+
/// 6. **`x-api-key` present** → [`AuthMode::Payg`] (Anthropic API key
|
|
109
|
+
/// style).
|
|
110
|
+
/// 7. **`x-goog-api-key` present** → [`AuthMode::Payg`] (Gemini key).
|
|
111
|
+
/// 8. **Default** → [`AuthMode::Payg`] (safest default; aggressive
|
|
112
|
+
/// compression on a misclassified request just costs us a re-run,
|
|
113
|
+
/// not a revoked subscription).
|
|
114
|
+
///
|
|
115
|
+
/// # Performance
|
|
116
|
+
///
|
|
117
|
+
/// One owned `String` allocation for the lowercase UA copy. All other
|
|
118
|
+
/// matches are zero-allocation `str::starts_with` / `str::contains` /
|
|
119
|
+
/// `str::split('.').count()`. Bench at
|
|
120
|
+
/// `crates/headroom-core/benches/auth_mode.rs` asserts <10us / call.
|
|
121
|
+
pub fn classify(headers: &HeaderMap) -> AuthMode {
|
|
122
|
+
// ── User-Agent ───────────────────────────────────────────────
|
|
123
|
+
// Subscription clients identify by UA prefix; this is the most
|
|
124
|
+
// specific signal because the same OAuth token shape appears in
|
|
125
|
+
// both Claude Pro (web) and Claude Code (CLI), and only the UA
|
|
126
|
+
// tells them apart. Read once, lowercase once.
|
|
127
|
+
let ua_owned = match headers.get("user-agent") {
|
|
128
|
+
Some(value) => match value.to_str() {
|
|
129
|
+
Ok(s) => s.to_ascii_lowercase(),
|
|
130
|
+
Err(_) => {
|
|
131
|
+
tracing::warn!(
|
|
132
|
+
event = "auth_mode_classify_unparseable_user_agent",
|
|
133
|
+
"non-UTF-8 user-agent header; falling through to bearer-token classification"
|
|
134
|
+
);
|
|
135
|
+
String::new()
|
|
136
|
+
}
|
|
137
|
+
},
|
|
138
|
+
None => String::new(),
|
|
139
|
+
};
|
|
140
|
+
if SUBSCRIPTION_UA_PREFIXES
|
|
141
|
+
.iter()
|
|
142
|
+
.any(|prefix| ua_owned.contains(prefix))
|
|
143
|
+
{
|
|
144
|
+
return AuthMode::Subscription;
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
// ── Authorization header ─────────────────────────────────────
|
|
148
|
+
// We must NOT log the value. `to_str` returns an `&str` with the
|
|
149
|
+
// same lifetime as the `HeaderMap`, so no copy here.
|
|
150
|
+
let auth = match headers.get("authorization") {
|
|
151
|
+
Some(value) => match value.to_str() {
|
|
152
|
+
Ok(s) => s,
|
|
153
|
+
Err(_) => {
|
|
154
|
+
tracing::warn!(
|
|
155
|
+
event = "auth_mode_classify_unparseable_authorization",
|
|
156
|
+
"non-UTF-8 authorization header; falling back to default Payg"
|
|
157
|
+
);
|
|
158
|
+
""
|
|
159
|
+
}
|
|
160
|
+
},
|
|
161
|
+
None => "",
|
|
162
|
+
};
|
|
163
|
+
|
|
164
|
+
if let Some(token) = auth.strip_prefix("Bearer ") {
|
|
165
|
+
// Order matters: the OAuth shape `sk-ant-oat-*` shares a
|
|
166
|
+
// prefix with `sk-ant-api*` only at `sk-ant-`, so we check
|
|
167
|
+
// the OAuth shape FIRST. Then the broad PAYG shapes.
|
|
168
|
+
if token.starts_with("sk-ant-oat-") {
|
|
169
|
+
return AuthMode::OAuth;
|
|
170
|
+
}
|
|
171
|
+
if token.starts_with("sk-ant-api") || token.starts_with("sk-") {
|
|
172
|
+
return AuthMode::Payg;
|
|
173
|
+
}
|
|
174
|
+
// JWT: classic three-segment `header.payload.signature`.
|
|
175
|
+
// We don't validate the JWT — just count dot-separated
|
|
176
|
+
// segments. This catches Codex / Cursor / Copilot OAuth.
|
|
177
|
+
if token.split('.').count() >= 3 {
|
|
178
|
+
return AuthMode::OAuth;
|
|
179
|
+
}
|
|
180
|
+
// Unknown bearer shape — fall through to header-based
|
|
181
|
+
// detection below; ultimately defaults to Payg.
|
|
182
|
+
} else if !auth.is_empty() {
|
|
183
|
+
// Authorization is present but NOT `Bearer ...` — most
|
|
184
|
+
// commonly AWS SigV4 (`AWS4-HMAC-SHA256 ...`) on a Bedrock
|
|
185
|
+
// request, or a `Basic ...` from a custom proxy chain. We
|
|
186
|
+
// treat all such non-Bearer schemes as passthrough-prefer.
|
|
187
|
+
// The IAM / signed flow is opaque to us; we never strip or
|
|
188
|
+
// mutate the value — just classify the policy.
|
|
189
|
+
return AuthMode::OAuth;
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
// ── Vendor-specific API-key headers ──────────────────────────
|
|
193
|
+
// Anthropic API-key style. Direct PAYG; same compression policy
|
|
194
|
+
// as a `Bearer sk-ant-api...`.
|
|
195
|
+
if headers.contains_key("x-api-key") {
|
|
196
|
+
return AuthMode::Payg;
|
|
197
|
+
}
|
|
198
|
+
// Gemini API key. Same PAYG semantics.
|
|
199
|
+
if headers.contains_key("x-goog-api-key") {
|
|
200
|
+
return AuthMode::Payg;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
// ── Default ──────────────────────────────────────────────────
|
|
204
|
+
// Anything else: assume PAYG. Misclassifying a non-PAYG client
|
|
205
|
+
// as PAYG only over-compresses; under-compressing a PAYG client
|
|
206
|
+
// would leave money on the table, which is worse for the
|
|
207
|
+
// OSS-default user.
|
|
208
|
+
AuthMode::Payg
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
#[cfg(test)]
|
|
212
|
+
mod inline_tests {
|
|
213
|
+
//! Smoke tests inlined alongside the function so `cargo test -p
|
|
214
|
+
//! headroom-core --lib` exercises the helper without pulling in
|
|
215
|
+
//! the integration-test binary. The exhaustive test matrix lives
|
|
216
|
+
//! in `crates/headroom-core/tests/auth_mode.rs`.
|
|
217
|
+
|
|
218
|
+
use super::*;
|
|
219
|
+
use http::HeaderValue;
|
|
220
|
+
|
|
221
|
+
#[test]
|
|
222
|
+
fn enum_as_str_is_stable() {
|
|
223
|
+
// Python parity tests assert these exact strings.
|
|
224
|
+
assert_eq!(AuthMode::Payg.as_str(), "payg");
|
|
225
|
+
assert_eq!(AuthMode::OAuth.as_str(), "oauth");
|
|
226
|
+
assert_eq!(AuthMode::Subscription.as_str(), "subscription");
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
#[test]
|
|
230
|
+
fn empty_headers_default_to_payg() {
|
|
231
|
+
// No Authorization, no x-api-key, no x-goog-api-key, no UA →
|
|
232
|
+
// safest default is PAYG. The bedrock OAuth branch fires only
|
|
233
|
+
// when there's a positive non-Bearer Authorization signal.
|
|
234
|
+
let headers = HeaderMap::new();
|
|
235
|
+
assert_eq!(classify(&headers), AuthMode::Payg);
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
#[test]
|
|
239
|
+
fn unparseable_auth_falls_back_to_default() {
|
|
240
|
+
// Non-UTF-8 Authorization header — the warn! fires but we
|
|
241
|
+
// do NOT panic. With no other distinguishing headers, we
|
|
242
|
+
// fall through to the default → Payg.
|
|
243
|
+
let mut headers = HeaderMap::new();
|
|
244
|
+
headers.insert(
|
|
245
|
+
"authorization",
|
|
246
|
+
HeaderValue::from_bytes(b"\xFFnope").unwrap(),
|
|
247
|
+
);
|
|
248
|
+
assert_eq!(classify(&headers), AuthMode::Payg);
|
|
249
|
+
}
|
|
250
|
+
}
|