node-red-contrib-knx-ultimate 6.4.1 → 7.0.0

package/examples/KNX AI - Conversational Control with Confirmation.json

@@ -1,395 +0,0 @@
-[
-  {
-    "id": "tab_knx_ai_control",
-    "type": "tab",
-    "label": "KNX AI - Conversational control",
-    "disabled": false,
-    "info": "Example of fresh KNX state reads, conversational multi-step routines and actuator control with a mandatory confirmation step for writes."
-  },
-  {
-    "id": "cmt_knx_ai_control_setup",
-    "type": "comment",
-    "z": "tab_knx_ai_control",
-    "name": "1. Configure the KNX gateway, import the ETS CSV and configure the LLM/API key in KNX AI",
-    "info": "The AI only uses exact group addresses and DPTs found in the ETS catalog imported by the KNX gateway configuration node. Any exact object may be read; only command objects may be written.",
-    "x": 490,
-    "y": 40,
-    "wires": []
-  },
-  {
-    "id": "cmt_knx_ai_control_warning",
-    "type": "comment",
-    "z": "tab_knx_ai_control",
-    "name": "WARNING: reads are immediate; after CONFERMA output 4 writes validated commands to the real KNX bus",
-    "info": "Test with safe group addresses. Fresh reads need no confirmation. A pending write plan expires after five minutes and belongs only to the same chatId.",
-    "x": 470,
-    "y": 80,
-    "wires": []
-  },
-  {
-    "id": "cmt_knx_ai_control_input",
-    "type": "comment",
-    "z": "tab_knx_ai_control",
-    "name": "Telegram receiver or the demo buttons",
-    "info": "A Telegram receiver can be connected directly when its message contains the text and chat identifier. The demo inject nodes use chatId=demo-chat-1.",
-    "x": 190,
-    "y": 140,
-    "wires": []
-  },
-  {
-    "id": "inj_knx_ai_control_ask",
-    "type": "inject",
-    "z": "tab_knx_ai_control",
-    "name": "1. Richiesta: accendi la luce",
-    "props": [
-      {
-        "p": "payload",
-        "v": "Accendi la luce del soggiorno",
-        "vt": "str"
-      },
-      {
-        "p": "topic",
-        "v": "ask",
-        "vt": "str"
-      },
-      {
-        "p": "chatId",
-        "v": "demo-chat-1",
-        "vt": "str"
-      },
-      {
-        "p": "language",
-        "v": "it",
-        "vt": "str"
-      }
-    ],
-    "repeat": "",
-    "crontab": "",
-    "once": false,
-    "onceDelay": 0.1,
-    "x": 190,
-    "y": 180,
-    "wires": [
-      [
-        "node_knx_ai_control"
-      ]
-    ]
-  },
-  {
-    "id": "inj_knx_ai_control_confirm",
-    "type": "inject",
-    "z": "tab_knx_ai_control",
-    "name": "2. CONFERMA (stessa chat)",
-    "props": [
-      {
-        "p": "payload",
-        "v": "CONFERMA",
-        "vt": "str"
-      },
-      {
-        "p": "topic",
-        "v": "ask",
-        "vt": "str"
-      },
-      {
-        "p": "chatId",
-        "v": "demo-chat-1",
-        "vt": "str"
-      },
-      {
-        "p": "language",
-        "v": "it",
-        "vt": "str"
-      }
-    ],
-    "repeat": "",
-    "crontab": "",
-    "once": false,
-    "onceDelay": 0.1,
-    "x": 180,
-    "y": 220,
-    "wires": [
-      [
-        "node_knx_ai_control"
-      ]
-    ]
-  },
-  {
-    "id": "inj_knx_ai_control_read",
-    "type": "inject",
-    "z": "tab_knx_ai_control",
-    "name": "Lettura: temperatura attuale dal bus",
-    "props": [
-      {
-        "p": "payload",
-        "v": "Richiedi al bus KNX la temperatura attuale del soggiorno e dimmi il valore",
-        "vt": "str"
-      },
-      {
-        "p": "topic",
-        "v": "ask",
-        "vt": "str"
-      },
-      {
-        "p": "chatId",
-        "v": "demo-chat-1",
-        "vt": "str"
-      },
-      {
-        "p": "language",
-        "v": "it",
-        "vt": "str"
-      }
-    ],
-    "repeat": "",
-    "crontab": "",
-    "once": false,
-    "onceDelay": 0.1,
-    "x": 200,
-    "y": 300,
-    "wires": [
-      [
-        "node_knx_ai_control"
-      ]
-    ]
-  },
-  {
-    "id": "inj_knx_ai_control_cancel",
-    "type": "inject",
-    "z": "tab_knx_ai_control",
-    "name": "Oppure ANNULLA (stessa chat)",
-    "props": [
-      {
-        "p": "payload",
-        "v": "ANNULLA",
-        "vt": "str"
-      },
-      {
-        "p": "topic",
-        "v": "ask",
-        "vt": "str"
-      },
-      {
-        "p": "chatId",
-        "v": "demo-chat-1",
-        "vt": "str"
-      },
-      {
-        "p": "language",
-        "v": "it",
-        "vt": "str"
-      }
-    ],
-    "repeat": "",
-    "crontab": "",
-    "once": false,
-    "onceDelay": 0.1,
-    "x": 190,
-    "y": 260,
-    "wires": [
-      [
-        "node_knx_ai_control"
-      ]
-    ]
-  },
-  {
-    "id": "inj_knx_ai_control_routine",
-    "type": "inject",
-    "z": "tab_knx_ai_control",
-    "name": "Routine: sto uscendo",
-    "props": [
-      {
-        "p": "payload",
-        "v": "Sto uscendo: controlla gli stati aggiornati della casa e prepara una routine sicura per spegnere le luci, abbassare le tapparelle e ridurre il clima. Segnalami porte o finestre aperte.",
-        "vt": "str"
-      },
-      {
-        "p": "topic",
-        "v": "ask",
-        "vt": "str"
-      },
-      {
-        "p": "chatId",
-        "v": "demo-chat-1",
-        "vt": "str"
-      },
-      {
-        "p": "language",
-        "v": "it",
-        "vt": "str"
-      }
-    ],
-    "repeat": "",
-    "crontab": "",
-    "once": false,
-    "onceDelay": 0.1,
-    "x": 170,
-    "y": 340,
-    "wires": [
-      [
-        "node_knx_ai_control"
-      ]
-    ]
-  },
-  {
-    "id": "node_knx_ai_control",
-    "type": "knxUltimateAI",
-    "z": "tab_knx_ai_control",
-    "server": "cfg_knx_ai_control",
-    "name": "KNX AI with confirmation",
-    "topic": "knx-ai",
-    "llmEnabled": true,
-    "llmProvider": "openai_compat",
-    "llmBaseUrl": "https://api.openai.com/v1/chat/completions",
-    "llmModel": "gpt-5.4",
-    "llmSystemPrompt": "Sei un assistente per un impianto KNX. Rispondi in italiano e proponi solo comandi necessari e coerenti con la richiesta.",
-    "llmIncludeRaw": false,
-    "llmIncludeDocsSnippets": true,
-    "llmAllowKnxCommands": true,
-    "llmRequireCommandConfirmation": true,
-    "x": 520,
-    "y": 220,
-    "wires": [
-      [
-        "dbg_knx_ai_control_summary"
-      ],
-      [
-        "dbg_knx_ai_control_anomalies"
-      ],
-      [
-        "dbg_knx_ai_control_reply"
-      ],
-      [
-        "dbg_knx_ai_control_command",
-        "node_knx_ai_control_universal"
-      ],
-      [
-      ]
-    ]
-  },
-  {
-    "id": "dbg_knx_ai_control_summary",
-    "type": "debug",
-    "z": "tab_knx_ai_control",
-    "name": "1 - Summary",
-    "active": false,
-    "tosidebar": true,
-    "console": false,
-    "tostatus": false,
-    "complete": "payload",
-    "targetType": "msg",
-    "x": 760,
-    "y": 140,
-    "wires": []
-  },
-  {
-    "id": "dbg_knx_ai_control_anomalies",
-    "type": "debug",
-    "z": "tab_knx_ai_control",
-    "name": "2 - Anomalies",
-    "active": false,
-    "tosidebar": true,
-    "console": false,
-    "tostatus": false,
-    "complete": "payload",
-    "targetType": "msg",
-    "x": 770,
-    "y": 180,
-    "wires": []
-  },
-  {
-    "id": "dbg_knx_ai_control_reply",
-    "type": "debug",
-    "z": "tab_knx_ai_control",
-    "name": "3 - Risposta/anteprima per Telegram",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "tostatus": true,
-    "complete": "true",
-    "targetType": "full",
-    "x": 840,
-    "y": 220,
-    "wires": []
-  },
-  {
-    "id": "dbg_knx_ai_control_command",
-    "type": "debug",
-    "z": "tab_knx_ai_control",
-    "name": "4 - Operazione KNX (lettura/scrittura)",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "tostatus": true,
-    "complete": "true",
-    "targetType": "full",
-    "x": 820,
-    "y": 260,
-    "wires": []
-  },
-  {
-    "id": "node_knx_ai_control_universal",
-    "type": "knxUltimate",
-    "z": "tab_knx_ai_control",
-    "server": "cfg_knx_ai_control",
-    "topic": "0/0/0",
-    "dpt": "1.001",
-    "initialread": false,
-    "notifyreadrequest": false,
-    "notifyresponse": true,
-    "notifywrite": true,
-    "notifyreadrequestalsorespondtobus": false,
-    "notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized": "",
-    "listenallga": true,
-    "setTopicType": "listenAllGA",
-    "name": "KNX Ultimate - Universal Mode",
-    "outputtype": "write",
-    "outputRBE": false,
-    "inputRBE": false,
-    "x": 820,
-    "y": 340,
-    "wires": [
-      [
-        "dbg_knx_ai_control_bus"
-      ]
-    ]
-  },
-  {
-    "id": "dbg_knx_ai_control_bus",
-    "type": "debug",
-    "z": "tab_knx_ai_control",
-    "name": "Telegrammi KNX ricevuti",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "tostatus": false,
-    "complete": "true",
-    "targetType": "full",
-    "x": 1070,
-    "y": 340,
-    "wires": []
-  },
-  {
-    "id": "cmt_knx_ai_control_output",
-    "type": "comment",
-    "z": "tab_knx_ai_control",
-    "name": "Replace Debug 3 with Telegram; optionally wire output 5 to TTS Ultimate",
-    "info": "The third output carries the text in msg.payload. Fresh reads are returned after KNX feedback and detailed in msg.knxAi.readResults. When a write confirmation is pending, msg.knxAi.confirmationRequest contains localized button labels, callbackData values and ready-to-send confirm/cancel messages. Every message on outputs 3 and 4 also preserves the triggering input in msg.inputMessage. Output 5 is deliberately unwired in this example: connect it to one or more ttsultimate nodes (or use Link Out/Link In across tabs) to receive model-selected announcements with msg.topic=knx_ai_announcement.",
-    "x": 850,
-    "y": 100,
-    "wires": []
-  },
-  {
-    "id": "cfg_knx_ai_control",
-    "type": "knxUltimate-config",
-    "z": "",
-    "host": "224.0.23.12",
-    "port": "3671",
-    "physAddr": "15.15.202",
-    "suppressACKRequest": false,
-    "csv": "",
-    "KNXEthInterface": "Auto",
-    "KNXEthInterfaceManuallyInput": "",
-    "autoReconnect": "yes"
-  }
-]

package/examples/KNX AI - Summary Anomalies and Ask.json

@@ -1,226 +0,0 @@
-[
-  {
-    "id": "tab_knx_ai_sample",
-    "type": "tab",
-    "label": "KNX AI sample",
-    "disabled": false,
-    "info": ""
-  },
-  {
-    "id": "cmt_knx_ai_1",
-    "type": "comment",
-    "z": "tab_knx_ai_sample",
-    "name": "Edit the KNX gateway config node at the bottom of this flow.",
-    "info": "",
-    "x": 330,
-    "y": 40,
-    "wires": []
-  },
-  {
-    "id": "inj_knx_ai_summary",
-    "type": "inject",
-    "z": "tab_knx_ai_sample",
-    "name": "Summary now",
-    "props": [
-      {
-        "p": "topic",
-        "vt": "str"
-      }
-    ],
-    "topic": "summary",
-    "once": false,
-    "onceDelay": 0.1,
-    "x": 140,
-    "y": 140,
-    "wires": [
-      [
-        "node_knx_ai"
-      ]
-    ]
-  },
-  {
-    "id": "inj_knx_ai_summary_auto",
-    "type": "inject",
-    "z": "tab_knx_ai_sample",
-    "name": "Summary every 60s",
-    "props": [
-      {
-        "p": "topic",
-        "vt": "str"
-      }
-    ],
-    "topic": "summary",
-    "repeat": "60",
-    "crontab": "",
-    "once": false,
-    "onceDelay": 0.1,
-    "x": 150,
-    "y": 180,
-    "wires": [
-      [
-        "node_knx_ai"
-      ]
-    ]
-  },
-  {
-    "id": "inj_knx_ai_reset",
-    "type": "inject",
-    "z": "tab_knx_ai_sample",
-    "name": "Reset history",
-    "props": [
-      {
-        "p": "topic",
-        "vt": "str"
-      }
-    ],
-    "topic": "reset",
-    "once": false,
-    "onceDelay": 0.1,
-    "x": 140,
-    "y": 220,
-    "wires": [
-      [
-        "node_knx_ai"
-      ]
-    ]
-  },
-  {
-    "id": "inj_knx_ai_ask",
-    "type": "inject",
-    "z": "tab_knx_ai_sample",
-    "name": "Ask (payload=question)",
-    "props": [
-      {
-        "p": "payload",
-        "vt": "str"
-      },
-      {
-        "p": "topic",
-        "vt": "str"
-      }
-    ],
-    "topic": "ask",
-    "payload": "Quali sono i GA più attivi? Ci sono anomalie evidenti?",
-    "payloadType": "str",
-    "once": false,
-    "onceDelay": 0.1,
-    "x": 170,
-    "y": 260,
-    "wires": [
-      [
-        "fn_knx_ai_prompt"
-      ]
-    ]
-  },
-  {
-    "id": "fn_knx_ai_prompt",
-    "type": "function",
-    "z": "tab_knx_ai_sample",
-    "name": "Set msg.prompt",
-    "func": "msg.prompt = (typeof msg.payload === 'string') ? msg.payload : JSON.stringify(msg.payload);\nreturn msg;",
-    "outputs": 1,
-    "noerr": 0,
-    "initialize": "",
-    "finalize": "",
-    "x": 360,
-    "y": 260,
-    "wires": [
-      [
-        "node_knx_ai"
-      ]
-    ]
-  },
-  {
-    "id": "node_knx_ai",
-    "type": "knxUltimateAI",
-    "z": "tab_knx_ai_sample",
-    "server": "cfg_knx_ai_1",
-    "name": "KNX AI",
-    "topic": "knx-ai",
-    "llmEnabled": false,
-    "llmProvider": "openai_compat",
-    "llmBaseUrl": "https://api.openai.com/v1/chat/completions",
-    "llmModel": "gpt-4o-mini",
-    "llmSystemPrompt": "You are a KNX building automation assistant. Analyze KNX bus traffic and provide actionable insights.",
-    "llmTemperature": "0.2",
-    "llmMaxTokens": "600",
-    "llmTimeoutMs": "1800000",
-    "llmMaxEventsInPrompt": "600",
-    "llmIncludeRaw": false,
-    "x": 560,
-    "y": 200,
-    "wires": [
-      [
-        "dbg_knx_ai_summary"
-      ],
-      [
-        "dbg_knx_ai_anom"
-      ],
-      [
-        "dbg_knx_ai_answer"
-      ],
-      [
-      ],
-      [
-      ]
-    ]
-  },
-  {
-    "id": "dbg_knx_ai_summary",
-    "type": "debug",
-    "z": "tab_knx_ai_sample",
-    "name": "Summary/Stats",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "tostatus": false,
-    "complete": "payload",
-    "targetType": "msg",
-    "x": 760,
-    "y": 160,
-    "wires": []
-  },
-  {
-    "id": "dbg_knx_ai_anom",
-    "type": "debug",
-    "z": "tab_knx_ai_sample",
-    "name": "Anomalies",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "tostatus": false,
-    "complete": "payload",
-    "targetType": "msg",
-    "x": 750,
-    "y": 200,
-    "wires": []
-  },
-  {
-    "id": "dbg_knx_ai_answer",
-    "type": "debug",
-    "z": "tab_knx_ai_sample",
-    "name": "AI answer",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "tostatus": false,
-    "complete": "payload",
-    "targetType": "msg",
-    "x": 750,
-    "y": 240,
-    "wires": []
-  },
-  {
-    "id": "cfg_knx_ai_1",
-    "type": "knxUltimate-config",
-    "z": "",
-    "host": "224.0.23.12",
-    "port": "3671",
-    "physAddr": "15.15.200",
-    "suppressACKRequest": false,
-    "csv": "",
-    "KNXEthInterface": "Auto",
-    "KNXEthInterfaceManuallyInput": "",
-    "autoReconnect": "yes"
-  }
-]