node-red-contrib-knx-ultimate 6.3.22 → 6.3.25

package/CHANGELOG.md

@@ -6,6 +6,25 @@
 
 # CHANGELOG
 
+**Version 6.3.25** - August 2026<br/>
+
+- **IoT Bridge — direct Modbus Flex adapter without a bundled Modbus client**: Modbus mappings can now emit the exact `modbus-flex-write` request consumed by `node-red-contrib-modbus` and decode `modbus-read` / `modbus-flex-getter` responses back to KNX. The protocol-specific editor asks only for Unit ID, zero-based address, Modbus area and Boolean/unsigned 16-bit/signed 16-bit format; FC1–FC6 and quantity are derived automatically. TCP/RTU connections, polling, queues and reconnects remain in the external Modbus nodes. KNX responses never become Modbus commands, write acknowledgements never become KNX state, unchanged polls can be suppressed with **Emit on change only**, and local KNX echoes are loop-protected. Existing scalar Modbus mappings remain on the legacy contract until explicitly switched to Flex. A safe manual example and the six localized help/wiki sets document the wiring and host-version compatibility.<br/>
+- **Dependency cleanup — native asynchronous gateway DNS resolution**: replaced `dns-sync` and its obsolete `shelljs` → `glob@7` → `inflight` production chain with Node's built-in promise-based OS resolver. KNX gateway hostnames and `/etc/hosts` resolution remain supported in verbatim address order, while connection startup no longer launches a blocking child process.<br/>
+
+**Version 6.3.24** - August 2026<br/>
+
+- **KNX AI — working Telegram confirmation buttons**: changed the `windkh/node-red-contrib-telegrambot` preset from inline callbacks to a one-time Telegram reply keyboard. **Confirm** and **Cancel** now return as normal localized messages through the already connected `telegram receiver`, eliminating the silent no-op caused by a missing `callback_query` event node. Existing saved preset output mappings are upgraded at runtime, the keyboard is removed after the decision, and legacy callback events remain accepted. The importable direct-chat example no longer requires extra callback wiring; help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.<br/>
+- **KNX AI — native CHAT learning memory**: replaced the verbose Markdown/JSON V2 learning file with the direct line-oriented `knxai-chat-context.knxctx` V3 format. Sessions, instructions, turns and camera watches are stored as editable tab-separated `SESSION`, `INSTRUCTION`, `TURN`, `CAMERA_WATCH` and `END_SESSION` records with escaped text fields, without JSON serialization or a regenerated preview. The Web UI keeps copy, download, restore, revision-safe save and protected reinitialization. Previous `.md` Markdown/JSON V2 and Base64 V1 files are deliberately not read, imported, migrated or deleted; KNX AI starts a new native context instead. Help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.<br/>
+- **KNX AI — compact LLM settings layout**: constrained the assistant connection form to a readable responsive width and removed the fixed 290 px indentation that allowed the local-context hint and status line to widen the complete Node-RED properties panel. The model autocomplete now reopens after mouse release, so the full provider list remains visible after a normal click instead of appearing only while the button is held.<br/>
+- **KNX AI — resettable CHAT learning**: added a protected **Reinitialize Memory** action to **Settings → AI Chat Learning**. After explicit confirmation it atomically replaces the shared learning file with a new empty native context, clears sessions, persistent instructions, camera watches and pending chat confirmations across every KNX AI node using the same storage, and refreshes the editor immediately. Concurrent changes remain protected by the existing content revision check.<br/>
+- **KNX AI — complete model picker**: clicking the model field now opens the complete list returned by the selected provider regardless of the text already present, while typed text can still filter the same list and custom model names remain accepted.<br/>
+- **KNX AI — native compact context archives**: replaced JSONL serialization for KNX telegram and detected-adapter history with KNX AI's direct line-oriented `.knxctx` format. Typed payloads, flags and bounded adapter metadata round-trip without repeated JSON property names, while bus and archive summaries are rendered as compact `key=value` context instead of JSON before reaching the model. Existing JSONL archives are deliberately not read or migrated; new daily files use `YYYY-MM-DD.knxctx`. The user-editable CHAT learning file remains separate because it is also a portable user backup surface. Context cards, editor help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.<br/>
+- **KNX AI — user-selectable local chat context**: added a localized **Chat context amount** selector for Ollama and Bionic LM Studio with 4K, 8K and 16K choices; 16K remains the default. The selected budget proportionally bounds KNX traffic, archives, ETS catalog, Node-RED inventory, memory and adapter context, and is also sent as Ollama's `num_ctx`, while the complete agent tool contract stays available without phrase classifiers, keyword gates or linguistic intent routing. The context overview now reports the configured operational limit. Editor help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.<br/>
+- **KNX AI — reliable conversational recall**: verified that session IDs and recent turns were already persisted correctly, then moved the current session memory next to the current request in the operational prompt so small local models do not lose user-supplied facts inside large KNX context. The structured memory tool now explicitly covers durable user facts such as preferred name and language as well as preferences and instructions, while remaining model-selected with no phrase classifiers or intent routing; credentials, security codes and API keys are excluded.<br/>
+- **KNX AI — editable and portable CHAT learning**: added **Settings → AI Chat Learning** to the Vue web UI for viewing the exact absolute path and editing, copying, downloading or restoring the shared learning file. The **Conversations & home** tab in the Node-RED node configuration includes a localized shortcut that opens the Web UI directly on this editor for the current node. Saves are validated, bounded to 512 KB, written atomically and applied immediately to every KNX AI node sharing the same storage, while revision checks prevent stale editors from overwriting newer learning. UI strings, editor help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.<br/>
+- **KNX AI — intent-free agentic chat tools**: removed hard-coded semantic phrase classifiers from conversational routing. Every Ask/CHAT request now lets the model reason directly over the current goal, persistent user guidance, AI Education and the available structured KNX, camera, TTS Ultimate and memory tools. Routine planning no longer depends on a multilingual keyword list, TTS announcements no longer require an action alias, and durable chat instructions are remembered or forgotten through model-selected structured actions instead of regular-expression intent detection. Runtime argument validation, adapter availability checks, ETS/DPT safeguards and command confirmation remain unchanged.<br/>
+- **KNX AI — learned KNX group-address roles**: a `neutral` GA is now treated as unresolved rather than permanently uncontrollable. The conversational model can learn or forget the exact `command`, `status` or `neutral` role from trusted user teaching, persistent chat guidance, AI Education or unequivocal ETS semantics through the structured `gaRoleActions` tool. Learned role, reason and evidence are persisted per node in `knxai-config-<node-id>.json`, synchronized into bounded semantic home memory and reused after restart. A command role learned in the current answer can validate a write in that same turn, while exact ETS membership, immutable DPT, payload validation and configured confirmation still apply. Help and wiki documentation were aligned in EN, IT, DE, FR, ES and zh-CN.<br/>
+
 **Version 6.3.22** - August 2026<br/>
 
 - **KNX AI — visible context size and real prompt weight**: the “Chat context overview” card now shows the current operational context limit and the actual UTF-8 size of the last operational chat prompt. Ollama, Bionic, OpenAI-compatible and Claude token-usage fields are captured when returned by the provider; otherwise the UI clearly labels the token count as an estimate. Local limits reflect the active context without exceeding KNX AI's 16K cap.<br/>

package/examples/IoT Bridge - Modbus Flex Adapter.json

@@ -0,0 +1,361 @@
+[
+  {
+    "id": "mb_flex_tab",
+    "type": "tab",
+    "label": "IoT Bridge - Modbus Flex Adapter",
+    "disabled": true,
+    "info": "Safe starter flow for the IoT Bridge and node-red-contrib-modbus. The tab is disabled on import and every Inject node is manual. Configure the KNX gateway, group addresses and Modbus client before enabling it."
+  },
+  {
+    "id": "mb_knx_cfg",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.215",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "no"
+  },
+  {
+    "id": "mb_client",
+    "type": "modbus-client",
+    "name": "LOCALHOST placeholder - configure me",
+    "clienttype": "tcp",
+    "bufferCommands": true,
+    "stateLogEnabled": false,
+    "queueLogEnabled": false,
+    "failureLogEnabled": true,
+    "tcpHost": "127.0.0.1",
+    "tcpPort": "1502",
+    "tcpType": "DEFAULT",
+    "serialPort": "/dev/ttyUSB",
+    "serialType": "RTU-BUFFERD",
+    "serialBaudrate": "9600",
+    "serialDatabits": "8",
+    "serialStopbits": "1",
+    "serialParity": "none",
+    "serialConnectionDelay": "100",
+    "serialAsciiResponseStartDelimiter": "0x3A",
+    "unit_id": "1",
+    "commandDelay": "1",
+    "clientTimeout": "1000",
+    "reconnectOnTimeout": false,
+    "reconnectTimeout": "2000",
+    "parallelUnitIdsAllowed": true,
+    "showWarnings": true,
+    "showLogs": false
+  },
+  {
+    "id": "mb_intro",
+    "type": "comment",
+    "z": "mb_flex_tab",
+    "name": "START HERE - disabled and manual-only",
+    "info": "1. Install a node-red-contrib-modbus version compatible with your Node-RED runtime.\n2. Configure the KNX gateway and replace the LOCALHOST Modbus client placeholder.\n3. Adapt every GA, Unit ID and zero-based address.\n4. Enable this tab only after reviewing the mappings.\n\nThere is no automatic Inject or polling in this example.",
+    "x": 300,
+    "y": 40,
+    "wires": []
+  },
+  {
+    "id": "mb_address_note",
+    "type": "comment",
+    "z": "mb_flex_tab",
+    "name": "Target is zero-based: manual reference 40010 is commonly address 9",
+    "info": "Always verify the addressing convention in the device manual. The bridge supports one bit or one 16-bit register per mapping.",
+    "x": 390,
+    "y": 80,
+    "wires": []
+  },
+  {
+    "id": "mb_bridge",
+    "type": "knxUltimateIoTBridge",
+    "z": "mb_flex_tab",
+    "server": "mb_knx_cfg",
+    "name": "KNX ↔ Modbus Flex adapter",
+    "outputtopic": "",
+    "emitOnChangeOnly": true,
+    "readOnDeploy": false,
+    "acceptFlowInput": true,
+    "nodeMode": "iot",
+    "haBusMode": "standalone",
+    "inputs": 1,
+    "outputs": 2,
+    "mappings": [
+      {
+        "id": "mb_map_coil",
+        "enabled": true,
+        "label": "Light command coil",
+        "ga": "3/1/1",
+        "dpt": "1.001",
+        "direction": "bidirectional",
+        "iotType": "modbus",
+        "target": "0",
+        "method": "POST",
+        "modbusFunction": "writeCoil",
+        "modbusMessageFormat": "flex",
+        "modbusUnitId": 1,
+        "modbusAddress": 0,
+        "modbusArea": "coil",
+        "modbusDataType": "bool",
+        "scale": 1,
+        "offset": 0,
+        "template": "",
+        "property": "",
+        "timeout": 0,
+        "retry": 0
+      },
+      {
+        "id": "mb_map_temperature",
+        "enabled": true,
+        "label": "Temperature x10 holding register",
+        "ga": "3/1/2",
+        "dpt": "9.001",
+        "direction": "bidirectional",
+        "iotType": "modbus",
+        "target": "9",
+        "method": "POST",
+        "modbusFunction": "writeHoldingRegister",
+        "modbusMessageFormat": "flex",
+        "modbusUnitId": 1,
+        "modbusAddress": 9,
+        "modbusArea": "holding-register",
+        "modbusDataType": "uint16",
+        "scale": 10,
+        "offset": 0,
+        "template": "",
+        "property": "",
+        "timeout": 0,
+        "retry": 0
+      },
+      {
+        "id": "mb_map_contact",
+        "enabled": true,
+        "label": "Read-only contact",
+        "ga": "3/1/3",
+        "dpt": "1.001",
+        "direction": "iot-to-knx",
+        "iotType": "modbus",
+        "target": "4",
+        "method": "POST",
+        "modbusFunction": "readDiscreteInputs",
+        "modbusMessageFormat": "flex",
+        "modbusUnitId": 1,
+        "modbusAddress": 4,
+        "modbusArea": "discrete-input",
+        "modbusDataType": "bool",
+        "scale": 1,
+        "offset": 0,
+        "template": "",
+        "property": "",
+        "timeout": 0,
+        "retry": 0
+      }
+    ],
+    "x": 650,
+    "y": 260,
+    "wires": [
+      [
+        "mb_flex_write",
+        "mb_debug_flex_payload"
+      ],
+      [
+        "mb_debug_knx_ack"
+      ]
+    ]
+  },
+  {
+    "id": "mb_manual_read",
+    "type": "inject",
+    "z": "mb_flex_tab",
+    "name": "MANUAL read holding register 9",
+    "props": [
+      {
+        "p": "payload",
+        "v": "{\"fc\":3,\"unitid\":1,\"address\":9,\"quantity\":1}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 230,
+    "y": 180,
+    "wires": [
+      [
+        "mb_flex_getter"
+      ]
+    ]
+  },
+  {
+    "id": "mb_flex_getter",
+    "type": "modbus-flex-getter",
+    "z": "mb_flex_tab",
+    "name": "Flex Getter (manual request)",
+    "showStatusActivities": false,
+    "showErrors": true,
+    "showWarnings": true,
+    "logIOActivities": false,
+    "server": "mb_client",
+    "useIOFile": false,
+    "ioFile": "",
+    "useIOForPayload": false,
+    "emptyMsgOnFail": false,
+    "keepMsgProperties": true,
+    "delayOnStart": false,
+    "enableDeformedMessages": false,
+    "startDelayTime": "",
+    "x": 490,
+    "y": 180,
+    "wires": [
+      [
+        "mb_bridge",
+        "mb_debug_read"
+      ],
+      [
+        "mb_debug_modbus_error"
+      ]
+    ]
+  },
+  {
+    "id": "mb_simulated_read",
+    "type": "inject",
+    "z": "mb_flex_tab",
+    "name": "MANUAL simulate raw 215 → KNX 21.5 °C",
+    "props": [
+      {
+        "p": "payload",
+        "v": "[215]",
+        "vt": "json"
+      },
+      {
+        "p": "modbusRequest",
+        "v": "{\"fc\":3,\"unitid\":1,\"address\":9,\"quantity\":1}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 270,
+    "y": 300,
+    "wires": [
+      [
+        "mb_bridge"
+      ]
+    ]
+  },
+  {
+    "id": "mb_flex_write",
+    "type": "modbus-flex-write",
+    "z": "mb_flex_tab",
+    "name": "Direct Flex Write",
+    "showStatusActivities": false,
+    "showErrors": true,
+    "showWarnings": true,
+    "logIOActivities": false,
+    "server": "mb_client",
+    "emptyMsgOnFail": false,
+    "keepMsgProperties": true,
+    "delayOnStart": false,
+    "startDelayTime": "",
+    "x": 930,
+    "y": 220,
+    "wires": [
+      [
+        "mb_debug_write"
+      ],
+      [
+        "mb_debug_modbus_error"
+      ]
+    ]
+  },
+  {
+    "id": "mb_debug_flex_payload",
+    "type": "debug",
+    "z": "mb_flex_tab",
+    "name": "Flex payload from bridge",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 960,
+    "y": 280,
+    "wires": []
+  },
+  {
+    "id": "mb_debug_knx_ack",
+    "type": "debug",
+    "z": "mb_flex_tab",
+    "name": "Modbus → KNX ack",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 950,
+    "y": 340,
+    "wires": []
+  },
+  {
+    "id": "mb_debug_read",
+    "type": "debug",
+    "z": "mb_flex_tab",
+    "name": "Raw Modbus read response",
+    "active": false,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 780,
+    "y": 140,
+    "wires": []
+  },
+  {
+    "id": "mb_debug_write",
+    "type": "debug",
+    "z": "mb_flex_tab",
+    "name": "Modbus write response",
+    "active": false,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 1190,
+    "y": 200,
+    "wires": []
+  },
+  {
+    "id": "mb_debug_modbus_error",
+    "type": "debug",
+    "z": "mb_flex_tab",
+    "name": "Modbus response / error",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 1190,
+    "y": 260,
+    "wires": []
+  }
+]

package/examples/KNX AI - Telegrambot Direct Chat.json

@@ -4,7 +4,7 @@
     "type": "tab",
     "label": "KNX AI - Telegrambot direct chat",
     "disabled": false,
-    "info": "Direct chat wiring for windkh/node-red-contrib-telegrambot using the KNX AI chat-adapter preset."
+    "info": "Direct chat wiring for windkh/node-red-contrib-telegrambot using the KNX AI chat-adapter preset. Confirmation buttons return through the same receiver; no callback event node is required."
   },
   {
     "id": "comment_knx_ai_telegram_setup",
@@ -53,22 +53,6 @@
       []
     ]
   },
-  {
-    "id": "telegram_callback_knx_ai",
-    "type": "telegram event",
-    "z": "tab_knx_ai_telegram",
-    "name": "Confirm / Cancel buttons",
-    "bot": "telegram_bot_knx_ai",
-    "event": "callback_query",
-    "autoanswer": true,
-    "x": 190,
-    "y": 240,
-    "wires": [
-      [
-        "node_knx_ai_telegram"
-      ]
-    ]
-  },
   {
     "id": "node_knx_ai_telegram",
     "type": "knxUltimateAI",

package/nodes/knxUltimate-config.js

@@ -6,6 +6,7 @@
 const fs = require('fs')
 const path = require('path')
 const net = require('net')
+const dns = require('dns/promises')
 const os = require('os')
 const _ = require('lodash')
 const knx = require('knxultimate')
@@ -195,6 +196,11 @@ const findAutoEthernetInterface = (targetIP) => {
   return bestMatch
 }
 
+const resolveHostAddress = async (hostname, lookup = dns.lookup) => {
+  const { address } = await lookup(hostname, { order: 'verbatim' })
+  return address
+}
+
 module.exports = (RED) => {
   // Log node and KNXUltimate engine versions once, at Node-RED startup.
   try {
@@ -1142,7 +1148,7 @@ module.exports = (RED) => {
       }
     }
 
-    node.setKnxConnectionProperties = () => {
+    node.setKnxConnectionProperties = async () => {
       // 25/08/2021 Moved out of node.initKNXConnection
       node.knxConnectionProperties = {
         ipAddr: node.host,
@@ -1183,10 +1189,9 @@ module.exports = (RED) => {
         switch (net.isIP(node.host)) {
           case 0:
             // Invalid IP, resolve the DNS name.
-            const dns = require('dns-sync')
             let resolvedIP = null
             try {
-              resolvedIP = dns.resolve(node.host)
+              resolvedIP = await resolveHostAddress(node.host)
             } catch (error) {
               throw new Error('net.isIP: INVALID IP OR DNS NAME. Error checking the Gateway Host in Config node. ' + error.message)
             }
@@ -1258,7 +1263,7 @@ module.exports = (RED) => {
 
     node.initKNXConnection = async () => {
       try {
-        node.setKnxConnectionProperties() // 28/12/2021 Added
+        await node.setKnxConnectionProperties() // 28/12/2021 Added
       } catch (error) {
         node.sysLogger?.error('setKnxConnectionProperties: ' + error.message)
         if (node.linkStatus !== 'disconnected') await node.Disconnect()
@@ -2764,3 +2769,7 @@ module.exports = (RED) => {
     }
   })
 }
+
+module.exports.__test = {
+  resolveHostAddress
+}