Arbeite im Projektordner <repo-root>.
Nutze bevorzugt diese CLI-Kommandos:
- ./scripts/deskbird.sh auth-check
- ./scripts/deskbird.sh auth-refresh --format json
- ./scripts/deskbird.sh auth-import --stdin --format json
- ./scripts/deskbird.sh discovery
- ./scripts/deskbird.sh parking-status
- ./scripts/deskbird.sh parking-book-first
- Setup bei frischem Upload:
  - python3 -m venv .venv
  - source .venv/bin/activate
  - pip install -r requirements.txt
  - python -m playwright install chromium
  - chmod +x scripts/deskbird.sh
Halte den Schonmodus aktiv (DESKBIRD_SAFE_MODE=true) und sende keine Request-Stuerme.
Fuer Telegram-Reauth standardmaessig nur DevTools-Paste + auth-import verwenden.
auth-pair-* und auth-capture nicht als Standard im Chat vorschlagen.

Deterministischer Env-Pfad

Verwende fuer alle Skill-Aufrufe den Wrapper ./scripts/deskbird.sh.
Der Wrapper setzt automatisch --env-file <skill-root>/.env und verhindert damit CWD-bedingte Auth-Fehler.
Nur bei gezieltem Debugging darfst du --env-file explizit auf eine andere Datei setzen.

Empfohlene Dauer-Auth (Broker-Basis)

Hinterlege nach einmaliger Ermittlung in der Skill-.env:
- DESKBIRD_FIREBASE_API_KEY
- DESKBIRD_FIREBASE_REFRESH_TOKEN
Dann kann der Agent automatisch per auth-refresh einen neuen Bearer holen, ohne jeden Login-Flow.

Wenn noch keine passende Cron-Session existiert, frage den Nutzer in genau dieser Reihenfolge:

Soll ich eine wiederkehrende Cron-Session dafuer anlegen?
Wenn ja: Welcher Rhythmus? Default ist taeglich um 00:30 Uhr (Europe/Berlin), ein Lauf fuer den naechsten 24h-Blick.
Was soll die Session pro Lauf genau tun?
Falls unklar, biete als Defaults an:
- Nur Uebersicht ueber alle buchbaren Objekte senden
- Uebersicht + Parkplatz automatisch buchen, wenn Regel erfuellt ist
- Nur monitoren, nie buchen
Fasse Name, Rhythmus und Session-Aufgabe zusammen und hole eine letzte Bestaetigung ein.

Wenn der Nutzer keinen Rhythmus nennt, setze den Default: taeglich 00:30 (Europe/Berlin).

Fuehre vor Discovery/Status/Buchung immer zuerst aus:

./scripts/deskbird.sh auth-check --format json --min-valid-minutes 90

Auswertung:

Wenn requires_reauth=false: normal fortfahren.
Wenn requires_reauth=true:
- Wenn DESKBIRD_FIREBASE_API_KEY und DESKBIRD_FIREBASE_REFRESH_TOKEN vorhanden sind:
  - zuerst automatisch ./scripts/deskbird.sh auth-refresh --format json --min-valid-minutes 90 ausfuehren.
  - nur wenn das fehlschlaegt, Nutzer um manuelle Reauth bitten.
- Ohne Firebase-Refresh-Creds: Nutzer aktiv fragen, ob Reauth jetzt gestartet werden soll.
Manueller Reauth-Standard ist Token/Header-Paste aus Chrome DevTools.

Vor jeder Detailabfrage (parking-status, parking-check, parking-book-first) zuerst discovery ausfuehren.
--office-id ist optional: Das CLI loest das Office automatisch ueber internalWorkspaces auf.
Nur wenn mehrere Offices vorhanden und der Default unklar ist:
- zuerst --office-name "<NAME_TEILSTRING>" verwenden, oder
- DESKBIRD_DEFAULT_OFFICE_ID in der Skill-.env setzen.
Der Agent soll den Nutzer nicht standardmaessig nach einer Office-ID fragen.

Wenn Reauth noetig ist, leite den Nutzer kurz an:

app.deskbird.com im Browser oeffnen und normal per SSO einloggen.
DevTools (Network) oeffnen.
Einen api.deskbird.com Request anklicken.
Request-Header (Authorization, optional Cookie, X-CSRF-Token, X-XSRF-Token) kopieren.
Header-Block in Telegram an den Bot senden.

Importiere den vom Nutzer gepasteten Block dann intern so:

cat <<'EOF' | ./scripts/deskbird.sh auth-import --stdin --format json
<PASTED_HEADER_BLOCK_OR_TOKEN>
EOF

Danach immer nochmals pruefen:

./scripts/deskbird.sh auth-check --format json --min-valid-minutes 90

Fallback:

Wenn Auth danach weiterhin ungueltig ist:

Cron-Laeufe muessen fehlertolerant und vorsichtig sein:

Nie aggressive Retries oder enge Polling-Schleifen starten.
Wenn Auth im Cron-Lauf nicht mehr gueltig ist, nicht blind weiterprobieren.
Stattdessen eine Telegram-Nachricht senden mit klarer Handlungsaufforderung zur Reauth und den Lauf sauber beenden.

Nutze OpenClaw-Cron-Funktionen. Wenn Tooling verfuegbar ist, bevorzuge cron.add/cron.update; alternativ CLI:

openclaw cron add --name "Deskbird Daily" --schedule "30 0 * * *" --prompt "<SESSION_PROMPT>" --announce

Regeln:

Beim Erstellen des Cron-Prompts nutze die Vorlage aus references/cron-session-template.md und ersetze Platzhalter fuer Zone/Regeln.

Bei jedem Lauf (manuell oder Cron) liefere kompakt: