pulslisted

# Puls — zarządzanie jobami przez REST API Puls (claude-cron) to lokalny scheduler agentów AI. Serwer HTTP działa na `http://localhost:7777` (port konfigurowalny przez env `CLAUDE_CRON_PORT`). Wszystkie operacje wykonuj przez `curl` (narzędzie Bash). Odpowiedzi są JSON-em; błąd ma kształt `{ "error": "komunikat" }` (HTTP 400/404). Jeśli user ma instancję na VPS: te same endpointy są dostępne przez proxy `http://localhost:7777/api/vps/*` (np. `/api/vps/jobs` = `/api/jobs` na VPS). Domyślnie działaj na instancji lokalnej — VPS tylko gdy user o to prosi. ## Endpointy | Metoda | Ścieżka | Opis | |--------|---------|------| | GET | `/api/status` | Status: uptime, `current_run`, `queue_length`, liczba jobów, statystyki dzisiaj, `next` (najbliższy run) | | GET | `/api/jobs` | Lista jobów (każdy z polem `next_run`) | | GET | `/api/jobs/:id` | Jeden job + `next_run` | | POST | `/api/jobs` | Utwórz job (body JSON, patrz „Pola joba") → 201 z jobem | | PUT | `/api/jobs/:id` | Częściowa aktualizacja — wysyłasz tylko zmieniane pola | | DELETE | `/api/jobs/:id` | Usuń job (kasuje też jego runy) → `{ "ok": true }` | | POST | `/api/jobs/:id/trigger` | Uruchom job teraz (kolejkuje run `trigger_type: manual`) | | POST | `/api/jobs/:id/toggle` | Przełącz `enabled` (włącz/wyłącz) | | POST | `/api/jobs/:id/webhook` | Wygeneruj/zregeneruj token webhooka (pole `webhook_token` w jobie) | | DELETE | `/api/jobs/:id/webhook` | Usuń token webhooka | | POST | `/webhook/:token` | Publiczny trigger joba