gamma-performance-tuning

# Gamma Performance Tuning ## Overview Optimize Gamma API integration performance. Gamma's generate-poll-retrieve pattern means most latency is in generation time (10-60s), not API call overhead. Optimize by: reducing poll overhead, parallelizing batch operations, caching results, and choosing the right generation parameters. ## Prerequisites - Working Gamma integration (see `gamma-sdk-patterns`) - Understanding of async patterns - Redis or in-memory cache (recommended) ## Performance Characteristics | Operation | Typical Latency | Notes | |-----------|----------------|-------| | POST `/generations` | 200-500ms | Just starts the generation | | GET `/generations/{id}` (poll) | 100-300ms | Per poll request | | Full generation (poll to completion) | 10-60s | Depends on content + cards | | GET `/themes` | 100-200ms | Cacheable | | GET `/folders` | 100-200ms | Cacheable | ## Instructions ### Step 1: Optimize Poll Strategy ```typescript // src/gamma/smart-poll.ts // Adaptive polling: start fast, slow down over time export async function smartPoll( gamma: GammaClient, generationId: string, opts = { maxTimeMs: 180000 } ): Promise<GenerateResult> { const deadline = Date.now() + opts.maxTimeMs; let interval = 2000; // Start at 2s while (Date.now() < deadline) { const result = await gamma.poll(generationId); if (result.status === "completed") return result; if (result.status === "failed") throw new Error("Generation failed"); // Adaptive backoff:...