juicebox-rate-limits

Implement Juicebox rate limiting and backoff.\nUse when handling API quotas, implementing retry logic,\nor optimizing request throughput.\nTrigger with phrases like \

1. Upewnij się, że masz zainstalowane zmienne środowiskowe JUICEBOX_USERNAME i JUICEBOX_API_TOKEN. Skill wymaga Node.js 18 lub nowszej wersji oraz dostępu do narzędzia curl do inspekcji nagłówków limitów.

2. Wyzwól skill frazami zawierającymi "juicebox rate limit", "juicebox quota", "juicebox throttling" lub "juicebox backoff". Skill automatycznie aktywuje się w kontekście obsługi limitów API.

3. Skill parsuje trzy nagłówki rate limit z każdej odpowiedzi API: X-RateLimit-Limit (maksimum zapytań w oknie), X-RateLimit-Remaining (pozostałe zapytania) i X-RateLimit-Reset (czas resetowania okna). Utrzymuje bieżący widok dostępnej kwoty.

4. Implementuje token bucket limiter, który respektuje limity raportowane przez serwer Juicebox. Limity różnią się w zależności od planu subskrypcji, dlatego skill dostosowuje się do rzeczywistych ograniczeń Twojego konta.

5. Obsługuje exponential backoff z jitterem dla automatycznego odzyskiwania po błędzie 429 (Too Many Requests). Nagłówek Retry-After jest parsowany i respektowany, aby uniknąć kolejnych błędów.

6. Zarządza kolejką priorytetową dla operacji bulk sourcing, umożliwiając efektywne przetwarzanie dużych ilości danych bez przekraczania limitów. Śledzi kwoty w czasie rzeczywistym dla endpointów search i enrichment oddzielnie.