xithead 1.2.2 → 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 +58 -137
- 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 +2 -2
- package/npm/bin/xtream-head.js +366 -0
- package/npm/index.js +18 -91
- package/npm/package.json +55 -0
- package/package.json +47 -42
- 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,315 @@
|
|
|
1
|
+
//! GCP Application Default Credentials → bearer token resolution.
|
|
2
|
+
//!
|
|
3
|
+
//! Vertex AI's `:rawPredict` / `:streamRawPredict` endpoints expect
|
|
4
|
+
//! `Authorization: Bearer <jwt>` where the JWT is a short-lived
|
|
5
|
+
//! Google-signed access token. The token is obtained from the ADC
|
|
6
|
+
//! provider chain (gcloud user creds, GCE/GKE metadata server,
|
|
7
|
+
//! service-account JSON via `GOOGLE_APPLICATION_CREDENTIALS`,
|
|
8
|
+
//! workload-identity federation, etc.) and refreshed before expiry.
|
|
9
|
+
//!
|
|
10
|
+
//! # Why an abstraction (not direct `gcp_auth::provider()`)?
|
|
11
|
+
//!
|
|
12
|
+
//! 1. **Tests must NOT hit real GCP.** Per project rule "no silent
|
|
13
|
+
//! fallbacks", we cannot dummy out the real provider in tests
|
|
14
|
+
//! silently — we need a mock implementation that is explicit and
|
|
15
|
+
//! distinct from production. The `TokenSource` trait gives us
|
|
16
|
+
//! exactly two impls: production (`GcpAdcTokenSource`) and tests
|
|
17
|
+
//! (`StaticTokenSource`).
|
|
18
|
+
//! 2. **Caching is policy.** `gcp_auth` exposes per-call token fetches.
|
|
19
|
+
//! The cache + refresh-ahead-of-expiry policy lives at this layer
|
|
20
|
+
//! so it's testable and tunable independent of the provider.
|
|
21
|
+
//!
|
|
22
|
+
//! # Refresh policy
|
|
23
|
+
//!
|
|
24
|
+
//! Tokens are refreshed when their remaining lifetime drops below
|
|
25
|
+
//! [`REFRESH_AHEAD_SECS`] (60s). That avoids the cliff-failure where
|
|
26
|
+
//! a request fired right at expiry races the upstream's clock.
|
|
27
|
+
//! `gcp_auth` itself caches internally, but we still wrap it so:
|
|
28
|
+
//!
|
|
29
|
+
//! - Tests can substitute a `StaticTokenSource`.
|
|
30
|
+
//! - We control the refresh-ahead window (gcp_auth's internal default
|
|
31
|
+
//! is implementation-defined and could change).
|
|
32
|
+
//! - We emit structured `event = "vertex_adc_token_refreshed"` logs
|
|
33
|
+
//! per refresh so operators can confirm the cache is live.
|
|
34
|
+
//!
|
|
35
|
+
//! # Failure mode
|
|
36
|
+
//!
|
|
37
|
+
//! When ADC fetch fails (no creds configured, metadata server
|
|
38
|
+
//! unreachable, IAM permission denied, etc.) the handler converts the
|
|
39
|
+
//! returned [`TokenSourceError`] to a structured 5xx response. We do
|
|
40
|
+
//! NOT silently forward without a token — per project rule
|
|
41
|
+
//! "no silent fallbacks", an unauthenticated forward to Vertex would
|
|
42
|
+
//! return a 401 from upstream that's harder to debug than our own
|
|
43
|
+
//! 502 with `event = "vertex_adc_fetch_failed"`.
|
|
44
|
+
|
|
45
|
+
use std::sync::Arc;
|
|
46
|
+
use std::time::{Duration, SystemTime};
|
|
47
|
+
|
|
48
|
+
use async_trait::async_trait;
|
|
49
|
+
use thiserror::Error;
|
|
50
|
+
use tokio::sync::Mutex;
|
|
51
|
+
|
|
52
|
+
/// Refresh tokens this many seconds before their expiry to avoid the
|
|
53
|
+
/// cliff-failure race. 60s comfortably covers a slow upstream and
|
|
54
|
+
/// clock skew.
|
|
55
|
+
pub const REFRESH_AHEAD_SECS: u64 = 60;
|
|
56
|
+
|
|
57
|
+
/// Default OAuth2 scope for Vertex / cloud-platform calls. The
|
|
58
|
+
/// `cloud-platform` scope is the broadest and is what gcloud emits
|
|
59
|
+
/// for ADC by default.
|
|
60
|
+
pub const DEFAULT_VERTEX_SCOPE: &str = "https://www.googleapis.com/auth/cloud-platform";
|
|
61
|
+
|
|
62
|
+
/// Errors fetching / refreshing an ADC bearer token. Surfaced
|
|
63
|
+
/// verbatim by the handler as structured log events plus an HTTP 5xx
|
|
64
|
+
/// response.
|
|
65
|
+
#[derive(Debug, Error)]
|
|
66
|
+
pub enum TokenSourceError {
|
|
67
|
+
/// `gcp_auth` failed to resolve any provider in the ADC chain.
|
|
68
|
+
/// Common cause: developer never ran `gcloud auth application-default
|
|
69
|
+
/// login` and no service-account JSON is in scope.
|
|
70
|
+
#[error("gcp ADC provider initialization failed: {0}")]
|
|
71
|
+
ProviderInit(String),
|
|
72
|
+
/// The provider was resolved but `.token(scopes)` failed.
|
|
73
|
+
#[error("gcp ADC token fetch failed: {0}")]
|
|
74
|
+
Fetch(String),
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/// A source of bearer tokens for Vertex calls. Production uses
|
|
78
|
+
/// [`GcpAdcTokenSource`]; tests use [`StaticTokenSource`]. There is
|
|
79
|
+
/// NO blanket impl — every concrete impl must be explicit (no silent
|
|
80
|
+
/// fallback to a "default token").
|
|
81
|
+
#[async_trait]
|
|
82
|
+
pub trait TokenSource: Send + Sync + std::fmt::Debug {
|
|
83
|
+
/// Return a non-empty bearer token suitable for the
|
|
84
|
+
/// `Authorization: Bearer <token>` header. The token is cached
|
|
85
|
+
/// internally; concurrent calls de-dup to a single fetch.
|
|
86
|
+
async fn bearer(&self) -> Result<String, TokenSourceError>;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/// Token + expiry pair held in the cache.
|
|
90
|
+
#[derive(Debug, Clone)]
|
|
91
|
+
struct CachedToken {
|
|
92
|
+
token: String,
|
|
93
|
+
expires_at: SystemTime,
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
impl CachedToken {
|
|
97
|
+
/// `true` when the token has more than `REFRESH_AHEAD_SECS` of
|
|
98
|
+
/// life left.
|
|
99
|
+
fn fresh(&self) -> bool {
|
|
100
|
+
match self.expires_at.duration_since(SystemTime::now()) {
|
|
101
|
+
Ok(remaining) => remaining > Duration::from_secs(REFRESH_AHEAD_SECS),
|
|
102
|
+
// `expires_at` already past now → not fresh.
|
|
103
|
+
Err(_) => false,
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/// Production token source backed by `gcp_auth`'s default ADC chain.
|
|
109
|
+
///
|
|
110
|
+
/// `gcp_auth::provider()` resolves lazily; the first `.bearer()` call
|
|
111
|
+
/// triggers the resolution and the result is memoized. Subsequent
|
|
112
|
+
/// calls re-use the provider and the cached token until its expiry
|
|
113
|
+
/// approaches.
|
|
114
|
+
pub struct GcpAdcTokenSource {
|
|
115
|
+
/// Configured OAuth scope. Defaults to `cloud-platform`.
|
|
116
|
+
scope: String,
|
|
117
|
+
/// Lazily-initialized provider. We wrap in a `Mutex<Option<...>>`
|
|
118
|
+
/// (rather than `OnceCell`) because the provider initialization
|
|
119
|
+
/// is fallible and we want the next call after a transient
|
|
120
|
+
/// failure to retry — not lock the cell to a permanent error.
|
|
121
|
+
provider: Mutex<Option<Arc<dyn ::gcp_auth::TokenProvider>>>,
|
|
122
|
+
/// Cached token + expiry. `Mutex` is fine here: the critical
|
|
123
|
+
/// section (compare expiry, optionally refresh) is sub-microsecond
|
|
124
|
+
/// in the cache-hit case and the refresh-miss path is rate-limited
|
|
125
|
+
/// by the upstream metadata server anyway.
|
|
126
|
+
cached: Mutex<Option<CachedToken>>,
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
impl std::fmt::Debug for GcpAdcTokenSource {
|
|
130
|
+
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
131
|
+
f.debug_struct("GcpAdcTokenSource")
|
|
132
|
+
.field("scope", &self.scope)
|
|
133
|
+
.field(
|
|
134
|
+
"provider_initialized",
|
|
135
|
+
&self
|
|
136
|
+
.provider
|
|
137
|
+
.try_lock()
|
|
138
|
+
.map(|g| g.is_some())
|
|
139
|
+
.unwrap_or(false),
|
|
140
|
+
)
|
|
141
|
+
.finish()
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
impl GcpAdcTokenSource {
|
|
146
|
+
/// Construct with the default `cloud-platform` scope. The
|
|
147
|
+
/// provider is NOT resolved here — we defer until the first
|
|
148
|
+
/// `.bearer()` call. That keeps proxy startup cheap when the
|
|
149
|
+
/// operator hasn't actually wired a Vertex route yet.
|
|
150
|
+
pub fn new() -> Self {
|
|
151
|
+
Self::with_scope(DEFAULT_VERTEX_SCOPE)
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
/// Construct with an explicit scope. Used by tests / by operators
|
|
155
|
+
/// who want a narrower scope than `cloud-platform`.
|
|
156
|
+
pub fn with_scope(scope: impl Into<String>) -> Self {
|
|
157
|
+
Self {
|
|
158
|
+
scope: scope.into(),
|
|
159
|
+
provider: Mutex::new(None),
|
|
160
|
+
cached: Mutex::new(None),
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/// Resolve the provider lazily. On success, stores it for re-use
|
|
165
|
+
/// and returns a clone of the `Arc`. On failure, returns the
|
|
166
|
+
/// error verbatim — the next call retries (no permanent lock).
|
|
167
|
+
async fn ensure_provider(
|
|
168
|
+
&self,
|
|
169
|
+
) -> Result<Arc<dyn ::gcp_auth::TokenProvider>, TokenSourceError> {
|
|
170
|
+
let mut guard = self.provider.lock().await;
|
|
171
|
+
if let Some(p) = guard.as_ref() {
|
|
172
|
+
return Ok(p.clone());
|
|
173
|
+
}
|
|
174
|
+
let provider = ::gcp_auth::provider()
|
|
175
|
+
.await
|
|
176
|
+
.map_err(|e| TokenSourceError::ProviderInit(e.to_string()))?;
|
|
177
|
+
*guard = Some(provider.clone());
|
|
178
|
+
Ok(provider)
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
impl Default for GcpAdcTokenSource {
|
|
183
|
+
fn default() -> Self {
|
|
184
|
+
Self::new()
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
#[async_trait]
|
|
189
|
+
impl TokenSource for GcpAdcTokenSource {
|
|
190
|
+
async fn bearer(&self) -> Result<String, TokenSourceError> {
|
|
191
|
+
// Fast path: cached + fresh.
|
|
192
|
+
{
|
|
193
|
+
let guard = self.cached.lock().await;
|
|
194
|
+
if let Some(c) = guard.as_ref() {
|
|
195
|
+
if c.fresh() {
|
|
196
|
+
return Ok(c.token.clone());
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
// Slow path: refresh. We re-take the lock around the fetch
|
|
202
|
+
// so concurrent callers serialize on a single network round
|
|
203
|
+
// trip (rather than thundering-herd the metadata server).
|
|
204
|
+
let mut guard = self.cached.lock().await;
|
|
205
|
+
// Double-check inside the lock — another waiter may have
|
|
206
|
+
// refreshed while we were queued.
|
|
207
|
+
if let Some(c) = guard.as_ref() {
|
|
208
|
+
if c.fresh() {
|
|
209
|
+
return Ok(c.token.clone());
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
let provider = self.ensure_provider().await?;
|
|
214
|
+
let scopes = [self.scope.as_str()];
|
|
215
|
+
let token = provider
|
|
216
|
+
.token(&scopes)
|
|
217
|
+
.await
|
|
218
|
+
.map_err(|e| TokenSourceError::Fetch(e.to_string()))?;
|
|
219
|
+
let token_str = token.as_str().to_string();
|
|
220
|
+
// `gcp_auth::Token::expires_at()` returns a `chrono::DateTime<Utc>`.
|
|
221
|
+
// Convert to `SystemTime` via the UNIX timestamp; `chrono` clamps
|
|
222
|
+
// to its valid range so this never panics. Negative timestamps
|
|
223
|
+
// (pre-epoch) are not legal for token expiries; if encountered we
|
|
224
|
+
// treat the token as already expired so the next call refreshes.
|
|
225
|
+
let expires_at = {
|
|
226
|
+
let dt = token.expires_at();
|
|
227
|
+
let unix_ts = dt.timestamp();
|
|
228
|
+
if unix_ts < 0 {
|
|
229
|
+
tracing::warn!(
|
|
230
|
+
event = "vertex_adc_token_negative_expiry",
|
|
231
|
+
expires_at_unix = unix_ts,
|
|
232
|
+
"gcp_auth token expires_at is pre-epoch; treating as already-expired"
|
|
233
|
+
);
|
|
234
|
+
SystemTime::UNIX_EPOCH
|
|
235
|
+
} else {
|
|
236
|
+
SystemTime::UNIX_EPOCH + Duration::from_secs(unix_ts as u64)
|
|
237
|
+
}
|
|
238
|
+
};
|
|
239
|
+
let lifetime_remaining = expires_at
|
|
240
|
+
.duration_since(SystemTime::now())
|
|
241
|
+
.map(|d| d.as_secs())
|
|
242
|
+
.unwrap_or(0);
|
|
243
|
+
tracing::info!(
|
|
244
|
+
event = "vertex_adc_token_refreshed",
|
|
245
|
+
scope = %self.scope,
|
|
246
|
+
lifetime_remaining_secs = lifetime_remaining,
|
|
247
|
+
"vertex ADC bearer token refreshed"
|
|
248
|
+
);
|
|
249
|
+
*guard = Some(CachedToken {
|
|
250
|
+
token: token_str.clone(),
|
|
251
|
+
expires_at,
|
|
252
|
+
});
|
|
253
|
+
Ok(token_str)
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
/// Static-token mock for tests. Production callers MUST NOT
|
|
258
|
+
/// instantiate this — there is no fallback to a default value, and
|
|
259
|
+
/// the test harness wires it explicitly.
|
|
260
|
+
#[derive(Debug, Clone)]
|
|
261
|
+
pub struct StaticTokenSource {
|
|
262
|
+
token: String,
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
impl StaticTokenSource {
|
|
266
|
+
pub fn new(token: impl Into<String>) -> Self {
|
|
267
|
+
Self {
|
|
268
|
+
token: token.into(),
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
#[async_trait]
|
|
274
|
+
impl TokenSource for StaticTokenSource {
|
|
275
|
+
async fn bearer(&self) -> Result<String, TokenSourceError> {
|
|
276
|
+
Ok(self.token.clone())
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
#[cfg(test)]
|
|
281
|
+
mod tests {
|
|
282
|
+
use super::*;
|
|
283
|
+
|
|
284
|
+
#[tokio::test]
|
|
285
|
+
async fn static_token_source_returns_token() {
|
|
286
|
+
let src = StaticTokenSource::new("test-bearer-abc123");
|
|
287
|
+
let t = src.bearer().await.expect("bearer");
|
|
288
|
+
assert_eq!(t, "test-bearer-abc123");
|
|
289
|
+
// Multiple calls return the same value.
|
|
290
|
+
let t2 = src.bearer().await.expect("bearer 2");
|
|
291
|
+
assert_eq!(t2, "test-bearer-abc123");
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
#[test]
|
|
295
|
+
fn cached_token_freshness_window() {
|
|
296
|
+
let now = SystemTime::now();
|
|
297
|
+
let fresh = CachedToken {
|
|
298
|
+
token: "x".into(),
|
|
299
|
+
expires_at: now + Duration::from_secs(REFRESH_AHEAD_SECS + 30),
|
|
300
|
+
};
|
|
301
|
+
assert!(fresh.fresh());
|
|
302
|
+
|
|
303
|
+
let stale = CachedToken {
|
|
304
|
+
token: "x".into(),
|
|
305
|
+
expires_at: now + Duration::from_secs(REFRESH_AHEAD_SECS - 1),
|
|
306
|
+
};
|
|
307
|
+
assert!(!stale.fresh());
|
|
308
|
+
|
|
309
|
+
let already_expired = CachedToken {
|
|
310
|
+
token: "x".into(),
|
|
311
|
+
expires_at: now - Duration::from_secs(1),
|
|
312
|
+
};
|
|
313
|
+
assert!(!already_expired.fresh());
|
|
314
|
+
}
|
|
315
|
+
}
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
//! Vertex publisher envelope parser.
|
|
2
|
+
//!
|
|
3
|
+
//! Vertex's Anthropic publisher path takes a body shaped almost
|
|
4
|
+
//! identically to the Anthropic Messages API, with two differences:
|
|
5
|
+
//!
|
|
6
|
+
//! 1. The body MUST contain `anthropic_version` (e.g. `"vertex-2023-10-16"`).
|
|
7
|
+
//! 2. The body MUST NOT contain `model` — the model id travels in
|
|
8
|
+
//! the URL path.
|
|
9
|
+
//!
|
|
10
|
+
//! We treat any other shape as wire-format drift: log loudly and
|
|
11
|
+
//! forward unmodified. This module's only job is to detect/confirm
|
|
12
|
+
//! the envelope shape so the handler decides whether the live-zone
|
|
13
|
+
//! Anthropic dispatcher should run. We never strip or rewrite
|
|
14
|
+
//! `anthropic_version`.
|
|
15
|
+
//!
|
|
16
|
+
//! # Performance note
|
|
17
|
+
//!
|
|
18
|
+
//! The envelope check uses `serde_json::from_slice::<Value>` once.
|
|
19
|
+
//! That's the same cost the live-zone dispatcher already pays; we're
|
|
20
|
+
//! not adding a parse, we're hoisting one read of two top-level keys
|
|
21
|
+
//! up before dispatching. No body clone — the parsed `Value` is
|
|
22
|
+
//! discarded and the dispatcher re-parses for byte-faithful surgery
|
|
23
|
+
//! (which uses `RawValue` to preserve exact bytes).
|
|
24
|
+
|
|
25
|
+
use serde_json::Value;
|
|
26
|
+
use thiserror::Error;
|
|
27
|
+
|
|
28
|
+
/// Errors detecting the Vertex envelope. None are panics; the handler
|
|
29
|
+
/// surfaces these as structured log events plus an HTTP error response.
|
|
30
|
+
#[derive(Debug, Error)]
|
|
31
|
+
pub enum VertexEnvelopeError {
|
|
32
|
+
#[error("body is not valid JSON: {0}")]
|
|
33
|
+
NotJson(#[from] serde_json::Error),
|
|
34
|
+
#[error("body is not a JSON object")]
|
|
35
|
+
NotObject,
|
|
36
|
+
#[error("body missing required field `anthropic_version`")]
|
|
37
|
+
MissingAnthropicVersion,
|
|
38
|
+
#[error(
|
|
39
|
+
"body has unexpected `model` field; Vertex carries the model in the URL path \
|
|
40
|
+
(got model={got:?})"
|
|
41
|
+
)]
|
|
42
|
+
UnexpectedModelField { got: String },
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/// Parsed-once view of the envelope's two distinguishing fields. The
|
|
46
|
+
/// dispatcher does not read the rest of the body through this struct —
|
|
47
|
+
/// it re-parses with `RawValue` for byte-faithful surgery.
|
|
48
|
+
#[derive(Debug, Clone)]
|
|
49
|
+
pub struct ParsedEnvelope {
|
|
50
|
+
/// Value of the `anthropic_version` field as it appeared in the
|
|
51
|
+
/// body. We do NOT validate against an allowlist — Vertex may
|
|
52
|
+
/// roll new versions without our involvement.
|
|
53
|
+
pub anthropic_version: String,
|
|
54
|
+
/// `true` if the body has at least one `messages[*]` entry.
|
|
55
|
+
/// Diagnostic only; the dispatcher walks `messages` independently.
|
|
56
|
+
pub has_messages: bool,
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/// Parse and validate the envelope. On success returns the
|
|
60
|
+
/// distinguishing-field view. On failure returns a structured error
|
|
61
|
+
/// the handler converts to a log event + HTTP response.
|
|
62
|
+
pub fn parse(body: &[u8]) -> Result<ParsedEnvelope, VertexEnvelopeError> {
|
|
63
|
+
let parsed: Value = serde_json::from_slice(body)?;
|
|
64
|
+
let obj = match parsed {
|
|
65
|
+
Value::Object(map) => map,
|
|
66
|
+
_ => return Err(VertexEnvelopeError::NotObject),
|
|
67
|
+
};
|
|
68
|
+
|
|
69
|
+
let anthropic_version = match obj.get("anthropic_version") {
|
|
70
|
+
Some(Value::String(s)) => s.clone(),
|
|
71
|
+
Some(other) => {
|
|
72
|
+
// Wire format says string; surface drift loudly. We still
|
|
73
|
+
// accept by stringifying so we don't reject novel
|
|
74
|
+
// representations Vertex might roll out — but log a
|
|
75
|
+
// structured event upstream of this call so operators
|
|
76
|
+
// see it. The handler is responsible for the warn log.
|
|
77
|
+
other.to_string()
|
|
78
|
+
}
|
|
79
|
+
None => return Err(VertexEnvelopeError::MissingAnthropicVersion),
|
|
80
|
+
};
|
|
81
|
+
|
|
82
|
+
if let Some(model) = obj.get("model") {
|
|
83
|
+
let got = match model {
|
|
84
|
+
Value::String(s) => s.clone(),
|
|
85
|
+
other => other.to_string(),
|
|
86
|
+
};
|
|
87
|
+
return Err(VertexEnvelopeError::UnexpectedModelField { got });
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
let has_messages = matches!(obj.get("messages"), Some(Value::Array(arr)) if !arr.is_empty());
|
|
91
|
+
|
|
92
|
+
Ok(ParsedEnvelope {
|
|
93
|
+
anthropic_version,
|
|
94
|
+
has_messages,
|
|
95
|
+
})
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
#[cfg(test)]
|
|
99
|
+
mod tests {
|
|
100
|
+
use super::*;
|
|
101
|
+
use serde_json::json;
|
|
102
|
+
|
|
103
|
+
#[test]
|
|
104
|
+
fn parses_minimal_envelope() {
|
|
105
|
+
let body = json!({
|
|
106
|
+
"anthropic_version": "vertex-2023-10-16",
|
|
107
|
+
"messages": [{"role": "user", "content": "hi"}],
|
|
108
|
+
"max_tokens": 64,
|
|
109
|
+
});
|
|
110
|
+
let bytes = serde_json::to_vec(&body).unwrap();
|
|
111
|
+
let env = parse(&bytes).expect("parse");
|
|
112
|
+
assert_eq!(env.anthropic_version, "vertex-2023-10-16");
|
|
113
|
+
assert!(env.has_messages);
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
#[test]
|
|
117
|
+
fn rejects_missing_anthropic_version() {
|
|
118
|
+
let body = json!({
|
|
119
|
+
"messages": [{"role": "user", "content": "hi"}],
|
|
120
|
+
});
|
|
121
|
+
let bytes = serde_json::to_vec(&body).unwrap();
|
|
122
|
+
let err = parse(&bytes).unwrap_err();
|
|
123
|
+
assert!(matches!(err, VertexEnvelopeError::MissingAnthropicVersion));
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
#[test]
|
|
127
|
+
fn rejects_model_field_present() {
|
|
128
|
+
let body = json!({
|
|
129
|
+
"anthropic_version": "vertex-2023-10-16",
|
|
130
|
+
"model": "claude-3-5-sonnet",
|
|
131
|
+
"messages": [],
|
|
132
|
+
});
|
|
133
|
+
let bytes = serde_json::to_vec(&body).unwrap();
|
|
134
|
+
let err = parse(&bytes).unwrap_err();
|
|
135
|
+
match err {
|
|
136
|
+
VertexEnvelopeError::UnexpectedModelField { got } => {
|
|
137
|
+
assert_eq!(got, "claude-3-5-sonnet");
|
|
138
|
+
}
|
|
139
|
+
other => panic!("wrong error: {other:?}"),
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
#[test]
|
|
144
|
+
fn rejects_non_object_body() {
|
|
145
|
+
let bytes = b"[1,2,3]";
|
|
146
|
+
let err = parse(bytes).unwrap_err();
|
|
147
|
+
assert!(matches!(err, VertexEnvelopeError::NotObject));
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
#[test]
|
|
151
|
+
fn rejects_invalid_json() {
|
|
152
|
+
let bytes = b"not json at all {{";
|
|
153
|
+
let err = parse(bytes).unwrap_err();
|
|
154
|
+
assert!(matches!(err, VertexEnvelopeError::NotJson(_)));
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
#[test]
|
|
158
|
+
fn empty_messages_array_marks_has_messages_false() {
|
|
159
|
+
let body = json!({
|
|
160
|
+
"anthropic_version": "vertex-2023-10-16",
|
|
161
|
+
"messages": [],
|
|
162
|
+
});
|
|
163
|
+
let bytes = serde_json::to_vec(&body).unwrap();
|
|
164
|
+
let env = parse(&bytes).unwrap();
|
|
165
|
+
assert!(!env.has_messages);
|
|
166
|
+
}
|
|
167
|
+
}
|