node-red-contrib-knx-ultimate 4.3.18 → 4.3.20

package/CHANGELOG.md

@@ -6,6 +6,18 @@
 
 # CHANGELOG
 
+**Version 4.3.20** - June 2026<br/>
+
+- KNX AI: new **Flow Builder** (BETA) tab in the AI web page — describe an automation in plain language and the AI generates a ready-to-import **Node-RED flow** (JSON) using KNX Ultimate nodes, the Philips Hue nodes and native Function/logic nodes, wired to your imported group addresses. Copy the JSON and paste it via Node-RED *Menu > Import*. Generated node ids, wiring and config-node references are validated and rewired server-side before output.<br/>
+- KNX AI: added **Anthropic (Claude)** as an LLM provider alongside OpenAI-compatible and Ollama. Uses Claude's native Messages API; model and API key are configurable from the node (default `claude-opus-4-8`), with model auto-discovery.<br/>
+- KNX AI: Flow Builder UI is fully localized (EN/IT/DE/FR/ES) and laid out side-by-side (prompt and generated JSON); minor sidebar fix so long menu labels are no longer truncated.<br/>
+
+**Version 4.3.19** - June 2026<br/>
+
+- Docs: reworked the multilingual **FAQ & Troubleshoot** wiki pages — rewrote the **ES/FR** pages in the clean concise style, removed a garbled machine-translated tail from the **IT** page, and deleted 5 orphan FAQ files not referenced in the navigation.<br/>
+- Docs: added a dedicated FAQ section about **Weinzierl (73x) KNX/IP interfaces** that may need *Suppress ACK request* (e.g. over VPN/high-latency links), in all 6 languages.<br/>
+- Editor: when a **Weinzierl** interface is selected from the discovery dropdown in the gateway config node, *Suppress ACK request* is now enabled automatically (it only enables it, never overrides a manual choice, and shows an info notification).<br/>
+
 **Version 4.3.18** - May 2026<br/>
 
 - Bump Engine to 5.5.8

package/nodes/knxUltimate-config.html

@@ -716,6 +716,20 @@
                     } catch (e) { }
                     $("#node-config-input-physAddr").val(`${prefix}.${rnd}`)
                     autoSelectEthernetInterfaceForHost({ force: true })
+                    // Weinzierl KNX/IP Interfaces (e.g. 73x series) may not return the L_Data.req ACK
+                    // in time, especially over VPN/high-latency links. Auto-enable "Suppress ACK request"
+                    // when such an interface is detected by its friendly name. We only turn it on (never off),
+                    // so a manual choice is never silently reverted.
+                    try {
+                        if (/weinzierl|\b73\d\b/i.test(String(gateway.name || ''))) {
+                            const $ack = $("#node-config-input-suppressACKRequest")
+                            if (!$ack.prop('checked')) {
+                                $ack.prop('checked', true)
+                                blinkBackgroundArray(["#node-config-input-suppressACKRequest"])
+                                try { RED.notify(node._('knxUltimate-config.properties.weinzierl_ack_autoenabled'), { type: 'info', timeout: 6000 }) } catch (e) { }
+                            }
+                        }
+                    } catch (e) { }
                     blinkBackgroundArray(["#node-config-input-host", "#node-config-input-port", "#node-config-input-name", "#node-config-input-physAddr"])
                     return false
                 },

package/nodes/knxUltimateAI.html

@@ -112,9 +112,11 @@
             try { RED.sidebar.show("help"); } catch (error) { }
             const OPENAI_COMPAT_DEFAULT_CHAT_URL = "https://api.openai.com/v1/chat/completions";
             const OLLAMA_DEFAULT_CHAT_URL = "http://localhost:11434/api/chat";
+            const ANTHROPIC_DEFAULT_CHAT_URL = "https://api.anthropic.com/v1/messages";
             const OLLAMA_LIBRARY_URL = "https://ollama.com/library";
             const OPENAI_COMPAT_DEFAULT_MODELS = ["gpt-5.4", "gpt-4o-mini"];
             const OLLAMA_DEFAULT_MODEL = "llama3.1";
+            const ANTHROPIC_DEFAULT_MODEL = "claude-opus-4-8";
 
             $("#knx-ai-accordion").accordion({
                 header: "h3",
@@ -214,6 +216,10 @@
             const isOpenAiDefaultUrl = (value) => normalizeUrl(value) === normalizeUrl(OPENAI_COMPAT_DEFAULT_CHAT_URL);
             const isOllamaDefaultUrl = (value) => normalizeUrl(value) === normalizeUrl(OLLAMA_DEFAULT_CHAT_URL);
             const isOpenAiDefaultModel = (value) => OPENAI_COMPAT_DEFAULT_MODELS.indexOf(String(value || "").trim().toLowerCase()) >= 0;
+            const DEFAULT_CHAT_URLS = [OPENAI_COMPAT_DEFAULT_CHAT_URL, OLLAMA_DEFAULT_CHAT_URL, ANTHROPIC_DEFAULT_CHAT_URL];
+            const DEFAULT_MODELS = OPENAI_COMPAT_DEFAULT_MODELS.concat([OLLAMA_DEFAULT_MODEL, ANTHROPIC_DEFAULT_MODEL]);
+            const isAnyDefaultUrl = (value) => DEFAULT_CHAT_URLS.some((u) => normalizeUrl(u) === normalizeUrl(value));
+            const isAnyDefaultModel = (value) => DEFAULT_MODELS.indexOf(String(value || "").trim().toLowerCase()) >= 0;
 
             const applyProviderDefaults = (provider) => {
                 const $baseUrl = $("#node-input-llmBaseUrl");
@@ -221,14 +227,15 @@
                 const currentBaseUrl = String($baseUrl.val() || "").trim();
                 const currentModel = String($model.val() || "").trim();
 
-                if (provider === "ollama") {
-                    if (!currentBaseUrl || isOpenAiDefaultUrl(currentBaseUrl)) $baseUrl.val(OLLAMA_DEFAULT_CHAT_URL);
-                    if (!currentModel || isOpenAiDefaultModel(currentModel)) $model.val(OLLAMA_DEFAULT_MODEL);
-                    return;
-                }
+                const urlByProvider = { ollama: OLLAMA_DEFAULT_CHAT_URL, anthropic: ANTHROPIC_DEFAULT_CHAT_URL, openai_compat: OPENAI_COMPAT_DEFAULT_CHAT_URL };
+                const modelByProvider = { ollama: OLLAMA_DEFAULT_MODEL, anthropic: ANTHROPIC_DEFAULT_MODEL, openai_compat: OPENAI_COMPAT_DEFAULT_MODELS[0] };
+                const targetUrl = urlByProvider[provider] || OPENAI_COMPAT_DEFAULT_CHAT_URL;
+                const targetModel = modelByProvider[provider] || OPENAI_COMPAT_DEFAULT_MODELS[0];
 
-                if (!currentBaseUrl || isOllamaDefaultUrl(currentBaseUrl)) $baseUrl.val(OPENAI_COMPAT_DEFAULT_CHAT_URL);
-                if (!currentModel || String(currentModel).trim().toLowerCase() === OLLAMA_DEFAULT_MODEL) $model.val(OPENAI_COMPAT_DEFAULT_MODELS[0]);
+                // Only overwrite when the field is empty or still holds another provider's default,
+                // so a user's custom base URL / model is never clobbered when switching providers.
+                if (!currentBaseUrl || isAnyDefaultUrl(currentBaseUrl)) $baseUrl.val(targetUrl);
+                if (!currentModel || isAnyDefaultModel(currentModel)) $model.val(targetModel);
             };
 
             const refreshModels = () => {
@@ -461,6 +468,7 @@
                     <label style="width:290px" for="node-input-llmProvider"><i class="fa fa-cog"></i> <span data-i18n="knxUltimateAI.properties.llmProvider"></span></label>
                     <select style="width:100%" id="node-input-llmProvider">
                         <option value="openai_compat" data-i18n="knxUltimateAI.selectlists.llmProvider.openai_compat"></option>
+                        <option value="anthropic" data-i18n="knxUltimateAI.selectlists.llmProvider.anthropic"></option>
                         <option value="ollama" data-i18n="knxUltimateAI.selectlists.llmProvider.ollama"></option>
                     </select>
                 </div>