node-red-contrib-knx-ultimate 4.3.6 → 4.3.8

package/CHANGELOG.md

@@ -6,6 +6,17 @@
 
 # CHANGELOG
 
+**Version 4.3.8** - April 2026<br/>
+
+- FIX: **KNX AI Web Assistant** `Ask` tab now truly uses the full available content width on desktop too; removed the leftover `50vw` cap that still kept the panel at half width.<br/>
+- FIX: **KNX DEVICE** in universal mode (`listenAllGA`) now falls back to `raw` instead of raising a datapoint-detection error when no ETS DPT is available and automatic inference fails; raw bytes remain available in `msg.knx.rawValue`.<br/>
+- NEW: **KNX AI** can now optionally archive captured telegrams to disk under `knxultimatestorage`, with configurable retention in days and automatic reuse of the archive for `Ask` queries.<br/>
+- CHANGE: **KNX AI** `Ask` now uses the disk archive by default when enabled, honoring explicit time references and otherwise searching the last 24 hours plus current RAM events.<br/>
+- CHANGE: **KNX AI** flow context for the AI prompt now includes the whole **Node-RED project inventory**, not only KNX nodes or the current flow, so `function`/`change`/`inject`/`template` nodes with KNX-related logic are visible to the assistant.<br/>
+- FIX: **KNX AI Ask** now includes the real JavaScript source of Node-RED `function` nodes for code-review questions, instead of exposing only short flattened snippets that could make the assistant say it could not inspect the full code.<br/>
+- UI: **KNX AI** editor options were reorganized into clearer sections, with technical tuning moved under **Advanced**, several low-value LLM tuning fields removed from the editor, and localized tab labels/help/docs updated in all supported languages.<br/>
+- UI: **KNX AI Web Assistant** `Ask` panel now uses the full available page width instead of being capped to half-page width on desktop.<br/>
+
 **Version 4.3.6** - April 2026<br/>
 
 - UI: when **KNX DEVICE** is set to **`dpt = raw`**, the editor now hides decoded-payload options that do not apply to raw telegrams, including **RBE**, **periodic send**, **format numeric values**, manual write button modes, and **notifyreadrequestalsorespondtobus**.<br/>

package/nodes/knxUltimate-config.js

@@ -2067,6 +2067,15 @@ module.exports = (RED) => {
       }
 
       const isRawMode = typeof _inputDpt === 'string' && _inputDpt.trim().toLowerCase() === 'raw'
+      const isUniversalNode = _oNode?.listenallga === true || _oNode?.listenallga === 'true'
+      const hasKnownInputDpt = !(_inputDpt === null || _inputDpt === undefined || _inputDpt === '')
+      const shouldFallbackToRaw = isUniversalNode && !hasKnownInputDpt
+      const setRawModeMetadata = () => {
+        sInputDpt = 'raw'
+        sPayloadmeasureunit = ''
+        sDptdesc = 'Raw value'
+        sPayloadsubtypevalue = ''
+      }
 
       const errorMessage = {
         topic: _outputtopic,
@@ -2091,14 +2100,43 @@ module.exports = (RED) => {
       // Resolve DPT and convert value if available
       if (_Rawvalue !== null) {
         if (isRawMode) {
-          sInputDpt = 'raw'
-          sPayloadmeasureunit = ''
-          sDptdesc = 'Raw value'
-          sPayloadsubtypevalue = ''
+          setRawModeMetadata()
         } else {
           try {
-            sInputDpt = _inputDpt === null ? tryToFigureOutDataPointFromRawValue(_Rawvalue) : _inputDpt
+            sInputDpt = !hasKnownInputDpt ? tryToFigureOutDataPointFromRawValue(_Rawvalue) : _inputDpt
           } catch (error) {
+            if (shouldFallbackToRaw) {
+              setRawModeMetadata()
+              jsValue = null
+              node.sysLogger?.debug(`buildInputMessage: falling back to RAW for universal node ${_oNode?.id || ''} destination ${_destGA}`)
+              try {
+                const finalMessage = {
+                  topic: _outputtopic,
+                  devicename: typeof _devicename !== 'undefined' ? _devicename : '',
+                  payload: jsValue,
+                  payloadmeasureunit: sPayloadmeasureunit,
+                  payloadsubtypevalue: sPayloadsubtypevalue,
+                  gainfo,
+                  echoed: _echoed,
+                  repeated: _repeated === true,
+                  repeat: _repeated === true,
+                  knx: {
+                    event: _event,
+                    dpt: sInputDpt,
+                    dptdesc: sDptdesc,
+                    source: _srcGA,
+                    destination: _destGA,
+                    rawValue: _Rawvalue,
+                    repeated: _repeated === true,
+                    repeat: _repeated === true
+                  }
+                }
+                return finalMessage
+              } catch (buildError) {
+                node.sysLogger?.error('buildInputMessage error: ' + buildError.message)
+                return errorMessage
+              }
+            }
             // Here comes if no datapoint has beeen found
             node.sysLogger?.error(
               'buildInputMessage: Error returning from tryToFigureOutDataPointFromRawValue. Device ' +
@@ -2216,11 +2254,8 @@ module.exports = (RED) => {
         }
       } else {
         // Don't care, it's a READ REQUEST
-        if (isRawMode) {
-          sInputDpt = 'raw'
-          sPayloadmeasureunit = ''
-          sDptdesc = 'Raw value'
-          sPayloadsubtypevalue = ''
+        if (isRawMode || shouldFallbackToRaw) {
+          setRawModeMetadata()
         }
       }
 

package/nodes/knxUltimateAI.html

@@ -9,7 +9,7 @@
         align-items: flex-start;
     }
 
-    #knx-ai-ollama-install-row > label {
+    #knx-ai-ollama-install-row>label {
         padding-top: 6px;
     }
 
@@ -32,7 +32,7 @@
     }
 
     @media (max-width: 900px) {
-        #knx-ai-ollama-install-row > label {
+        #knx-ai-ollama-install-row>label {
             width: 100% !important;
             padding-top: 0;
             margin-bottom: 6px;
@@ -64,6 +64,8 @@
 
             analysisWindowSec: { value: 120, required: true, validate: RED.validators.number() },
             historyWindowSec: { value: 600, required: true, validate: RED.validators.number() },
+            historyStoreToDisk: { value: true },
+            historyStoreRetentionDays: { value: 10, required: true, validate: RED.validators.number() },
             emitIntervalSec: { value: 0, required: true, validate: RED.validators.number() },
             topN: { value: 10, required: true, validate: RED.validators.number() },
             maxEvents: { value: 50000, required: true, validate: RED.validators.number() },
@@ -84,17 +86,10 @@
             llmBaseUrl: { value: "https://api.openai.com/v1/chat/completions" },
             llmModel: { value: "gpt-5.4" },
             llmSystemPrompt: { value: "" },
-            llmTemperature: { value: 0.2, required: false, validate: RED.validators.number() },
-            llmMaxTokens: { value: 50000, required: false, validate: RED.validators.number() },
-            llmTimeoutMs: { value: 120000, required: false, validate: RED.validators.number() },
-            llmMaxEventsInPrompt: { value: 120, required: false, validate: RED.validators.number() },
             llmIncludeRaw: { value: false },
             llmIncludeFlowContext: { value: true },
-            llmMaxFlowNodesInPrompt: { value: 400, required: false, validate: RED.validators.number() },
             llmIncludeDocsSnippets: { value: true },
-            llmDocsLanguage: { value: "en" },
-            llmDocsMaxSnippets: { value: 5, required: false, validate: RED.validators.number() },
-            llmDocsMaxChars: { value: 60000, required: false, validate: RED.validators.number() }
+            llmDocsLanguage: { value: "en" }
         },
         credentials: {
             llmApiKey: { type: "password" }
@@ -121,14 +116,6 @@
             const OPENAI_COMPAT_DEFAULT_MODELS = ["gpt-5.4", "gpt-4o-mini"];
             const OLLAMA_DEFAULT_MODEL = "llama3.1";
 
-            const $accordion = $("#knx-ai-accordion");
-            const $llmContent = $accordion.find("#node-input-llmEnabled").closest("#knx-ai-accordion > div").first();
-            const $llmHeader = $llmContent.prev("h3");
-            if ($llmHeader.length && $llmContent.length) {
-                $llmContent.prependTo($accordion);
-                $llmHeader.prependTo($accordion);
-            }
-
             $("#knx-ai-accordion").accordion({
                 header: "h3",
                 heightStyle: "content",
@@ -138,14 +125,26 @@
 
             const toggleLLM = () => {
                 const enabled = $("#node-input-llmEnabled").is(":checked");
-                if (enabled) {
-                    $("#knx-ai-llm-settings").show();
-                } else {
-                    $("#knx-ai-llm-settings").hide();
-                }
+                $("#knx-ai-llm-connection-settings").toggle(enabled);
+                $("#knx-ai-llm-context-settings").toggle(enabled);
             };
             $("#node-input-llmEnabled").on("change", toggleLLM);
+
+            const toggleHistoryArchive = () => {
+                const enabled = $("#node-input-historyStoreToDisk").is(":checked");
+                $("#knx-ai-history-retention-row").toggle(enabled);
+            };
+            $("#node-input-historyStoreToDisk").on("change", toggleHistoryArchive);
+
+            const toggleDocsContext = () => {
+                const enabled = $("#node-input-llmIncludeDocsSnippets").is(":checked");
+                $("#knx-ai-docs-language-row").toggle(enabled);
+            };
+            $("#node-input-llmIncludeDocsSnippets").on("change", toggleDocsContext);
+
             toggleLLM();
+            toggleHistoryArchive();
+            toggleDocsContext();
 
             const nodeId = this.id;
             const resolveAdminRoot = () => {
@@ -422,74 +421,42 @@
             </div>
         </div>
 
-        <h3><span data-i18n="knxUltimateAI.sections.analysis"></span></h3>
+        <h3><span data-i18n="knxUltimateAI.sections.storage"></span></h3>
         <div>
-            <div class="form-row">
-                <label style="width:290px" for="node-input-analysisWindowSec"><i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateAI.properties.analysisWindowSec"></span></label>
-                <input style="width:90px" type="number" id="node-input-analysisWindowSec">
-            </div>
             <div class="form-row">
                 <label style="width:290px" for="node-input-historyWindowSec"><i class="fa fa-history"></i> <span data-i18n="knxUltimateAI.properties.historyWindowSec"></span></label>
                 <input style="width:90px" type="number" id="node-input-historyWindowSec">
             </div>
             <div class="form-row">
-                <label style="width:290px" for="node-input-maxEvents"><i class="fa fa-bars"></i> <span data-i18n="knxUltimateAI.properties.maxEvents"></span></label>
-                <input style="width:90px" type="number" id="node-input-maxEvents">
+                <input type="checkbox" id="node-input-historyStoreToDisk" style="display:inline-block; width:auto; vertical-align:top;">
+                <label style="width:auto" for="node-input-historyStoreToDisk">&nbsp;&nbsp;<span data-i18n="knxUltimateAI.properties.historyStoreToDisk"></span></label>
+            </div>
+            <div class="form-row" id="knx-ai-history-retention-row">
+                <label style="width:290px" for="node-input-historyStoreRetentionDays"><i class="fa fa-calendar"></i> <span data-i18n="knxUltimateAI.properties.historyStoreRetentionDays"></span></label>
+                <input style="width:90px" type="number" id="node-input-historyStoreRetentionDays">
             </div>
             <div class="form-row">
                 <label style="width:290px" for="node-input-emitIntervalSec"><i class="fa fa-send"></i> <span data-i18n="knxUltimateAI.properties.emitIntervalSec"></span></label>
                 <input style="width:90px" type="number" id="node-input-emitIntervalSec">
             </div>
-            <div class="form-row">
-                <label style="width:290px" for="node-input-topN"><i class="fa fa-list-ol"></i> <span data-i18n="knxUltimateAI.properties.topN"></span></label>
-                <input style="width:90px" type="number" id="node-input-topN">
-            </div>
-            <div class="form-row">
-                <input type="checkbox" id="node-input-enablePattern" style="display:inline-block; width:auto; vertical-align:top;">
-                <label style="width:auto" for="node-input-enablePattern">&nbsp;&nbsp;<span data-i18n="knxUltimateAI.properties.enablePattern"></span></label>
-            </div>
-            <div class="form-row">
-                <label style="width:290px" for="node-input-patternMaxLagMs"><i class="fa fa-arrows-h"></i> <span data-i18n="knxUltimateAI.properties.patternMaxLagMs"></span></label>
-                <input style="width:120px" type="number" id="node-input-patternMaxLagMs">
-            </div>
-            <div class="form-row">
-                <label style="width:290px" for="node-input-patternMinCount"><i class="fa fa-filter"></i> <span data-i18n="knxUltimateAI.properties.patternMinCount"></span></label>
-                <input style="width:90px" type="number" id="node-input-patternMinCount">
-            </div>
         </div>
 
-        <h3><span data-i18n="knxUltimateAI.sections.anomalies"></span></h3>
+        <h3><span data-i18n="knxUltimateAI.sections.detection"></span></h3>
         <div>
             <div class="form-row">
-                <label style="width:290px" for="node-input-rateWindowSec"><i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateAI.properties.rateWindowSec"></span></label>
-                <input style="width:90px" type="number" id="node-input-rateWindowSec">
-            </div>
-            <div class="form-row">
-                <label style="width:290px" for="node-input-maxTelegramPerSecOverall"><i class="fa fa-tachometer"></i> <span data-i18n="knxUltimateAI.properties.maxTelegramPerSecOverall"></span></label>
-                <input style="width:90px" type="number" id="node-input-maxTelegramPerSecOverall">
-            </div>
-            <div class="form-row">
-                <label style="width:290px" for="node-input-maxTelegramPerSecPerGA"><i class="fa fa-bolt"></i> <span data-i18n="knxUltimateAI.properties.maxTelegramPerSecPerGA"></span></label>
-                <input style="width:90px" type="number" id="node-input-maxTelegramPerSecPerGA">
-            </div>
-            <div class="form-row">
-                <label style="width:290px" for="node-input-flapWindowSec"><i class="fa fa-exchange"></i> <span data-i18n="knxUltimateAI.properties.flapWindowSec"></span></label>
-                <input style="width:90px" type="number" id="node-input-flapWindowSec">
-            </div>
-            <div class="form-row">
-                <label style="width:290px" for="node-input-flapMaxChanges"><i class="fa fa-random"></i> <span data-i18n="knxUltimateAI.properties.flapMaxChanges"></span></label>
-                <input style="width:90px" type="number" id="node-input-flapMaxChanges">
+                <input type="checkbox" id="node-input-enablePattern" style="display:inline-block; width:auto; vertical-align:top;">
+                <label style="width:auto" for="node-input-enablePattern">&nbsp;&nbsp;<span data-i18n="knxUltimateAI.properties.enablePattern"></span></label>
             </div>
         </div>
 
-        <h3><span data-i18n="knxUltimateAI.sections.llm"></span></h3>
+        <h3><span data-i18n="knxUltimateAI.sections.llmConnection"></span></h3>
         <div>
             <div class="form-row">
                 <input type="checkbox" id="node-input-llmEnabled" style="display:inline-block; width:auto; vertical-align:top;">
                 <label style="width:auto" for="node-input-llmEnabled">&nbsp;&nbsp;<span data-i18n="knxUltimateAI.properties.llmEnabled"></span></label>
             </div>
 
-            <div id="knx-ai-llm-settings">
+            <div id="knx-ai-llm-connection-settings">
                 <div class="form-row">
                     <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">
@@ -540,31 +507,12 @@
                     <code>ollama pull llama3.1</code>
                 </div>
 
-                <div class="form-row">
-                    <label style="width:290px" for="node-input-llmSystemPrompt"><i class="fa fa-commenting-o"></i> <span data-i18n="knxUltimateAI.properties.llmSystemPrompt"></span></label>
-                    <textarea style="width:100%; height:110px;" id="node-input-llmSystemPrompt" data-i18n="[placeholder]knxUltimateAI.placeholder.llmSystemPrompt"></textarea>
-                </div>
-
-                <div class="form-row">
-                    <label style="width:290px" for="node-input-llmTemperature"><i class="fa fa-sliders"></i> <span data-i18n="knxUltimateAI.properties.llmTemperature"></span></label>
-                    <input style="width:90px" type="number" id="node-input-llmTemperature">
-                </div>
-
-                <div class="form-row">
-                    <label style="width:290px" for="node-input-llmMaxTokens"><i class="fa fa-align-left"></i> <span data-i18n="knxUltimateAI.properties.llmMaxTokens"></span></label>
-                    <input style="width:90px" type="number" id="node-input-llmMaxTokens">
-                </div>
-
-                <div class="form-row">
-                    <label style="width:290px" for="node-input-llmTimeoutMs"><i class="fa fa-hourglass-half"></i> <span data-i18n="knxUltimateAI.properties.llmTimeoutMs"></span></label>
-                    <input style="width:120px" type="number" id="node-input-llmTimeoutMs">
-                </div>
-
-                <div class="form-row">
-                    <label style="width:290px" for="node-input-llmMaxEventsInPrompt"><i class="fa fa-list"></i> <span data-i18n="knxUltimateAI.properties.llmMaxEventsInPrompt"></span></label>
-                    <input style="width:90px" type="number" id="node-input-llmMaxEventsInPrompt">
-                </div>
+            </div>
+        </div>
 
+        <h3><span data-i18n="knxUltimateAI.sections.llmContext"></span></h3>
+        <div>
+            <div id="knx-ai-llm-context-settings">
                 <div class="form-row">
                     <input type="checkbox" id="node-input-llmIncludeRaw" style="display:inline-block; width:auto; vertical-align:top;">
                     <label style="width:auto" for="node-input-llmIncludeRaw">&nbsp;&nbsp;<span data-i18n="knxUltimateAI.properties.llmIncludeRaw"></span></label>
@@ -575,17 +523,12 @@
                     <label style="width:auto" for="node-input-llmIncludeFlowContext">&nbsp;&nbsp;<span data-i18n="knxUltimateAI.properties.llmIncludeFlowContext"></span></label>
                 </div>
 
-                <div class="form-row">
-                    <label style="width:290px" for="node-input-llmMaxFlowNodesInPrompt"><i class="fa fa-sitemap"></i> <span data-i18n="knxUltimateAI.properties.llmMaxFlowNodesInPrompt"></span></label>
-                    <input style="width:90px" type="number" id="node-input-llmMaxFlowNodesInPrompt">
-                </div>
-
                 <div class="form-row">
                     <input type="checkbox" id="node-input-llmIncludeDocsSnippets" style="display:inline-block; width:auto; vertical-align:top;">
                     <label style="width:auto" for="node-input-llmIncludeDocsSnippets">&nbsp;&nbsp;<span data-i18n="knxUltimateAI.properties.llmIncludeDocsSnippets"></span></label>
                 </div>
 
-                <div class="form-row">
+                <div class="form-row" id="knx-ai-docs-language-row">
                     <label style="width:290px" for="node-input-llmDocsLanguage"><i class="fa fa-language"></i> <span data-i18n="knxUltimateAI.properties.llmDocsLanguage"></span></label>
                     <select style="width:100%" id="node-input-llmDocsLanguage">
                         <option value="it">Italiano</option>
@@ -596,16 +539,54 @@
                         <option value="zh-CN">简体中文</option>
                     </select>
                 </div>
+            </div>
+        </div>
 
-                <div class="form-row">
-                    <label style="width:290px" for="node-input-llmDocsMaxSnippets"><i class="fa fa-files-o"></i> <span data-i18n="knxUltimateAI.properties.llmDocsMaxSnippets"></span></label>
-                    <input style="width:90px" type="number" id="node-input-llmDocsMaxSnippets">
-                </div>
-
-                <div class="form-row">
-                    <label style="width:290px" for="node-input-llmDocsMaxChars"><i class="fa fa-text-width"></i> <span data-i18n="knxUltimateAI.properties.llmDocsMaxChars"></span></label>
-                    <input style="width:110px" type="number" id="node-input-llmDocsMaxChars">
-                </div>
+        <h3><span data-i18n="knxUltimateAI.sections.advanced"></span></h3>
+        <div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-analysisWindowSec"><i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateAI.properties.analysisWindowSec"></span></label>
+                <input style="width:90px" type="number" id="node-input-analysisWindowSec">
+            </div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-maxEvents"><i class="fa fa-bars"></i> <span data-i18n="knxUltimateAI.properties.maxEvents"></span></label>
+                <input style="width:90px" type="number" id="node-input-maxEvents">
+            </div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-topN"><i class="fa fa-list-ol"></i> <span data-i18n="knxUltimateAI.properties.topN"></span></label>
+                <input style="width:90px" type="number" id="node-input-topN">
+            </div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-patternMaxLagMs"><i class="fa fa-arrows-h"></i> <span data-i18n="knxUltimateAI.properties.patternMaxLagMs"></span></label>
+                <input style="width:120px" type="number" id="node-input-patternMaxLagMs">
+            </div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-patternMinCount"><i class="fa fa-filter"></i> <span data-i18n="knxUltimateAI.properties.patternMinCount"></span></label>
+                <input style="width:90px" type="number" id="node-input-patternMinCount">
+            </div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-rateWindowSec"><i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateAI.properties.rateWindowSec"></span></label>
+                <input style="width:90px" type="number" id="node-input-rateWindowSec">
+            </div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-maxTelegramPerSecOverall"><i class="fa fa-tachometer"></i> <span data-i18n="knxUltimateAI.properties.maxTelegramPerSecOverall"></span></label>
+                <input style="width:90px" type="number" id="node-input-maxTelegramPerSecOverall">
+            </div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-maxTelegramPerSecPerGA"><i class="fa fa-bolt"></i> <span data-i18n="knxUltimateAI.properties.maxTelegramPerSecPerGA"></span></label>
+                <input style="width:90px" type="number" id="node-input-maxTelegramPerSecPerGA">
+            </div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-flapWindowSec"><i class="fa fa-exchange"></i> <span data-i18n="knxUltimateAI.properties.flapWindowSec"></span></label>
+                <input style="width:90px" type="number" id="node-input-flapWindowSec">
+            </div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-flapMaxChanges"><i class="fa fa-random"></i> <span data-i18n="knxUltimateAI.properties.flapMaxChanges"></span></label>
+                <input style="width:90px" type="number" id="node-input-flapMaxChanges">
+            </div>
+            <div class="form-row">
+                <label style="width:290px" for="node-input-llmSystemPrompt"><i class="fa fa-commenting-o"></i> <span data-i18n="knxUltimateAI.properties.llmSystemPrompt"></span></label>
+                <textarea style="width:100%; height:110px;" id="node-input-llmSystemPrompt" data-i18n="[placeholder]knxUltimateAI.placeholder.llmSystemPrompt"></textarea>
             </div>
         </div>
     </div>