node-red-contrib-knx-ultimate 6.1.0 → 6.2.0

package/nodes/locales/fr/knxUltimateMatterControllerDevice.html

@@ -19,11 +19,11 @@ Il remplace les nœuds Matter séparés non publiés et conserve toute l'UI lumi
 | Capteurs | Les endpoints capteur affichent leur GA de mesure/état uniquement si elle est supportée : température, humidité, éclairement, occupation, contact et batterie. |
 | Read at startup | Publie la valeur Matter en cache au déploiement/démarrage ou quand le périphérique se reconnecte. |
 | Update local state from KNX write | Met à jour le cache local Matter/KNX lorsqu'un télégramme est écrit sur une GA KNX configurée. |
-| Node Input/Output PINs | Affiche les pins entrée/sortie Node-RED. Les endpoints autres que lumière acceptent le format simple `{function,value}` et les champs Matter avancés ; la sortie émet les états. |
+| Node Input/Output PINs | Affiche les pins entrée/sortie Node-RED et la section **Entrée du flow** juste sous ce champ. Les lumières affichent leurs messages d'état pris en charge au premier niveau ; les autres endpoints affichent le format simple `{function,value}` et les champs Matter avancés. |
 
 ## Entrée du flow
 
-Pour un endpoint autre que lumière, ouvrez l'onglet **Entrée du flow**. L'onglet est construit depuis la structure annoncée et affiche des exemples copiables, l'Endpoint ID, tous les attributs lisibles/inscriptibles et toutes les commandes acceptées. Il reste disponible lorsque le nœud est utilisé uniquement par le flow, sans passerelle KNX.
+Activez **Node Input/Output PINs** pour afficher la section **Entrée du flow** juste sous le sélecteur. Pour une lumière, elle propose des exemples copiables des propriétés prises en charge au premier niveau, comme `msg.on`, `msg.dimming`, `msg.color_temperature` et `msg.color`. Pour les autres endpoints, elle est construite depuis la structure annoncée et affiche l'Endpoint ID, tous les attributs lisibles/inscriptibles et toutes les commandes acceptées. Elle reste disponible sans passerelle KNX.
 
 Une écriture simple utilise `msg.payload = {function:"position",value:35}`. Omettez `value` pour lire un état, par exemple `{function:"temperature"}` ; la sortie utilise des unités lisibles et place les détails bruts dans `msg.matter`. Les fonctions `onoff`, `level`, `position`, `open`, `close`, `stop`, consignes, ventilateur et capteurs ne sont proposées que si l'endpoint les annonce. Une serrure accepte `{function:"lock",value:true|false}`.
 

package/nodes/locales/fr/knxUltimateMatterControllerDevice.json

@@ -17,6 +17,7 @@
     "input_help_endpoint_hint": "Le nœud connaît déjà le Node ID et l'Endpoint ID ; les messages simples n'en ont pas besoin.",
     "input_help_simple_title": "Messages simples",
     "input_help_simple_hint": "Ces fonctions utilisent des unités lisibles et sont traduites vers le cluster, la commande ou l'attribut Matter de l'endpoint sélectionné.",
+    "input_help_light_hint": "Les endpoints de type lumière acceptent les propriétés d'état directement dans msg (pas dans msg.payload). Seules les commandes prises en charge par la lumière sélectionnée sont affichées.",
     "input_help_advanced_title": "Détails Matter avancés",
     "input_help_advanced_hint": "Seuls les attributs et commandes annoncés sont affichés. Les exemples d'écriture utilisent 0 comme valeur provisoire ; les arguments des commandes peuvent devoir être adaptés au type Matter.",
     "input_help_operation": "Opération",
@@ -31,7 +32,7 @@
     "input_help_no_simple": "Cet endpoint ne possède aucune fonction d'entrée simple connue.",
     "input_help_no_structure": "La structure Matter est indisponible. Actualisez la liste des appareils lorsque l'endpoint est en ligne.",
     "input_functions": {
-      "onoff": "Marche / Arrêt", "level": "Niveau", "position": "Position du volet", "tiltposition": "Inclinaison du volet", "open": "Ouvrir", "close": "Fermer", "stop": "Arrêter", "setpoint": "Consigne chauffage", "coolingsetpoint": "Consigne refroidissement", "currenttemp": "Température actuelle", "fanspeed": "Vitesse du ventilateur", "temperature": "Température", "humidity": "Humidité", "illuminance": "Éclairement", "occupancy": "Occupation", "contact": "Contact", "battery": "Batterie", "activepower": "Puissance active", "importedenergy": "Énergie importée", "identify": "Identifier", "lock": "Verrouiller", "unlock": "Déverrouiller"
+      "onoff": "Marche / Arrêt", "on": "Allumer", "off": "Éteindre", "level": "Niveau", "brightness": "Luminosité", "color_temperature": "Température de couleur", "xy_color": "Couleur XY", "position": "Position du volet", "tiltposition": "Inclinaison du volet", "open": "Ouvrir", "close": "Fermer", "stop": "Arrêter", "setpoint": "Consigne chauffage", "coolingsetpoint": "Consigne refroidissement", "currenttemp": "Température actuelle", "fanspeed": "Vitesse du ventilateur", "temperature": "Température", "humidity": "Humidité", "illuminance": "Éclairement", "occupancy": "Occupation", "contact": "Contact", "battery": "Batterie", "activepower": "Puissance active", "importedenergy": "Énergie importée", "identify": "Identifier", "lock": "Verrouiller", "unlock": "Déverrouiller"
     },
     "tabs": {
       "switch": "Changer",

package/nodes/locales/it/knxUltimateAI.html

@@ -1,18 +1,48 @@
 <script type="text/markdown" data-help-name="knxUltimateAI">
 Questo nodo ascolta **tutti i telegrammi KNX** dal gateway KNX Ultimate selezionato, costruisce statistiche di traffico, rileva anomalie e può interrogare opzionalmente un LLM.
 
+Le sezioni dell'editor utilizzano le stesse tab verticali a sinistra dei nodi Matter. **Configurazione rapida** contiene soltanto le scelte AI più comuni (abilitazione, provider, credenziali, modello, lettura stati/comando attuatori KNX e conferma); i parametri tecnici sono raggruppati per argomento nelle altre tab.
+
 ## Output
 1. **Summary/Statistiche** (`msg.payload` JSON)
 2. **Anomalie** (`msg.payload` JSON)
 3. **Assistente AI** (`msg.payload` testo, con `msg.summary`)
+4. **Operazioni KNX** (un messaggio Universal Mode per ogni lettura o scrittura validata)
+
+Ogni messaggio emesso dalle uscite 3 e 4 contiene anche una copia del messaggio originale in ingresso in `msg.inputMessage`. In questo modo payload, topic, metadati della chat e qualsiasi altra proprietà di ingresso restano disponibili per i nodi successivi. Gli errori di clonazione o di invio vengono intercettati e segnalati senza propagarsi al runtime di Node-RED.
 
 ## Comandi (input)
 Invia `msg.topic`:
 - `summary` (o vuoto): emette subito la summary
 - `reset`: azzera storico e contatori interni
 - `ask`: invia una domanda all'LLM configurato
+- `confirm` / `cancel`: conferma o annulla i comandi KNX in attesa senza richiamare l'LLM
+- `clear_chat`: azzera la memoria della conversazione per la sessione corrente
+
+Per `ask`, passa la domanda in `msg.prompt` (consigliato), in `msg.payload` (stringa), oppure nei comuni campi Telegram `msg.payload.content` / `msg.payload.text`.
+
+Quando il controllo KNX è abilitato, i turni recenti sono conservati in RAM per `msg.knxAi.sessionId`, `msg.sessionId` o per il chat ID Telegram rilevato. Collega l'uscita 3 al nodo di risposta della chat e l'uscita 4 a un nodo KNX Ultimate configurato in **Modalità Universale**. Con la conferma attiva, la prima risposta mostra GA, DPT e payload delle scritture senza emetterle; la stessa sessione deve poi rispondere `CONFERMA`/`ANNULLA` entro 5 minuti. Una nuova richiesta sostituisce l'eventuale piano precedente. Ogni comando confermato contiene `msg.destination`, `msg.dpt`, `msg.payload` e `msg.event = "GroupValue_Write"`.
+Per le scritture DPT 1.xxx, gli equivalenti sicuri prodotti dall'AI `true`/`false`, `1`/`0` e `on`/`off` vengono normalizzati in un vero booleano prima della validazione locale e dell'uscita.
+
+### Letture KNX aggiornate
+Quando l'utente chiede esplicitamente uno stato attuale o aggiornato, l'AI può interrogare gli oggetti esatti del catalogo ETS importato, compresi gli oggetti di stato e di sola lettura. L'uscita 4 emette `msg.destination`, `msg.dpt`, `msg.event = "GroupValue_Read"` e `msg.readstatus = true`. Il nodo attende fino a 6 secondi ogni `GroupValue_Response` o scrittura fresca, poi restituisce i valori decodificati sull'uscita 3 e i dettagli in `msg.knxAi.readResults`. Le letture non richiedono mai conferma e non vengono mai trasformate in scritture.
+
+### Richiesta di conferma per pulsanti chat
+Quando un piano è in attesa, l'uscita 3 contiene `msg.knxAi.confirmationRequest`. L'oggetto include `required`, `status`, `sessionId`, `expiresAt`, `commandCount` e due elementi in `actions`. Usa `action.label` per il testo del pulsante Telegram, `action.callbackData` per il callback e reinvia `action.message` al nodo KNX AI per confermare o annullare senza digitare testo.
+
+### Preset adattatori chat
+La tab **Adattatori chat** carica le mappature selezionabili da `resources/KNXAIChatAdapterMappings.js`. Scegliendo un preset vengono inserite due mappature JavaScript sincrone e modificabili in caselle di testo a larghezza piena: una eseguita prima che KNX AI elabori l'ingresso e una prima dell'emissione sull'uscita 3. Restituisci `msg` per continuare oppure nessun valore per scartare il messaggio. Errori di sintassi o esecuzione vengono intercettati e segnalati senza arrestare Node-RED.
+
+Il preset incluso **windkh/node-red-contrib-telegrambot** segue il contratto receiver/sender del pacchetto. Collega direttamente un `telegram receiver` a KNX AI e l'uscita 3 direttamente a un `telegram sender`; per usare i pulsanti inline di conferma, collega allo stesso ingresso KNX AI anche un `telegram event` configurato come `callback_query`. La mappatura d'ingresso estrae `msg.payload.content`, `msg.payload.chatId` e la lingua Telegram. Quella d'uscita crea i campi richiesti `msg.payload.chatId`, `type` e `content`, aggiungendo `options.reply_markup` da `msg.knxAi.confirmationRequest` quando una scrittura attende conferma. Il pacchetto Telegram resta una dipendenza opzionale separata.
 
-Per `ask`, passa la domanda in `msg.prompt` (consigliato) oppure in `msg.payload` (stringa).
+## Workflow rapido: controllo KNX
+1. Importa il CSV ETS nel gateway e configura provider, modello e credenziali LLM.
+2. Abilita **Assistente LLM** e **lettura stati e controllo attuatori KNX**; lascia attiva la conferma.
+3. Collega l'ingresso della chat al nodo KNX AI mantenendo un ID sessione/chat stabile.
+4. Collega l'uscita 3 alla risposta della chat e l'uscita 4 a KNX Ultimate in **Modalità Universale**.
+5. L'utente invia una richiesta; gli stati aggiornati vengono letti subito, mentre per le scritture l'AI mostra prima GA, DPT e valore senza scrivere sul bus.
+6. Entro 5 minuti, la stessa chat risponde esattamente `CONFERMA` oppure `ANNULLA`.
+7. Solo `CONFERMA` rivalida ed emette i comandi sull'uscita 4; verifica l'esecuzione tramite una GA di stato.
 
 ## Campi di configurazione
 Di seguito sono elencati tutti i campi presenti nell'editor del nodo KNX AI.
@@ -53,7 +83,13 @@ Di seguito sono elencati tutti i campi presenti nell'editor del nodo KNX AI.
 - **URL endpoint**: URL endpoint chat/completions.
 - **API key**: chiave API (non necessaria con Ollama locale).
 - **Modello**: ID/nome modello.
+- **Compatibilità modello chat**: il modello selezionato deve supportare l'endpoint Chat Completions configurato. I modelli legacy disponibili solo tramite completions, come `gpt-3.5-turbo-instruct`, vengono esclusi quando si aggiorna la lista. Se il provider rifiuta un valore personalizzato di temperature o il parametro del limite token, KNX AI riprova rimuovendo o sostituendo soltanto il campo incompatibile.
 - **Prompt di sistema**: istruzione globale del comportamento analisi KNX (Advanced).
+- **Consenti all'AI di leggere stati KNX e comandare attuatori**: abilita l'uscita 4 ed è disattivato per default. Gli oggetti esatti del catalogo ETS possono essere letti; le scritture sono accettate solo per gli oggetti classificati come `command`. Operazioni sconosciute, con DPT discordante, non valide o eccessive e scritture verso oggetti di stato/neutrali vengono rifiutate localmente.
+- **Chiedi conferma prima di inviare comandi KNX**: attivo per default. Mostra prima le modifiche validate e non emette comandi KNX finché la stessa sessione chat non le conferma. Quando ci sono comandi in attesa, la risposta aggiunge sempre le istruzioni esatte per confermare o annullare nella lingua della richiesta corrente. I comandi vengono validati nuovamente subito prima dell'uscita.
+- **Preset adattatore**: carica una coppia di mappature ingresso/uscita dal file degli adattatori chat incluso. La selezione sostituisce intenzionalmente entrambe le caselle di testo; il codice resta modificabile.
+- **Mappatura ingresso (chat → KNX AI)**: JavaScript sincrono applicato prima dell'elaborazione del comando in ingresso.
+- **Mappatura uscita (KNX AI → chat)**: JavaScript sincrono applicato solo ai messaggi dell'uscita 3.
 - Se l'archivio su disco e' attivo, **Ask** lo usa di default: rispetta date/intervalli espliciti e, se non presenti, cerca nelle ultime 24 ore piu' gli eventi correnti in RAM.
 - **Includi payload raw in hex**: include payload raw esadecimale nel prompt.
 - **Includi inventario del progetto Node-RED**: include nel prompt l'inventario dell'intero progetto Node-RED, compresi nodi KNX e altri nodi utili come function/change/inject/template quando contengono logica KNX o group address.
@@ -84,5 +120,5 @@ Di seguito sono elencati tutti i campi presenti nell'editor del nodo KNX AI.
 - Se Node-RED gira in Docker, usa `host.docker.internal` al posto di `localhost` nell'endpoint.
 
 ## Nota sicurezza
-Se l'LLM è abilitato, il contesto traffico KNX può essere inviato all'endpoint configurato. Per privacy on-prem, usa provider locali.
+Se l'LLM è abilitato, il contesto traffico KNX può essere inviato all'endpoint configurato. Per privacy on-prem, usa provider locali. Un comando emesso sull'uscita 4 ha superato la validazione locale ed è stato inoltrato al flow, ma non prova che l'attuatore lo abbia eseguito. Per la conferma usa una GA di stato KNX.
 </script>

package/nodes/locales/it/knxUltimateAI.json

@@ -2,12 +2,14 @@
   "knxUltimateAI": {
     "title": "KNX AI (Analisi Traffico)",
     "sections": {
+      "quickSetup": "Configurazione rapida",
       "capture": "Cattura",
       "storage": "Storico e Summary",
       "detection": "Rilevamento e Avvisi",
       "llmConnection": "Connessione Assistente AI",
       "llmContext": "Contesto Assistente AI",
-      "advanced": "Tuning Avanzato"
+      "chatAdapter": "Adattatori chat",
+      "advanced": "AI avanzata"
     },
     "properties": {
       "server": "Gateway",
@@ -39,19 +41,28 @@
       "llmSystemPrompt": "Prompt di sistema",
       "llmIncludeRaw": "Includi payload raw in hex",
       "llmIncludeFlowContext": "Includi inventario del progetto Node-RED",
+      "llmAllowKnxCommands": "Consenti all'AI di leggere stati KNX e comandare attuatori",
+      "llmRequireCommandConfirmation": "Chiedi conferma prima di inviare comandi KNX",
+      "chatAdapterPreset": "Preset adattatore",
+      "chatInputCode": "Mappatura ingresso (chat → KNX AI)",
+      "chatOutputCode": "Mappatura uscita (KNX AI → chat)",
       "llmIncludeDocsSnippets": "Includi estratti documentazione (help/README/esempi)",
       "llmDocsLanguage": "Lingua documentazione"
     },
     "outputs": {
       "summary": "Summary/Statistiche",
       "anomalies": "Anomalie",
-      "assistant": "Assistente AI"
+      "assistant": "Assistente AI",
+      "knxCommands": "Operazioni KNX"
     },
     "selectlists": {
       "llmProvider": {
         "openai_compat": "Compatibile OpenAI (chat/completions)",
         "anthropic": "Anthropic (Claude)",
         "ollama": "Ollama (locale, beta)"
+      },
+      "chatAdapter": {
+        "none": "Nessun adattatore"
       }
     },
     "buttons": {
@@ -69,7 +80,9 @@
       "installedOllamaModel": "Modello Ollama installato",
       "installOllamaModelFailed": "Installazione modello Ollama non riuscita",
       "ollamaInstallSteps": "1) Apri la libreria, scegli un modello e copiane il nome (es. llama3.1). 2) Inserisci il nome nel campo Modello e clicca Installalo.",
-      "ollamaStartedAuto": "Server Ollama avviato automaticamente."
+      "ollamaStartedAuto": "Server Ollama avviato automaticamente.",
+      "chatAdapterIntro": "Scegli un preset per inserire il codice di mappatura in ingresso e in uscita. La lista viene caricata dal file degli adattatori chat incluso nel pacchetto; il codice generato resta modificabile.",
+      "chatAdapterCodeHelp": "Le mappature sono sincrone. Restituisci msg per continuare oppure nessun valore per scartarlo. Gli errori vengono intercettati e segnalati senza arrestare Node-RED."
     },
     "placeholder": {
       "llmBaseUrl": "https://api.openai.com/v1/chat/completions (o endpoint compatibile)",

package/nodes/locales/it/knxUltimateMatterBridge.html

@@ -45,7 +45,7 @@ Queste opzioni sono nascoste finché non servono al tipo selezionato. I disposit
 
 ## PIN del nodo
 
-Se abiliti i PIN input/output del nodo:
+Il selettore dei PIN si trova fuori dalle TAB dell'editor. Abilitandolo compare subito sotto una sezione contestuale **Input/output del flow**, con esempi copiabili filtrati per il tipo di dispositivo selezionato:
 
 - **Input**: aggiorna lo stato Matter dal flow, senza passare dal bus KNX: `msg.payload = { function: "onoff", value: true }` (`function` è una tra `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile per esporre ad Alexa & Co. valori calcolati nel flow (es. un sensore virtuale).
 - **Output**: ogni comando ricevuto da un controller Matter viene inoltrato al flow: `msg.topic` = nome del dispositivo, `msg.payload` = valore, `msg.matter` = il comando grezzo. Un dispositivo senza GA di comando diventa un **dispositivo solo-flow**.

package/nodes/locales/it/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "Mappature KNX",
       "advanced": "Opzioni avanzate"
     },
+    "flow_help": {
+      "title": "Input/output del flow",
+      "intro": "Questi esempi corrispondono al tipo di dispositivo selezionato e sono disponibili quando i PIN input/output del nodo sono abilitati.",
+      "input_title": "Flow → Matter (input del nodo)",
+      "input_hint": "Invia uno di questi messaggi per aggiornare lo stato Matter esposto senza scrivere sul bus KNX.",
+      "output_title": "Matter → Flow (output del nodo)",
+      "output_hint": "I comandi ricevuti da un controller Matter vengono emessi con il valore in msg.payload e i dettagli raw in msg.matter.",
+      "function": "Funzione",
+      "message": "Messaggio di esempio",
+      "copy": "Copia",
+      "copied": "Messaggio copiato",
+      "no_input": "Questo tipo di dispositivo non ha esempi di aggiornamento stato dal flow.",
+      "no_output": "Questo tipo di dispositivo non emette comandi dal controller; il suo output rimane inattivo."
+    },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA stato On/Off",

package/nodes/locales/it/knxUltimateMatterControllerDevice.html

@@ -19,11 +19,11 @@ Sostituisce i nodi Matter separati non pubblicati e mantiene tutta la UI luce qu
 | Sensori | Gli endpoint sensore mostrano il relativo GA di misura/stato solo quando supportato: temperatura, umidità, illuminamento, presenza, contatto e batteria. |
 | Read at startup | Pubblica il valore Matter in cache al deploy/avvio o quando il dispositivo si riconnette. |
 | Update local state from KNX write | Aggiorna la cache locale Matter/KNX quando arriva una scrittura su un GA KNX configurato. |
-| Node Input/Output PINs | Mostra i pin input/output Node-RED. Gli endpoint non luce accettano il formato semplice `{function,value}` descritto sotto e i campi Matter avanzati; l'output emette gli aggiornamenti di stato. La selezione viene mantenuta alla riapertura dell'editor. |
+| Node Input/Output PINs | Mostra i pin input/output Node-RED e la sezione **Input dal flow** subito sotto questo campo. Per le luci sono mostrati i messaggi di stato luce supportati al primo livello; per gli endpoint non luce sono mostrati il formato semplice `{function,value}` e i campi Matter avanzati. La selezione viene mantenuta alla riapertura dell'editor. |
 
 ## Input dal flow
 
-Per un endpoint non luce selezionato, apri la TAB **Input dal flow** nell'editor. La scheda viene costruita dalla struttura annunciata dall'endpoint e mostra esempi copiabili, l'Endpoint ID selezionato, tutti gli attributi leggibili/scrivibili e tutti i comandi accettati. Rimane disponibile anche quando il nodo viene usato soltanto dal flow senza gateway KNX.
+Abilita **PIN di Input/Output del nodo** per mostrare la sezione **Input dal flow** subito sotto il selettore. Per le luci contiene esempi copiabili delle proprietà supportate al primo livello, come `msg.on`, `msg.dimming`, `msg.color_temperature` e `msg.color`. Per gli endpoint non luce viene costruita dalla struttura annunciata e mostra l'Endpoint ID selezionato, tutti gli attributi leggibili/scrivibili e tutti i comandi accettati. Rimane disponibile anche quando il nodo viene usato soltanto dal flow senza gateway KNX.
 
 Le scritture semplici usano `msg.payload = {function:"position",value:35}`. Ometti `value` per leggere uno stato supportato, ad esempio `{function:"temperature"}`; l'output usa unità comprensibili e include i dettagli raw in `msg.matter`. Le funzioni comprendono `onoff`, `level`, `position`, `tiltposition`, `open`, `close`, `stop`, `setpoint`, `coolingsetpoint`, `currenttemp`, `fanspeed`, letture sensore e `identify`, ma soltanto se annunciate dall'endpoint. La serratura accetta `{function:"lock",value:true|false}`.
 

package/nodes/locales/it/knxUltimateMatterControllerDevice.json

@@ -17,6 +17,7 @@
     "input_help_endpoint_hint": "Il nodo conosce già Node ID ed Endpoint ID, quindi non servono nei messaggi semplici.",
     "input_help_simple_title": "Messaggi semplici",
     "input_help_simple_hint": "Queste funzioni usano unità comprensibili e vengono tradotte nel cluster, comando o attributo Matter esposto dall'endpoint selezionato.",
+    "input_help_light_hint": "Gli endpoint luce accettano le proprietà dello stato luce direttamente in msg (non dentro msg.payload). Sono mostrati solo i controlli supportati dalla luce selezionata.",
     "input_help_advanced_title": "Dettagli Matter avanzati",
     "input_help_advanced_hint": "Sono elencati soltanto attributi e comandi annunciati. Gli esempi di scrittura usano 0 come segnaposto; gli argomenti dei comandi possono richiedere un adattamento al tipo Matter.",
     "input_help_operation": "Operazione",
@@ -31,7 +32,7 @@
     "input_help_no_simple": "Questo endpoint non espone funzioni semplici conosciute.",
     "input_help_no_structure": "La struttura Matter non è disponibile. Aggiorna la lista dei dispositivi mentre l'endpoint è online.",
     "input_functions": {
-      "onoff": "On / Off", "level": "Livello", "position": "Posizione tapparella", "tiltposition": "Inclinazione tapparella", "open": "Apri", "close": "Chiudi", "stop": "Stop", "setpoint": "Setpoint riscaldamento", "coolingsetpoint": "Setpoint raffrescamento", "currenttemp": "Temperatura corrente", "fanspeed": "Velocità ventilatore", "temperature": "Temperatura", "humidity": "Umidità", "illuminance": "Illuminamento", "occupancy": "Presenza", "contact": "Contatto", "battery": "Batteria", "activepower": "Potenza attiva", "importedenergy": "Energia importata", "identify": "Identifica", "lock": "Blocca", "unlock": "Sblocca"
+      "onoff": "On / Off", "on": "Accendi", "off": "Spegni", "level": "Livello", "brightness": "Luminosità", "color_temperature": "Temperatura colore", "xy_color": "Colore XY", "position": "Posizione tapparella", "tiltposition": "Inclinazione tapparella", "open": "Apri", "close": "Chiudi", "stop": "Stop", "setpoint": "Setpoint riscaldamento", "coolingsetpoint": "Setpoint raffrescamento", "currenttemp": "Temperatura corrente", "fanspeed": "Velocità ventilatore", "temperature": "Temperatura", "humidity": "Umidità", "illuminance": "Illuminamento", "occupancy": "Presenza", "contact": "Contatto", "battery": "Batteria", "activepower": "Potenza attiva", "importedenergy": "Energia importata", "identify": "Identifica", "lock": "Blocca", "unlock": "Sblocca"
     },
     "tabs": {
       "switch": "On/Off",

package/nodes/locales/zh-CN/knxUltimateAI.html

@@ -1,18 +1,48 @@
 <script type="text/markdown" data-help-name="knxUltimateAI">
 此节点会监听所选 KNX Ultimate 网关上的**所有 KNX 电报**，生成流量统计、检测异常，并可选调用 LLM。
 
+编辑器各部分使用与 Matter 节点相同的左侧垂直选项卡。**快速配置**仅包含常用 AI 选项（启用、提供商、凭据、模型、KNX 状态读取/执行器控制和确认）；技术参数按主题归入其他选项卡。
+
 ## 输出
 1. **摘要/统计**（`msg.payload` 为 JSON）
 2. **异常**（`msg.payload` 为 JSON）
 3. **AI 助手**（`msg.payload` 为文本，包含 `msg.summary`）
+4. **KNX 操作**（每个通过验证的读取或写入输出一条 Universal Mode 消息）
+
+输出 3 和输出 4 发出的每条消息还会在 `msg.inputMessage` 中包含原始输入消息的副本。因此，原始 payload、topic、聊天元数据及其他输入属性都可供后续节点使用。克隆或输出错误会被捕获并报告，不会传播到 Node-RED 运行时。
 
 ## 命令（输入）
 发送 `msg.topic`：
 - `summary`（或空）：立即输出摘要
 - `reset`：清空内部历史与计数器
 - `ask`：向已配置的 LLM 提问
+- `confirm` / `cancel`：无需再次调用 LLM，即可确认或取消待处理的 KNX 命令
+- `clear_chat`：清除当前会话的对话记忆
+
+`ask` 的问题建议放在 `msg.prompt`，也可放在 `msg.payload`（字符串）或常见 Telegram 字段 `msg.payload.content` / `msg.payload.text`。
+
+启用 KNX 控制后，最近的对话会按 `msg.knxAi.sessionId`、`msg.sessionId` 或检测到的 Telegram 聊天 ID 保存在 RAM 中。将输出 3 连接到聊天发送节点，将输出 4 连接到配置为**通用模式**的 KNX Ultimate 节点。启用确认后，第一条回复会显示 GA、DPT 和 payload，但不会发送写入；同一会话必须在 5 分钟内回复“确认”或“取消”。新请求会替换旧的待处理计划。每条已确认命令都包含 `msg.destination`、`msg.dpt`、`msg.payload` 和 `msg.event = "GroupValue_Write"`。
+对于 DPT 1.xxx 写入，AI 生成的安全等价值 `true`/`false`、`1`/`0` 和 `on`/`off` 会在本地校验和输出前统一转换为真正的布尔值。
+
+### 最新 KNX 读取
+当用户明确要求当前或最新状态时，AI 可以查询已导入 ETS 目录中的精确对象，包括状态对象和其他只读对象。输出 4 会发送 `msg.destination`、`msg.dpt`、`msg.event = "GroupValue_Read"` 和 `msg.readstatus = true`。节点会为每个 `GroupValue_Response` 或最新写入等待最多 6 秒，然后在输出 3 返回解码值，并在 `msg.knxAi.readResults` 中提供详细信息。读取从不需要确认，也绝不会转换为写入。
+
+### 用于聊天按钮的确认请求
+计划等待确认时，输出 3 包含 `msg.knxAi.confirmationRequest`。该对象包括 `required`、`status`、`sessionId`、`expiresAt`、`commandCount`，以及 `actions` 中的两个项目。使用 `action.label` 作为 Telegram 按钮文本，使用 `action.callbackData` 作为回调，并将 `action.message` 发送回 KNX AI，即可在无需输入文本的情况下确认或取消。
+
+### 聊天适配器预设
+**聊天适配器**选项卡从 `resources/KNXAIChatAdapterMappings.js` 加载可选映射。选择预设会在全宽文本框中插入两段可编辑的同步 JavaScript 映射：一段在 KNX AI 处理输入前运行，另一段在输出 3 发出消息前运行。返回 `msg` 以继续，或不返回值以丢弃消息。语法和执行错误会被捕获并报告，不会停止 Node-RED。
+
+随附的 **windkh/node-red-contrib-telegrambot** 预设遵循该包的 receiver/sender 消息约定。把 `telegram receiver` 直接连接到 KNX AI，并把输出 3 直接连接到 `telegram sender`。如需内联确认按钮，还要把配置为 `callback_query` 的 `telegram event` 连接到同一个 KNX AI 输入。输入映射会提取 `msg.payload.content`、`msg.payload.chatId` 和 Telegram 语言；输出映射会创建所需的 `msg.payload.chatId`、`type` 和 `content`，并在写入等待确认时从 `msg.knxAi.confirmationRequest` 添加 `options.reply_markup`。Telegram 包仍是独立的可选依赖项。
 
-`ask` 的问题建议放在 `msg.prompt`，也可放在 `msg.payload`（字符串）。
+## 快速工作流程：KNX 控制
+1. 将 ETS CSV 导入网关，并配置 LLM 提供商、模型和凭据。
+2. 启用 **LLM 助手**和 **读取 KNX 状态并控制执行器**；保持确认选项启用。
+3. 将聊天输入连接到 KNX AI，并保留稳定的会话/聊天 ID。
+4. 将输出 3 连接到聊天回复，将输出 4 连接到处于**通用模式**的 KNX Ultimate。
+5. 用户发送请求；当前状态会立即读取，而写入会先显示 GA、DPT 和值，不会立即写入总线。
+6. 同一聊天必须在 5 分钟内准确回复“确认”或“取消”。
+7. 只有“确认”会重新验证并在输出 4 发送命令；请通过 KNX 状态 GA 验证执行结果。
 
 ## 配置字段
 以下是编辑器里用户可见的全部字段名称。
@@ -53,7 +83,13 @@
 - **Endpoint URL**：chat/completions 接口 URL。
 - **API key**：API Key（本地 Ollama 可不填）。
 - **Model**：模型 ID/名称。
+- **聊天模型兼容性**：所选模型必须支持已配置的 Chat Completions 端点。刷新模型列表时，会排除仅支持旧版 completions 的模型，例如 `gpt-3.5-turbo-instruct`。如果提供商拒绝自定义 temperature 值或令牌限制参数，KNX AI 会仅移除或替换不兼容字段后重试。
 - **System prompt**：KNX 分析全局系统提示词（Advanced）。
+- **允许 AI 读取 KNX 状态并控制执行器**：启用输出 4，默认关闭。可以读取 ETS 目录中的精确对象；仅接受写入明确标记为 `command` 的对象。未知、DPT 不匹配、无效或数量过多的操作，以及向状态或中性对象的写入，都会在本地被拒绝。
+- **发送 KNX 命令前请求确认**：默认启用。先显示已验证的修改，在同一聊天会话确认前不会发送任何 KNX 命令。有命令等待确认时，回复始终会使用当前请求的语言附加准确的确认或取消说明。命令会在输出前再次验证。
+- **适配器预设**：从随附的聊天适配器文件加载一对输入/输出映射。选择预设会有意替换两个文本框，之后仍可编辑代码。
+- **输入映射（聊天 → KNX AI）**：在处理输入命令前运行的同步 JavaScript。
+- **输出映射（KNX AI → 聊天）**：仅应用于输出 3 消息的同步 JavaScript。
 - 如果启用了磁盘归档，**Ask** 默认会查询该归档：若问题里写了明确日期/时间范围就按其查询，否则默认查询最近 24 小时并补上当前 RAM 事件。
 - **Include raw payload hex**：在提示词中包含原始十六进制 payload。
 - **包含 Node-RED 项目清单**：在提示词中加入整个 Node-RED 项目的节点清单，不仅包含 KNX 节点，也包含 function/change/inject/template 等在内且带有 KNX 逻辑或组地址的有用节点。
@@ -84,5 +120,5 @@
 - 若 Node-RED 运行在 Docker 中，endpoint 请使用 `host.docker.internal` 替代 `localhost`。
 
 ## 安全说明
-启用 LLM 后，KNX 流量上下文可能发送到所配置的 endpoint。若需严格本地化，请使用本地 provider。
+启用 LLM 后，KNX 流量上下文可能发送到所配置的 endpoint。若需严格本地化，请使用本地 provider。输出 4 上的命令仅表示已通过本地验证并转发到 flow，并不能证明执行器已执行；需要确认时请使用 KNX 状态 GA。
 </script>

package/nodes/locales/zh-CN/knxUltimateAI.json

@@ -2,12 +2,14 @@
   "knxUltimateAI": {
     "title": "KNX AI (Traffic Analyzer)",
     "sections": {
+      "quickSetup": "快速配置",
       "capture": "Capture",
       "storage": "历史与摘要",
       "detection": "检测与告警",
       "llmConnection": "AI 助手连接",
       "llmContext": "AI 助手上下文",
-      "advanced": "高级调优"
+      "chatAdapter": "聊天适配器",
+      "advanced": "AI 高级设置"
     },
     "properties": {
       "server": "Gateway",
@@ -39,19 +41,28 @@
       "llmSystemPrompt": "System prompt",
       "llmIncludeRaw": "Include raw payload hex",
       "llmIncludeFlowContext": "包含 Node-RED 项目清单",
+      "llmAllowKnxCommands": "允许 AI 读取 KNX 状态并控制执行器",
+      "llmRequireCommandConfirmation": "发送 KNX 命令前请求确认",
+      "chatAdapterPreset": "适配器预设",
+      "chatInputCode": "输入映射（聊天 → KNX AI）",
+      "chatOutputCode": "输出映射（KNX AI → 聊天）",
       "llmIncludeDocsSnippets": "Include documentation snippets (help/README/examples)",
       "llmDocsLanguage": "Docs language"
     },
     "outputs": {
       "summary": "摘要/统计",
       "anomalies": "异常",
-      "assistant": "AI 助手"
+      "assistant": "AI 助手",
+      "knxCommands": "KNX 操作"
     },
     "selectlists": {
       "llmProvider": {
         "openai_compat": "OpenAI-compatible (chat/completions)",
         "anthropic": "Anthropic (Claude)",
         "ollama": "Ollama (local, beta)"
+      },
+      "chatAdapter": {
+        "none": "无适配器"
       }
     },
     "messages": {
@@ -61,7 +72,9 @@
       "installedOllamaModel": "Ollama model installed",
       "installOllamaModelFailed": "Failed to install Ollama model",
       "ollamaInstallSteps": "1) Open the model library and copy the model name (for example llama3.1). 2) Put the name in the Model field and click Install it.",
-      "ollamaStartedAuto": "Ollama server started automatically."
+      "ollamaStartedAuto": "Ollama server started automatically.",
+      "chatAdapterIntro": "选择预设即可插入输入和输出映射代码。列表从随包提供的聊天适配器文件加载；生成的代码仍可编辑。",
+      "chatAdapterCodeHelp": "映射同步运行。返回 msg 以继续，或不返回值以丢弃消息。错误会被捕获并报告，不会停止 Node-RED。"
     },
     "placeholder": {
       "llmBaseUrl": "https://api.openai.com/v1/chat/completions (or your compatible endpoint)",

package/nodes/locales/zh-CN/knxUltimateMatterBridge.html

@@ -45,7 +45,7 @@
 
 ## 节点引脚
 
-如果启用节点的输入/输出引脚：
+引脚选择器位于编辑器选项卡之外。启用后，其下方会显示与所选设备类型匹配的 **Flow 输入/输出** 区域，并提供可复制示例：
 
 - **输入**：从 Flow 更新 Matter 状态，无需经过 KNX 总线：`msg.payload = { function: "onoff", value: true }`（`function` 为 `onoff`、`level`、`rgb`、`colortemp`、`position`、`temperature`、`humidity`、`illuminance`、`occupancy`、`contact`、`currenttemp`、`setpoint`、`fanspeed`、`smoke`、`co`、`leak`、`co2`、`rvcstate`、`rvcmode` 之一）。适合把 Flow 中计算的值（如虚拟传感器）公开给 Alexa 等。
 - **输出**：从 Matter 控制器收到的每个命令都转发到 Flow：`msg.topic` = 设备名称，`msg.payload` = 值，`msg.matter` = 原始命令。没有命令 GA 的设备成为**纯 Flow 设备**。

package/nodes/locales/zh-CN/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "KNX 映射",
       "advanced": "高级选项"
     },
+    "flow_help": {
+      "title": "Flow 输入/输出",
+      "intro": "这些示例与所选设备类型匹配，并在启用节点输入/输出引脚时显示。",
+      "input_title": "Flow → Matter（节点输入）",
+      "input_hint": "发送以下消息之一，无需写入 KNX 即可更新所公开的 Matter 状态。",
+      "output_title": "Matter → Flow（节点输出）",
+      "output_hint": "Matter 控制器收到的命令会输出，值位于 msg.payload，原始路由详情位于 msg.matter。",
+      "function": "功能",
+      "message": "示例消息",
+      "copy": "复制",
+      "copied": "消息已复制",
+      "no_input": "此设备类型没有 Flow 状态更新示例。",
+      "no_output": "此设备类型不会输出控制器命令；其输出保持静默。"
+    },
     "functions": {
       "fn_onoff_cmd": "开/关 命令 GA",
       "fn_onoff_status": "开/关 状态 GA",

package/nodes/locales/zh-CN/knxUltimateMatterControllerDevice.html

@@ -19,11 +19,11 @@
 | 传感器 | 传感器 endpoint 只在支持时显示对应测量/状态 GA：温度、湿度、照度、占用、接触和电池。 |
 | Read at startup | 在部署/启动或设备重新连接时发布缓存的 Matter 值。 |
 | Update local state from KNX write | 当配置的 KNX GA 收到写入 telegram 时，更新本地 Matter/KNX 缓存。 |
-| Node Input/Output PINs | 显示 Node-RED 输入/输出端口。非灯光端点接受简单的 `{function,value}` 格式和高级 Matter 字段；输出发送状态更新。 |
+| Node Input/Output PINs | 显示 Node-RED 输入/输出端口，并在该字段下方显示 **流程输入** 区域。灯光会显示其支持的顶层灯光状态消息；其他端点会显示简单的 `{function,value}` 格式和高级 Matter 字段。 |
 
 ## 流程输入
 
-选择非灯光端点后，打开 **流程输入** 选项卡。该选项卡根据端点公布的结构生成，并显示可复制示例、Endpoint ID、所有可读/可写属性以及接受的命令。节点仅用于 flow 且未选择 KNX 网关时，该选项卡仍然可用。
+启用 **Node Input/Output PINs** 后，**流程输入** 区域会直接显示在选择器下方。对于灯光，它提供所支持顶层属性的可复制示例，例如 `msg.on`、`msg.dimming`、`msg.color_temperature` 和 `msg.color`。对于其他端点，该区域根据公布的结构生成，并显示 Endpoint ID、所有可读/可写属性以及接受的命令。未选择 KNX 网关时仍然可用。
 
 简单写入使用 `msg.payload = {function:"position",value:35}`。省略 `value` 即可读取支持的状态，例如 `{function:"temperature"}`；输出使用易懂单位，并在 `msg.matter` 中保留原始详情。`onoff`、`level`、`position`、`open`、`close`、`stop`、设定点、风扇和传感器功能仅在端点公布支持时出现。门锁接受 `{function:"lock",value:true|false}`。
 

package/nodes/locales/zh-CN/knxUltimateMatterControllerDevice.json

@@ -17,6 +17,7 @@
     "input_help_endpoint_hint": "节点已知 Node ID 和 Endpoint ID，因此简单消息无需提供它们。",
     "input_help_simple_title": "简单消息",
     "input_help_simple_hint": "这些功能使用易懂的单位，并自动转换为所选端点公开的 Matter 集群、命令或属性。",
+    "input_help_light_hint": "灯光端点直接在 msg 上接收灯光状态属性（而不是放在 msg.payload 中）。这里只显示所选灯具支持的控制项。",
     "input_help_advanced_title": "高级 Matter 详情",
     "input_help_advanced_hint": "仅列出设备公布的属性和命令。写入示例中的 0 是占位值；命令参数可能需要按 Matter 数据类型调整。",
     "input_help_operation": "操作",
@@ -31,7 +32,7 @@
     "input_help_no_simple": "此端点没有已知的简单输入功能。",
     "input_help_no_structure": "Matter 结构不可用。请在端点在线时刷新设备列表。",
     "input_functions": {
-      "onoff": "开 / 关", "level": "亮度", "position": "窗帘位置", "tiltposition": "百叶角度", "open": "打开", "close": "关闭", "stop": "停止", "setpoint": "制热设定点", "coolingsetpoint": "制冷设定点", "currenttemp": "当前温度", "fanspeed": "风扇速度", "temperature": "温度", "humidity": "湿度", "illuminance": "照度", "occupancy": "占用", "contact": "触点", "battery": "电池", "activepower": "有功功率", "importedenergy": "输入电能", "identify": "识别", "lock": "上锁", "unlock": "解锁"
+      "onoff": "开 / 关", "on": "打开", "off": "关闭", "level": "亮度", "brightness": "亮度", "color_temperature": "色温", "xy_color": "XY 颜色", "position": "窗帘位置", "tiltposition": "百叶角度", "open": "打开", "close": "关闭", "stop": "停止", "setpoint": "制热设定点", "coolingsetpoint": "制冷设定点", "currenttemp": "当前温度", "fanspeed": "风扇速度", "temperature": "温度", "humidity": "湿度", "illuminance": "照度", "occupancy": "占用", "contact": "触点", "battery": "电池", "activepower": "有功功率", "importedenergy": "输入电能", "identify": "识别", "lock": "上锁", "unlock": "解锁"
     },
     "tabs": {
       "switch": "开关",

package/nodes/utils/sysLogger.js

@@ -1,86 +1,8 @@
 /**
 * (C) 2024 Supergiovane
 */
-const util = require('util')
 const logger = require('node-color-log')
 
-const DEBUG_BUFFER_LIMIT = 5000
-const debugBuffer = []
-let debugSequence = 0
-
-const cloneEntry = (entry) => ({
-  seq: entry.seq,
-  level: entry.level,
-  prefix: entry.prefix,
-  message: entry.message,
-  timestamp: entry.timestamp,
-  isoTimestamp: entry.isoTimestamp,
-  sessionStart: entry.sessionStart
-})
-
-const normaliseLevel = (level) => {
-  const allowed = ['success', 'debug', 'info', 'warn', 'error']
-  if (allowed.includes(level)) return level
-  return 'info'
-}
-
-const stringifyArg = (arg) => {
-  if (arg === null) return 'null'
-  if (arg === undefined) return 'undefined'
-  if (arg instanceof Error) return arg.stack || `${arg.name || 'Error'}: ${arg.message}`
-  const type = typeof arg
-  if (type === 'string') return arg
-  if (type === 'number' || type === 'boolean' || type === 'bigint') return String(arg)
-  if (type === 'symbol') return arg.toString()
-  try {
-    return util.inspect(arg, { depth: 6, breakLength: 120, compact: false })
-  } catch (error) {
-    return String(arg)
-  }
-}
-
-const formatArgs = (args) => {
-  if (!args || !args.length) return ''
-  return args.map(stringifyArg).join(' ')
-}
-
-const pushDebugEntry = (level, prefix, args, meta = {}) => {
-  try {
-    const effectiveLevel = normaliseLevel(level)
-    const timestamp = Date.now()
-    const isoTimestamp = new Date(timestamp).toISOString()
-    const message = formatArgs(args)
-    debugSequence += 1
-    debugBuffer.push({
-      seq: debugSequence,
-      level: effectiveLevel,
-      prefix: prefix || '',
-      message,
-      timestamp,
-      isoTimestamp,
-      sessionStart: !!meta.sessionStart
-    })
-    if (debugBuffer.length > DEBUG_BUFFER_LIMIT) {
-      debugBuffer.splice(0, debugBuffer.length - DEBUG_BUFFER_LIMIT)
-    }
-  } catch (error) {
-    // As a last resort, make sure the failure itself is recorded.
-    debugSequence += 1
-    debugBuffer.push({
-      seq: debugSequence,
-      level: 'error',
-      prefix: prefix || '',
-      message: `Logger buffer failure: ${error.message || error}`,
-      timestamp: Date.now(),
-      isoTimestamp: new Date().toISOString(),
-      sessionStart: false
-    })
-    if (debugBuffer.length > DEBUG_BUFFER_LIMIT) {
-      debugBuffer.splice(0, debugBuffer.length - DEBUG_BUFFER_LIMIT)
-    }
-  }
-}
-
 class loggerClass {
   logLevel = 'info'
   prefix = ''
@@ -99,62 +21,31 @@ class loggerClass {
     this.logger.setLevel(requestedLevel)
     this.logger.setDate(() => (new Date()).toLocaleString())
     this.logLevel = requestedLevel
-    pushDebugEntry('info', this.prefix, [`--- Logger session started (level: ${this.logLevel}) ---`], { sessionStart: true })
   }
 
   destroy = () => {
     // Placeholder for backward compatibility; kept for API symmetry.
   }
 
-  record = (level, args) => {
-    pushDebugEntry(level, this.prefix, args)
-  }
-
   success = (...args) => {
-    this.record('success', args)
     this.logger.success(...args)
   }
 
   debug = (...args) => {
-    this.record('debug', args)
     this.logger.debug(...args)
   }
 
   info = (...args) => {
-    this.record('info', args)
     this.logger.info(...args)
   }
 
   warn = (...args) => {
-    this.record('warn', args)
     this.logger.warn(...args)
   }
 
   error = (...args) => {
-    this.record('error', args)
     this.logger.error(...args)
   }
 }
 
-loggerClass.getDebugSnapshot = (options = {}) => {
-  const sinceSeqRaw = options.sinceSeq
-  const sinceSeq = Number.isInteger(sinceSeqRaw) ? sinceSeqRaw : null
-  const source = sinceSeq === null ? debugBuffer : debugBuffer.filter((entry) => entry.seq > sinceSeq)
-  const entries = source.map(cloneEntry)
-  const latestSeq = debugBuffer.length ? debugBuffer[debugBuffer.length - 1].seq : (sinceSeq || 0)
-  return {
-    entries,
-    latestSeq,
-    total: debugBuffer.length,
-    limit: DEBUG_BUFFER_LIMIT
-  }
-}
-
-loggerClass.clearDebugBuffer = () => {
-  debugBuffer.length = 0
-  debugSequence = 0
-}
-
-loggerClass.DEBUG_BUFFER_LIMIT = DEBUG_BUFFER_LIMIT
-
 module.exports = loggerClass

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.1.0",
+  "version": "6.2.0",
   "description": "KNX Ultimate is the most advanced KNX integration for Node-RED, providing secure KNX/IP communication, routing, ETS project import, Philips Hue, Matter Controller and Matter Bridge (control matter device via KNX and expose KNX GA via Matter), MQTT, diagnostics with AI, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.",
   "files": [
     "nodes/",
@@ -32,7 +32,6 @@
     "version": ">=3.1.1",
     "plugins": {
       "commonFunctions": "/nodes/commonFunctions.js",
-      "knxUltimateMonitorSidebar": "/nodes/plugins/knxUltimateMonitor-sidebar-plugin.html",
       "knxUltimateFlowBubbles": "/nodes/plugins/knxUltimate-flow-bubbles-plugin.html"
     },
     "nodes": {