Lokaler Agent

Fuer Runner und Swarm braucht das Portal einen lokalen Agenten.

Agent anmelden

npx @xyva/agent login

Der Login oeffnet den Portal-Handoff im Browser und speichert die lokalen Zugangsdaten in ~/.xyva/credentials.json.

Agent starten

npx @xyva/agent start --port 7900 --project /absoluter/pfad/zum/repo

Der Agent stellt bereit:

• GET /health
• POST /auth/refresh
• WebSocket-Bridge auf ws://127.0.0.1:7900

Verbindung im Portal

1. Agent-Statusbadge in der Portal-Topbar oeffnen.
2. Lokalen Token und Port eintragen, falls sie noch nicht im Browser gespeichert sind.
3. Verbinden klicken.

Das Portal prueft zuerst /health, holt danach ueber /auth/refresh einen kurzlebigen Bridge-Token und startet dann die WebSocket-Verbindung.

Hardening aus Step 11

• Begrenzte gleichzeitige WebSocket-Verbindungen
• Payload-Limit fuer WebSocket und JSON-Requests
• Saubere Ablehnung fehlerhafter Payloads
• Kurzlebige Refresh-Tokens fuer Reconnects

Fehlerbilder

• Agent not reachable: Port oder lokale Firewall pruefen.
• Auth required: Browser-Token ist veraltet, npx @xyva/agent login erneut ausfuehren.
• Protocol version mismatch: Portal und Agent muessen aus demselben Repo-Stand kommen.