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,66 @@
|
|
|
1
|
+
//! Native AWS Bedrock InvokeModel route — Phase D PR-D1.
|
|
2
|
+
//!
|
|
3
|
+
//! # Why a separate module?
|
|
4
|
+
//!
|
|
5
|
+
//! The Python proxy currently routes Anthropic-on-Bedrock through the
|
|
6
|
+
//! `litellm` shim (`headroom/backends/litellm.py`). That shim
|
|
7
|
+
//! lossy-converts every request and response between Anthropic and
|
|
8
|
+
//! OpenAI shapes, dropping `thinking`, `redacted_thinking`,
|
|
9
|
+
//! `document`, `search_result`, `image`, `server_tool_use`, and
|
|
10
|
+
//! `mcp_tool_use` blocks (P4-37). It also hardcodes
|
|
11
|
+
//! `stop_sequence: null` (§11.1 violation) and re-wraps
|
|
12
|
+
//! `function_call.arguments` as a parsed JSON object (§4.4 — P4-43).
|
|
13
|
+
//!
|
|
14
|
+
//! Phase D rebuilds the Bedrock surface natively in Rust. PR-D1
|
|
15
|
+
//! handles the **non-streaming** `POST /model/{model}/invoke` route:
|
|
16
|
+
//!
|
|
17
|
+
//! 1. Parse the Bedrock envelope (`{"anthropic_version": "...",
|
|
18
|
+
//! ...rest_of_anthropic_body}`).
|
|
19
|
+
//! 2. Route Anthropic-shape bodies through the live-zone compression
|
|
20
|
+
//! path (the same one `/v1/messages` uses).
|
|
21
|
+
//! 3. Re-emit the envelope with `anthropic_version` preserved as the
|
|
22
|
+
//! first key — Bedrock is strict about schema validation.
|
|
23
|
+
//! 4. Sign the **outgoing** body bytes with AWS SigV4 (after
|
|
24
|
+
//! compression) and forward to the configured Bedrock endpoint.
|
|
25
|
+
//!
|
|
26
|
+
//! # Cache safety
|
|
27
|
+
//!
|
|
28
|
+
//! The signed bytes are exactly the bytes Bedrock receives. If the
|
|
29
|
+
//! compressor mutated the body, the SigV4 signature is computed
|
|
30
|
+
//! against the post-compression bytes; the upstream verifier will
|
|
31
|
+
//! accept them. There is no "sign before compress" path — that would
|
|
32
|
+
//! produce a signature that doesn't match the wire payload.
|
|
33
|
+
//!
|
|
34
|
+
//! # Module layout
|
|
35
|
+
//!
|
|
36
|
+
//! - [`envelope`] — `BedrockEnvelope` parse + emit (preserves
|
|
37
|
+
//! `anthropic_version` ordering byte-equal).
|
|
38
|
+
//! - [`sigv4`] — AWS SigV4 signing helper. Wraps the `aws-sigv4`
|
|
39
|
+
//! crate with the project's no-fallback / structured-logging
|
|
40
|
+
//! policy.
|
|
41
|
+
//! - [`invoke`] — POST handler for `/model/{model}/invoke`.
|
|
42
|
+
//!
|
|
43
|
+
//! Streaming (`/model/{model}/invoke-with-response-stream`) is
|
|
44
|
+
//! handled by [`invoke_streaming`] in PR-D2. Binary EventStream
|
|
45
|
+
//! parsing is in [`eventstream`]; the SSE translator is in
|
|
46
|
+
//! [`eventstream_to_sse`].
|
|
47
|
+
|
|
48
|
+
pub mod auth_mode_layer;
|
|
49
|
+
pub mod envelope;
|
|
50
|
+
pub mod eventstream;
|
|
51
|
+
pub mod eventstream_to_sse;
|
|
52
|
+
pub mod invoke;
|
|
53
|
+
pub mod invoke_streaming;
|
|
54
|
+
pub mod sigv4;
|
|
55
|
+
pub mod vendor;
|
|
56
|
+
|
|
57
|
+
pub use auth_mode_layer::classify_and_attach_auth_mode;
|
|
58
|
+
pub use envelope::{BedrockEnvelope, EnvelopeError};
|
|
59
|
+
pub use eventstream::{
|
|
60
|
+
parse as parse_eventstream, CrcValidation, EventStreamMessage, EventStreamParser, HeaderValue,
|
|
61
|
+
MessageBuilder, ParseError,
|
|
62
|
+
};
|
|
63
|
+
pub use eventstream_to_sse::{translate_message, OutputMode, TranslateError, TranslateOutcome};
|
|
64
|
+
pub use invoke::handle_invoke;
|
|
65
|
+
pub use invoke_streaming::handle_invoke_streaming;
|
|
66
|
+
pub use sigv4::{sign_request, SigV4Error, SigningInputs};
|
|
@@ -0,0 +1,324 @@
|
|
|
1
|
+
//! AWS SigV4 request signing for the Bedrock InvokeModel route.
|
|
2
|
+
//!
|
|
3
|
+
//! # What this module does
|
|
4
|
+
//!
|
|
5
|
+
//! Wraps the `aws-sigv4` crate with the project's policies:
|
|
6
|
+
//!
|
|
7
|
+
//! - **No silent fallbacks.** A failed sign-attempt returns a
|
|
8
|
+
//! structured error; the handler surfaces 5xx and logs an event.
|
|
9
|
+
//! We NEVER forward an unsigned request to Bedrock, because the
|
|
10
|
+
//! AWS endpoint will reject anyway and the user would see an
|
|
11
|
+
//! opaque 403.
|
|
12
|
+
//! - **Body bytes are hashed AFTER compression.** The signing
|
|
13
|
+
//! inputs include a `&[u8]` that is the EXACT byte slice the
|
|
14
|
+
//! forwarder will send upstream. There is no separate "hash the
|
|
15
|
+
//! pre-compression body" code path.
|
|
16
|
+
//! - **Structured logs at every decision point.** Every code path
|
|
17
|
+
//! emits `tracing::info!`/`warn!` with an `event = ...` field so
|
|
18
|
+
//! operators can confirm signing happened.
|
|
19
|
+
//!
|
|
20
|
+
//! # What this module deliberately does NOT do
|
|
21
|
+
//!
|
|
22
|
+
//! - It does not resolve credentials — that's `aws-config`'s job and
|
|
23
|
+
//! happens at app-startup time so per-request signing is cheap.
|
|
24
|
+
//! The handler holds the resolved [`aws_credential_types::Credentials`]
|
|
25
|
+
//! in `AppState` and passes them in.
|
|
26
|
+
//! - It does not buffer the body — callers buffer the body in the
|
|
27
|
+
//! compression gate (it's the same byte slice).
|
|
28
|
+
//! - It does not handle SigV4a (the cross-region variant). Bedrock
|
|
29
|
+
//! uses standard SigV4 per region.
|
|
30
|
+
|
|
31
|
+
use std::time::SystemTime;
|
|
32
|
+
|
|
33
|
+
use aws_credential_types::Credentials;
|
|
34
|
+
use aws_sigv4::http_request::{
|
|
35
|
+
sign, PayloadChecksumKind, SignableBody, SignableRequest, SigningSettings,
|
|
36
|
+
};
|
|
37
|
+
use aws_sigv4::sign::v4;
|
|
38
|
+
use aws_smithy_runtime_api::client::identity::Identity;
|
|
39
|
+
use thiserror::Error;
|
|
40
|
+
use url::Url;
|
|
41
|
+
|
|
42
|
+
/// AWS service name used in the SigV4 string-to-sign for Bedrock.
|
|
43
|
+
/// Documented at
|
|
44
|
+
/// <https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam.html>
|
|
45
|
+
pub const BEDROCK_SERVICE_NAME: &str = "bedrock";
|
|
46
|
+
|
|
47
|
+
/// Inputs needed to sign a Bedrock request. Borrows the body so we
|
|
48
|
+
/// avoid a copy on the hot path.
|
|
49
|
+
#[derive(Debug)]
|
|
50
|
+
pub struct SigningInputs<'a> {
|
|
51
|
+
/// HTTP method (always `"POST"` for InvokeModel today, but we
|
|
52
|
+
/// keep this explicit so a future GET-shaped surface doesn't
|
|
53
|
+
/// require redoing the call site).
|
|
54
|
+
pub method: &'a str,
|
|
55
|
+
/// Fully-qualified upstream URL (scheme + host + path + query).
|
|
56
|
+
/// Used for canonical-request URI normalization.
|
|
57
|
+
pub url: &'a Url,
|
|
58
|
+
/// AWS region the upstream endpoint lives in.
|
|
59
|
+
pub region: &'a str,
|
|
60
|
+
/// AWS credentials (resolved from the `aws-config` default chain
|
|
61
|
+
/// at app-startup time).
|
|
62
|
+
pub credentials: &'a Credentials,
|
|
63
|
+
/// Body bytes to sign. MUST be the exact bytes the forwarder
|
|
64
|
+
/// will send to Bedrock (post-compression).
|
|
65
|
+
pub body: &'a [u8],
|
|
66
|
+
/// Extra headers the canonical request must include in the
|
|
67
|
+
/// signed-headers list. The signer always includes `host`,
|
|
68
|
+
/// `x-amz-date`, and `x-amz-content-sha256`; callers add
|
|
69
|
+
/// anything else they want covered (e.g. `accept-encoding`,
|
|
70
|
+
/// `content-type`).
|
|
71
|
+
pub extra_signed_headers: &'a [(&'a str, &'a str)],
|
|
72
|
+
/// Time to use in the signature. Production uses
|
|
73
|
+
/// `SystemTime::now()`; tests pin a known time to make the
|
|
74
|
+
/// canonical request deterministic.
|
|
75
|
+
pub time: SystemTime,
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/// Headers that the signer will write into the outbound request.
|
|
79
|
+
/// The handler must add every entry to the upstream-bound HeaderMap
|
|
80
|
+
/// before sending — Bedrock validates each header against the
|
|
81
|
+
/// canonical request.
|
|
82
|
+
#[derive(Debug, Clone)]
|
|
83
|
+
pub struct SignedHeaders {
|
|
84
|
+
pub entries: Vec<(String, String)>,
|
|
85
|
+
/// Lowercase hex SHA-256 of the body. Surfaced for tests + logs.
|
|
86
|
+
pub signature: String,
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/// Errors surfaced by the signing path.
|
|
90
|
+
#[derive(Debug, Error)]
|
|
91
|
+
pub enum SigV4Error {
|
|
92
|
+
/// `aws-sigv4` rejected the request (URL parse, malformed header,
|
|
93
|
+
/// etc).
|
|
94
|
+
#[error("sigv4 signing failed: {0}")]
|
|
95
|
+
Sign(String),
|
|
96
|
+
/// The signing-params builder rejected the inputs (e.g. missing
|
|
97
|
+
/// region — should never happen because we validate at startup).
|
|
98
|
+
#[error("sigv4 builder error: {0}")]
|
|
99
|
+
Builder(String),
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/// Sign a Bedrock request and return the headers the handler must add
|
|
103
|
+
/// to the outbound request.
|
|
104
|
+
///
|
|
105
|
+
/// # Cache safety
|
|
106
|
+
///
|
|
107
|
+
/// The body bytes passed in MUST be the bytes the proxy is about to
|
|
108
|
+
/// send upstream. If the compressor mutated the body, those mutated
|
|
109
|
+
/// bytes are what get signed — Bedrock will accept because the
|
|
110
|
+
/// signature covers the wire payload, not the original.
|
|
111
|
+
///
|
|
112
|
+
/// # Errors
|
|
113
|
+
///
|
|
114
|
+
/// Returns [`SigV4Error::Sign`] when `aws-sigv4` rejects the request
|
|
115
|
+
/// (malformed URL, etc). Returns [`SigV4Error::Builder`] when the
|
|
116
|
+
/// signing-params builder rejects the inputs.
|
|
117
|
+
pub fn sign_request(inputs: &SigningInputs<'_>) -> Result<SignedHeaders, SigV4Error> {
|
|
118
|
+
// Build the identity wrapper around the credentials. Identity is
|
|
119
|
+
// the type the SigV4 signer accepts; it can in principle hold
|
|
120
|
+
// alternative auth schemes (Bearer, etc) but we only ever use it
|
|
121
|
+
// for AWS creds.
|
|
122
|
+
let identity: Identity = Identity::new(inputs.credentials.clone(), None);
|
|
123
|
+
|
|
124
|
+
// Default settings + force `x-amz-content-sha256` into the
|
|
125
|
+
// canonical request. Bedrock validates the content hash to
|
|
126
|
+
// catch any in-flight body mutation; with `NoHeader` (the
|
|
127
|
+
// crate-level default) the signer would skip the header,
|
|
128
|
+
// which means a downstream gateway that DOES check it would
|
|
129
|
+
// 403.
|
|
130
|
+
let mut settings = SigningSettings::default();
|
|
131
|
+
settings.payload_checksum_kind = PayloadChecksumKind::XAmzSha256;
|
|
132
|
+
|
|
133
|
+
let signing_params = v4::SigningParams::builder()
|
|
134
|
+
.identity(&identity)
|
|
135
|
+
.region(inputs.region)
|
|
136
|
+
.name(BEDROCK_SERVICE_NAME)
|
|
137
|
+
.time(inputs.time)
|
|
138
|
+
.settings(settings)
|
|
139
|
+
.build()
|
|
140
|
+
.map_err(|e| SigV4Error::Builder(e.to_string()))?
|
|
141
|
+
.into();
|
|
142
|
+
|
|
143
|
+
// The signer needs the URL as a string; Url's Display impl is
|
|
144
|
+
// canonical RFC 3986 form which is what aws-sigv4 expects.
|
|
145
|
+
let url_string = inputs.url.to_string();
|
|
146
|
+
|
|
147
|
+
let signable = SignableRequest::new(
|
|
148
|
+
inputs.method,
|
|
149
|
+
url_string,
|
|
150
|
+
inputs.extra_signed_headers.iter().copied(),
|
|
151
|
+
SignableBody::Bytes(inputs.body),
|
|
152
|
+
)
|
|
153
|
+
.map_err(|e| SigV4Error::Sign(e.to_string()))?;
|
|
154
|
+
|
|
155
|
+
let signing_output =
|
|
156
|
+
sign(signable, &signing_params).map_err(|e| SigV4Error::Sign(e.to_string()))?;
|
|
157
|
+
|
|
158
|
+
let signature = signing_output.signature().to_string();
|
|
159
|
+
let (instructions, _signature) = signing_output.into_parts();
|
|
160
|
+
let (header_entries, _query_params) = instructions.into_parts();
|
|
161
|
+
let entries = header_entries
|
|
162
|
+
.into_iter()
|
|
163
|
+
.map(|h| (h.name().to_string(), h.value().to_string()))
|
|
164
|
+
.collect::<Vec<_>>();
|
|
165
|
+
|
|
166
|
+
tracing::info!(
|
|
167
|
+
event = "sigv4_signed",
|
|
168
|
+
forwarder = "rust_proxy",
|
|
169
|
+
region = inputs.region,
|
|
170
|
+
service = BEDROCK_SERVICE_NAME,
|
|
171
|
+
method = inputs.method,
|
|
172
|
+
host = inputs.url.host_str().unwrap_or(""),
|
|
173
|
+
body_bytes = inputs.body.len(),
|
|
174
|
+
headers_added = entries.len(),
|
|
175
|
+
"bedrock request signed with sigv4"
|
|
176
|
+
);
|
|
177
|
+
|
|
178
|
+
Ok(SignedHeaders { entries, signature })
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
#[cfg(test)]
|
|
182
|
+
mod tests {
|
|
183
|
+
use super::*;
|
|
184
|
+
use std::time::Duration;
|
|
185
|
+
|
|
186
|
+
fn fixed_time() -> SystemTime {
|
|
187
|
+
// 2026-05-03T12:00:00Z — pinned so canonical request is
|
|
188
|
+
// deterministic across runs.
|
|
189
|
+
SystemTime::UNIX_EPOCH + Duration::from_secs(1_777_910_400)
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
fn fixture_credentials() -> Credentials {
|
|
193
|
+
Credentials::new("AKIA_TEST", "secret_test", None, None, "test")
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
#[test]
|
|
197
|
+
fn signs_minimal_request_produces_expected_headers() {
|
|
198
|
+
let url = Url::parse(
|
|
199
|
+
"https://bedrock-runtime.us-east-1.amazonaws.com/model/anthropic.claude-3-haiku-20240307-v1:0/invoke",
|
|
200
|
+
)
|
|
201
|
+
.unwrap();
|
|
202
|
+
let creds = fixture_credentials();
|
|
203
|
+
let body = br#"{"anthropic_version":"bedrock-2023-05-31","max_tokens":16,"messages":[]}"#;
|
|
204
|
+
let inputs = SigningInputs {
|
|
205
|
+
method: "POST",
|
|
206
|
+
url: &url,
|
|
207
|
+
region: "us-east-1",
|
|
208
|
+
credentials: &creds,
|
|
209
|
+
body,
|
|
210
|
+
extra_signed_headers: &[("content-type", "application/json")],
|
|
211
|
+
time: fixed_time(),
|
|
212
|
+
};
|
|
213
|
+
let signed = sign_request(&inputs).expect("sigv4 sign");
|
|
214
|
+
// The signer always emits `authorization`, `x-amz-date`, and
|
|
215
|
+
// `x-amz-content-sha256`. Confirm all three are present.
|
|
216
|
+
let names: Vec<String> = signed
|
|
217
|
+
.entries
|
|
218
|
+
.iter()
|
|
219
|
+
.map(|(k, _)| k.to_ascii_lowercase())
|
|
220
|
+
.collect();
|
|
221
|
+
assert!(
|
|
222
|
+
names.iter().any(|n| n == "authorization"),
|
|
223
|
+
"must add authorization; got {names:?}"
|
|
224
|
+
);
|
|
225
|
+
assert!(
|
|
226
|
+
names.iter().any(|n| n == "x-amz-date"),
|
|
227
|
+
"must add x-amz-date"
|
|
228
|
+
);
|
|
229
|
+
assert!(
|
|
230
|
+
names.iter().any(|n| n == "x-amz-content-sha256"),
|
|
231
|
+
"must add x-amz-content-sha256"
|
|
232
|
+
);
|
|
233
|
+
assert_eq!(signed.signature.len(), 64, "sigv4 signature is 32-byte hex");
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
#[test]
|
|
237
|
+
fn signature_is_deterministic_for_fixed_inputs() {
|
|
238
|
+
let url = Url::parse(
|
|
239
|
+
"https://bedrock-runtime.us-east-1.amazonaws.com/model/anthropic.claude-3-haiku-20240307-v1:0/invoke",
|
|
240
|
+
)
|
|
241
|
+
.unwrap();
|
|
242
|
+
let creds = fixture_credentials();
|
|
243
|
+
let body = br#"{"anthropic_version":"bedrock-2023-05-31","max_tokens":16}"#;
|
|
244
|
+
let mk = || SigningInputs {
|
|
245
|
+
method: "POST",
|
|
246
|
+
url: &url,
|
|
247
|
+
region: "us-east-1",
|
|
248
|
+
credentials: &creds,
|
|
249
|
+
body,
|
|
250
|
+
extra_signed_headers: &[("content-type", "application/json")],
|
|
251
|
+
time: fixed_time(),
|
|
252
|
+
};
|
|
253
|
+
let a = sign_request(&mk()).unwrap();
|
|
254
|
+
let b = sign_request(&mk()).unwrap();
|
|
255
|
+
assert_eq!(a.signature, b.signature);
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
#[test]
|
|
259
|
+
fn changing_body_changes_signature() {
|
|
260
|
+
let url = Url::parse(
|
|
261
|
+
"https://bedrock-runtime.us-east-1.amazonaws.com/model/anthropic.claude-3-haiku-20240307-v1:0/invoke",
|
|
262
|
+
)
|
|
263
|
+
.unwrap();
|
|
264
|
+
let creds = fixture_credentials();
|
|
265
|
+
let inputs_a = SigningInputs {
|
|
266
|
+
method: "POST",
|
|
267
|
+
url: &url,
|
|
268
|
+
region: "us-east-1",
|
|
269
|
+
credentials: &creds,
|
|
270
|
+
body: br#"{"anthropic_version":"bedrock-2023-05-31","max_tokens":16}"#,
|
|
271
|
+
extra_signed_headers: &[("content-type", "application/json")],
|
|
272
|
+
time: fixed_time(),
|
|
273
|
+
};
|
|
274
|
+
let inputs_b = SigningInputs {
|
|
275
|
+
body: br#"{"anthropic_version":"bedrock-2023-05-31","max_tokens":32}"#,
|
|
276
|
+
..SigningInputs {
|
|
277
|
+
method: "POST",
|
|
278
|
+
url: &url,
|
|
279
|
+
region: "us-east-1",
|
|
280
|
+
credentials: &creds,
|
|
281
|
+
body: &[],
|
|
282
|
+
extra_signed_headers: &[("content-type", "application/json")],
|
|
283
|
+
time: fixed_time(),
|
|
284
|
+
}
|
|
285
|
+
};
|
|
286
|
+
let a = sign_request(&inputs_a).unwrap();
|
|
287
|
+
let b = sign_request(&inputs_b).unwrap();
|
|
288
|
+
assert_ne!(
|
|
289
|
+
a.signature, b.signature,
|
|
290
|
+
"different body bytes must yield different signatures"
|
|
291
|
+
);
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
#[test]
|
|
295
|
+
fn changing_region_changes_signature() {
|
|
296
|
+
let url = Url::parse(
|
|
297
|
+
"https://bedrock-runtime.us-east-1.amazonaws.com/model/anthropic.claude-3-haiku-20240307-v1:0/invoke",
|
|
298
|
+
)
|
|
299
|
+
.unwrap();
|
|
300
|
+
let creds = fixture_credentials();
|
|
301
|
+
let body = br#"{"anthropic_version":"bedrock-2023-05-31"}"#;
|
|
302
|
+
let east = SigningInputs {
|
|
303
|
+
method: "POST",
|
|
304
|
+
url: &url,
|
|
305
|
+
region: "us-east-1",
|
|
306
|
+
credentials: &creds,
|
|
307
|
+
body,
|
|
308
|
+
extra_signed_headers: &[],
|
|
309
|
+
time: fixed_time(),
|
|
310
|
+
};
|
|
311
|
+
let west = SigningInputs {
|
|
312
|
+
method: "POST",
|
|
313
|
+
url: &url,
|
|
314
|
+
region: "us-west-2",
|
|
315
|
+
credentials: &creds,
|
|
316
|
+
body,
|
|
317
|
+
extra_signed_headers: &[],
|
|
318
|
+
time: fixed_time(),
|
|
319
|
+
};
|
|
320
|
+
let a = sign_request(&east).unwrap();
|
|
321
|
+
let b = sign_request(&west).unwrap();
|
|
322
|
+
assert_ne!(a.signature, b.signature);
|
|
323
|
+
}
|
|
324
|
+
}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
//! Canonical Bedrock vendor resolution.
|
|
2
|
+
//!
|
|
3
|
+
//! Bedrock model IDs are `<vendor>.<model>-<date>-<rev>` (e.g.
|
|
4
|
+
//! `anthropic.claude-3-haiku-20240307-v1:0`). Cross-region inference
|
|
5
|
+
//! profiles prepend a geo routing token before the vendor
|
|
6
|
+
//! (`eu.anthropic.…`, `us.anthropic.…`, `apac.anthropic.…`,
|
|
7
|
+
//! `global.anthropic.…`). Matching the bare `anthropic.` prefix alone
|
|
8
|
+
//! silently skips compression for those profiles, so we strip a known
|
|
9
|
+
//! geo prefix first, then take the leading dot-segment as the vendor.
|
|
10
|
+
//! Literal matching only — no regexes (project rule).
|
|
11
|
+
|
|
12
|
+
/// Cross-region inference-profile routing prefixes AWS prepends to the
|
|
13
|
+
/// vendor segment. Stripped (once) before vendor resolution. Kept to a
|
|
14
|
+
/// closed, known set so an unrelated `something.anthropic.x` id is not
|
|
15
|
+
/// mistaken for an Anthropic inference profile.
|
|
16
|
+
const GEO_PREFIXES: [&str; 4] = ["eu.", "us.", "apac.", "global."];
|
|
17
|
+
|
|
18
|
+
/// Resolve the canonical vendor of a Bedrock model id, stripping a
|
|
19
|
+
/// cross-region inference-profile geo prefix first.
|
|
20
|
+
///
|
|
21
|
+
/// `eu.anthropic.claude-…` → `anthropic`; `amazon.titan-…` → `amazon`;
|
|
22
|
+
/// `global.amazon.nova-…` → `amazon`.
|
|
23
|
+
pub fn canonical_vendor(model_id: &str) -> &str {
|
|
24
|
+
let stripped = GEO_PREFIXES
|
|
25
|
+
.iter()
|
|
26
|
+
.find_map(|p| model_id.strip_prefix(p))
|
|
27
|
+
.unwrap_or(model_id);
|
|
28
|
+
stripped.split('.').next().unwrap_or(stripped)
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/// Whether the model id is an Anthropic-shape model — a foundation
|
|
32
|
+
/// model (`anthropic.…`) or a cross-region inference profile
|
|
33
|
+
/// (`<geo>.anthropic.…`) — i.e. eligible for the live-zone Anthropic
|
|
34
|
+
/// compression + envelope pipeline.
|
|
35
|
+
pub fn is_anthropic_model_id(model_id: &str) -> bool {
|
|
36
|
+
canonical_vendor(model_id) == "anthropic"
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
#[cfg(test)]
|
|
40
|
+
mod tests {
|
|
41
|
+
use super::*;
|
|
42
|
+
|
|
43
|
+
#[test]
|
|
44
|
+
fn canonical_vendor_strips_known_cross_region_prefix() {
|
|
45
|
+
assert_eq!(
|
|
46
|
+
canonical_vendor("anthropic.claude-3-haiku-20240307-v1:0"),
|
|
47
|
+
"anthropic"
|
|
48
|
+
);
|
|
49
|
+
assert_eq!(
|
|
50
|
+
canonical_vendor("eu.anthropic.claude-haiku-4-5-20251001-v1:0"),
|
|
51
|
+
"anthropic"
|
|
52
|
+
);
|
|
53
|
+
assert_eq!(canonical_vendor("amazon.titan-text-express-v1"), "amazon");
|
|
54
|
+
assert_eq!(canonical_vendor("global.amazon.nova-lite-v1:0"), "amazon");
|
|
55
|
+
// Unknown leading token is NOT stripped — stays as its own vendor.
|
|
56
|
+
assert_eq!(canonical_vendor("random.anthropic.x"), "random");
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
#[test]
|
|
60
|
+
fn anthropic_model_id_matches_foundation_and_inference_profiles() {
|
|
61
|
+
assert!(is_anthropic_model_id(
|
|
62
|
+
"anthropic.claude-3-haiku-20240307-v1:0"
|
|
63
|
+
));
|
|
64
|
+
assert!(is_anthropic_model_id(
|
|
65
|
+
"eu.anthropic.claude-haiku-4-5-20251001-v1:0"
|
|
66
|
+
));
|
|
67
|
+
assert!(is_anthropic_model_id(
|
|
68
|
+
"us.anthropic.claude-3-5-sonnet-20241022-v2:0"
|
|
69
|
+
));
|
|
70
|
+
assert!(is_anthropic_model_id(
|
|
71
|
+
"apac.anthropic.claude-3-5-sonnet-20240620-v1:0"
|
|
72
|
+
));
|
|
73
|
+
assert!(is_anthropic_model_id(
|
|
74
|
+
"global.anthropic.claude-haiku-4-5-20251001-v1:0"
|
|
75
|
+
));
|
|
76
|
+
// Non-Anthropic vendors, including geo-prefixed, stay false.
|
|
77
|
+
assert!(!is_anthropic_model_id("amazon.titan-text-express-v1"));
|
|
78
|
+
assert!(!is_anthropic_model_id("meta.llama3-70b-instruct-v1:0"));
|
|
79
|
+
assert!(!is_anthropic_model_id("eu.amazon.nova-lite-v1:0"));
|
|
80
|
+
assert!(!is_anthropic_model_id("mistral.voxtral-mini-3b-2507"));
|
|
81
|
+
}
|
|
82
|
+
}
|