.WAITFOR

Stellt Warte-Hilfsfunktionen für Bausteine und Events bereit (RAGAI.WAITFOR).

Hintergrund

initialIdle muss der allererste RAGAI-Aufruf in jedem Custom-JS-Baustein sein: Solange der Bot noch initialisiert (Skills laden, Avatar verbindet ggf.), können andere RAGAI-Kommandos ignoriert werden oder fehlschlagen. RAGAI.FLOW.ready wird intern genau dann ausgelöst, wenn initialIdle() das erste Mal auflöst. nextIdle ist etwas anderes: es wartet auf den nächsten Ruhezustand nach einem laufenden Bot-Run (z. B. um zu warten, bis die aktuelle Antwort fertig geschrieben ist), nicht auf die initiale Bereitschaft. varsInit muss abgewartet werden, bevor auf RAGAI.SCORE-Werte zugegriffen wird, da deren initiale Werte asynchron aus dem KeyVal-Speicher geladen werden.

Methoden

.secondsAndExec(seconds, fn?)

Wartet eine bestimmte Anzahl Sekunden und führt danach eine Funktion aus.

Parameter	Typ	Beschreibung
seconds	number | z.input<typeof waitForSecondsSchema>	Anzahl der zu wartenden Sekunden, oder ein Objekt gemäß waitForSecondsSchema.
fn	() => unknown	Die danach auszuführende Funktion.

Objekt-Form (validiert über waitForSecondsSchema):

Feld	Typ	Pflicht	Beschreibung
seconds	number	✔	Anzahl der zu wartenden Sekunden.
fn	any	✔	Die nach Ablauf der Wartezeit auszuführende Funktion.

Rückgabewert: void

.minutesAndExec(minutes, fn?)

Wartet eine bestimmte Anzahl Minuten und führt danach eine Funktion aus.

Parameter	Typ	Beschreibung
minutes	number | z.input<typeof waitForMinutesSchema>	Anzahl der zu wartenden Minuten, oder ein Objekt gemäß waitForMinutesSchema.
fn	() => unknown	Die danach auszuführende Funktion.

Objekt-Form (validiert über waitForMinutesSchema):

Feld	Typ	Pflicht	Beschreibung
minutes	number	✔	Anzahl der zu wartenden Minuten.
fn	any	✔	Die nach Ablauf der Wartezeit auszuführende Funktion.

Rückgabewert: void

.event(hook)

Wartet, bis ein bestimmtes RAGAI-Event ausgelöst wird.

Parameter	Typ	Beschreibung
hook	string | z.input<typeof waitForEventSchema>	Name des abzuwartenden Events, oder ein Objekt gemäß waitForEventSchema.

Objekt-Form (validiert über waitForEventSchema):

Feld	Typ	Pflicht	Beschreibung
hook	string	✔	Name des abzuwartenden Events.

Rückgabewert: Promise<unknown>

Die Event-Parameter, sobald das Event ausgelöst wurde.

.nextIdle()

Wartet auf den nächsten Idle-Zustand des Bots.

Rückgabewert: Promise<unknown>

Aufgelöst, sobald der nächste Idle-Zustand erreicht ist.

.scormInited()

Wartet, bis SCORM initialisiert ist (oder sofort, wenn nicht im LMS).

Rückgabewert: Promise<unknown>

Aufgelöst, sobald SCORM bereit ist.

.initialIdle()

Wartet, bis der Bot seine Initialisierung abgeschlossen hat und im Ruhezustand ist (optional inkl. Avatar-Verbindung).

Rückgabewert: Promise<unknown>

Aufgelöst, sobald der Bot bereit ist.

.varsInit()

Wartet, bis die initialen Punktestände geladen wurden.

Rückgabewert: Promise<void>

Aufgelöst, sobald die Punktestände bereit sind.