Skip to main content

Queues And Workers

Nova uses queues so user-facing requests stay fast while background work runs reliably.

Queues​

  • ingestion
  • normalization
  • llm
  • action
  • delivery
  • sync

Worker responsibilities​

  • Ingestion: receive/fetch provider payloads
  • Normalization: map raw payloads into Nova models
  • LLM: completion/extraction tasks
  • Action: prepare executable action jobs
  • Delivery: send emails/messages via providers
  • Sync: full/incremental sync and mailbox lifecycle jobs

Why queues are used​

  • isolate retries from user requests
  • handle bursts safely
  • keep observability clear by job type

Operator endpoints​

  • GET /v1/admin/queues
  • GET /v1/admin/queue-ops/stats
  • queue pause/resume/drain and failed-job retry endpoints