Runtime Manager

Der Runtime Manager verwaltet die Laufzeitumgebung für xyva.ai. Er stellt sicher, dass alle benötigten Abhängigkeiten — insbesondere Playwright-Browser und Node.js — korrekt installiert und einsatzbereit sind.

Überblick

Das xyva-runtime-Paket bündelt alle Werkzeuge, die für die Testausführung und das Swarm-Scanning benötigt werden:

• Playwright-Browser — Chromium, Firefox und WebKit für die Testausführung
• Node.js-Runtime — Prüfung der installierten Node.js-Version
• CLI-Tools — Kommandozeilenwerkzeuge für Headless-Betrieb

Playwright-Browser-Installation

Der Runtime Manager übernimmt die Installation und Aktualisierung der Playwright-Browser:

1. Automatische Prüfung — Beim Start prüft xyva, ob alle benötigten Browser vorhanden sind
2. Gezielte Installation — Fehlende Browser werden automatisch heruntergeladen
3. Versionsabgleich — Bei einem Playwright-Update werden die Browser aktualisiert

Tipp

Die Browser werden im lokalen Cache gespeichert. Bei der Erstinstallation kann der Download je nach Verbindung einige Minuten dauern.

Node.js-Runtime-Prüfung

xyva benötigt eine kompatible Node.js-Version. Der Runtime Manager prüft:

• Ob Node.js installiert ist
• Ob die installierte Version den Mindestanforderungen entspricht
• Ob npm oder pnpm als Paketmanager verfügbar sind

Achtung

Für xyva.ai wird Node.js 18 oder höher empfohlen. Ältere Versionen können zu unerwartetem Verhalten führen.

CLI-Tools

Der Runtime Manager stellt CLI-Tools bereit, die auch ohne die grafische Oberfläche genutzt werden können:

# Headless-Testausführung
npx xyva-runtime run --headless --spec tests/login.spec.ts

# Swarm-Scan starten
npx xyva-runtime swarm --target https://example.com

# Browser-Status prüfen
npx xyva-runtime doctor

Hinweis

Die CLI-Tools eignen sich besonders für die Einbindung in CI/CD-Pipelines, in denen keine grafische Oberfläche verfügbar ist.

Fehlerbehebung

Problem	Lösung
Browser nicht gefunden	npx xyva-runtime doctor ausführen
Node.js-Version zu alt	Node.js auf Version 18+ aktualisieren
Berechtigungsfehler	Installation mit Administratorrechten wiederholen

Nächste Schritte

• Runner — Testausführung in xyva
• Swarm QA — Automatisierte Agenten-Scans
• AI Proxy — Self-hosted KI-Gateway