--- name: background-jobs description: Async processing and scheduled jobs patterns. Use when implementing background tasks, event-driven workflows, task queues, and scheduled jobs. --- # Background Jobs & Async Processing Patterns for async task processing, scheduling, and event-driven workflows. ## Task Queues Fire-and-forget async processing for expensive operations. ## Scheduled Jobs (Cron) Recurring tasks on a schedule. ## Stateful Workflows (Durable Objects) For workflows requiring coordinated state across multiple steps. 1. Use Queues for fire-and-forget async tasks (exports, notifications, webhooks) 2. Use Cron Triggers for scheduled recurring work (cleanup, aggregation) 3. Use Durable Objects only for stateful coordination (rare, use Queues first) 4. Always include a dead letter queue for production tasks 5. Implement exponential backoff on retries: `delaySeconds: Math.pow(2, attempts) * 10` 6. Include message type in queue payloads for routing in consumer 7. Keep consumers idempotent (at-least-once delivery means possible duplicates) 8. Log all task failures with context for debugging 9. Monitor dead letter queues for persistent failures 10. Test scheduled jobs locally before deployment

observability

Scan your own AI components