Worker Setup

The Cloudflare Worker is the global evaluator. It runs on a cron schedule (every 1 minute) to detect offline agents, create incidents, and dispatch notifications.

npm install -g wrangler
wrangler login

cd apps/worker

npx wrangler secret put DATABASE_URL
# Paste your Neon connection string when prompted
 
npx wrangler secret put WORKER_SECRET
# Set a strong random string for manual trigger auth

npx wrangler deploy

Verify the Worker

After deployment, you can trigger the evaluator manually for testing:

curl -X POST https://your-worker.YOUR_SUBDOMAIN.workers.dev/trigger \
  -H "Authorization: Bearer YOUR_WORKER_SECRET"

What the Worker Does

Each cron run executes these steps in order:

1. Detect overdue agents — SELECT agents WHERE offline_deadline_at < NOW() AND status != 'offline'
2. Mark offline + create incident — update status, insert incident if none open
3. Dispatch offline notifications — Telegram, Discord, or Webhook
4. Detect recovered agents — SELECT agents WHERE offline_deadline_at >= NOW() AND status = 'offline'
5. Mark online + resolve incident — update status, set resolved_at
6. Dispatch recovery notifications
7. Run cloud monitor checks — parallel HTTP/TLS/Keyword checks
8. Retention cleanup — delete metric_buckets > 7 days, cloud results > 30 days