trigger-tasks

Build durable background tasks that run reliably with automatic retries, queuing, and observability. Waits > 5 seconds are checkpointed and don't count toward compute. Consolidate rapid triggers into a single execution: See references/ for detailed documentation on each feature. - Creating background jobs or async workflows - Building AI agents that need long-running execution - Processing webhooks, emails, or file uploads - Scheduling recurring tasks (cron) - Any work that shouldn't block your main application - Always use @trigger.dev/sdk — never use deprecated client.defineJob - Check result.ok before accessing result.output from triggerAndWait() - Never use Promise.all with triggerAndWait() or wait.* calls - Export tasks from files in your trigger/ directory - Make tasks idempotent — safe to retry without side effects - Use queues to prevent overwhelming external services - Configure appropriate retries with exponential backoff - Track progress with metadata for long-running tasks - Use debouncing for user activity and webhook bursts - Match machine size to computational requirements