amv-sentinel-risk-core
v2.4.0
Published
Deterministic rule evaluation engine and policy compiler for AMEVA Sentinel
Maintainers
Readme
amv-sentinel-risk-core
The engine underneath @amv/sentinel: bot classification, risk rules, GEO delivery, and token verification — zero framework dependency.
Most integrations should use @amv/sentinel instead; install this package directly if you need the primitives without the Sentinel class wrapper.
Features
- 43-signature bot classifier (
classifyBot) — search engines, AI agents (GPTBot→OpenAI, ClaudeBot→Anthropic, PerplexityBot, and more), social-preview bots, uptime monitors, feed fetchers, and scripting clients (curl, python-requests, Playwright, Selenium, ...). Verified against all 43 signatures plus a real-browser control case with zero misclassifications. - 8-rule risk engine (
evaluateRisk) — webdriver detection, burst-rate limiting, trusted-input absence, touch/UA mismatch, headless-fingerprint checks, HTTP header-completeness checks. 0–100 clamped scoring withdeepFreezed, immutable output and structured evidence per rule. GeoDeliveryEngine— route-matched byte-savings math (resolveGeoPayloadCore/calculateBandwidthSavings/matchRouteBaseline) for serving AI crawlers a markdown payload instead of a full page, with a real measured baseline comparison (not a synthesized savings figure).- Two token-verification schemes — a simple
v1.*HMAC scheme, and an additivesv1.*scheme (StaticKeyResolver/MemoryNonceStore/verifyCollectorToken) with audience/purpose/issuer binding and single-use nonce replay protection. - Bounded in-memory stores —
MemoryFixedWindowCounterStore/MemoryRiskEventStoreboth cap their memory footprint and evict rather than growing unbounded under a high-cardinality key space. resolveAdminAccess()— view-only-by-default admin dashboard access gating.- An orthogonal Multi-Axis Cost Guard subsystem (
SentinelCostGuardEvaluator,RequestShapeGuard,TrustedProxyPolicy) for pagination/time-series query budget abuse — unrelated to bot triage, used by the framework adapters in@amv/sentinel.
License
Apache-2.0 © 2026 AMEVA Open Source Ecosystem.
