iobroker.assistant 1.4.1 → 1.4.3

package/README.md

@@ -235,6 +235,15 @@ train it twice.
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 1.4.3 (2026-11-03)
+* (@GermanBluefox) An empty question sent with `sendTo('ask')` is rejected (`{error: 'empty question'}`) instead of going to the model with nothing but the time context, and the log names the sender once a minute. A script that asked on every answer looped about once a second and used pi-agent tokens. The log line of every `ask` now names the sender
+
+### 1.4.2 (2026-11-03)
+* (@GermanBluefox) ESPHome satellites: after 2.5 seconds of speech a pause may be half as long again before the request ends, so a pause for thought no longer cuts off a longer request. Short commands close as fast as before
+* (@GermanBluefox) ESPHome satellites: speech recognition gets the recording without the device's chirp or beep and without the silence around the speech, and quiet speech is amplified (up to ×10). Whisper made "Продолжение следует..." of the beep and the silence
+* (@GermanBluefox) The speech-to-text fallback also steps in when the first engine returns no text for speech
+* (@GermanBluefox) Request details: the speech recognition step shows the level profile of the recording (RMS per 100 ms), where speech started, why the recording ended and what went to the recognition
+
 ### 1.4.1 (2026-11-03)
 * (@GermanBluefox) Satellite settings: compound controls show their name ("Firmware Update") instead of the object id ("thirdreality_firmware_update"), and values of ESPHome devices no longer carry float noise (0.5 instead of 0.5000000237487257, step 0.001 instead of 0.0010000000474974513). Existing number controls get the cleaned range on the next connect
 * (@GermanBluefox) Satellite settings, firmware update: the install button only appears when another version is available, and a running update shows its progress as a bar

package/admin/i18n/de.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "Längste gesprochene Antwort (Zeichen)",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "Eine längere Antwort wird am letzten Satzende vor dieser Grenze abgeschnitten. 400 Zeichen sind etwa 25–30 Sekunden Sprache. 0 = keine Grenze.",
   "Text-to-speech provider": "Sprachausgabe-Anbieter",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "Diese Geräte streamen, bis der Server sie stoppt — der Adapter entscheidet also, wann du aufgehört hast zu sprechen. Erhöhen, wenn die Antwort dir ins Wort fällt; verringern, wenn der Assistent zu lange wartet.",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "Diese Geräte streamen, bis der Server sie stoppt — der Adapter entscheidet also, wann du aufgehört hast zu sprechen. Erhöhen, wenn die Antwort dir ins Wort fällt; verringern, wenn der Assistent zu lange wartet. Nach 2,5 Sekunden Sprechen gilt das Anderthalbfache, damit eine Denkpause eine längere Anfrage nicht beendet.",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. Diese Geräte lauschen auf TCP 6053 und der Adapter baut die Verbindung zu ihnen auf — für das Audio selbst wird also kein Port geöffnet, nur der Medien-Server unten, von dem sie die gesprochene Antwort abholen.",
   "Timer sound (mp3/wav, optional)": "Timer-Sound (mp3/wav, optional)",
   "Triggers": "Trigger",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "Jede Frage, die die Regeln nicht verstehen, geht vor der Cloud an das lokale Modell. Spart Cloud-Aufrufe, kostet auf einem Raspberry Pi aber 10–25 Sekunden pro solcher Frage.",
   "Local model timeout (s)": "Zeitlimit lokales Modell (s)",
   "After this time the local model is stopped and the question goes on to the cloud.": "Nach dieser Zeit wird das lokale Modell abgebrochen und die Frage geht an die Cloud weiter.",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "Wird genutzt, wenn der Anbieter oben ausfällt (Störung, abgelaufener Key, leeres Guthaben). Eine lokale Engine hält die Sprachsteuerung ohne Internet am Leben.",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "Wird genutzt, wenn der Anbieter oben ausfällt (Störung, abgelaufener Key, leeres Guthaben) oder für Sprache keinen Text liefert. Eine lokale Engine hält die Sprachsteuerung ohne Internet am Leben.",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "Wird genutzt, wenn der Anbieter oben ausfällt. Piper lässt den Assistenten ohne Internet weitersprechen.",
   "Verify device feedback": "Geräte-Rückmeldung prüfen",
   "Voice": "Sprache",

package/admin/i18n/en.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "Longest spoken answer (characters)",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.",
   "Text-to-speech provider": "Text-to-speech provider",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.",
   "Timer sound (mp3/wav, optional)": "Timer sound (mp3/wav, optional)",
   "Triggers": "Triggers",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.",
   "Local model timeout (s)": "Local model timeout (s)",
   "After this time the local model is stopped and the question goes on to the cloud.": "After this time the local model is stopped and the question goes on to the cloud.",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "Used when the provider above fails. Piper keeps the assistant speaking without the internet.",
   "Verify device feedback": "Verify device feedback",
   "Voice": "Voice",

package/admin/i18n/es.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "Respuesta hablada más larga (caracteres)",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "Una respuesta más larga se corta en el último final de frase antes de este límite. 400 caracteres son unos 25–30 segundos de voz. 0 = sin límite.",
   "Text-to-speech provider": "Proveedor de conversión de texto a voz",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "Estos dispositivos transmiten hasta que el servidor los detiene, así que el adaptador decide cuándo has dejado de hablar. Súbelo si la respuesta te corta; bájalo si el asistente espera demasiado.",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "Estos dispositivos transmiten hasta que el servidor los detiene, así que el adaptador decide cuándo has dejado de hablar. Auméntalo si la respuesta te interrumpe; redúcelo si el asistente espera demasiado. Tras 2,5 segundos de habla se permite una pausa una vez y media más larga, para que una pausa para pensar no termine una petición larga.",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. Estos dispositivos escuchan en TCP 6053 y es el adaptador quien los llama, así que no se abre ningún puerto para el audio en sí, solo el servidor multimedia de abajo, del que descargan la respuesta hablada.",
   "Timer sound (mp3/wav, optional)": "Sonido del temporizador (mp3/wav, opcional)",
   "Triggers": "Disparadores",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "Cada pregunta que las reglas no entienden va al modelo local antes que a la nube. Ahorra llamadas a la nube, pero en una Raspberry Pi añade 10–25 segundos a esas preguntas.",
   "Local model timeout (s)": "Tiempo límite del modelo local (s)",
   "After this time the local model is stopped and the question goes on to the cloud.": "Pasado este tiempo, el modelo local se detiene y la pregunta pasa a la nube.",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "Se usa cuando falla el proveedor de arriba (caída, clave caducada, cuota agotada). Un motor local mantiene el control por voz funcionando sin internet.",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "Se usa cuando el proveedor de arriba falla (caída, clave caducada, cuota agotada) o no devuelve texto para el habla. Un motor local mantiene la voz funcionando sin internet.",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "Se usa cuando falla el proveedor de arriba. Piper mantiene al asistente hablando sin internet.",
   "Verify device feedback": "Verificar la respuesta del dispositivo",
   "Voice": "Voz",

package/admin/i18n/fr.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "Réponse parlée la plus longue (caractères)",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "Une réponse plus longue est coupée à la dernière fin de phrase avant cette limite. 400 caractères correspondent à environ 25 à 30 secondes de parole. 0 = aucune limite.",
   "Text-to-speech provider": "fournisseur de synthèse vocale",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "Ces appareils émettent jusqu’à ce que le serveur les arrête : c’est donc l’adaptateur qui décide quand vous avez fini de parler. Augmentez si la réponse vous coupe, diminuez si l’assistant attend trop longtemps.",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "Ces appareils diffusent jusqu'à ce que le serveur les arrête : c'est donc l'adaptateur qui décide quand vous avez fini de parler. Augmentez la valeur si la réponse vous coupe la parole, diminuez-la si l'assistant attend trop longtemps. Après 2,5 secondes de parole, une pause une fois et demie plus longue est admise, pour qu'une pause de réflexion ne termine pas une demande longue.",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. Ces appareils écoutent sur le TCP 6053 et c’est l’adaptateur qui les appelle : aucun port n’est donc ouvert pour l’audio lui-même, seulement le serveur multimédia ci-dessous, d’où ils récupèrent la réponse parlée.",
   "Timer sound (mp3/wav, optional)": "Son de minuterie (mp3/wav, optionnel)",
   "Triggers": "Déclencheurs",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "Chaque question que les règles ne comprennent pas va au modèle local avant le cloud. Économise des appels au cloud, mais ajoute 10 à 25 secondes à ces questions sur un Raspberry Pi.",
   "Local model timeout (s)": "Délai du modèle local (s)",
   "After this time the local model is stopped and the question goes on to the cloud.": "Passé ce délai, le modèle local est arrêté et la question est transmise au cloud.",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "Utilisé lorsque le fournisseur ci-dessus échoue (panne, clé expirée, quota épuisé). Un moteur local permet à la commande vocale de fonctionner sans Internet.",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "Utilisé lorsque le fournisseur ci-dessus échoue (panne, clé expirée, quota épuisé) ou ne renvoie aucun texte pour de la parole. Un moteur local maintient la voix sans internet.",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "Utilisé lorsque le fournisseur ci-dessus échoue. Piper permet à l'assistant de continuer à parler sans Internet.",
   "Verify device feedback": "Vérifier le retour de l'appareil",
   "Voice": "Voix",

package/admin/i18n/it.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "Risposta parlata più lunga (caratteri)",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "Una risposta più lunga viene tagliata all'ultima fine di frase prima di questo limite. 400 caratteri sono circa 25–30 secondi di parlato. 0 = nessun limite.",
   "Text-to-speech provider": "Fornitore di sintesi vocale",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "Questi dispositivi trasmettono finché il server non li ferma, quindi è l’adapter a decidere quando hai smesso di parlare. Aumenta se la risposta ti interrompe, riduci se l’assistente attende troppo.",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "Questi dispositivi trasmettono finché il server non li ferma, quindi è l'adattatore a decidere quando hai finito di parlare. Aumentalo se la risposta ti interrompe, riducilo se l'assistente aspetta troppo. Dopo 2,5 secondi di parlato è ammessa una pausa una volta e mezza più lunga, così una pausa per riflettere non chiude una richiesta lunga.",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. Questi dispositivi ascoltano sulla TCP 6053 ed è l’adapter a contattarli, quindi per l’audio non viene aperta alcuna porta: solo il media server qui sotto, da cui scaricano la risposta parlata.",
   "Timer sound (mp3/wav, optional)": "Suono del timer (mp3/wav, facoltativo)",
   "Triggers": "Trigger",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "Ogni domanda che le regole non capiscono va al modello locale prima che al cloud. Risparmia chiamate al cloud, ma su un Raspberry Pi aggiunge 10–25 secondi a queste domande.",
   "Local model timeout (s)": "Timeout del modello locale (s)",
   "After this time the local model is stopped and the question goes on to the cloud.": "Trascorso questo tempo il modello locale viene interrotto e la domanda passa al cloud.",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "Usato quando il provider sopra non funziona (interruzione, chiave scaduta, credito esaurito). Un motore locale mantiene attivo il controllo vocale senza internet.",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "Usato quando il fornitore sopra non funziona (guasto, chiave scaduta, quota esaurita) o non restituisce testo per il parlato. Un motore locale mantiene la voce attiva senza internet.",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "Usato quando il provider sopra non funziona. Piper fa parlare l'assistente anche senza internet.",
   "Verify device feedback": "Verifica il riscontro del dispositivo",
   "Voice": "Voce",

package/admin/i18n/nl.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "Langste gesproken antwoord (tekens)",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "Een langer antwoord wordt afgekapt bij het laatste zinseinde vóór deze grens. 400 tekens zijn ongeveer 25–30 seconden spraak. 0 = geen grens.",
   "Text-to-speech provider": "Tekst-naar-spraak-aanbieder",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "Deze apparaten streamen tot de server ze stopt, dus de adapter bepaalt wanneer je klaar bent met praten. Verhoog dit als het antwoord je afkapt, verlaag het als de assistent te lang wacht.",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "Deze apparaten streamen tot de server ze stopt, dus de adapter beslist wanneer je klaar bent met praten. Verhoog de waarde als het antwoord je onderbreekt, verlaag haar als de assistent te lang wacht. Na 2,5 seconden spraak is een anderhalf keer zo lange pauze toegestaan, zodat een denkpauze een langer verzoek niet beëindigt.",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. Deze apparaten luisteren op TCP 6053 en de adapter belt ze zelf aan, dus voor de audio zelf wordt geen poort geopend — alleen de mediaserver hieronder, waar ze het gesproken antwoord ophalen.",
   "Timer sound (mp3/wav, optional)": "Timergeluid (mp3/wav, optioneel)",
   "Triggers": "Triggers",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "Elke vraag die de regels niet begrijpen gaat eerst naar het lokale model en dan naar de cloud. Bespaart cloudaanroepen, maar kost op een Raspberry Pi 10–25 seconden extra per zo’n vraag.",
   "Local model timeout (s)": "Time-out lokaal model (s)",
   "After this time the local model is stopped and the question goes on to the cloud.": "Na deze tijd wordt het lokale model gestopt en gaat de vraag door naar de cloud.",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "Wordt gebruikt als de bovenstaande provider faalt (storing, verlopen sleutel, tegoed op). Een lokale engine houdt spraakbediening werkend zonder internet.",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "Gebruikt als de bovenstaande provider faalt (storing, verlopen sleutel, leeg tegoed) of voor spraak geen tekst teruggeeft. Een lokale engine houdt spraak werkend zonder internet.",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "Wordt gebruikt als de bovenstaande provider faalt. Met Piper blijft de assistent spreken zonder internet.",
   "Verify device feedback": "Terugmelding van apparaat controleren",
   "Voice": "Stem",

package/admin/i18n/pl.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "Najdłuższa wypowiadana odpowiedź (znaki)",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "Dłuższa odpowiedź jest obcinana na ostatnim końcu zdania przed tym limitem. 400 znaków to około 25–30 sekund mowy. 0 = bez limitu.",
   "Text-to-speech provider": "Dostawca tekstu na mowę",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "Te urządzenia transmitują, dopóki serwer ich nie zatrzyma, więc to adapter decyduje, kiedy skończyłeś mówić. Zwiększ, jeśli odpowiedź ci przerywa; zmniejsz, jeśli asystent czeka zbyt długo.",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "Te urządzenia przesyłają dźwięk, dopóki serwer ich nie zatrzyma, więc to adapter decyduje, kiedy skończyłeś mówić. Zwiększ wartość, jeśli odpowiedź ci przerywa, zmniejsz, jeśli asystent czeka zbyt długo. Po 2,5 sekundy mowy dozwolona jest półtora raza dłuższa pauza, aby pauza do namysłu nie kończyła dłuższego polecenia.",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. Te urządzenia nasłuchują na TCP 6053 i to adapter nawiązuje z nimi połączenie, więc dla samego dźwięku nie jest otwierany żaden port — tylko serwer multimediów poniżej, z którego pobierają wypowiedzianą odpowiedź.",
   "Timer sound (mp3/wav, optional)": "Dźwięk timera (mp3/wav, opcjonalnie)",
   "Triggers": "Wyzwalacze",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "Każde pytanie, którego nie rozumieją reguły, trafia do modelu lokalnego przed chmurą. Oszczędza wywołania chmury, ale na Raspberry Pi wydłuża takie pytania o 10–25 sekund.",
   "Local model timeout (s)": "Limit czasu modelu lokalnego (s)",
   "After this time the local model is stopped and the question goes on to the cloud.": "Po tym czasie model lokalny jest zatrzymywany, a pytanie trafia do chmury.",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "Używane, gdy powyższy dostawca zawiedzie (awaria, wygasły klucz, wyczerpany limit). Lokalny silnik utrzymuje sterowanie głosowe bez internetu.",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "Używany, gdy powyższy dostawca zawiedzie (awaria, wygasły klucz, wyczerpany limit) lub nie zwróci tekstu dla mowy. Lokalny silnik utrzymuje sterowanie głosem bez internetu.",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "Używane, gdy powyższy dostawca zawiedzie. Piper pozwala asystentowi mówić bez internetu.",
   "Verify device feedback": "Sprawdzaj potwierdzenie z urządzenia",
   "Voice": "Głos",

package/admin/i18n/pt.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "Resposta falada mais longa (caracteres)",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "Uma resposta mais longa é cortada no último fim de frase antes deste limite. 400 caracteres são cerca de 25–30 segundos de fala. 0 = sem limite.",
   "Text-to-speech provider": "provedor de texto para voz",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "Estes dispositivos transmitem até o servidor os parar, por isso é o adaptador que decide quando terminou de falar. Aumente se a resposta o interromper; reduza se o assistente esperar demasiado.",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "Estes dispositivos transmitem até o servidor os parar, por isso é o adaptador que decide quando você parou de falar. Aumente se a resposta o interromper; diminua se o assistente esperar demasiado. Após 2,5 segundos de fala é permitida uma pausa uma vez e meia mais longa, para que uma pausa para pensar não termine um pedido longo.",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. Estes dispositivos escutam na TCP 6053 e é o adaptador que os contacta, por isso não é aberta nenhuma porta para o áudio em si — apenas o servidor de media abaixo, de onde eles buscam a resposta falada.",
   "Timer sound (mp3/wav, optional)": "Som do temporizador (mp3/wav, opcional)",
   "Triggers": "Gatilhos",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "Cada pergunta que as regras não entendem vai ao modelo local antes da nuvem. Poupa chamadas à nuvem, mas num Raspberry Pi acrescenta 10–25 segundos a essas perguntas.",
   "Local model timeout (s)": "Tempo limite do modelo local (s)",
   "After this time the local model is stopped and the question goes on to the cloud.": "Após este tempo o modelo local é interrompido e a pergunta segue para a nuvem.",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "Usado quando o provedor acima falha (interrupção, chave expirada, cota esgotada). Um motor local mantém o controle por voz funcionando sem internet.",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "Usado quando o fornecedor acima falha (falha, chave expirada, quota esgotada) ou não devolve texto para a fala. Um motor local mantém a voz a funcionar sem internet.",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "Usado quando o provedor acima falha. O Piper mantém o assistente falando sem internet.",
   "Verify device feedback": "Verificar a resposta do dispositivo",
   "Voice": "Voz",

package/admin/i18n/ru.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "Самый длинный произносимый ответ (символов)",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "Более длинный ответ обрезается по последнему концу предложения перед этим пределом. 400 символов — это примерно 25–30 секунд речи. 0 = без ограничения.",
   "Text-to-speech provider": "Поставщик услуг преобразования текста в речь",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "Эти устройства передают поток, пока сервер их не остановит, поэтому момент окончания речи определяет адаптер. Увеличьте, если ответ перебивает вас; уменьшите, если ассистент слишком долго ждёт.",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "Эти устройства передают звук, пока сервер их не остановит, поэтому адаптер сам решает, когда вы закончили говорить. Увеличьте значение, если ответ перебивает вас, уменьшите, если ассистент ждёт слишком долго. После 2,5 секунды речи допускается пауза в полтора раза длиннее, чтобы пауза на раздумье не обрывала длинный запрос.",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. Эти устройства слушают TCP 6053, и адаптер подключается к ним сам — поэтому для самого звука порт не открывается, только медиасервер ниже, с которого они забирают произнесённый ответ.",
   "Timer sound (mp3/wav, optional)": "Звук таймера (mp3/wav, по желанию)",
   "Triggers": "Триггеры",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "Каждый вопрос, который не поняли правила, сначала идёт к локальной модели, потом в облако. Экономит облачные запросы, но на Raspberry Pi добавляет к таким вопросам 10–25 секунд.",
   "Local model timeout (s)": "Тайм-аут локальной модели (с)",
   "After this time the local model is stopped and the question goes on to the cloud.": "По истечении этого времени локальная модель останавливается, и вопрос передаётся в облако.",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "Используется, если указанный выше провайдер не работает (сбой, истёкший ключ, исчерпанная квота). Локальный движок сохраняет голосовое управление без интернета.",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "Используется, если указанный выше провайдер не работает (сбой, истёкший ключ, исчерпанная квота) или не распознал речь. Локальный движок сохраняет голосовое управление без интернета.",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "Используется, если указанный выше провайдер не работает. Piper позволяет ассистенту говорить без интернета.",
   "Verify device feedback": "Проверять ответ устройства",
   "Voice": "Голос",

package/admin/i18n/uk.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "Найдовша вимовлена відповідь (символів)",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "Довша відповідь обрізається за останнім кінцем речення перед цією межею. 400 символів — це приблизно 25–30 секунд мовлення. 0 = без обмеження.",
   "Text-to-speech provider": "Постачальник перетворення тексту в мовлення",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "Ці пристрої передають потік, доки сервер їх не зупинить, тож момент завершення мовлення визначає адаптер. Збільште, якщо відповідь перебиває вас; зменште, якщо асистент чекає задовго.",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "Ці пристрої передають звук, доки сервер їх не зупинить, тому адаптер сам вирішує, коли ви закінчили говорити. Збільште значення, якщо відповідь перебиває вас, зменште, якщо асистент чекає надто довго. Після 2,5 секунди мовлення допускається пауза в півтора раза довша, щоб пауза на роздуми не обривала довгий запит.",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. Ці пристрої слухають на TCP 6053, і адаптер підключається до них сам — тож для самого звуку порт не відкривається, лише медіасервер нижче, з якого вони забирають озвучену відповідь.",
   "Timer sound (mp3/wav, optional)": "Звук таймера (mp3/wav, необов'язково)",
   "Triggers": "Тригери",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "Кожне запитання, яке не зрозуміли правила, спочатку йде до локальної моделі, потім у хмару. Заощаджує хмарні запити, але на Raspberry Pi додає до таких запитань 10–25 секунд.",
   "Local model timeout (s)": "Тайм-аут локальної моделі (с)",
   "After this time the local model is stopped and the question goes on to the cloud.": "Після цього часу локальна модель зупиняється, і запитання передається в хмару.",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "Використовується, якщо вказаний вище провайдер не працює (збій, прострочений ключ, вичерпана квота). Локальний рушій зберігає голосове керування без інтернету.",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "Використовується, якщо вказаний вище провайдер не працює (збій, прострочений ключ, вичерпана квота) або не розпізнав мовлення. Локальний рушій зберігає голосове керування без інтернету.",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "Використовується, якщо вказаний вище провайдер не працює. Piper дає асистентові змогу говорити без інтернету.",
   "Verify device feedback": "Перевіряти відповідь пристрою",
   "Voice": "Голос",

package/admin/i18n/zh-cn.json

@@ -157,7 +157,7 @@
   "Longest spoken answer (characters)": "最长语音回答（字符）",
   "A longer answer is cut at the last sentence end before this limit. 400 characters are about 25–30 seconds of speech. 0 = no limit.": "更长的回答会在此上限之前的最后一个句末处截断。400 个字符约为 25–30 秒语音。0 = 不限制。",
   "Text-to-speech provider": "文本转语音服务提供商",
-  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.": "这些设备会一直传输，直到服务器让它们停止，因此由适配器判断你何时说完。若回复打断你就调大，若助手等待过久就调小。",
+  "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.": "这些设备会一直传输音频，直到服务器让它们停止，因此由适配器判断您何时说完。如果回复打断了您，请调高；如果助手等待太久，请调低。说话超过 2.5 秒后，允许的停顿延长为 1.5 倍，这样思考时的停顿不会提前结束较长的请求。",
   "ThirdReality Voice & Music Assistant, Home Assistant Voice PE, linux-voice-assistant. These devices listen on TCP 6053 and the adapter dials them, so no port is opened for the audio itself — only the media server below, which they fetch the spoken reply from.": "ThirdReality Voice & Music Assistant、Home Assistant Voice PE、linux-voice-assistant。这些设备在 TCP 6053 上监听，由适配器主动连接它们，因此音频本身不会占用端口——只有下面的媒体服务器，设备会从那里获取语音回复。",
   "Timer sound (mp3/wav, optional)": "定时器声音（mp3/wav格式，可选）",
   "Triggers": "触发器",
@@ -170,7 +170,7 @@
   "Every question the rules do not understand goes to the local model before the cloud. Saves cloud calls, but on a Raspberry Pi it adds 10–25 seconds to such questions.": "规则无法理解的每个问题都会先交给本地模型，再交给云端。可节省云端调用，但在树莓派上每个此类问题会多花 10–25 秒。",
   "Local model timeout (s)": "本地模型超时（秒）",
   "After this time the local model is stopped and the question goes on to the cloud.": "超过此时间后本地模型将被停止，问题转交给云端。",
-  "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.": "当上方的服务商不可用时使用（故障、密钥过期、额度用尽）。本地引擎可在没有互联网时保持语音功能可用。",
+  "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.": "当上面的提供商出现故障（服务中断、密钥过期、额度用完）或对语音未返回文字时使用。本地引擎可在没有互联网时保持语音功能。",
   "Used when the provider above fails. Piper keeps the assistant speaking without the internet.": "当上方的服务商不可用时使用。Piper 可让助手在没有互联网时继续说话。",
   "Verify device feedback": "验证设备反馈",
   "Voice": "嗓音",

package/admin/jsonConfig.json

@@ -937,7 +937,7 @@
                 "esphomeSilenceMs": {
                     "type": "number",
                     "label": "End of speech after (ms of silence)",
-                    "help": "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long.",
+                    "help": "These devices stream until the server stops them, so the adapter decides when you stopped talking. Raise it if replies cut you off, lower it if the assistant waits too long. After 2.5 seconds of speech half as much again is allowed, so a pause for thought does not end a longer request.",
                     "default": 900,
                     "min": 200,
                     "max": 5000,
@@ -1060,7 +1060,7 @@
                     "newLine": true,
                     "type": "select",
                     "label": "Speech-to-text fallback",
-                    "help": "Used when the provider above fails (outage, expired key, empty quota). A local engine keeps voice working without the internet.",
+                    "help": "Used when the provider above fails (outage, expired key, empty quota) or returns no text for speech. A local engine keeps voice working without the internet.",
                     "options": [
                         { "label": "None", "value": "" },
                         { "label": "OpenAI (Whisper)", "value": "openai" },

package/build/lib/journal.js.map

@@ -1 +1 @@
-{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/lib/journal.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmKA,kCAEC;AAMD,4BAuBC;AAGD,8BAeC;AAGD,gDAcC;AArOD;;;;;;;;;;;;;;;;;GAiBG;AACH,uDAAqD;AACrD,qCAAyC;AACzC,gDAAkC;AA6HlC,wGAAwG;AACxG,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,4CAA4C;AAC/B,QAAA,UAAU,GAAG,GAAG,CAAC;AAC9B,oFAAoF;AACpF,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,oFAAoF;AACpF,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,sFAAsF;AACtF,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAClC,2EAA2E;AAC3E,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACjC,4FAA4F;AAC5F,MAAM,KAAK,GAAG,cAAc,CAAC;AAE7B,0DAA0D;AAC1D,SAAgB,WAAW,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAU,EAAE,EAAE;YACpD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;gBACxD,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,iBAAiB,SAAS,CAAC;YACxF,CAAC;YACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACxB,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;YACxB,CAAC;YACD,6DAA6D;YAC7D,MAAM,CAAC,GAAG,CAA8C,CAAC;YACzD,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7E,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC;YACtC,CAAC;YACD,OAAO,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,sBAAuB,CAAW,CAAC,OAAO,GAAG,CAAC;IACzD,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,SAAgB,SAAS,CAAC,CAAU;IAChC,IAAI,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3E,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC;QACxF,MAAM,CAAC,GAAI,CAAwC,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACL,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,SAAgB,kBAAkB,CAAC,MAAc;IAC7C,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,OAAO,UAAU,CAAC;IACtB,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,MAAa,OAAO;IAaa;IAZrB,OAAO,GAAmB,EAAE,CAAC;IACpB,KAAK,GAAG,IAAI,oCAAiB,EAAgB,CAAC;IACvD,SAAS,GAA0B,IAAI,CAAC;IACxC,OAAO,GAAG,CAAC,CAAC;IACpB,8EAA8E;IAC7D,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC3D,mDAAmD;IAClC,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3C,qGAAqG;IACpF,SAAS,GAAG,IAAI,OAAO,EAAwB,CAAC;IAChD,QAAQ,CAAS;IAElC,YAA6B,IAAoB;QAApB,SAAI,GAAJ,IAAI,CAAgB;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,IAAI;QACN,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO;QACX,CAAC;QACD,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;YAC7E,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,wDAAwD;gBACxD,IAAI,CAAC,OAAO,GAAI,GAAsB;qBACjC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC;qBACtE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC;gBACpF,IAAI,CAAC,KAAK,EAAE,CAAC;YACjB,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACjD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,8BAA+B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7E,CAAC;QACL,CAAC;IACL,CAAC;IAED,qDAAqD;IACrD,IAAI,CAAC,KAAK,GAAG,CAAC;QACV,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,KAAK;QACD,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,YAAY,EAAE,CAAC;IACxB,CAAC;IAED,6EAA6E;IAC7E,GAAG,CAAC,EAAU;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,0GAA0G;IAC1G,KAAK,CAAC,KAAK,CAAC,EAAU;QAClB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACR,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAEvF,CAAC;YACF,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,KAAuB,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,MAAc,EAAE,MAAqB,EAAE,EAAyB;QACxF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO,EAAE,EAAE,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,GAAiB;YACxB,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;YACjE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,IAAI,EAAE,KAAK;YACX,MAAM;YACN,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC,MAAM,CAAC;YACzD,QAAQ;YACR,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;SACd,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAU,EAAE,CAAC;YAC/E,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;gBACjD,KAA4C,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACrE,CAAC;QACL,CAAC;QACD,yFAAyF;QACzF,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;YACzB,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;YAChB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,gBAAgB,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,GAAG;YACvE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;SACrC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC/C,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;YACtB,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,KAAK,CAAC,KAAK,GAAI,CAAW,CAAC,OAAO,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAChG,MAAM,CAAC,CAAC;QACZ,CAAC;gBAAS,CAAC;YACP,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;YAClB,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,YAAY,EAAE,CAAC;QACxB,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,IAAI,CAAC,KAAuB;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAI,IAAY,EAAE,IAA6B,EAAE,EAAoB;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,EAAE,EAAE,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YAC1F,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;YAClC,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAC9B,MAAM,OAAO,GAAI,CAAW,CAAC,OAAO,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;gBAChB,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,QAAQ,IAAI,YAAY,OAAO,EAAE;gBACxC,EAAE;gBACF,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE;aACtC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC9C,MAAM,CAAC,CAAC;QACZ,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACpE,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAI,IAAY,EAAE,IAAyC,EAAE,EAAoB;QAC5F,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,EAAE,EAAE,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,EAAE,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACrG,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;gBAChB,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,GAAG,IAAI,YAAa,CAAW,CAAC,OAAO,EAAE;gBAChD,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBACtB,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE;aACtC,CAAC,CAAC;YACH,MAAM,CAAC,CAAC;QACZ,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAc,EAAE,MAAqB;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC1B,SAAS;YACb,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,gBAAgB,EAAE,CAAC;gBAClG,OAAO;YACX,CAAC;YACD,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;gBAChB,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,qBAAqB,MAAM,CAAC,QAAQ,GAAG,KAAK,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa;gBACvG,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM;aACf,CAAC,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,OAAO;QACX,CAAC;IACL,CAAC;IAEO,OAAO,CAAC,KAAmB,EAAE,KAAuB;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACrC,OAAO;QACX,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC;gBACP,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE;gBACxB,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,aAAa,SAAS,mCAAmC;aACnE,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QACD,MAAM,IAAI,GAAgB;YACtB,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;YAC1C,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;SACrB,CAAC;QACF,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC7B,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC3B,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;YACvD,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;YACrC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACzB,GAAG,CAAC,SAAS,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;YAClE,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC1B,GAAG,CAAC,UAAU,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;YACrE,CAAC;QACL,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,gFAAgF;IAChF,IAAI,CAAC,MAAmE;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC;IACL,CAAC;IAED,iEAAiE;IACjE,IAAI,CAAC,IAAY,EAAE,IAA6B,EAAE,EAAU,EAAE,MAAe,EAAE,KAAc;QACzF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO;QACX,CAAC;QACD,MAAM,IAAI,GAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC;QACzD,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,CAAC;aAAM,CAAC;YACJ,IAAI,IAAY,CAAC;YACjB,IAAI,CAAC;gBACD,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC;gBACL,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACxF,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,gFAAgF;QAChF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,wGAAwG;IACxG,WAAW,CAAC,IAAY,EAAE,IAAyC;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO;QACX,CAAC;QACD,IAAI,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACxB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;oBACrD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxB,CAAC;YACL,CAAC;QACL,CAAC;aAAM,IAAI,IAAI,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC7D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC;aAAM,IAAI,IAAI,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC7D,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAA6C,EAAE,CAAC;gBACjE,IAAI,OAAO,CAAC,EAAE,EAAE,KAAK,QAAQ,EAAE,CAAC;oBAC5B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBACrD,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,KAAK;QACP,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAEO,OAAO,CAAC,KAAmB;QAC/B,IAAI,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACL,yCAAyC;QAC7C,CAAC;IACL,CAAC;IAEO,KAAK;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACvD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;YACpE,KAAK,EAAE,CAAC;QACZ,CAAC;QACD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAC3D,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACZ,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;QACD,+EAA+E;QAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,kBAAU,CAAC;QACxD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;gBAC3B,MAAM;YACV,CAAC;YACD,wEAAwE;YACxE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC1E,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;IACL,CAAC;IAEO,YAAY;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,OAAO;QACX,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC,EAAE,aAAa,CAAC,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,IAAI;QACd,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO;QACX,CAAC;QACD,IAAI,CAAC;YACD,MAAM,kBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,MAAM,kBAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,+BAAgC,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IAED,+FAA+F;IACvF,KAAK,CAAC,UAAU;QACpB,IAAI,CAAC;YACD,MAAM,kBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACtB,IAAI,KAAK,EAAE,CAAC;oBACR,MAAM,kBAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC9F,CAAC;YACL,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,kBAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACrE,KAAK,MAAM,IAAI,IAAI,MAAM,kBAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzD,MAAM,kBAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjE,CAAC;YACL,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,sCAAuC,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACrF,CAAC;IACL,CAAC;CACJ;AA9aD,0BA8aC","sourcesContent":["/**\n * Conversation journal: one entry per request the assistant answered — where it came from (chat, script,\n * Telegram, which satellite, which wake word), which tier answered it (routine, rule-based NLU, local\n * model, cloud model), which tools the model called and which state ids were read or written along the\n * way. The admin chat shows it live, so one can check what a satellite heard and what was done about it.\n *\n * Tools and state accesses happen deep inside the pipeline (NLU executor, LLM tool loop, routine\n * executor). Instead of threading an entry object through all of them, the entry rides along in an\n * {@link AsyncLocalStorage}: {@link Journal.run} opens it, and {@link Journal.note}/{@link Journal.tool}/\n * {@link Journal.stateAccess} write to whatever entry the current call chain belongs to — and do nothing\n * outside of one (a trigger writing a state is not a conversation).\n *\n * Besides the entry, every request keeps a **trace**: the steps of its processing with their timing and\n * whatever explains them — the NLU's parse, the full prompt and every round of the model, tool arguments\n * and results in full, speech recognition and synthesis. Traces are too big to ride along in `journal.last`\n * and in `journal.json`, so the chat fetches one when a request is opened ({@link Journal.trace}); each is\n * kept in a file of its own and only for the newest {@link MAX_TRACES} requests.\n */\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport { promises as fs } from 'node:fs';\nimport * as path from 'node:path';\n\n/** How a request reached us. */\nexport type JournalTransport = 'chat' | 'script' | 'state' | 'telegram' | 'esphome' | 'udp' | 'native' | 'wyoming';\n\n/** Which stage of the pipeline produced the answer. */\nexport type JournalTier =\n    | 'stop' // stop word silenced a ringing timer/alarm\n    | 'askReply' // the utterance answered an open `askUser` question\n    | 'routine'\n    | 'nlu'\n    | 'localLlm'\n    | 'cloud'\n    | 'none'; // nothing local understood it and there is no cloud provider\n\n/** Tokens a model call used (summed over the rounds of a request in {@link JournalEntry.tokens}). */\nexport interface JournalTokens {\n    input: number;\n    output: number;\n    /** Prompt tokens served from the provider's prompt cache. */\n    cacheRead?: number;\n    /** Prompt tokens written to the provider's prompt cache (Anthropic). */\n    cacheWrite?: number;\n}\n\n/** One step of how a request was processed — what the debug view of the admin chat shows. */\nexport interface JournalStep {\n    /** Start of the step in ms after the request started (negative for speech recognition, which comes first). */\n    t: number;\n    /** Duration, for steps that took time. */\n    ms?: number;\n    /** Pipeline stage: request, stt, context, stop, askReply, routine, youtube, nlu, localLlm, cloud, tool, state, answer, tts, error. */\n    stage: string;\n    title: string;\n    level?: 'warn' | 'error';\n    tokens?: JournalTokens;\n    /** Whatever explains the step (prompts, model responses, parse results) — a JSON snapshot. */\n    data?: unknown;\n}\n\n/** What a caller records; the journal adds the timing. */\nexport type JournalStepInput = Omit<JournalStep, 't'>;\n\n/** Hook for library code that should not know the journal (the LLM agent). */\nexport type TraceFn = (step: JournalStepInput) => void;\n\nexport interface JournalTool {\n    name: string;\n    args: Record<string, unknown>;\n    ms: number;\n    /** Result, JSON, shortened. */\n    result?: string;\n    error?: string;\n}\n\nexport interface JournalEntry {\n    id: string;\n    /** Start of the answer, ms. */\n    ts: number;\n    /** False while the answer is still being produced. */\n    done: boolean;\n    /** Time to produce the answer (without STT/TTS). */\n    ms?: number;\n    source: string;\n    transport: JournalTransport;\n    satellite?: string;\n    room?: string;\n    /** Wake word the satellite reported; '' = the mic was re-opened for a follow-up, absent = unknown. */\n    wakeWord?: string;\n    /** Speech recognition time, for voice requests. */\n    sttMs?: number;\n    /** Length of the recorded utterance. */\n    audioMs?: number;\n    /** Speech synthesis time of the reply (voice requests, filled in after the answer). */\n    ttsMs?: number;\n    /** Length of the spoken reply. */\n    replyAudioMs?: number;\n    question: string;\n    answer?: string;\n    error?: string;\n    tier?: JournalTier;\n    /** Model name, routine name or NLU actions — whatever explains the tier. */\n    detail?: string;\n    tools: JournalTool[];\n    /** State ids read to produce the answer. */\n    read: string[];\n    /** States written to produce the answer. */\n    written: { id: string; value: unknown }[];\n    /** The reply asks back, so a satellite re-opened its mic. */\n    followUp?: boolean;\n    /** Tokens of all model calls, when a cloud model answered. */\n    tokens?: JournalTokens;\n}\n\n/** What the caller knows about a request before the pipeline starts. */\nexport interface JournalOrigin {\n    transport?: JournalTransport;\n    satellite?: string;\n    room?: string;\n    wakeWord?: string;\n    sttMs?: number;\n    audioMs?: number;\n    /** Voice activity detection of the utterance (ESPHome) — trace only. */\n    vad?: { peak: number; noiseFloor: number; startLevel: number; endLevel: number };\n}\n\n/** What a transport reports after it synthesised the reply. */\nexport interface JournalSpeech {\n    ms: number;\n    audioMs: number;\n    provider: string;\n    fallback?: string;\n    voice?: string;\n}\n\nexport interface JournalOptions {\n    /** Retention in hours; 0 disables the journal entirely. */\n    hours: number;\n    /** File the journal is kept in across restarts ('' = memory only). */\n    file: string;\n    /** Called with every new or updated entry (drives the `journal.last` state the chat listens to). */\n    onChange?: (entry: JournalEntry) => void;\n    log: ioBroker.Logger;\n}\n\n/** Hard cap independent of the retention — a script asking every few seconds must not fill the disk. */\nconst MAX_ENTRIES = 3000;\nconst SAVE_DELAY_MS = 5000;\nconst RESULT_CHARS = 300;\n/** Requests whose trace is kept on disk. */\nexport const MAX_TRACES = 200;\n/** Traces held in memory (the newest ones — the ones somebody is about to open). */\nconst MEMORY_TRACES = 30;\n/** Steps per request; a tool loop gone wild must not grow one trace without end. */\nconst MAX_STEPS = 400;\n/** Longer strings are cut — enough for a system prompt with a few hundred devices. */\nconst STEP_STRING_CHARS = 100_000;\n/** A reply is matched to its synthesis only this long after the answer. */\nconst SPEECH_WINDOW_MS = 120_000;\n/** Entry ids as {@link Journal.run} makes them — checked before one becomes a file name. */\nconst ID_RE = /^[a-z0-9-]+$/;\n\n/** Directory the traces of a journal file are kept in. */\nexport function traceDirFor(file: string): string {\n    return path.join(path.dirname(file), 'journal-trace');\n}\n\n/**\n * JSON snapshot of a step's data — taken when it is recorded, because the objects go on changing (the\n * model's message list grows, cache markers move). Long strings are cut and buffers summarised.\n */\nexport function snapshot(value: unknown): unknown {\n    if (value === undefined) {\n        return undefined;\n    }\n    try {\n        const text = JSON.stringify(value, (_key, v: unknown) => {\n            if (typeof v === 'string' && v.length > STEP_STRING_CHARS) {\n                return `${v.slice(0, STEP_STRING_CHARS)}… [+${v.length - STEP_STRING_CHARS} chars]`;\n            }\n            if (typeof v === 'bigint') {\n                return v.toString();\n            }\n            // Buffer.toJSON() has already run when the replacer sees it.\n            const b = v as { type?: unknown; data?: unknown } | null;\n            if (b && typeof b === 'object' && b.type === 'Buffer' && Array.isArray(b.data)) {\n                return `<${b.data.length} bytes>`;\n            }\n            return v;\n        });\n        return text === undefined ? undefined : JSON.parse(text);\n    } catch (e) {\n        return `<not serializable: ${(e as Error).message}>`;\n    }\n}\n\n/** Everything an error carries that helps — an API error's status and body, the stack. */\nexport function errorInfo(e: unknown): Record<string, unknown> {\n    if (!(e instanceof Error)) {\n        return { message: String(e) };\n    }\n    const info: Record<string, unknown> = { name: e.name, message: e.message };\n    for (const key of ['status', 'code', 'type', 'param', 'error', 'request_id', 'requestID']) {\n        const v = (e as unknown as Record<string, unknown>)[key];\n        if (v !== undefined && v !== null) {\n            info[key] = v;\n        }\n    }\n    if (e.stack) {\n        info.stack = e.stack;\n    }\n    return info;\n}\n\n/** Derive the transport from a request source when the caller did not say. */\nexport function transportForSource(source: string): JournalTransport {\n    if (source === 'chat') {\n        return 'chat';\n    }\n    if (source === '') {\n        return 'state';\n    }\n    if (source === 'wyoming') {\n        return 'wyoming';\n    }\n    if (source.startsWith('telegram:')) {\n        return 'telegram';\n    }\n    return 'script';\n}\n\nexport class Journal {\n    private entries: JournalEntry[] = [];\n    private readonly store = new AsyncLocalStorage<JournalEntry>();\n    private saveTimer: NodeJS.Timeout | null = null;\n    private counter = 0;\n    /** Steps of the newest requests; older ones are read back from their file. */\n    private readonly traces = new Map<string, JournalStep[]>();\n    /** Traces changed since they were last written. */\n    private readonly dirty = new Set<string>();\n    /** LLM tool calls in progress per request: a state access inside one belongs to that tool's step. */\n    private readonly toolDepth = new WeakMap<JournalEntry, number>();\n    private readonly traceDir: string;\n\n    constructor(private readonly opts: JournalOptions) {\n        this.traceDir = opts.file ? traceDirFor(opts.file) : '';\n    }\n\n    get enabled(): boolean {\n        return this.opts.hours > 0;\n    }\n\n    /** Load the entries of the last run (silently starts empty when there are none). */\n    async load(): Promise<void> {\n        if (!this.enabled || !this.opts.file) {\n            return;\n        }\n        try {\n            const raw = JSON.parse(await fs.readFile(this.opts.file, 'utf8')) as unknown;\n            if (Array.isArray(raw)) {\n                // An entry still open at shutdown never got its answer.\n                this.entries = (raw as JournalEntry[])\n                    .filter(e => e && typeof e.id === 'string' && typeof e.ts === 'number')\n                    .map(e => (e.done ? e : { ...e, done: true, error: e.error || 'interrupted' }));\n                this.prune();\n            }\n        } catch (e) {\n            if ((e as NodeJS.ErrnoException).code !== 'ENOENT') {\n                this.opts.log.warn(`Journal could not be read: ${(e as Error).message}`);\n            }\n        }\n    }\n\n    /** Entries newer than `since` (ms), oldest first. */\n    list(since = 0): JournalEntry[] {\n        this.prune();\n        return this.entries.filter(e => e.ts > since);\n    }\n\n    clear(): void {\n        this.entries = [];\n        this.traces.clear();\n        this.dirty.clear();\n        this.scheduleSave();\n    }\n\n    /** The entry of a request (the chat asks for it together with its trace). */\n    get(id: string): JournalEntry | undefined {\n        return this.entries.find(e => e.id === id);\n    }\n\n    /** The processing steps of a request, or null when none were kept (too old, or from an older version). */\n    async trace(id: string): Promise<JournalStep[] | null> {\n        if (!ID_RE.test(id) || !this.get(id)) {\n            return null;\n        }\n        const steps = this.traces.get(id);\n        if (steps) {\n            return steps;\n        }\n        if (!this.traceDir) {\n            return null;\n        }\n        try {\n            const raw = JSON.parse(await fs.readFile(path.join(this.traceDir, `${id}.json`), 'utf8')) as {\n                steps?: unknown;\n            };\n            return Array.isArray(raw?.steps) ? (raw.steps as JournalStep[]) : null;\n        } catch {\n            return null;\n        }\n    }\n\n    /**\n     * Run `fn` as one journalled request. The entry is published once when the request starts (so the\n     * chat shows the question while the answer is still being worked out) and once when it is finished.\n     */\n    async run(question: string, source: string, origin: JournalOrigin, fn: () => Promise<string>): Promise<string> {\n        if (!this.enabled) {\n            return fn();\n        }\n        const entry: JournalEntry = {\n            id: `${Date.now().toString(36)}-${(this.counter++).toString(36)}`,\n            ts: Date.now(),\n            done: false,\n            source,\n            transport: origin.transport || transportForSource(source),\n            question,\n            tools: [],\n            read: [],\n            written: [],\n        };\n        for (const key of ['satellite', 'room', 'wakeWord', 'sttMs', 'audioMs'] as const) {\n            if (origin[key] !== undefined && origin[key] !== '') {\n                (entry as unknown as Record<string, unknown>)[key] = origin[key];\n            }\n        }\n        // A satellite that re-opened its mic reports no wake word — say so instead of \"unknown\".\n        if (origin.wakeWord === '') {\n            entry.wakeWord = '';\n        }\n        this.entries.push(entry);\n        this.traces.set(entry.id, []);\n        this.addStep(entry, {\n            stage: 'request',\n            title: `Request from ${source || entry.transport} (${entry.transport})`,\n            data: { question, source, origin },\n        });\n        this.publish(entry);\n        try {\n            const answer = await this.store.run(entry, fn);\n            entry.answer = answer;\n            return answer;\n        } catch (e) {\n            entry.error = (e as Error).message;\n            this.addStep(entry, { stage: 'error', level: 'error', title: entry.error, data: errorInfo(e) });\n            throw e;\n        } finally {\n            entry.done = true;\n            entry.ms = Date.now() - entry.ts;\n            this.dirty.add(entry.id);\n            this.publish(entry);\n            this.prune();\n            this.scheduleSave();\n        }\n    }\n\n    /** Add a step to the current request's trace (nothing outside of one). */\n    step(input: JournalStepInput): void {\n        const entry = this.store.getStore();\n        if (entry) {\n            this.addStep(entry, input);\n        }\n    }\n\n    /**\n     * Run an LLM tool as part of the current request: the call lands in the entry's tool list and, with the\n     * full arguments and result, in the trace.\n     */\n    async toolCall<T>(name: string, args: Record<string, unknown>, fn: () => Promise<T>): Promise<T> {\n        const entry = this.store.getStore();\n        if (!entry) {\n            return fn();\n        }\n        this.toolDepth.set(entry, (this.toolDepth.get(entry) || 0) + 1);\n        const start = Date.now();\n        try {\n            const result = await fn();\n            const ms = Date.now() - start;\n            this.addStep(entry, { stage: 'tool', title: `Tool ${name}`, ms, data: { args, result } });\n            this.tool(name, args, ms, result);\n            return result;\n        } catch (e) {\n            const ms = Date.now() - start;\n            const message = (e as Error).message;\n            this.addStep(entry, {\n                stage: 'tool',\n                level: 'error',\n                title: `Tool ${name} failed: ${message}`,\n                ms,\n                data: { args, error: errorInfo(e) },\n            });\n            this.tool(name, args, ms, undefined, message);\n            throw e;\n        } finally {\n            this.toolDepth.set(entry, (this.toolDepth.get(entry) || 1) - 1);\n        }\n    }\n\n    /**\n     * Run a state call (MCP `get_states`/`set_state`/…) as part of the current request: the ids land in the\n     * entry's read/written lists, and — unless an LLM tool made the call, whose step already shows it — the\n     * call with its result in the trace.\n     */\n    async stateCall<T>(name: string, args: Record<string, unknown> | undefined, fn: () => Promise<T>): Promise<T> {\n        const entry = this.store.getStore();\n        if (!entry) {\n            return fn();\n        }\n        this.stateAccess(name, args);\n        if (this.toolDepth.get(entry)) {\n            return fn();\n        }\n        const start = Date.now();\n        try {\n            const result = await fn();\n            this.addStep(entry, { stage: 'state', title: name, ms: Date.now() - start, data: { args, result } });\n            return result;\n        } catch (e) {\n            this.addStep(entry, {\n                stage: 'state',\n                level: 'error',\n                title: `${name} failed: ${(e as Error).message}`,\n                ms: Date.now() - start,\n                data: { args, error: errorInfo(e) },\n            });\n            throw e;\n        }\n    }\n\n    /**\n     * A transport synthesised the reply to the latest request of `source`. That happens after the answer,\n     * outside of the request, so the entry is found by its source.\n     */\n    spoken(source: string, speech: JournalSpeech): void {\n        const now = Date.now();\n        for (let i = this.entries.length - 1; i >= 0; i--) {\n            const entry = this.entries[i];\n            if (entry.source !== source) {\n                continue;\n            }\n            if (!entry.done || entry.ttsMs !== undefined || now - entry.ts - (entry.ms || 0) > SPEECH_WINDOW_MS) {\n                return;\n            }\n            entry.ttsMs = speech.ms;\n            entry.replyAudioMs = Math.round(speech.audioMs);\n            const voice = speech.voice ? ` (${speech.voice})` : '';\n            this.addStep(entry, {\n                stage: 'tts',\n                title: `Speech synthesis: ${speech.provider}${voice}, ${(speech.audioMs / 1000).toFixed(1)} s of audio`,\n                ms: speech.ms,\n                data: speech,\n            });\n            this.dirty.add(entry.id);\n            this.publish(entry);\n            this.scheduleSave();\n            return;\n        }\n    }\n\n    private addStep(entry: JournalEntry, input: JournalStepInput): void {\n        const steps = this.traces.get(entry.id);\n        if (!steps || steps.length > MAX_STEPS) {\n            return;\n        }\n        if (steps.length === MAX_STEPS) {\n            steps.push({\n                t: Date.now() - entry.ts,\n                stage: 'error',\n                level: 'warn',\n                title: `More than ${MAX_STEPS} steps — the rest is not recorded`,\n            });\n            return;\n        }\n        const step: JournalStep = {\n            t: Date.now() - entry.ts - (input.ms || 0),\n            stage: input.stage,\n            title: input.title,\n        };\n        if (input.ms !== undefined) {\n            step.ms = input.ms;\n        }\n        if (input.level) {\n            step.level = input.level;\n        }\n        if (input.tokens) {\n            step.tokens = input.tokens;\n            const sum = (entry.tokens ||= { input: 0, output: 0 });\n            sum.input += input.tokens.input || 0;\n            sum.output += input.tokens.output || 0;\n            if (input.tokens.cacheRead) {\n                sum.cacheRead = (sum.cacheRead || 0) + input.tokens.cacheRead;\n            }\n            if (input.tokens.cacheWrite) {\n                sum.cacheWrite = (sum.cacheWrite || 0) + input.tokens.cacheWrite;\n            }\n        }\n        if (input.data !== undefined) {\n            step.data = snapshot(input.data);\n        }\n        steps.push(step);\n    }\n\n    /** Fill in fields of the current request's entry (tier, detail, followUp …). */\n    note(fields: Partial<Pick<JournalEntry, 'tier' | 'detail' | 'followUp'>>): void {\n        const entry = this.store.getStore();\n        if (entry) {\n            Object.assign(entry, fields);\n        }\n    }\n\n    /** Record a tool call the model made for the current request. */\n    tool(name: string, args: Record<string, unknown>, ms: number, result: unknown, error?: string): void {\n        const entry = this.store.getStore();\n        if (!entry) {\n            return;\n        }\n        const item: JournalTool = { name, args: args || {}, ms };\n        if (error) {\n            item.error = error;\n        } else {\n            let text: string;\n            try {\n                text = typeof result === 'string' ? result : JSON.stringify(result);\n            } catch {\n                text = String(result);\n            }\n            item.result = text.length > RESULT_CHARS ? `${text.slice(0, RESULT_CHARS)}…` : text;\n        }\n        entry.tools.push(item);\n        // Live view: show each tool call as it happens, a cloud round can take seconds.\n        this.publish(entry);\n    }\n\n    /** Record which states a call reads or writes (MCP `get_states`/`set_state`/`set_states`, routines). */\n    stateAccess(tool: string, args: Record<string, unknown> | undefined): void {\n        const entry = this.store.getStore();\n        if (!entry || !args) {\n            return;\n        }\n        if (tool === 'get_states' && Array.isArray(args.ids)) {\n            for (const id of args.ids) {\n                if (typeof id === 'string' && !entry.read.includes(id)) {\n                    entry.read.push(id);\n                }\n            }\n        } else if (tool === 'get_state' && typeof args.id === 'string') {\n            if (!entry.read.includes(args.id)) {\n                entry.read.push(args.id);\n            }\n        } else if (tool === 'set_state' && typeof args.id === 'string') {\n            entry.written.push({ id: args.id, value: args.value });\n        } else if (tool === 'set_states' && Array.isArray(args.states)) {\n            for (const s of args.states as { id?: unknown; value?: unknown }[]) {\n                if (typeof s?.id === 'string') {\n                    entry.written.push({ id: s.id, value: s.value });\n                }\n            }\n        }\n    }\n\n    /** Write pending changes now (on unload). */\n    async flush(): Promise<void> {\n        if (this.saveTimer) {\n            clearTimeout(this.saveTimer);\n            this.saveTimer = null;\n        }\n        await this.save();\n    }\n\n    private publish(entry: JournalEntry): void {\n        try {\n            this.opts.onChange?.(entry);\n        } catch {\n            // a listener must never break the answer\n        }\n    }\n\n    private prune(): void {\n        const cutoff = Date.now() - this.opts.hours * 3600_000;\n        let start = 0;\n        while (start < this.entries.length && this.entries[start].ts < cutoff) {\n            start++;\n        }\n        start = Math.max(start, this.entries.length - MAX_ENTRIES);\n        if (start > 0) {\n            for (const e of this.entries.slice(0, start)) {\n                this.traces.delete(e.id);\n                this.dirty.delete(e.id);\n            }\n            this.entries = this.entries.slice(start);\n        }\n        // Without a file the memory is all there is: keep as many as would be on disk.\n        const keep = this.traceDir ? MEMORY_TRACES : MAX_TRACES;\n        for (const id of this.traces.keys()) {\n            if (this.traces.size <= keep) {\n                break;\n            }\n            // Not written yet, or still being answered: needed until it is on disk.\n            if ((!this.traceDir || !this.dirty.has(id)) && this.get(id)?.done !== false) {\n                this.traces.delete(id);\n            }\n        }\n    }\n\n    private scheduleSave(): void {\n        if (!this.opts.file || this.saveTimer) {\n            return;\n        }\n        this.saveTimer = setTimeout(() => {\n            this.saveTimer = null;\n            void this.save();\n        }, SAVE_DELAY_MS);\n        this.saveTimer.unref?.();\n    }\n\n    private async save(): Promise<void> {\n        if (!this.opts.file) {\n            return;\n        }\n        try {\n            await fs.mkdir(path.dirname(this.opts.file), { recursive: true });\n            await fs.writeFile(this.opts.file, JSON.stringify(this.entries.filter(e => e.done)));\n        } catch (e) {\n            this.opts.log.warn(`Journal could not be saved: ${(e as Error).message}`);\n        }\n        await this.saveTraces();\n        this.prune();\n    }\n\n    /** Write the traces that changed, and delete the files of requests that are no longer kept. */\n    private async saveTraces(): Promise<void> {\n        try {\n            await fs.mkdir(this.traceDir, { recursive: true });\n            for (const id of [...this.dirty]) {\n                const steps = this.traces.get(id);\n                this.dirty.delete(id);\n                if (steps) {\n                    await fs.writeFile(path.join(this.traceDir, `${id}.json`), JSON.stringify({ id, steps }));\n                }\n            }\n            const keep = new Set(this.entries.slice(-MAX_TRACES).map(e => e.id));\n            for (const name of await fs.readdir(this.traceDir)) {\n                if (name.endsWith('.json') && !keep.has(name.slice(0, -5))) {\n                    await fs.rm(path.join(this.traceDir, name), { force: true });\n                }\n            }\n        } catch (e) {\n            this.opts.log.warn(`Journal traces could not be saved: ${(e as Error).message}`);\n        }\n    }\n}\n"]}
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/lib/journal.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Conversation journal: one entry per request the assistant answered — where it came from (chat, script,\n * Telegram, which satellite, which wake word), which tier answered it (routine, rule-based NLU, local\n * model, cloud model), which tools the model called and which state ids were read or written along the\n * way. The admin chat shows it live, so one can check what a satellite heard and what was done about it.\n *\n * Tools and state accesses happen deep inside the pipeline (NLU executor, LLM tool loop, routine\n * executor). Instead of threading an entry object through all of them, the entry rides along in an\n * {@link AsyncLocalStorage}: {@link Journal.run} opens it, and {@link Journal.note}/{@link Journal.tool}/\n * {@link Journal.stateAccess} write to whatever entry the current call chain belongs to — and do nothing\n * outside of one (a trigger writing a state is not a conversation).\n *\n * Besides the entry, every request keeps a **trace**: the steps of its processing with their timing and\n * whatever explains them — the NLU's parse, the full prompt and every round of the model, tool arguments\n * and results in full, speech recognition and synthesis. Traces are too big to ride along in `journal.last`\n * and in `journal.json`, so the chat fetches one when a request is opened ({@link Journal.trace}); each is\n * kept in a file of its own and only for the newest {@link MAX_TRACES} requests.\n */\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport { promises as fs } from 'node:fs';\nimport * as path from 'node:path';\nimport type { VadReport } from './voice/vad';\n\n/** How a request reached us. */\nexport type JournalTransport = 'chat' | 'script' | 'state' | 'telegram' | 'esphome' | 'udp' | 'native' | 'wyoming';\n\n/** Which stage of the pipeline produced the answer. */\nexport type JournalTier =\n    | 'stop' // stop word silenced a ringing timer/alarm\n    | 'askReply' // the utterance answered an open `askUser` question\n    | 'routine'\n    | 'nlu'\n    | 'localLlm'\n    | 'cloud'\n    | 'none'; // nothing local understood it and there is no cloud provider\n\n/** Tokens a model call used (summed over the rounds of a request in {@link JournalEntry.tokens}). */\nexport interface JournalTokens {\n    input: number;\n    output: number;\n    /** Prompt tokens served from the provider's prompt cache. */\n    cacheRead?: number;\n    /** Prompt tokens written to the provider's prompt cache (Anthropic). */\n    cacheWrite?: number;\n}\n\n/** One step of how a request was processed — what the debug view of the admin chat shows. */\nexport interface JournalStep {\n    /** Start of the step in ms after the request started (negative for speech recognition, which comes first). */\n    t: number;\n    /** Duration, for steps that took time. */\n    ms?: number;\n    /** Pipeline stage: request, stt, context, stop, askReply, routine, youtube, nlu, localLlm, cloud, tool, state, answer, tts, error. */\n    stage: string;\n    title: string;\n    level?: 'warn' | 'error';\n    tokens?: JournalTokens;\n    /** Whatever explains the step (prompts, model responses, parse results) — a JSON snapshot. */\n    data?: unknown;\n}\n\n/** What a caller records; the journal adds the timing. */\nexport type JournalStepInput = Omit<JournalStep, 't'>;\n\n/** Hook for library code that should not know the journal (the LLM agent). */\nexport type TraceFn = (step: JournalStepInput) => void;\n\nexport interface JournalTool {\n    name: string;\n    args: Record<string, unknown>;\n    ms: number;\n    /** Result, JSON, shortened. */\n    result?: string;\n    error?: string;\n}\n\nexport interface JournalEntry {\n    id: string;\n    /** Start of the answer, ms. */\n    ts: number;\n    /** False while the answer is still being produced. */\n    done: boolean;\n    /** Time to produce the answer (without STT/TTS). */\n    ms?: number;\n    source: string;\n    transport: JournalTransport;\n    satellite?: string;\n    room?: string;\n    /** Wake word the satellite reported; '' = the mic was re-opened for a follow-up, absent = unknown. */\n    wakeWord?: string;\n    /** Speech recognition time, for voice requests. */\n    sttMs?: number;\n    /** Length of the recorded utterance. */\n    audioMs?: number;\n    /** Speech synthesis time of the reply (voice requests, filled in after the answer). */\n    ttsMs?: number;\n    /** Length of the spoken reply. */\n    replyAudioMs?: number;\n    question: string;\n    answer?: string;\n    error?: string;\n    tier?: JournalTier;\n    /** Model name, routine name or NLU actions — whatever explains the tier. */\n    detail?: string;\n    tools: JournalTool[];\n    /** State ids read to produce the answer. */\n    read: string[];\n    /** States written to produce the answer. */\n    written: { id: string; value: unknown }[];\n    /** The reply asks back, so a satellite re-opened its mic. */\n    followUp?: boolean;\n    /** Tokens of all model calls, when a cloud model answered. */\n    tokens?: JournalTokens;\n}\n\n/** What the caller knows about a request before the pipeline starts. */\nexport interface JournalOrigin {\n    transport?: JournalTransport;\n    satellite?: string;\n    room?: string;\n    wakeWord?: string;\n    sttMs?: number;\n    audioMs?: number;\n    /** Voice activity detection of the utterance (ESPHome) — trace only. */\n    vad?: VadReport;\n}\n\n/** What a transport reports after it synthesised the reply. */\nexport interface JournalSpeech {\n    ms: number;\n    audioMs: number;\n    provider: string;\n    fallback?: string;\n    voice?: string;\n}\n\nexport interface JournalOptions {\n    /** Retention in hours; 0 disables the journal entirely. */\n    hours: number;\n    /** File the journal is kept in across restarts ('' = memory only). */\n    file: string;\n    /** Called with every new or updated entry (drives the `journal.last` state the chat listens to). */\n    onChange?: (entry: JournalEntry) => void;\n    log: ioBroker.Logger;\n}\n\n/** Hard cap independent of the retention — a script asking every few seconds must not fill the disk. */\nconst MAX_ENTRIES = 3000;\nconst SAVE_DELAY_MS = 5000;\nconst RESULT_CHARS = 300;\n/** Requests whose trace is kept on disk. */\nexport const MAX_TRACES = 200;\n/** Traces held in memory (the newest ones — the ones somebody is about to open). */\nconst MEMORY_TRACES = 30;\n/** Steps per request; a tool loop gone wild must not grow one trace without end. */\nconst MAX_STEPS = 400;\n/** Longer strings are cut — enough for a system prompt with a few hundred devices. */\nconst STEP_STRING_CHARS = 100_000;\n/** A reply is matched to its synthesis only this long after the answer. */\nconst SPEECH_WINDOW_MS = 120_000;\n/** Entry ids as {@link Journal.run} makes them — checked before one becomes a file name. */\nconst ID_RE = /^[a-z0-9-]+$/;\n\n/** Directory the traces of a journal file are kept in. */\nexport function traceDirFor(file: string): string {\n    return path.join(path.dirname(file), 'journal-trace');\n}\n\n/**\n * JSON snapshot of a step's data — taken when it is recorded, because the objects go on changing (the\n * model's message list grows, cache markers move). Long strings are cut and buffers summarised.\n */\nexport function snapshot(value: unknown): unknown {\n    if (value === undefined) {\n        return undefined;\n    }\n    try {\n        const text = JSON.stringify(value, (_key, v: unknown) => {\n            if (typeof v === 'string' && v.length > STEP_STRING_CHARS) {\n                return `${v.slice(0, STEP_STRING_CHARS)}… [+${v.length - STEP_STRING_CHARS} chars]`;\n            }\n            if (typeof v === 'bigint') {\n                return v.toString();\n            }\n            // Buffer.toJSON() has already run when the replacer sees it.\n            const b = v as { type?: unknown; data?: unknown } | null;\n            if (b && typeof b === 'object' && b.type === 'Buffer' && Array.isArray(b.data)) {\n                return `<${b.data.length} bytes>`;\n            }\n            return v;\n        });\n        return text === undefined ? undefined : JSON.parse(text);\n    } catch (e) {\n        return `<not serializable: ${(e as Error).message}>`;\n    }\n}\n\n/** Everything an error carries that helps — an API error's status and body, the stack. */\nexport function errorInfo(e: unknown): Record<string, unknown> {\n    if (!(e instanceof Error)) {\n        return { message: String(e) };\n    }\n    const info: Record<string, unknown> = { name: e.name, message: e.message };\n    for (const key of ['status', 'code', 'type', 'param', 'error', 'request_id', 'requestID']) {\n        const v = (e as unknown as Record<string, unknown>)[key];\n        if (v !== undefined && v !== null) {\n            info[key] = v;\n        }\n    }\n    if (e.stack) {\n        info.stack = e.stack;\n    }\n    return info;\n}\n\n/** Derive the transport from a request source when the caller did not say. */\nexport function transportForSource(source: string): JournalTransport {\n    if (source === 'chat') {\n        return 'chat';\n    }\n    if (source === '') {\n        return 'state';\n    }\n    if (source === 'wyoming') {\n        return 'wyoming';\n    }\n    if (source.startsWith('telegram:')) {\n        return 'telegram';\n    }\n    return 'script';\n}\n\nexport class Journal {\n    private entries: JournalEntry[] = [];\n    private readonly store = new AsyncLocalStorage<JournalEntry>();\n    private saveTimer: NodeJS.Timeout | null = null;\n    private counter = 0;\n    /** Steps of the newest requests; older ones are read back from their file. */\n    private readonly traces = new Map<string, JournalStep[]>();\n    /** Traces changed since they were last written. */\n    private readonly dirty = new Set<string>();\n    /** LLM tool calls in progress per request: a state access inside one belongs to that tool's step. */\n    private readonly toolDepth = new WeakMap<JournalEntry, number>();\n    private readonly traceDir: string;\n\n    constructor(private readonly opts: JournalOptions) {\n        this.traceDir = opts.file ? traceDirFor(opts.file) : '';\n    }\n\n    get enabled(): boolean {\n        return this.opts.hours > 0;\n    }\n\n    /** Load the entries of the last run (silently starts empty when there are none). */\n    async load(): Promise<void> {\n        if (!this.enabled || !this.opts.file) {\n            return;\n        }\n        try {\n            const raw = JSON.parse(await fs.readFile(this.opts.file, 'utf8')) as unknown;\n            if (Array.isArray(raw)) {\n                // An entry still open at shutdown never got its answer.\n                this.entries = (raw as JournalEntry[])\n                    .filter(e => e && typeof e.id === 'string' && typeof e.ts === 'number')\n                    .map(e => (e.done ? e : { ...e, done: true, error: e.error || 'interrupted' }));\n                this.prune();\n            }\n        } catch (e) {\n            if ((e as NodeJS.ErrnoException).code !== 'ENOENT') {\n                this.opts.log.warn(`Journal could not be read: ${(e as Error).message}`);\n            }\n        }\n    }\n\n    /** Entries newer than `since` (ms), oldest first. */\n    list(since = 0): JournalEntry[] {\n        this.prune();\n        return this.entries.filter(e => e.ts > since);\n    }\n\n    clear(): void {\n        this.entries = [];\n        this.traces.clear();\n        this.dirty.clear();\n        this.scheduleSave();\n    }\n\n    /** The entry of a request (the chat asks for it together with its trace). */\n    get(id: string): JournalEntry | undefined {\n        return this.entries.find(e => e.id === id);\n    }\n\n    /** The processing steps of a request, or null when none were kept (too old, or from an older version). */\n    async trace(id: string): Promise<JournalStep[] | null> {\n        if (!ID_RE.test(id) || !this.get(id)) {\n            return null;\n        }\n        const steps = this.traces.get(id);\n        if (steps) {\n            return steps;\n        }\n        if (!this.traceDir) {\n            return null;\n        }\n        try {\n            const raw = JSON.parse(await fs.readFile(path.join(this.traceDir, `${id}.json`), 'utf8')) as {\n                steps?: unknown;\n            };\n            return Array.isArray(raw?.steps) ? (raw.steps as JournalStep[]) : null;\n        } catch {\n            return null;\n        }\n    }\n\n    /**\n     * Run `fn` as one journalled request. The entry is published once when the request starts (so the\n     * chat shows the question while the answer is still being worked out) and once when it is finished.\n     */\n    async run(question: string, source: string, origin: JournalOrigin, fn: () => Promise<string>): Promise<string> {\n        if (!this.enabled) {\n            return fn();\n        }\n        const entry: JournalEntry = {\n            id: `${Date.now().toString(36)}-${(this.counter++).toString(36)}`,\n            ts: Date.now(),\n            done: false,\n            source,\n            transport: origin.transport || transportForSource(source),\n            question,\n            tools: [],\n            read: [],\n            written: [],\n        };\n        for (const key of ['satellite', 'room', 'wakeWord', 'sttMs', 'audioMs'] as const) {\n            if (origin[key] !== undefined && origin[key] !== '') {\n                (entry as unknown as Record<string, unknown>)[key] = origin[key];\n            }\n        }\n        // A satellite that re-opened its mic reports no wake word — say so instead of \"unknown\".\n        if (origin.wakeWord === '') {\n            entry.wakeWord = '';\n        }\n        this.entries.push(entry);\n        this.traces.set(entry.id, []);\n        this.addStep(entry, {\n            stage: 'request',\n            title: `Request from ${source || entry.transport} (${entry.transport})`,\n            data: { question, source, origin },\n        });\n        this.publish(entry);\n        try {\n            const answer = await this.store.run(entry, fn);\n            entry.answer = answer;\n            return answer;\n        } catch (e) {\n            entry.error = (e as Error).message;\n            this.addStep(entry, { stage: 'error', level: 'error', title: entry.error, data: errorInfo(e) });\n            throw e;\n        } finally {\n            entry.done = true;\n            entry.ms = Date.now() - entry.ts;\n            this.dirty.add(entry.id);\n            this.publish(entry);\n            this.prune();\n            this.scheduleSave();\n        }\n    }\n\n    /** Add a step to the current request's trace (nothing outside of one). */\n    step(input: JournalStepInput): void {\n        const entry = this.store.getStore();\n        if (entry) {\n            this.addStep(entry, input);\n        }\n    }\n\n    /**\n     * Run an LLM tool as part of the current request: the call lands in the entry's tool list and, with the\n     * full arguments and result, in the trace.\n     */\n    async toolCall<T>(name: string, args: Record<string, unknown>, fn: () => Promise<T>): Promise<T> {\n        const entry = this.store.getStore();\n        if (!entry) {\n            return fn();\n        }\n        this.toolDepth.set(entry, (this.toolDepth.get(entry) || 0) + 1);\n        const start = Date.now();\n        try {\n            const result = await fn();\n            const ms = Date.now() - start;\n            this.addStep(entry, { stage: 'tool', title: `Tool ${name}`, ms, data: { args, result } });\n            this.tool(name, args, ms, result);\n            return result;\n        } catch (e) {\n            const ms = Date.now() - start;\n            const message = (e as Error).message;\n            this.addStep(entry, {\n                stage: 'tool',\n                level: 'error',\n                title: `Tool ${name} failed: ${message}`,\n                ms,\n                data: { args, error: errorInfo(e) },\n            });\n            this.tool(name, args, ms, undefined, message);\n            throw e;\n        } finally {\n            this.toolDepth.set(entry, (this.toolDepth.get(entry) || 1) - 1);\n        }\n    }\n\n    /**\n     * Run a state call (MCP `get_states`/`set_state`/…) as part of the current request: the ids land in the\n     * entry's read/written lists, and — unless an LLM tool made the call, whose step already shows it — the\n     * call with its result in the trace.\n     */\n    async stateCall<T>(name: string, args: Record<string, unknown> | undefined, fn: () => Promise<T>): Promise<T> {\n        const entry = this.store.getStore();\n        if (!entry) {\n            return fn();\n        }\n        this.stateAccess(name, args);\n        if (this.toolDepth.get(entry)) {\n            return fn();\n        }\n        const start = Date.now();\n        try {\n            const result = await fn();\n            this.addStep(entry, { stage: 'state', title: name, ms: Date.now() - start, data: { args, result } });\n            return result;\n        } catch (e) {\n            this.addStep(entry, {\n                stage: 'state',\n                level: 'error',\n                title: `${name} failed: ${(e as Error).message}`,\n                ms: Date.now() - start,\n                data: { args, error: errorInfo(e) },\n            });\n            throw e;\n        }\n    }\n\n    /**\n     * A transport synthesised the reply to the latest request of `source`. That happens after the answer,\n     * outside of the request, so the entry is found by its source.\n     */\n    spoken(source: string, speech: JournalSpeech): void {\n        const now = Date.now();\n        for (let i = this.entries.length - 1; i >= 0; i--) {\n            const entry = this.entries[i];\n            if (entry.source !== source) {\n                continue;\n            }\n            if (!entry.done || entry.ttsMs !== undefined || now - entry.ts - (entry.ms || 0) > SPEECH_WINDOW_MS) {\n                return;\n            }\n            entry.ttsMs = speech.ms;\n            entry.replyAudioMs = Math.round(speech.audioMs);\n            const voice = speech.voice ? ` (${speech.voice})` : '';\n            this.addStep(entry, {\n                stage: 'tts',\n                title: `Speech synthesis: ${speech.provider}${voice}, ${(speech.audioMs / 1000).toFixed(1)} s of audio`,\n                ms: speech.ms,\n                data: speech,\n            });\n            this.dirty.add(entry.id);\n            this.publish(entry);\n            this.scheduleSave();\n            return;\n        }\n    }\n\n    private addStep(entry: JournalEntry, input: JournalStepInput): void {\n        const steps = this.traces.get(entry.id);\n        if (!steps || steps.length > MAX_STEPS) {\n            return;\n        }\n        if (steps.length === MAX_STEPS) {\n            steps.push({\n                t: Date.now() - entry.ts,\n                stage: 'error',\n                level: 'warn',\n                title: `More than ${MAX_STEPS} steps — the rest is not recorded`,\n            });\n            return;\n        }\n        const step: JournalStep = {\n            t: Date.now() - entry.ts - (input.ms || 0),\n            stage: input.stage,\n            title: input.title,\n        };\n        if (input.ms !== undefined) {\n            step.ms = input.ms;\n        }\n        if (input.level) {\n            step.level = input.level;\n        }\n        if (input.tokens) {\n            step.tokens = input.tokens;\n            const sum = (entry.tokens ||= { input: 0, output: 0 });\n            sum.input += input.tokens.input || 0;\n            sum.output += input.tokens.output || 0;\n            if (input.tokens.cacheRead) {\n                sum.cacheRead = (sum.cacheRead || 0) + input.tokens.cacheRead;\n            }\n            if (input.tokens.cacheWrite) {\n                sum.cacheWrite = (sum.cacheWrite || 0) + input.tokens.cacheWrite;\n            }\n        }\n        if (input.data !== undefined) {\n            step.data = snapshot(input.data);\n        }\n        steps.push(step);\n    }\n\n    /** Fill in fields of the current request's entry (tier, detail, followUp …). */\n    note(fields: Partial<Pick<JournalEntry, 'tier' | 'detail' | 'followUp'>>): void {\n        const entry = this.store.getStore();\n        if (entry) {\n            Object.assign(entry, fields);\n        }\n    }\n\n    /** Record a tool call the model made for the current request. */\n    tool(name: string, args: Record<string, unknown>, ms: number, result: unknown, error?: string): void {\n        const entry = this.store.getStore();\n        if (!entry) {\n            return;\n        }\n        const item: JournalTool = { name, args: args || {}, ms };\n        if (error) {\n            item.error = error;\n        } else {\n            let text: string;\n            try {\n                text = typeof result === 'string' ? result : JSON.stringify(result);\n            } catch {\n                text = String(result);\n            }\n            item.result = text.length > RESULT_CHARS ? `${text.slice(0, RESULT_CHARS)}…` : text;\n        }\n        entry.tools.push(item);\n        // Live view: show each tool call as it happens, a cloud round can take seconds.\n        this.publish(entry);\n    }\n\n    /** Record which states a call reads or writes (MCP `get_states`/`set_state`/`set_states`, routines). */\n    stateAccess(tool: string, args: Record<string, unknown> | undefined): void {\n        const entry = this.store.getStore();\n        if (!entry || !args) {\n            return;\n        }\n        if (tool === 'get_states' && Array.isArray(args.ids)) {\n            for (const id of args.ids) {\n                if (typeof id === 'string' && !entry.read.includes(id)) {\n                    entry.read.push(id);\n                }\n            }\n        } else if (tool === 'get_state' && typeof args.id === 'string') {\n            if (!entry.read.includes(args.id)) {\n                entry.read.push(args.id);\n            }\n        } else if (tool === 'set_state' && typeof args.id === 'string') {\n            entry.written.push({ id: args.id, value: args.value });\n        } else if (tool === 'set_states' && Array.isArray(args.states)) {\n            for (const s of args.states as { id?: unknown; value?: unknown }[]) {\n                if (typeof s?.id === 'string') {\n                    entry.written.push({ id: s.id, value: s.value });\n                }\n            }\n        }\n    }\n\n    /** Write pending changes now (on unload). */\n    async flush(): Promise<void> {\n        if (this.saveTimer) {\n            clearTimeout(this.saveTimer);\n            this.saveTimer = null;\n        }\n        await this.save();\n    }\n\n    private publish(entry: JournalEntry): void {\n        try {\n            this.opts.onChange?.(entry);\n        } catch {\n            // a listener must never break the answer\n        }\n    }\n\n    private prune(): void {\n        const cutoff = Date.now() - this.opts.hours * 3600_000;\n        let start = 0;\n        while (start < this.entries.length && this.entries[start].ts < cutoff) {\n            start++;\n        }\n        start = Math.max(start, this.entries.length - MAX_ENTRIES);\n        if (start > 0) {\n            for (const e of this.entries.slice(0, start)) {\n                this.traces.delete(e.id);\n                this.dirty.delete(e.id);\n            }\n            this.entries = this.entries.slice(start);\n        }\n        // Without a file the memory is all there is: keep as many as would be on disk.\n        const keep = this.traceDir ? MEMORY_TRACES : MAX_TRACES;\n        for (const id of this.traces.keys()) {\n            if (this.traces.size <= keep) {\n                break;\n            }\n            // Not written yet, or still being answered: needed until it is on disk.\n            if ((!this.traceDir || !this.dirty.has(id)) && this.get(id)?.done !== false) {\n                this.traces.delete(id);\n            }\n        }\n    }\n\n    private scheduleSave(): void {\n        if (!this.opts.file || this.saveTimer) {\n            return;\n        }\n        this.saveTimer = setTimeout(() => {\n            this.saveTimer = null;\n            void this.save();\n        }, SAVE_DELAY_MS);\n        this.saveTimer.unref?.();\n    }\n\n    private async save(): Promise<void> {\n        if (!this.opts.file) {\n            return;\n        }\n        try {\n            await fs.mkdir(path.dirname(this.opts.file), { recursive: true });\n            await fs.writeFile(this.opts.file, JSON.stringify(this.entries.filter(e => e.done)));\n        } catch (e) {\n            this.opts.log.warn(`Journal could not be saved: ${(e as Error).message}`);\n        }\n        await this.saveTraces();\n        this.prune();\n    }\n\n    /** Write the traces that changed, and delete the files of requests that are no longer kept. */\n    private async saveTraces(): Promise<void> {\n        try {\n            await fs.mkdir(this.traceDir, { recursive: true });\n            for (const id of [...this.dirty]) {\n                const steps = this.traces.get(id);\n                this.dirty.delete(id);\n                if (steps) {\n                    await fs.writeFile(path.join(this.traceDir, `${id}.json`), JSON.stringify({ id, steps }));\n                }\n            }\n            const keep = new Set(this.entries.slice(-MAX_TRACES).map(e => e.id));\n            for (const name of await fs.readdir(this.traceDir)) {\n                if (name.endsWith('.json') && !keep.has(name.slice(0, -5))) {\n                    await fs.rm(path.join(this.traceDir, name), { force: true });\n                }\n            }\n        } catch (e) {\n            this.opts.log.warn(`Journal traces could not be saved: ${(e as Error).message}`);\n        }\n    }\n}\n"]}

package/build/lib/voice/captures.js.map

@@ -1 +1 @@
-{"version":3,"file":"captures.js","sourceRoot":"","sources":["../../../src/lib/voice/captures.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Diagnosis recordings: microphone audio that a satellite captured but that never became a request — dropped as\n * silence, or returned empty by the speech recognition. Without the audio there is no telling whether a false\n * wake heard the TV, a quiet microphone missed a voice, or the recognition failed on real speech.\n *\n * Each recording is a WAV plus a JSON with what the voice activity detection made of it and a level profile (RMS\n * per 100 ms), so the levels can be read without an audio editor. Only the newest {@link MAX_CAPTURES} are kept.\n * The store does not care where files go; the adapter hands it its file storage (Admin → Files).\n */\n\nimport { pcmToWav } from './stt';\nimport { rms, type Bytes } from './vad';\n\n/** Why a recording was dropped. */\nexport type DiscardReason =\n    /** nobody started speaking before the start timeout */\n    | 'no-speech'\n    /** sound, but never loud enough for the speech threshold */\n    | 'silence'\n    /** speech by level, but the recognition returned no text */\n    | 'empty-stt';\n\nexport interface DiscardedCapture {\n    device: string;\n    room: string;\n    /** Wake word that opened the mic; '' = re-opened for a follow-up. */\n    wakeWord: string;\n    reason: DiscardReason;\n    pcm: Bytes;\n    sampleRate: number;\n    vad: { peak: number; analysedPeak: number; noiseFloor: number; startLevel: number; endLevel: number };\n}\n\n/** File operations, relative to the store's root (the adapter's file storage). */\nexport interface CaptureFiles {\n    write(path: string, data: Buffer | string): Promise<void>;\n    /** File names in `dir`; empty (not an error) when it does not exist yet. */\n    list(dir: string): Promise<string[]>;\n    remove(path: string): Promise<void>;\n}\n\nexport const CAPTURE_DIR = 'captures';\n/** ~400 KB per 12 s recording at 16 kHz, so at most ~20 MB. */\nexport const MAX_CAPTURES = 50;\n/** Resolution of the level profile in the JSON. */\nexport const LEVEL_STEP_MS = 100;\n\n/** RMS per `stepMs` of mono 16-bit PCM, rounded. */\nexport function levelProfile(pcm: Bytes, sampleRate: number, stepMs = LEVEL_STEP_MS): number[] {\n    const step = Math.max(2, Math.round((sampleRate * stepMs) / 1000) * 2);\n    const levels: number[] = [];\n    for (let offset = 0; offset < pcm.length; offset += step) {\n        levels.push(Math.round(rms(pcm.subarray(offset, Math.min(pcm.length, offset + step)))));\n    }\n    return levels;\n}\n\n/**\n * `2026-11-03_08-33-36-123_<device>_<reason>` in local time: sorts chronologically by name, which is what\n * pruning relies on, and reads well in the Admin file list.\n */\nexport function captureBaseName(date: Date, device: string, reason: DiscardReason): string {\n    const pad = (n: number, len = 2): string => String(n).padStart(len, '0');\n    const time =\n        `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}_` +\n        `${pad(date.getHours())}-${pad(date.getMinutes())}-${pad(date.getSeconds())}-${pad(date.getMilliseconds(), 3)}`;\n    const name = (device || 'satellite').replace(/[^\\w.-]/g, '_').slice(0, 60);\n    return `${time}_${name}_${reason}`;\n}\n\nexport class CaptureStore {\n    /** Saves run one after another, so two at once cannot prune each other's files. */\n    private queue: Promise<unknown> = Promise.resolve();\n\n    constructor(\n        private readonly files: CaptureFiles,\n        private readonly max = MAX_CAPTURES,\n    ) {}\n\n    /** Store one recording and drop the oldest beyond the limit. Resolves with the path of the WAV. */\n    save(capture: DiscardedCapture, now = new Date()): Promise<string> {\n        const run = this.queue.then(() => this.write(capture, now));\n        this.queue = run.catch(() => undefined);\n        return run;\n    }\n\n    private async write(capture: DiscardedCapture, now: Date): Promise<string> {\n        const base = `${CAPTURE_DIR}/${captureBaseName(now, capture.device, capture.reason)}`;\n        const info = {\n            time: now.toISOString(),\n            device: capture.device,\n            room: capture.room,\n            wakeWord: capture.wakeWord || '(follow-up)',\n            reason: capture.reason,\n            seconds: Math.round((capture.pcm.length / 2 / capture.sampleRate) * 100) / 100,\n            sampleRate: capture.sampleRate,\n            vad: capture.vad,\n            levelStepMs: LEVEL_STEP_MS,\n            levels: levelProfile(capture.pcm, capture.sampleRate),\n        };\n        await this.files.write(`${base}.wav`, pcmToWav(Buffer.from(capture.pcm), capture.sampleRate));\n        await this.files.write(`${base}.json`, `${JSON.stringify(info, null, 2)}\\n`);\n        await this.prune();\n        return `${base}.wav`;\n    }\n\n    private async prune(): Promise<void> {\n        const names = (await this.files.list(CAPTURE_DIR)).filter(n => /\\.(wav|json)$/.test(n));\n        const bases = [...new Set(names.map(n => n.replace(/\\.(wav|json)$/, '')))].sort();\n        for (const base of bases.slice(0, Math.max(0, bases.length - this.max))) {\n            for (const name of names.filter(n => n.replace(/\\.(wav|json)$/, '') === base)) {\n                await this.files.remove(`${CAPTURE_DIR}/${name}`).catch(() => undefined);\n            }\n        }\n    }\n}\n"]}
+{"version":3,"file":"captures.js","sourceRoot":"","sources":["../../../src/lib/voice/captures.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Diagnosis recordings: microphone audio that a satellite captured but that never became a request — dropped as\n * silence, or returned empty by the speech recognition. Without the audio there is no telling whether a false\n * wake heard the TV, a quiet microphone missed a voice, or the recognition failed on real speech.\n *\n * Each recording is a WAV plus a JSON with what the voice activity detection made of it and a level profile (RMS\n * per 100 ms), so the levels can be read without an audio editor. Only the newest {@link MAX_CAPTURES} are kept.\n * The store does not care where files go; the adapter hands it its file storage (Admin → Files).\n */\n\nimport { pcmToWav } from './stt';\nimport { rms, type Bytes, type VadReport } from './vad';\n\n/** Why a recording was dropped. */\nexport type DiscardReason =\n    /** nobody started speaking before the start timeout */\n    | 'no-speech'\n    /** sound, but never loud enough for the speech threshold */\n    | 'silence'\n    /** speech by level, but the recognition returned no text */\n    | 'empty-stt';\n\nexport interface DiscardedCapture {\n    device: string;\n    room: string;\n    /** Wake word that opened the mic; '' = re-opened for a follow-up. */\n    wakeWord: string;\n    reason: DiscardReason;\n    pcm: Bytes;\n    sampleRate: number;\n    vad: VadReport;\n}\n\n/** File operations, relative to the store's root (the adapter's file storage). */\nexport interface CaptureFiles {\n    write(path: string, data: Buffer | string): Promise<void>;\n    /** File names in `dir`; empty (not an error) when it does not exist yet. */\n    list(dir: string): Promise<string[]>;\n    remove(path: string): Promise<void>;\n}\n\nexport const CAPTURE_DIR = 'captures';\n/** ~400 KB per 12 s recording at 16 kHz, so at most ~20 MB. */\nexport const MAX_CAPTURES = 50;\n/** Resolution of the level profile in the JSON. */\nexport const LEVEL_STEP_MS = 100;\n\n/** RMS per `stepMs` of mono 16-bit PCM, rounded. */\nexport function levelProfile(pcm: Bytes, sampleRate: number, stepMs = LEVEL_STEP_MS): number[] {\n    const step = Math.max(2, Math.round((sampleRate * stepMs) / 1000) * 2);\n    const levels: number[] = [];\n    for (let offset = 0; offset < pcm.length; offset += step) {\n        levels.push(Math.round(rms(pcm.subarray(offset, Math.min(pcm.length, offset + step)))));\n    }\n    return levels;\n}\n\n/**\n * `2026-11-03_08-33-36-123_<device>_<reason>` in local time: sorts chronologically by name, which is what\n * pruning relies on, and reads well in the Admin file list.\n */\nexport function captureBaseName(date: Date, device: string, reason: DiscardReason): string {\n    const pad = (n: number, len = 2): string => String(n).padStart(len, '0');\n    const time =\n        `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}_` +\n        `${pad(date.getHours())}-${pad(date.getMinutes())}-${pad(date.getSeconds())}-${pad(date.getMilliseconds(), 3)}`;\n    const name = (device || 'satellite').replace(/[^\\w.-]/g, '_').slice(0, 60);\n    return `${time}_${name}_${reason}`;\n}\n\nexport class CaptureStore {\n    /** Saves run one after another, so two at once cannot prune each other's files. */\n    private queue: Promise<unknown> = Promise.resolve();\n\n    constructor(\n        private readonly files: CaptureFiles,\n        private readonly max = MAX_CAPTURES,\n    ) {}\n\n    /** Store one recording and drop the oldest beyond the limit. Resolves with the path of the WAV. */\n    save(capture: DiscardedCapture, now = new Date()): Promise<string> {\n        const run = this.queue.then(() => this.write(capture, now));\n        this.queue = run.catch(() => undefined);\n        return run;\n    }\n\n    private async write(capture: DiscardedCapture, now: Date): Promise<string> {\n        const base = `${CAPTURE_DIR}/${captureBaseName(now, capture.device, capture.reason)}`;\n        const info = {\n            time: now.toISOString(),\n            device: capture.device,\n            room: capture.room,\n            wakeWord: capture.wakeWord || '(follow-up)',\n            reason: capture.reason,\n            seconds: Math.round((capture.pcm.length / 2 / capture.sampleRate) * 100) / 100,\n            sampleRate: capture.sampleRate,\n            vad: capture.vad,\n            levelStepMs: LEVEL_STEP_MS,\n            levels: levelProfile(capture.pcm, capture.sampleRate),\n        };\n        await this.files.write(`${base}.wav`, pcmToWav(Buffer.from(capture.pcm), capture.sampleRate));\n        await this.files.write(`${base}.json`, `${JSON.stringify(info, null, 2)}\\n`);\n        await this.prune();\n        return `${base}.wav`;\n    }\n\n    private async prune(): Promise<void> {\n        const names = (await this.files.list(CAPTURE_DIR)).filter(n => /\\.(wav|json)$/.test(n));\n        const bases = [...new Set(names.map(n => n.replace(/\\.(wav|json)$/, '')))].sort();\n        for (const base of bases.slice(0, Math.max(0, bases.length - this.max))) {\n            for (const name of names.filter(n => n.replace(/\\.(wav|json)$/, '') === base)) {\n                await this.files.remove(`${CAPTURE_DIR}/${name}`).catch(() => undefined);\n            }\n        }\n    }\n}\n"]}