node-red-contrib-knx-ultimate 6.3.18 → 6.3.21

package/CHANGELOG.md

@@ -6,6 +6,16 @@
 
 # CHANGELOG
 
+**Version 6.3.21** - August 2026<br/>
+
+- **KNX AI — persistent adapter-event history**: every event published by an automatically detected adapter is now normalized into vendor-neutral metadata and appended to a node-specific daily JSONL archive. The archive follows the 10-day KNX retention, guaranteeing at least 24 hours of camera and future adapter events across Node-RED restarts without storing snapshot image data. The editor context card exposes the actual adapter-history directories.<br/>
+- **KNX AI — authoritative historical queries**: web Assistant, Telegram, RedBot and custom CHAT channels now query both the adapter-event archive and the existing KNX daily telegram files. Historical prompts include totals calculated across every stored row in the requested interval plus relevance-selected detail samples, preventing sample size from being reported as the total. Natural-language ranges now include multilingual “last N hours” requests and are bounded by available retention.<br/>
+
+**Version 6.3.19** - August 2026<br/>
+
+- **KNX AI — conversational multi-step routines**: added coordinated routines such as leaving home, bedtime and cinema mode. KNX AI can now perform a first pass with up to 20 fresh KNX state reads, use the authoritative bus results to prepare an ordered plan of up to 12 validated writes, request one confirmation and then execute the complete routine. After confirmation it waits up to four seconds for immediate matching bus feedback, reports verified and unverified operations without treating missing immediate feedback as a device failure, and dispatches any explicitly requested TTS Ultimate announcement only after execution. Routine details, preliminary readings and execution results are exposed as structured chat metadata. The importable confirmation example, editor help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.<br/>
+- **KNX AI — localized output labels**: corrected the four output-pin labels to use the node-scoped Node-RED translation catalog, so Summary, Anomalies, Assistant and KNX Commands follow the active editor language.<br/>
+
 **Version 6.3.18** - August 2026<br/>
 
 - **KNX AI — focused configuration with fixed defaults**: aligned the hidden traffic-analysis defaults to a 600-second history, disk archival enabled for 10 days, automatic summaries disabled, a 120-second analysis window, 5,000 in-memory events and a Top-12 list. The Node-RED project inventory is now always included, while traffic analysis, chat input/output mappings and their obsolete editor controls remain hidden. Documentation language selection was removed because the AI now chooses the appropriate language. Proactive-home switches and advanced proactive settings were removed without legacy-value migration: user-managed AI Education is now the sole configuration surface for this behaviour. Editor help, examples and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.<br/>

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

@@ -4,7 +4,7 @@
     "type": "tab",
     "label": "KNX AI - Conversational control",
     "disabled": false,
-    "info": "Example of fresh KNX state reads and conversational actuator control with a mandatory confirmation step for writes."
+    "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",
@@ -192,6 +192,45 @@
       ]
     ]
   },
+  {
+    "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",

package/nodes/knxUltimateAI.html

@@ -282,10 +282,10 @@
         outputs: 4,
         outputLabels: function (i) {
             switch (i) {
-                case 0: return RED._('knxUltimateAI.outputs.summary');
-                case 1: return RED._('knxUltimateAI.outputs.anomalies');
-                case 2: return RED._('knxUltimateAI.outputs.assistant');
-                case 3: return RED._('knxUltimateAI.outputs.knxCommands');
+                case 0: return this._('knxUltimateAI.outputs.summary');
+                case 1: return this._('knxUltimateAI.outputs.anomalies');
+                case 2: return this._('knxUltimateAI.outputs.assistant');
+                case 3: return this._('knxUltimateAI.outputs.knxCommands');
             }
         },
         icon: "node-eye-icon.svg",
@@ -635,6 +635,7 @@
 
                 const sourceLabels = {
                     knxTraffic: t("knxUltimateAI.messages.chatContextSourceKnxTraffic", "Live KNX summary, anomalies, topology and selected telegrams."),
+                    adapterHistory: t("knxUltimateAI.messages.chatContextSourceAdapterHistory", "Persistent history of automatically detected adapter events."),
                     etsProject: t("knxUltimateAI.messages.chatContextSourceEtsProject", "ETS semantics and the full Node-RED project inventory."),
                     memoryEducation: t("knxUltimateAI.messages.chatContextSourceMemoryEducation", "Session context, AI Education and bounded home memory."),
                     camerasDocs: t("knxUltimateAI.messages.chatContextSourceCamerasDocs", "Detected cameras and relevant help, README and example snippets."),
@@ -668,7 +669,9 @@
 
                 const directoryLabels = {
                     archiveRoot: t("knxUltimateAI.messages.chatContextDirectoryRoot", "Telegram archive root"),
-                    nodeArchive: t("knxUltimateAI.messages.chatContextDirectoryNode", "This node's telegram archive")
+                    nodeArchive: t("knxUltimateAI.messages.chatContextDirectoryNode", "This node's telegram archive"),
+                    adapterArchiveRoot: t("knxUltimateAI.messages.chatContextDirectoryAdapterRoot", "Adapter event archive root"),
+                    adapterNodeArchive: t("knxUltimateAI.messages.chatContextDirectoryAdapterNode", "This node's adapter event archive")
                 };
                 (Array.isArray(overview.telegramDirectories) ? overview.telegramDirectories : []).forEach(function (item) {
                     if (!item || !item.path) return;
@@ -677,7 +680,9 @@
                         directoryLabels[item.id] || String(item.id || ""),
                         "",
                         item.path,
-                        t("knxUltimateAI.messages.chatContextDirectoryBadge", "KNX")
+                        /^adapter/.test(String(item.id || ""))
+                            ? t("knxUltimateAI.messages.chatContextDirectoryAdapterBadge", "Adapter")
+                            : t("knxUltimateAI.messages.chatContextDirectoryBadge", "KNX")
                     );
                 });