Repository navigation
v0.9.0 — Retry-After, Multi-Secret Rotation, Endpoint Verification
What's New in v0.9.0
Three production-grade features for enterprise webhook delivery.
1. Retry-After Header Support (RFC 7231)
When a downstream server returns 429/503 with a Retry-After header, the engine now:
- Parses both integer-seconds (
Retry-After: 120) and HTTP-date formats - Uses the server-requested delay instead of computed backoff
- Clamps the delay to
max_delay_secondsfor safety - Stores
retry_after_secondsin the attempt metadata
2. Multi-Secret Rotation (Zero-Downtime Key Rotation)
Full lifecycle HMAC signing key rotation via SecretRotationManager:
- initiate — demotes current primary to 'previous', promotes new secret to 'rotating'
- verify — confirms new secret working, retires old with 24h grace period
- complete — cleans up expired retired secrets
- Old secrets remain valid for incoming verification during grace period
- Cancel mid-rotation reverts to previous primary
3. Endpoint Verification Challenge
Prove endpoint ownership before activation via ChallengeManager:
- Generates 256-bit cryptographic random token
- Endpoint must echo token in header (
X-Webhook-Verify-Challenge) or body field - Configurable: location (header/body/either), TTL (default 10min), max attempts (default 3)
- Constant-time token comparison prevents timing attacks
Stats
- MCP tools: 73 → 82 (+9 new)
- Tests: 661 → 743 (+82 new)
- New modules:
secret_rotation.py,verification.py - New model field:
DeliveryAttempt.metadata