node-red-contrib-knx-ultimate 4.2.10 → 4.2.12

package/CHANGELOG.md

@@ -6,6 +6,21 @@
 
 # CHANGELOG
 
+**Version 4.2.12** - April 2026<br/>
+
+- FIX: **KNX AI Web** and **KNX Viewer Web** admin routes now normalize `access_token` auth safely by mapping query token to `Authorization: Bearer ...` only when missing, then removing `access_token` from `req.query` before permission checks.<br/>
+- FIX: resolved intermittent `400 Bad Request` on authenticated web pages caused by duplicate bearer token sources (header + query string).<br/>
+- CHANGE: extracted shared auth normalization helper to `nodes/utils/httpAdminAccessToken.js` to keep AI/Viewer behavior aligned and easier to maintain.<br/>
+
+**Version 4.2.11** - April 2026<br/>
+
+- UI: **KNX AI Web** improved assistant workflow with chat-style layout (prompt input under messages), clearer prompt focus, and streamlined Ask page text.<br/>
+- UI: **KNX AI Web** added clearer loading feedback for AI operations (area regeneration/deletion and planner generation), including a centered blocking wait overlay during long-running area generation.<br/>
+- NEW: **KNX AI Web** added bulk action **Delete AI Areas** and localized labels for **Regenerate AI Areas** / **Delete AI Areas** across supported UI languages.<br/>
+- FIX: **KNX AI backend** hardened JSON extraction/parsing for LLM outputs and improved timeout/token-limit diagnostics in error messages.<br/>
+- CHANGE: **KNX AI backend** raised default/forced `llmMaxTokens` handling for structured responses and aligned editor defaults for high-token completions.<br/>
+- Docs/wiki: improved **KNX AI Dashboard** pages for end users, added localized guidance updates, and made support CTA links visible in docs navigation.<br/>
+
 **Version 4.2.10** - April 2026<br/>
 
 - UI: **KNX AI Web** sidebar menu style aligned to Homebridge (font size/weight, spacing, icon/text alignment and sidebar widths) for closer visual consistency.<br/>

package/examples/OSC to KNX via Function External Module.json

@@ -0,0 +1,144 @@
+[
+  {
+    "id": "tab_osc_knx_fn",
+    "type": "tab",
+    "label": "OSC -> KNX (Function)",
+    "disabled": false,
+    "info": ""
+  },
+  {
+    "id": "cmt_osc_knx_fn_intro",
+    "type": "comment",
+    "z": "tab_osc_knx_fn",
+    "name": "Receive OSC in a Function node and map to two KNX DPTs",
+    "info": "Prerequisites:\n1) In Node-RED settings.js set functionExternalModules: true and restart Node-RED.\n2) Deploy this flow: Node-RED will install node-osc for this Function node.\n\nOSC mappings handled by the Function node:\n- /knx/switch <value>  -> KNX Device DPT 1.001 (true/false)\n- /knx/value <value>   -> KNX Device DPT 5.001 (0..255 integer)\n\nExample OSC values:\n- /knx/switch 1\n- /knx/switch false\n- /knx/value 120",
+    "x": 410,
+    "y": 40,
+    "wires": []
+  },
+  {
+    "id": "fn_osc_receiver",
+    "type": "function",
+    "z": "tab_osc_knx_fn",
+    "name": "OSC Receiver (node-osc)",
+    "func": "// Input messages are ignored: this node emits only from the OSC callback defined in Setup.\nreturn null;",
+    "outputs": 2,
+    "timeout": 0,
+    "noerr": 0,
+    "initialize": "const listenPort = 8001;\nconst listenHost = \"0.0.0.0\";\n\nconst closeServer = (server) => {\n    if (!server || typeof server.close !== \"function\") {\n        return Promise.resolve();\n    }\n\n    try {\n        if (typeof server.removeAllListeners === \"function\") {\n            server.removeAllListeners(\"message\");\n            server.removeAllListeners(\"bundle\");\n            server.removeAllListeners(\"error\");\n            server.removeAllListeners(\"listening\");\n        }\n    } catch (err) {\n        node.warn(\"Error removing OSC listeners: \" + err.message);\n    }\n\n    return new Promise((resolve) => {\n        let doneCalled = false;\n        const done = () => {\n            if (doneCalled) return;\n            doneCalled = true;\n            resolve();\n        };\n\n        try {\n            const maybePromise = server.close((err) => {\n                if (err) node.warn(\"OSC close callback error: \" + err.message);\n                done();\n            });\n\n            if (maybePromise && typeof maybePromise.then === \"function\") {\n                maybePromise.then(done).catch((err) => {\n                    node.warn(\"OSC close promise error: \" + err.message);\n                    done();\n                });\n            } else {\n                setTimeout(done, 150);\n            }\n        } catch (err) {\n            node.warn(\"OSC close throw: \" + err.message);\n            done();\n        }\n    });\n};\n\nif (!nodeOsc || typeof nodeOsc.Server !== \"function\") {\n    node.status({ fill: \"red\", shape: \"ring\", text: \"node-osc missing\" });\n    node.error(\"node-osc not available. Enable functionExternalModules and deploy again.\");\n    return;\n}\n\nconst normalizeBoolean = (value) => {\n    if (typeof value === \"boolean\") return value;\n    if (typeof value === \"number\") return value !== 0;\n    const text = String(value).trim().toLowerCase();\n    return text === \"true\" || text === \"1\" || text === \"on\";\n};\n\nconst previousServer = context.get(\"oscServer\");\ncontext.set(\"oscServer\", null);\nnode.status({ fill: \"yellow\", shape: \"ring\", text: \"restarting OSC...\" });\n\nreturn closeServer(previousServer).then(() => {\n    const oscServer = new nodeOsc.Server(listenPort, listenHost, function () {\n        node.status({ fill: \"green\", shape: \"dot\", text: \"OSC \" + listenHost + \":\" + listenPort });\n    });\n\n    context.set(\"oscServer\", oscServer);\n\n    oscServer.on(\"error\", function (err) {\n        node.warn(\"OSC server error: \" + (err && err.message ? err.message : err));\n    });\n\n    oscServer.on(\"message\", function (oscMsg) {\n        if (!Array.isArray(oscMsg) || oscMsg.length < 2) return;\n\n        const address = String(oscMsg[0] || \"\");\n        const value = oscMsg[1];\n\n        if (address === \"/knx/switch\") {\n            node.send([{\n                payload: normalizeBoolean(value),\n                oscAddress: address,\n                rawOsc: oscMsg\n            }, null]);\n            return;\n        }\n\n        if (address === \"/knx/value\") {\n            const parsed = Number(value);\n            if (!Number.isFinite(parsed)) {\n                node.warn(\"OSC /knx/value not numeric: \" + value);\n                return;\n            }\n\n            node.send([null, {\n                payload: Math.max(0, Math.min(255, Math.round(parsed))),\n                oscAddress: address,\n                rawOsc: oscMsg\n            }]);\n        }\n    });\n}).catch((err) => {\n    node.status({ fill: \"red\", shape: \"ring\", text: \"OSC start error\" });\n    node.error(\"Unable to start OSC server: \" + (err && err.message ? err.message : err));\n});",
+    "finalize": "const closeServer = (server) => {\n    if (!server || typeof server.close !== \"function\") {\n        return Promise.resolve();\n    }\n\n    try {\n        if (typeof server.removeAllListeners === \"function\") {\n            server.removeAllListeners(\"message\");\n            server.removeAllListeners(\"bundle\");\n            server.removeAllListeners(\"error\");\n            server.removeAllListeners(\"listening\");\n        }\n    } catch (err) {\n        node.warn(\"Error removing OSC listeners in finalize: \" + err.message);\n    }\n\n    return new Promise((resolve) => {\n        let doneCalled = false;\n        const done = () => {\n            if (doneCalled) return;\n            doneCalled = true;\n            resolve();\n        };\n\n        try {\n            const maybePromise = server.close((err) => {\n                if (err) node.warn(\"OSC finalize close callback error: \" + err.message);\n                done();\n            });\n\n            if (maybePromise && typeof maybePromise.then === \"function\") {\n                maybePromise.then(done).catch((err) => {\n                    node.warn(\"OSC finalize close promise error: \" + err.message);\n                    done();\n                });\n            } else {\n                setTimeout(done, 150);\n            }\n        } catch (err) {\n            node.warn(\"OSC finalize close throw: \" + err.message);\n            done();\n        }\n    });\n};\n\nconst oscServer = context.get(\"oscServer\");\ncontext.set(\"oscServer\", null);\nnode.status({ fill: \"yellow\", shape: \"ring\", text: \"stopping OSC...\" });\n\nreturn closeServer(oscServer).then(() => {\n    node.status({});\n});",
+    "libs": [
+      {
+        "var": "nodeOsc",
+        "module": "node-osc"
+      }
+    ],
+    "x": 230,
+    "y": 180,
+    "wires": [
+      [
+        "knx_bool_1"
+      ],
+      [
+        "knx_int_1"
+      ]
+    ]
+  },
+  {
+    "id": "knx_bool_1",
+    "type": "knxUltimate",
+    "z": "tab_osc_knx_fn",
+    "server": "osc_knx_cfg_1",
+    "topic": "1/1/1",
+    "outputtopic": "",
+    "dpt": "1.001",
+    "initialread": false,
+    "notifyreadrequest": false,
+    "notifyresponse": true,
+    "notifywrite": true,
+    "notifyreadrequestalsorespondtobus": false,
+    "notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized": "",
+    "listenallga": false,
+    "name": "KNX Switch (DPT 1.001)",
+    "outputtype": "write",
+    "outputRBE": false,
+    "inputRBE": false,
+    "x": 520,
+    "y": 150,
+    "wires": [
+      [
+        "dbg_bool_out"
+      ]
+    ]
+  },
+  {
+    "id": "knx_int_1",
+    "type": "knxUltimate",
+    "z": "tab_osc_knx_fn",
+    "server": "osc_knx_cfg_1",
+    "topic": "1/1/2",
+    "outputtopic": "",
+    "dpt": "5.001",
+    "initialread": false,
+    "notifyreadrequest": false,
+    "notifyresponse": true,
+    "notifywrite": true,
+    "notifyreadrequestalsorespondtobus": false,
+    "notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized": "",
+    "listenallga": false,
+    "name": "KNX Value (DPT 5.001)",
+    "outputtype": "write",
+    "outputRBE": false,
+    "inputRBE": false,
+    "x": 510,
+    "y": 220,
+    "wires": [
+      [
+        "dbg_int_out"
+      ]
+    ]
+  },
+  {
+    "id": "dbg_bool_out",
+    "type": "debug",
+    "z": "tab_osc_knx_fn",
+    "name": "Bool KNX out",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 720,
+    "y": 150,
+    "wires": []
+  },
+  {
+    "id": "dbg_int_out",
+    "type": "debug",
+    "z": "tab_osc_knx_fn",
+    "name": "Int KNX out",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 710,
+    "y": 220,
+    "wires": []
+  },
+  {
+    "id": "osc_knx_cfg_1",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.203",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "yes"
+  }
+]

package/nodes/knxUltimateAI.html

@@ -36,8 +36,8 @@
             llmModel: { value: "gpt-5.4" },
             llmSystemPrompt: { value: "" },
             llmTemperature: { value: 0.2, required: false, validate: RED.validators.number() },
-            llmMaxTokens: { value: 10000, required: false, validate: RED.validators.number() },
-            llmTimeoutMs: { value: 30000, 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 },
@@ -99,10 +99,31 @@
             toggleProvider();
 
             const nodeId = this.id;
+            const resolveAdminRoot = () => {
+                const raw = (RED.settings && typeof RED.settings.httpAdminRoot === "string") ? RED.settings.httpAdminRoot : "/";
+                const trimmed = String(raw || "/").trim();
+                if (trimmed === "" || trimmed === "/") return "";
+                return "/" + trimmed.replace(/^\/+|\/+$/g, "");
+            };
+            const resolveAccessToken = () => {
+                try {
+                    const tokens = (RED.settings && typeof RED.settings.get === "function") ? RED.settings.get("auth-tokens") : null;
+                    const token = tokens && typeof tokens.access_token === "string" ? tokens.access_token.trim() : "";
+                    return token;
+                } catch (error) {
+                    return "";
+                }
+            };
 
             $("#knx-ai-open-web-page-vue").on("click", function (evt) {
                 evt.preventDefault();
-                const target = "knxUltimateAI/sidebar/page" + (nodeId ? ("?nodeId=" + encodeURIComponent(nodeId)) : "");
+                const adminRoot = resolveAdminRoot();
+                const targetBase = adminRoot + "/knxUltimateAI/sidebar/page";
+                const params = new URLSearchParams();
+                if (nodeId) params.set("nodeId", nodeId);
+                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) { }
             });

package/nodes/knxUltimateAI.js

@@ -3,6 +3,7 @@ const loggerClass = require('./utils/sysLogger')
 const dptlib = require('knxultimate').dptlib
 const fs = require('fs')
 const path = require('path')
+const { getRequestAccessToken, normalizeAuthFromAccessTokenQuery } = require('./utils/httpAdminAccessToken')
 let googleTranslateTTS = null
 try {
   googleTranslateTTS = require('google-translate-tts')
@@ -16,17 +17,23 @@ let adminEndpointsRegistered = false
 const aiRuntimeNodes = new Map()
 const knxAiVueDistDir = path.join(__dirname, 'plugins', 'knxUltimateAI-vue')
 
-const sendKnxAiVueIndex = (res) => {
+const sendKnxAiVueIndex = (req, res) => {
   const entryPath = path.join(knxAiVueDistDir, 'index.html')
-  fs.stat(entryPath, (error, stats) => {
-    if (error || !stats || !stats.isFile()) {
+  fs.readFile(entryPath, 'utf8', (error, html) => {
+    if (error || typeof html !== 'string') {
       res.status(503).type('text/plain').send('KNX AI Vue build not found. Run "npm run knx-ai:build" in the module root.')
       return
     }
-    res.sendFile(entryPath, (sendError) => {
-      if (!sendError || res.headersSent) return
-      res.status(sendError.statusCode || 500).type('text/plain').send(sendError.message || String(sendError))
-    })
+    const rawToken = getRequestAccessToken(req)
+    if (!rawToken) {
+      res.type('text/html').send(html)
+      return
+    }
+    const encodedToken = encodeURIComponent(rawToken)
+    const htmlWithToken = html
+      .replace('./assets/app.js', `./assets/app.js?access_token=${encodedToken}`)
+      .replace('./assets/app.css', `./assets/app.css?access_token=${encodedToken}`)
+    res.type('text/html').send(htmlWithToken)
   })
 }
 
@@ -254,31 +261,124 @@ const buildLlmSummarySnapshot = (summary) => {
 const extractJsonFragmentFromText = (value) => {
   const text = String(value || '').trim()
   if (!text) throw new Error('Empty AI response')
-  const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/i)
-  const candidate = fenced && fenced[1] ? String(fenced[1]).trim() : text
+  const normalizeCandidate = (input) => String(input || '')
+    .replace(/^\uFEFF/, '')
+    .replace(/^\s*json\s*\n/i, '')
+    .trim()
+
   const tryParse = (input) => {
-    if (!input) return null
+    const source = normalizeCandidate(input)
+    if (!source) return null
     try {
-      return JSON.parse(input)
+      return JSON.parse(source)
+    } catch (error) {}
+    // Fallback: tolerate comments and trailing commas that some models emit.
+    const relaxed = source
+      .replace(/\/\*[\s\S]*?\*\//g, '')
+      .replace(/^\s*\/\/.*$/gm, '')
+      .replace(/,\s*([}\]])/g, '$1')
+      .trim()
+    if (!relaxed || relaxed === source) return null
+    try {
+      return JSON.parse(relaxed)
     } catch (error) {
       return null
     }
   }
-  const direct = tryParse(candidate)
-  if (direct !== null) return direct
-  const objectStart = candidate.indexOf('{')
-  const objectEnd = candidate.lastIndexOf('}')
-  if (objectStart !== -1 && objectEnd !== -1 && objectEnd > objectStart) {
-    const parsedObject = tryParse(candidate.slice(objectStart, objectEnd + 1))
-    if (parsedObject !== null) return parsedObject
+
+  const extractBalancedJsonSlices = (input, maxSlices = 24) => {
+    const source = String(input || '')
+    const out = []
+    for (let i = 0; i < source.length; i += 1) {
+      const ch = source[i]
+      if (ch !== '{' && ch !== '[') continue
+      const stack = [ch === '{' ? '}' : ']']
+      let inString = false
+      let escaped = false
+      for (let j = i + 1; j < source.length; j += 1) {
+        const current = source[j]
+        if (inString) {
+          if (escaped) {
+            escaped = false
+            continue
+          }
+          if (current === '\\') {
+            escaped = true
+            continue
+          }
+          if (current === '"') inString = false
+          continue
+        }
+        if (current === '"') {
+          inString = true
+          continue
+        }
+        if (current === '{') {
+          stack.push('}')
+          continue
+        }
+        if (current === '[') {
+          stack.push(']')
+          continue
+        }
+        if ((current === '}' || current === ']') && stack.length) {
+          if (current !== stack[stack.length - 1]) break
+          stack.pop()
+          if (!stack.length) {
+            const slice = normalizeCandidate(source.slice(i, j + 1))
+            if (slice) out.push(slice)
+            i = j
+            break
+          }
+        }
+      }
+      if (out.length >= maxSlices) break
+    }
+    return out
+  }
+
+  const candidates = []
+  const seen = new Set()
+  const pushCandidate = (input) => {
+    const normalized = normalizeCandidate(input)
+    if (!normalized || seen.has(normalized)) return
+    seen.add(normalized)
+    candidates.push(normalized)
   }
-  const arrayStart = candidate.indexOf('[')
-  const arrayEnd = candidate.lastIndexOf(']')
-  if (arrayStart !== -1 && arrayEnd !== -1 && arrayEnd > arrayStart) {
-    const parsedArray = tryParse(candidate.slice(arrayStart, arrayEnd + 1))
-    if (parsedArray !== null) return parsedArray
+
+  pushCandidate(text)
+  const fencedRe = /```(?:[a-zA-Z0-9_-]+)?\s*([\s\S]*?)```/g
+  let fenceMatch
+  while ((fenceMatch = fencedRe.exec(text)) !== null) {
+    pushCandidate(fenceMatch[1])
+  }
+
+  for (const candidate of candidates) {
+    const direct = tryParse(candidate)
+    if (direct !== null) return direct
+
+    const objectStart = candidate.indexOf('{')
+    const objectEnd = candidate.lastIndexOf('}')
+    if (objectStart !== -1 && objectEnd !== -1 && objectEnd > objectStart) {
+      const parsedObject = tryParse(candidate.slice(objectStart, objectEnd + 1))
+      if (parsedObject !== null) return parsedObject
+    }
+    const arrayStart = candidate.indexOf('[')
+    const arrayEnd = candidate.lastIndexOf(']')
+    if (arrayStart !== -1 && arrayEnd !== -1 && arrayEnd > arrayStart) {
+      const parsedArray = tryParse(candidate.slice(arrayStart, arrayEnd + 1))
+      if (parsedArray !== null) return parsedArray
+    }
+
+    const balancedSlices = extractBalancedJsonSlices(candidate)
+    for (const slice of balancedSlices) {
+      const parsedSlice = tryParse(slice)
+      if (parsedSlice !== null) return parsedSlice
+    }
   }
-  throw new Error('The LLM response did not contain valid JSON')
+
+  const preview = text.slice(0, 180).replace(/\s+/g, ' ').trim()
+  throw new Error(`The LLM response did not contain valid JSON${preview ? ` (preview: ${preview})` : ''}`)
 }
 
 const normalizeValueForCompare = (value) => {
@@ -2046,15 +2146,25 @@ const buildRelevantDocsContext = ({ moduleRootDir, question, preferredLangDir, m
 }
 
 const postJson = async ({ url, headers, body, timeoutMs }) => {
+  const resolvedTimeoutMs = Math.max(1000, Number(timeoutMs) || 30000)
   const controller = new AbortController()
-  const timer = setTimeout(() => controller.abort(), timeoutMs || 30000)
+  const timer = setTimeout(() => controller.abort(), resolvedTimeoutMs)
   try {
-    const res = await fetch(url, {
-      method: 'POST',
-      headers: Object.assign({ 'content-type': 'application/json' }, headers || {}),
-      body: JSON.stringify(body || {}),
-      signal: controller.signal
-    })
+    let res
+    try {
+      res = await fetch(url, {
+        method: 'POST',
+        headers: Object.assign({ 'content-type': 'application/json' }, headers || {}),
+        body: JSON.stringify(body || {}),
+        signal: controller.signal
+      })
+    } catch (error) {
+      const isAbort = (error && error.name === 'AbortError') || /\babort(ed)?\b/i.test(String(error && error.message ? error.message : ''))
+      if (isAbort) {
+        throw new Error(`LLM request timeout after ${Math.round(resolvedTimeoutMs / 1000)}s. Increase "Timeout ms" in the KNX AI node settings or reduce prompt context.`)
+      }
+      throw error
+    }
     const text = await res.text()
     let json
     try {
@@ -2076,8 +2186,9 @@ const postJson = async ({ url, headers, body, timeoutMs }) => {
 }
 
 const getJson = async ({ url, headers, timeoutMs }) => {
+  const resolvedTimeoutMs = Math.max(1000, Number(timeoutMs) || 20000)
   const controller = new AbortController()
-  const timer = setTimeout(() => controller.abort(), timeoutMs || 20000)
+  const timer = setTimeout(() => controller.abort(), resolvedTimeoutMs)
   try {
     const res = await fetch(url, { method: 'GET', headers: headers || {}, signal: controller.signal })
     const text = await res.text()
@@ -2453,12 +2564,14 @@ module.exports = function (RED) {
   if (!adminEndpointsRegistered) {
     adminEndpointsRegistered = true
 
+    RED.httpAdmin.use('/knxUltimateAI/sidebar', normalizeAuthFromAccessTokenQuery)
+
     RED.httpAdmin.get('/knxUltimateAI/sidebar/page', RED.auth.needsPermission('knxUltimate-config.read'), (req, res) => {
-      sendKnxAiVueIndex(res)
+      sendKnxAiVueIndex(req, res)
     })
 
     RED.httpAdmin.get('/knxUltimateAI/sidebar/page-vue', RED.auth.needsPermission('knxUltimate-config.read'), (req, res) => {
-      sendKnxAiVueIndex(res)
+      sendKnxAiVueIndex(req, res)
     })
 
     RED.httpAdmin.get('/knxUltimateAI/sidebar/page/assets/:file', RED.auth.needsPermission('knxUltimate-config.read'), (req, res) => {
@@ -2469,6 +2582,16 @@ module.exports = function (RED) {
       })
     })
 
+    // Alias for relative asset URLs resolved from ".../sidebar/page?nodeId=..."
+    // which become ".../sidebar/assets/<file>" in browsers.
+    RED.httpAdmin.get('/knxUltimateAI/sidebar/assets/:file', RED.auth.needsPermission('knxUltimate-config.read'), (req, res) => {
+      sendStaticFileSafe({
+        rootDir: knxAiVueDistDir,
+        relativePath: path.join('assets', String(req.params?.file || '')),
+        res
+      })
+    })
+
     RED.httpAdmin.get('/knxUltimateAI/sidebar/page-vue/assets/:file', RED.auth.needsPermission('knxUltimate-config.read'), (req, res) => {
       sendStaticFileSafe({
         rootDir: knxAiVueDistDir,
@@ -2616,6 +2739,25 @@ module.exports = function (RED) {
       }
     })
 
+    RED.httpAdmin.post('/knxUltimateAI/sidebar/areas/delete-llm', RED.auth.needsPermission('knxUltimate-config.write'), async (req, res) => {
+      try {
+        const nodeId = req.body?.nodeId ? String(req.body.nodeId) : ''
+        if (!nodeId) {
+          res.status(400).json({ error: 'Missing nodeId' })
+          return
+        }
+        const n = aiRuntimeNodes.get(nodeId) || RED.nodes.getNode(nodeId)
+        if (!n || n.type !== 'knxUltimateAI' || typeof n.deleteAllLlmAreas !== 'function') {
+          res.status(404).json({ error: 'KNX AI node not found' })
+          return
+        }
+        const ret = await n.deleteAllLlmAreas()
+        res.json(ret)
+      } catch (error) {
+        res.status(error.status || 500).json({ error: error.message || String(error) })
+      }
+    })
+
     RED.httpAdmin.post('/knxUltimateAI/sidebar/areas/catalog', RED.auth.needsPermission('knxUltimate-config.read'), async (req, res) => {
       try {
         const nodeId = req.body?.nodeId ? String(req.body.nodeId) : ''
@@ -3207,8 +3349,8 @@ module.exports = function (RED) {
     node.llmModel = config.llmModel || 'gpt-4o-mini'
     node.llmSystemPrompt = config.llmSystemPrompt || 'You are a KNX building automation assistant. Analyze KNX bus traffic and provide actionable insights.'
     node.llmTemperature = (config.llmTemperature === undefined || config.llmTemperature === '') ? 0.2 : Number(config.llmTemperature)
-    node.llmMaxTokens = (config.llmMaxTokens === undefined || config.llmMaxTokens === '') ? 10000 : Number(config.llmMaxTokens)
-    node.llmTimeoutMs = (config.llmTimeoutMs === undefined || config.llmTimeoutMs === '') ? 30000 : Number(config.llmTimeoutMs)
+    node.llmMaxTokens = (config.llmMaxTokens === undefined || config.llmMaxTokens === '') ? 50000 : Number(config.llmMaxTokens)
+    node.llmTimeoutMs = (config.llmTimeoutMs === undefined || config.llmTimeoutMs === '') ? 120000 : Number(config.llmTimeoutMs)
     node.llmMaxEventsInPrompt = (config.llmMaxEventsInPrompt === undefined || config.llmMaxEventsInPrompt === '') ? 120 : Number(config.llmMaxEventsInPrompt)
     node.llmIncludeRaw = config.llmIncludeRaw !== undefined ? coerceBoolean(config.llmIncludeRaw) : false
     node.llmIncludeFlowContext = config.llmIncludeFlowContext !== undefined ? coerceBoolean(config.llmIncludeFlowContext) : true
@@ -5011,13 +5153,15 @@ module.exports = function (RED) {
           translated: false
         }
       }
+      const jsonMaxTokens = Math.max(50000, Number(node.llmMaxTokens) || 0)
       const llmResponse = await callLLMChat({
         systemPrompt: [
           'You are a KNX installer assistant.',
           'Translate only human-readable KNX test labels.',
           'Return JSON only.'
         ].join(' '),
-        userContent: buildTestPlanTranslationPrompt({ language: targetLanguage, languageName: targetLanguageName, plan })
+        userContent: buildTestPlanTranslationPrompt({ language: targetLanguage, languageName: targetLanguageName, plan }),
+        maxTokensOverride: jsonMaxTokens
       })
       const parsed = extractJsonFragmentFromText(llmResponse.content)
       const translatedSteps = Array.isArray(parsed)
@@ -5059,13 +5203,15 @@ module.exports = function (RED) {
     const suggestGaRoleOverridesWithLlm = async ({ gaCatalog }) => {
       const candidates = (Array.isArray(gaCatalog) ? gaCatalog : []).filter(item => item && item.ga && isAmbiguousGaRoleSource(item.baseRoleSource || item.roleSource))
       if (!candidates.length) return {}
+      const jsonMaxTokens = Math.max(50000, Number(node.llmMaxTokens) || 0)
       const llmResponse = await callLLMChat({
         systemPrompt: [
           'You are a KNX installation modeling assistant.',
           'Classify KNX group addresses as command, status, or neutral for installers.',
           'Return JSON only.'
         ].join(' '),
-        userContent: buildGaRoleSuggestionPrompt({ gaCatalog: candidates })
+        userContent: buildGaRoleSuggestionPrompt({ gaCatalog: candidates }),
+        maxTokensOverride: jsonMaxTokens
       })
       const parsed = extractJsonFragmentFromText(llmResponse.content)
       const gaCatalogMap = new Map(candidates.map(item => [String(item.ga).trim(), item]))
@@ -5743,17 +5889,38 @@ module.exports = function (RED) {
       }
     }
 
+    node.deleteAllLlmAreas = async () => {
+      const currentOverrides = Object.assign({}, loadAreaOverrides())
+      const llmAreaIds = Object.keys(currentOverrides).filter(key => String(key || '').startsWith('llm:'))
+      llmAreaIds.forEach((areaId) => {
+        delete currentOverrides[areaId]
+      })
+      writeAreaOverrides(currentOverrides)
+      const summary = node._lastSummary || rebuildCachedSummaryNow()
+      return {
+        ok: true,
+        deletedCount: llmAreaIds.length,
+        areas: buildAreasSnapshot({ summary }),
+        profiles: buildProfilesSnapshot(),
+        actuatorTests: buildActuatorTestsSnapshot(),
+        testPlans: buildAiTestPlansSnapshot(),
+        gaCatalog: getGaCatalogSnapshot()
+      }
+    }
+
     node.regenerateLlmAreas = async () => {
       if (!node.llmEnabled) throw new Error('LLM is disabled in the KNX AI node config')
       const gaCatalog = getGaCatalogSnapshot()
       if (!Array.isArray(gaCatalog) || !gaCatalog.length) throw new Error('No ETS group addresses available')
+      const jsonMaxTokens = Math.max(50000, Number(node.llmMaxTokens) || 0)
       const llmResponse = await callLLMChat({
         systemPrompt: [
           'You are a KNX installation modeling assistant.',
           'Group KNX group addresses into practical installer-friendly operational areas.',
           'Return JSON only.'
         ].join(' '),
-        userContent: buildAreaRegenerationPrompt({ gaCatalog })
+        userContent: buildAreaRegenerationPrompt({ gaCatalog }),
+        maxTokensOverride: jsonMaxTokens
       })
       const parsed = extractJsonFragmentFromText(llmResponse.content)
       const rawAreas = Array.isArray(parsed)
@@ -5826,6 +5993,7 @@ module.exports = function (RED) {
       if (!installerPrompt) throw new Error('Missing prompt')
       const gaCatalog = getGaCatalogSnapshot()
       if (!Array.isArray(gaCatalog) || !gaCatalog.length) throw new Error('No ETS group addresses available')
+      const jsonMaxTokens = Math.max(50000, Number(node.llmMaxTokens) || 0)
       const llmResponse = await callLLMChat({
         systemPrompt: [
           'You are a KNX installation modeling assistant.',
@@ -5838,7 +6006,8 @@ module.exports = function (RED) {
           draftDescription: description,
           currentGaList: Array.isArray(gaList) ? gaList : [],
           gaCatalog
-        })
+        }),
+        maxTokensOverride: jsonMaxTokens
       })
       const parsed = extractJsonFragmentFromText(llmResponse.content)
       const gaCatalogMap = new Map(gaCatalog.map(item => [String(item && item.ga ? item.ga : '').trim(), item]))
@@ -6216,10 +6385,13 @@ module.exports = function (RED) {
       if (!node.llmApiKey && node.llmProvider !== 'ollama') {
         throw new Error('Missing API key: paste only the OpenAI key (starts with sk-), without "Bearer"')
       }
-      const maxTokensRaw = (maxTokensOverride !== null && maxTokensOverride !== undefined && maxTokensOverride !== '')
-        ? Number(maxTokensOverride)
-        : Number(node.llmMaxTokens)
-      const resolvedMaxTokens = Number.isFinite(maxTokensRaw) && maxTokensRaw > 0 ? Math.round(maxTokensRaw) : 10000
+    const maxTokensRaw = (maxTokensOverride !== null && maxTokensOverride !== undefined && maxTokensOverride !== '')
+      ? Number(maxTokensOverride)
+      : Number(node.llmMaxTokens)
+    const resolvedMaxTokens = Number.isFinite(maxTokensRaw) && maxTokensRaw > 0 ? Math.round(maxTokensRaw) : 10000
+    const configuredTimeoutMs = Number(node.llmTimeoutMs)
+    const resolvedTimeoutMs = Number.isFinite(configuredTimeoutMs) && configuredTimeoutMs > 0 ? Math.round(configuredTimeoutMs) : 30000
+    const effectiveTimeoutMs = Math.max(120000, resolvedTimeoutMs)
 
       if (node.llmProvider === 'ollama') {
         const url = node.llmBaseUrl || 'http://localhost:11434/api/chat'
@@ -6234,7 +6406,7 @@ module.exports = function (RED) {
             temperature: node.llmTemperature
           }
         }
-        const json = await postJson({ url, body, timeoutMs: node.llmTimeoutMs })
+        const json = await postJson({ url, body, timeoutMs: effectiveTimeoutMs })
         const content = json && json.message && typeof json.message.content === 'string' ? json.message.content : safeStringify(json)
         return { provider: 'ollama', model: body.model, content, finishReason: String(json && json.done_reason ? json.done_reason : '') }
       }
@@ -6279,26 +6451,26 @@ module.exports = function (RED) {
 
       let json
       try {
-        json = await postJson({ url, headers, body: bodyWithMaxTokens, timeoutMs: node.llmTimeoutMs })
+        json = await postJson({ url, headers, body: bodyWithMaxTokens, timeoutMs: effectiveTimeoutMs })
       } catch (error) {
         const msg = (error && error.message) ? String(error.message) : ''
         if (isResponseFormatCompatibilityError(msg)) {
           try {
-            json = await postJson({ url, headers, body: plainBodyWithMaxTokens, timeoutMs: node.llmTimeoutMs })
+            json = await postJson({ url, headers, body: plainBodyWithMaxTokens, timeoutMs: effectiveTimeoutMs })
           } catch (innerError) {
             const innerMsg = (innerError && innerError.message) ? String(innerError.message) : ''
             if (innerMsg.includes("Unsupported parameter: 'max_tokens'") || innerMsg.includes('max_completion_tokens')) {
-              json = await postJson({ url, headers, body: plainBodyWithMaxCompletionTokens, timeoutMs: node.llmTimeoutMs })
+              json = await postJson({ url, headers, body: plainBodyWithMaxCompletionTokens, timeoutMs: effectiveTimeoutMs })
             } else if (innerMsg.includes("Unsupported parameter: 'max_completion_tokens'")) {
-              json = await postJson({ url, headers, body: plainBodyWithMaxTokens, timeoutMs: node.llmTimeoutMs })
+              json = await postJson({ url, headers, body: plainBodyWithMaxTokens, timeoutMs: effectiveTimeoutMs })
             } else {
               throw innerError
             }
           }
         } else if (msg.includes("Unsupported parameter: 'max_tokens'") || msg.includes('max_completion_tokens')) {
-          json = await postJson({ url, headers, body: bodyWithMaxCompletionTokens, timeoutMs: node.llmTimeoutMs })
+          json = await postJson({ url, headers, body: bodyWithMaxCompletionTokens, timeoutMs: effectiveTimeoutMs })
         } else if (msg.includes("Unsupported parameter: 'max_completion_tokens'")) {
-          json = await postJson({ url, headers, body: bodyWithMaxTokens, timeoutMs: node.llmTimeoutMs })
+          json = await postJson({ url, headers, body: bodyWithMaxTokens, timeoutMs: effectiveTimeoutMs })
         } else {
           throw error
         }