twinmind-rate-limits

# TwinMind Rate Limits ## Overview Handle TwinMind rate limits gracefully with exponential backoff and request optimization. ## Prerequisites - TwinMind API access (Pro/Enterprise) - Understanding of async/await patterns - Familiarity with rate limiting concepts ## Instructions ### Step 1: Understand Rate Limit Tiers | Tier | Audio Hours/Month | API Requests/Min | Concurrent Transcriptions | Burst | |------|-------------------|------------------|--------------------------|-------| | Free | Unlimited | 30 | 1 | 5 | | Pro ($10/mo) | Unlimited | 60 | 3 | 15 | | Enterprise | Unlimited | 300 | 10 | 50 | **Key Limits:** - Transcription: Based on audio duration ($0.23/hour with Ear-3) - AI Operations: Token-based (2M context for Pro) - Summarization: 10/minute (Free), 30/minute (Pro) - Memory Search: 60/minute (Free), 300/minute (Pro) ### Step 2: Implement Exponential Backoff with Jitter ```typescript // src/twinmind/rate-limit.ts interface RateLimitConfig { maxRetries: number; baseDelayMs: number; maxDelayMs: number; jitterMs: number; } const defaultConfig: RateLimitConfig = { maxRetries: 5, baseDelayMs: 1000, # 1000: 1 second in ms maxDelayMs: 60000, // Max 1 minute # 60000: 1 minute in ms jitterMs: 500, # HTTP 500 Internal Server Error }; export async function withRateLimit<T>( operation: () => Promise<T>, config: Partial<RateLimitConfig> = {} ): Promise<T> { const { maxRetries, baseDelayMs, maxDelayMs, jitterMs } = { ...defaultConfig, ....