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

package/CHANGELOG.md

@@ -6,6 +6,21 @@
 
 # CHANGELOG
 
+**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/>
+- **KNX AI — documentation-free operational chat**: Telegram, RedBot and custom CHAT adapters no longer inject packaged help, README, changelog, wiki or example snippets into model prompts. They retain live and archived KNX data, ETS semantics, Node-RED inventory, conversation and home memory, AI Education, cameras and TTS; the web Assistant keeps documentation access for package-support questions.<br/>
+- **KNX AI — tolerant safe-read normalization**: state queries from small local models no longer become rejected writes when the model returns exact ETS destinations but omits the operation discriminator and payload. Payload-free operations are safely inferred as `GroupValue_Read`; payload-bearing operations remain writes and retain every ETS-role, DPT, payload and confirmation safeguard.<br/>
+- **KNX AI — fixed 16K Ollama runtime and prompt budget**: Ollama's advertised model maximum is now informational instead of being sent back as the requested `num_ctx`. KNX AI caps `num_ctx` and its relevance-selected semantic prompt at 16K, preventing 131K KV-cache allocation and full-context prefill. An audit confirmed that OpenAI and Claude receive only output limits, not a client-selected maximum context window.<br/>
+- **KNX AI — fixed 16K Bionic prompt budget**: Bionic's reported active or maximum context can no longer promote conversations to the full 131K data view. KNX AI always builds a relevance-selected 16K semantic prompt for Bionic while preserving the provider's loaded instance, open-ended reasoning, routines, KNX control, cameras and TTS capabilities.<br/>
+- **KNX AI — preserve Bionic LM Studio context**: model discovery now keeps the context length of an already loaded Bionic instance instead of confusing the model's maximum capability with the desired runtime setting. KNX AI no longer loads inactive models through the management API: the first chat request leaves JIT loading and saved per-model defaults to Bionic, while KNX AI uses a conservative 16K prompt budget until the active configuration can be inspected.<br/>
+- **KNX AI — neutral structured-response example**: the conversational contract now demonstrates empty action arrays instead of a fabricated group address, DPT, camera and payload. This prevents small local models from copying placeholder operations into unrelated replies such as greetings while preserving open-ended reasoning and every existing KNX, camera, TTS and routine capability.<br/>
+
+**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/>

package/nodes/knxUltimateAI.html

@@ -182,12 +182,18 @@
     #knx-ai-detected-adapters-status,
     #knx-ai-chat-context-status,
     .knx-ai-chat-context-intro,
+    .knx-ai-chat-context-metric,
     .knx-ai-chat-context-description,
     .knx-ai-chat-context-pattern {
         color: var(--red-ui-secondary-text-color, #777);
         font-size: 12px;
     }
 
+    .knx-ai-chat-context-metric {
+        margin-top: 6px;
+        font-weight: 600;
+    }
+
     .knx-ai-chat-context-group-title {
         margin: 12px 0 2px;
         font-size: 12px;
@@ -610,6 +616,8 @@
                 const $sources = $("#knx-ai-chat-context-sources-list").empty();
                 const $files = $("#knx-ai-chat-context-files-list").empty();
                 const $directories = $("#knx-ai-chat-context-directories-list").empty();
+                const $contextLimit = $("#knx-ai-chat-context-limit");
+                const $lastPromptUsage = $("#knx-ai-chat-context-last-prompt");
                 if (!overview || typeof overview !== "object") {
                     $content.hide();
                     $status
@@ -633,11 +641,59 @@
                     $row.appendTo($list);
                 };
 
+                const formatCompactTokens = function (value) {
+                    const tokens = Math.max(0, Number(value) || 0);
+                    if (!tokens) return "?";
+                    if (tokens >= 1024 && tokens % 1024 === 0) return (tokens / 1024) + "K";
+                    return tokens.toLocaleString();
+                };
+                const formatBytes = function (value) {
+                    const bytes = Math.max(0, Number(value) || 0);
+                    if (bytes >= (1024 * 1024)) return (bytes / (1024 * 1024)).toLocaleString(undefined, { maximumFractionDigits: 1 }) + " MB";
+                    if (bytes >= 1024) return (bytes / 1024).toLocaleString(undefined, { maximumFractionDigits: 1 }) + " KB";
+                    return bytes.toLocaleString() + " B";
+                };
+
+                const contextLimit = overview.contextLimit && typeof overview.contextLimit === "object" ? overview.contextLimit : {};
+                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);
+                }
+                const contextLimitValue = contextLimitTokens
+                    ? formatCompactTokens(contextLimitTokens) + " " + t("knxUltimateAI.messages.chatContextTokens", "tokens")
+                    : t("knxUltimateAI.messages.chatContextProviderManaged", "managed by the selected provider/model");
+                $contextLimit
+                    .text(t("knxUltimateAI.messages.chatContextLimitLabel", "Maximum operational context") + ": " + contextLimitValue)
+                    .attr("title", contextLimitTokens ? contextLimitTokens.toLocaleString() + " tokens" : contextLimitValue);
+
+                const promptUsage = overview.lastPromptUsage && typeof overview.lastPromptUsage === "object" ? overview.lastPromptUsage : null;
+                if (promptUsage && Number(promptUsage.bytes) > 0) {
+                    const exactInputTokens = Math.max(0, Number(promptUsage.exactInputTokens) || 0);
+                    const estimatedInputTokens = Math.max(0, Number(promptUsage.estimatedInputTokens) || 0);
+                    const tokenText = exactInputTokens
+                        ? formatCompactTokens(exactInputTokens) + " " + t("knxUltimateAI.messages.chatContextExactInputTokens", "input tokens measured by the provider")
+                        : "~" + formatCompactTokens(estimatedInputTokens) + " " + t("knxUltimateAI.messages.chatContextEstimatedInputTokens", "estimated input tokens");
+                    const imageText = Number(promptUsage.imageCount) > 0
+                        ? " · " + Number(promptUsage.imageCount).toLocaleString() + " " + t("knxUltimateAI.messages.chatContextImages", "images")
+                        : "";
+                    $lastPromptUsage.text(
+                        t("knxUltimateAI.messages.chatContextLastPromptLabel", "Last chat prompt actual size") + ": " +
+                        formatBytes(promptUsage.bytes) + " · " + tokenText + imageText
+                    );
+                } else {
+                    $lastPromptUsage.text(
+                        t("knxUltimateAI.messages.chatContextLastPromptLabel", "Last chat prompt actual size") + ": " +
+                        t("knxUltimateAI.messages.chatContextLastPromptUnavailable", "not available until the first chat request")
+                    );
+                }
+
                 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."),
+                    cameras: t("knxUltimateAI.messages.chatContextSourceCameras", "Detected cameras and their available capabilities."),
                     ttsUltimate: t("knxUltimateAI.messages.chatContextSourceTtsUltimate", "Selected TTS Ultimate announcement target.")
                 };
                 (Array.isArray(overview.sources) ? overview.sources : []).forEach(function (sourceId) {
@@ -668,7 +724,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 +735,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")
                     );
                 });
 
@@ -747,11 +807,14 @@
                 let text = t("knxUltimateAI.messages.lmStudioContextAvailable", "Maximum model context") + ": " + maxTokens + " token";
                 let color = "#555";
                 if (state === "loading") {
-                    text = t("knxUltimateAI.messages.lmStudioContextLoading", "Loading the model with its maximum context") + ": " + maxTokens + " token…";
+                    text = t("knxUltimateAI.messages.lmStudioContextLoading", "Checking the active model context") + "…";
                     color = "#1565c0";
+                } else if (state === "inactive") {
+                    text = t("knxUltimateAI.messages.lmStudioContextInactive", "Model inactive; Bionic defaults will be used on the first request");
+                    color = "#555";
                 } else if (state === "configured") {
                     const configuredTokens = formatContextTokens(detail.configuredContextLength || detail.loadedContextLength || detail.maxContextLength);
-                    text = t("knxUltimateAI.messages.lmStudioContextConfigured", "Maximum model context configured") + ": " + configuredTokens + " token";
+                    text = t("knxUltimateAI.messages.lmStudioContextConfigured", "Active model context") + ": " + configuredTokens + " token";
                     color = "#2e7d32";
                 } else if (state === "error") {
                     text = String(errorText || t("knxUltimateAI.messages.lmStudioContextFailed", "Unable to configure the model context"));
@@ -759,6 +822,9 @@
                 } else if (detail.loadedContextLength > 0) {
                     text += " · " + t("knxUltimateAI.messages.lmStudioContextCurrentlyLoaded", "currently loaded") + ": " + loadedTokens + " token";
                 }
+                if (provider === "lmstudio" || provider === "ollama") {
+                    text += " · " + t("knxUltimateAI.messages.localContextBudget", "KNX AI context budget") + ": 16K";
+                }
                 $status.text(text).css("color", color).show();
             };
 
@@ -819,9 +885,13 @@
                 }
 
                 const requestVersion = ++localContextRequestVersion;
-                $("#node-input-llmContextLength").val(Number(detail.maxContextLength));
+                const activeContextLength = Number(detail.loadedContextLength) > 0
+                    ? Number(detail.loadedContextLength)
+                    : Number(detail.maxContextLength);
+                $("#node-input-llmContextLength").val(activeContextLength);
                 if (provider === "ollama") {
-                    detail.configuredContextLength = Number(detail.maxContextLength);
+                    detail.configuredContextLength = Math.min(Number(detail.maxContextLength), 16384);
+                    $("#node-input-llmContextLength").val(detail.configuredContextLength);
                     setLocalModelContextStatus(detail, "configured");
                     return;
                 }
@@ -843,13 +913,14 @@
                     type: "POST",
                     contentType: "application/json",
                     data: JSON.stringify(payload)
-                })
+                    })
                     .done(function (data) {
                         if (requestVersion !== localContextRequestVersion) return;
-                        detail.loadedContextLength = Math.max(0, Number(data && data.contextLength) || Number(detail.maxContextLength));
-                        detail.configuredContextLength = detail.loadedContextLength;
-                        $("#node-input-llmContextLength").val(detail.loadedContextLength);
-                        setLocalModelContextStatus(detail, "configured");
+                        const resolvedContextLength = Math.max(0, Number(data && data.contextLength) || 0);
+                        detail.loadedContextLength = data && data.active === true ? resolvedContextLength : 0;
+                        detail.configuredContextLength = resolvedContextLength;
+                        $("#node-input-llmContextLength").val(resolvedContextLength);
+                        setLocalModelContextStatus(detail, data && data.active === true ? "configured" : "inactive");
                     })
                     .fail(function (xhr) {
                         if (requestVersion !== localContextRequestVersion) return;
@@ -1115,6 +1186,8 @@
                 <div id="knx-ai-chat-context-status" data-i18n="knxUltimateAI.messages.chatContextLoading"></div>
                 <div id="knx-ai-chat-context-content" style="display:none;">
                     <div class="knx-ai-chat-context-intro" data-i18n="knxUltimateAI.messages.chatContextIntro"></div>
+                    <div id="knx-ai-chat-context-limit" class="knx-ai-chat-context-metric"></div>
+                    <div id="knx-ai-chat-context-last-prompt" class="knx-ai-chat-context-metric"></div>
                     <div class="knx-ai-chat-context-group-title" data-i18n="knxUltimateAI.messages.chatContextSourcesTitle"></div>
                     <div id="knx-ai-chat-context-sources-list"></div>
                     <div class="knx-ai-chat-context-group-title" data-i18n="knxUltimateAI.messages.chatContextFilesTitle"></div>