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

package/CHANGELOG.md

@@ -6,6 +6,20 @@
 
 # CHANGELOG
 
+**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/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/knxUltimateAI.html

@@ -5,6 +5,37 @@
         align-items: flex-start;
     }
 
+    #knx-ai-llm-connection-settings {
+        width: 100%;
+        max-width: 720px;
+        min-width: 0;
+    }
+
+    #knx-ai-llm-connection-settings .form-row {
+        min-width: 0;
+    }
+
+    #knx-ai-local-context-status,
+    .knx-ai-prompt-context-hint {
+        width: 100%;
+        max-width: 720px;
+        min-width: 0;
+        box-sizing: border-box;
+        color: var(--red-ui-secondary-text-color, #777);
+        font-size: 12px;
+        line-height: 1.4;
+        white-space: normal;
+        overflow-wrap: break-word;
+    }
+
+    #knx-ai-local-context-status {
+        margin: -8px 0 12px;
+    }
+
+    .knx-ai-prompt-context-hint {
+        margin: 6px 0 0;
+    }
+
     #knx-ai-ollama-install-row>label {
         padding-top: 6px;
     }
@@ -138,7 +169,8 @@
     }
 
     #knx-ai-detected-adapters-panel,
-    #knx-ai-chat-context-panel {
+    #knx-ai-chat-context-panel,
+    #knx-ai-chat-learning-link-panel {
         margin: 0 0 18px;
         padding: 12px 14px;
         border: 1px solid var(--red-ui-form-input-border-color, #ccc);
@@ -155,7 +187,8 @@
     }
 
     #knx-ai-detected-adapters-panel>h4,
-    #knx-ai-chat-context-panel>h4 {
+    #knx-ai-chat-context-panel>h4,
+    #knx-ai-chat-learning-link-panel>h4 {
         margin: 0 0 9px;
         font-size: 14px;
         font-weight: 600;
@@ -189,6 +222,17 @@
         font-size: 12px;
     }
 
+    #knx-ai-chat-learning-link-panel {
+        margin: 18px 0 0;
+    }
+
+    .knx-ai-chat-learning-link-copy {
+        margin: 0 0 10px;
+        color: var(--red-ui-secondary-text-color, #777);
+        font-size: 12px;
+        line-height: 1.45;
+    }
+
     .knx-ai-chat-context-metric {
         margin-top: 6px;
         font-weight: 600;
@@ -273,6 +317,7 @@
             llmBaseUrl: { value: "https://api.openai.com/v1/chat/completions" },
             llmModel: { value: "gpt-5.4" },
             llmContextLength: { value: 0 },
+            llmPromptContextTokens: { value: 16384 },
             llmAllowKnxCommands: { value: false },
             llmRequireCommandConfirmation: { value: true },
             chatAdapterPreset: { value: "none" },
@@ -398,6 +443,13 @@
                     } catch (error) { }
                     delete node[key];
                 });
+                try {
+                    const $model = $("#node-input-llmModel");
+                    $model.off(".knxUltimateAiModelPicker");
+                    if (typeof $model.autocomplete === "function" && $model.data("ui-autocomplete")) {
+                        $model.autocomplete("destroy");
+                    }
+                } catch (error) { }
             };
 
             try {
@@ -658,7 +710,11 @@
                 const currentProvider = String(contextLimit.provider || $("#node-input-llmProvider").val() || "").toLowerCase();
                 let contextLimitTokens = Math.max(0, Number(contextLimit.tokens) || 0);
                 if (!contextLimitTokens && (currentProvider === "lmstudio" || currentProvider === "ollama")) {
-                    contextLimitTokens = Math.min(Math.max(0, Number($("#node-input-llmContextLength").val()) || 16384), 16384);
+                    contextLimitTokens = Math.min(
+                        Math.max(0, Number($("#node-input-llmContextLength").val()) || 16384),
+                        Math.max(0, Number($("#node-input-llmPromptContextTokens").val()) || 16384),
+                        16384
+                    );
                 }
                 const contextLimitValue = contextLimitTokens
                     ? formatCompactTokens(contextLimitTokens) + " " + t("knxUltimateAI.messages.chatContextTokens", "tokens")
@@ -742,7 +798,7 @@
                 });
 
                 $("#knx-ai-chat-context-pattern")
-                    .text(t("knxUltimateAI.messages.chatContextTelegramPattern", "Daily files") + ": " + String(overview.telegramFilePattern || "YYYY-MM-DD.jsonl"));
+                    .text(t("knxUltimateAI.messages.chatContextTelegramPattern", "Daily files") + ": " + String(overview.telegramFilePattern || "YYYY-MM-DD.knxctx"));
                 $status.hide();
                 $content.show();
             };
@@ -763,17 +819,30 @@
                     renderChatContextOverview(null);
                 });
 
-            $("#knx-ai-open-web-page-vue").on("click", function (evt) {
-                evt.preventDefault();
+            const openKnxAiWebPage = function (view) {
                 const adminRoot = resolveAdminRoot();
                 const targetBase = adminRoot + "/knxUltimateAI/sidebar/page";
                 const params = new URLSearchParams();
                 if (nodeId) params.set("nodeId", nodeId);
+                if (view === "chat-learning") {
+                    params.set("tab", "settings");
+                    params.set("settingsTab", "learning");
+                }
                 const accessToken = resolveAccessToken();
                 if (accessToken) params.set("access_token", accessToken);
                 const target = targetBase + (params.toString() ? ("?" + params.toString()) : "");
                 const wnd = window.open(target, "_blank", "noopener,noreferrer");
                 try { if (wnd && typeof wnd.focus === "function") wnd.focus(); } catch (e) { }
+            };
+
+            $("#knx-ai-open-web-page-vue").on("click", function (evt) {
+                evt.preventDefault();
+                openKnxAiWebPage();
+            });
+
+            $("#knx-ai-open-chat-learning").on("click", function (evt) {
+                evt.preventDefault();
+                openKnxAiWebPage("chat-learning");
             });
 
             const setRefreshModelsBusy = (busy) => {
@@ -788,6 +857,8 @@
             };
 
             let localModelDetailsById = new Map();
+            let availableModelItems = [];
+            let modelPickerMouseDown = false;
             let localContextRequestVersion = 0;
 
             const formatContextTokens = (value) => {
@@ -823,28 +894,63 @@
                     text += " · " + t("knxUltimateAI.messages.lmStudioContextCurrentlyLoaded", "currently loaded") + ": " + loadedTokens + " token";
                 }
                 if (provider === "lmstudio" || provider === "ollama") {
-                    text += " · " + t("knxUltimateAI.messages.localContextBudget", "KNX AI context budget") + ": 16K";
+                    const selectedBudget = Math.max(4096, Number($("#node-input-llmPromptContextTokens").val()) || 16384);
+                    text += " · " + t("knxUltimateAI.messages.localContextBudget", "KNX AI context budget") + ": " + (selectedBudget / 1024) + "K";
                 }
                 $status.text(text).css("color", color).show();
             };
 
             const populateModels = (models, modelDetails) => {
-                const $dl = $("#knx-ai-llmModels");
-                if (!$dl || $dl.length === 0) return;
                 localModelDetailsById = new Map();
                 (modelDetails || []).forEach(function (detail) {
                     if (detail && detail.id) localModelDetailsById.set(String(detail.id), detail);
                 });
-                $dl.empty();
-                (models || []).forEach(function (m) {
+                availableModelItems = (models || []).map(function (m) {
                     const detail = localModelDetailsById.get(String(m));
                     const label = detail
                         ? String(detail.displayName || detail.id) + " · " + formatContextTokens(detail.maxContextLength) + " token"
                         : String(m);
-                    $("<option>").attr("value", m).attr("label", label).appendTo($dl);
+                    return { label: label, value: String(m) };
                 });
             };
 
+            const configureModelPicker = () => {
+                const $model = $("#node-input-llmModel");
+                if (!$model.length || typeof $model.autocomplete !== "function") return;
+                $model.autocomplete({
+                    minLength: 0,
+                    source: function (request, response) {
+                        const term = String(request && request.term ? request.term : "").trim().toLowerCase();
+                        if (!term) {
+                            response(availableModelItems.slice());
+                            return;
+                        }
+                        response(availableModelItems.filter(function (item) {
+                            return item.value.toLowerCase().includes(term) || item.label.toLowerCase().includes(term);
+                        }));
+                    },
+                    select: function (event, ui) {
+                        $(this).val(ui.item.value).trigger("change");
+                        return false;
+                    }
+                });
+                $model.on("mousedown.knxUltimateAiModelPicker", function () {
+                    modelPickerMouseDown = true;
+                }).on("focus.knxUltimateAiModelPicker", function () {
+                    if (!modelPickerMouseDown) $(this).autocomplete("search", "");
+                }).on("click.knxUltimateAiModelPicker", function () {
+                    modelPickerMouseDown = false;
+                    const input = this;
+                    setTimeout(function () {
+                        try { $(input).autocomplete("search", ""); } catch (error) { }
+                    }, 0);
+                }).on("blur.knxUltimateAiModelPicker", function () {
+                    modelPickerMouseDown = false;
+                });
+            };
+
+            configureModelPicker();
+
             const normalizeUrl = (value) => String(value || "").trim().replace(/\/+$/, "").toLowerCase();
             const isOpenAiDefaultUrl = (value) => normalizeUrl(value) === normalizeUrl(OPENAI_COMPAT_DEFAULT_CHAT_URL);
             const isOllamaDefaultUrl = (value) => normalizeUrl(value) === normalizeUrl(OLLAMA_DEFAULT_CHAT_URL);
@@ -1044,7 +1150,9 @@
 
             const toggleProvider = ({ applyDefaults = false, autoLoadModels = false } = {}) => {
                 const provider = $("#node-input-llmProvider").val();
+                const localProvider = provider === "lmstudio" || provider === "ollama";
                 if (applyDefaults) applyProviderDefaults(provider);
+                $("#knx-ai-prompt-context-row").toggle(localProvider);
                 if (provider === "ollama") {
                     $("#knx-ai-apikey-row").hide();
                     $("#knx-ai-ollama-install-row").show();
@@ -1071,6 +1179,10 @@
             $("#node-input-llmModel").on("change", function () {
                 configureSelectedLocalModel();
             });
+            $("#node-input-llmPromptContextTokens").on("change", function () {
+                const detail = localModelDetailsById.get(String($("#node-input-llmModel").val() || "").trim());
+                if (detail) setLocalModelContextStatus(detail, detail.loadedContextLength > 0 ? "configured" : "inactive");
+            });
             $("#knx-ai-downloadOllamaModel").on("click", function (evt) {
                 evt.preventDefault();
                 openOllamaLibrary();
@@ -1171,6 +1283,13 @@
                 <h4><i class="fa fa-home"></i> <span data-i18n="knxUltimateAI.sections.homeIntelligence"></span></h4>
                 <div class="knx-ai-accordion-mount" id="knx-ai-mount-home-intelligence"></div>
             </div>
+            <div id="knx-ai-chat-learning-link-panel">
+                <h4><i class="fa fa-graduation-cap"></i> <span data-i18n="knxUltimateAI.sections.chatLearning"></span></h4>
+                <p class="knx-ai-chat-learning-link-copy" data-i18n="knxUltimateAI.messages.chatLearningOpenHint"></p>
+                <button type="button" class="red-ui-button" id="knx-ai-open-chat-learning">
+                    <i class="fa fa-external-link"></i> <span data-i18n="knxUltimateAI.buttons.openChatLearning"></span>
+                </button>
+            </div>
             <div id="knx-ai-detected-adapters-panel">
                 <h4><i class="fa fa-puzzle-piece"></i> <span data-i18n="knxUltimateAI.sections.detectedAdapters"></span></h4>
                 <div id="knx-ai-detected-adapters-status" data-i18n="knxUltimateAI.messages.detectedAdaptersLoading"></div>
@@ -1226,14 +1345,22 @@
 
                 <div class="form-row">
                     <label style="width:290px" for="node-input-llmModel"><i class="fa fa-cube"></i> <span data-i18n="knxUltimateAI.properties.llmModel"></span></label>
-                    <input style="width:calc(100% - 110px)" type="text" id="node-input-llmModel" list="knx-ai-llmModels" data-i18n="[placeholder]knxUltimateAI.placeholder.llmModel">
+                    <input style="width:calc(100% - 110px)" type="text" id="node-input-llmModel" autocomplete="off" data-i18n="[placeholder]knxUltimateAI.placeholder.llmModel">
                     <button type="button" class="red-ui-button" id="knx-ai-refreshModels" style="margin-left:6px;" title="Refresh models">
                         <i class="fa fa-refresh"></i> <span data-i18n="knxUltimateAI.buttons.refreshModels"></span>
                     </button>
                 </div>
-                <datalist id="knx-ai-llmModels"></datalist>
                 <input type="hidden" id="node-input-llmContextLength">
-                <div id="knx-ai-local-context-status" style="display:none; margin:-8px 0 12px 290px; font-size:12px;"></div>
+                <div id="knx-ai-local-context-status" style="display:none;"></div>
+                <div class="form-row" id="knx-ai-prompt-context-row" style="display:none;">
+                    <label style="width:290px" for="node-input-llmPromptContextTokens"><i class="fa fa-database"></i> <span data-i18n="knxUltimateAI.properties.llmPromptContextTokens"></span></label>
+                    <select style="width:100%" id="node-input-llmPromptContextTokens">
+                        <option value="4096" data-i18n="knxUltimateAI.selectlists.promptContext.small"></option>
+                        <option value="8192" data-i18n="knxUltimateAI.selectlists.promptContext.medium"></option>
+                        <option value="16384" data-i18n="knxUltimateAI.selectlists.promptContext.full"></option>
+                    </select>
+                    <div class="knx-ai-prompt-context-hint" data-i18n="knxUltimateAI.messages.promptContextHint"></div>
+                </div>
                 <div class="form-row">
                     <input type="checkbox" id="node-input-llmAllowKnxCommands" style="display:inline-block; width:auto; vertical-align:top;">
                     <label style="width:auto" for="node-input-llmAllowKnxCommands">&nbsp;&nbsp;<span data-i18n="knxUltimateAI.properties.llmAllowKnxCommands"></span></label>