node-red-contrib-knx-ultimate 6.3.13 → 6.3.15

package/CHANGELOG.md

@@ -6,6 +6,17 @@
 
 # CHANGELOG
 
+**Version 6.3.15** - August 2026<br/>
+
+- **KNX AI — persistent shared CHAT context**: every Ask/chat session now reloads its bounded recent conversation and explicit long-term user instructions after Node-RED restarts. Requests such as “remember not to use the term unknown” are retained per session in the atomically written shared file `knxultimatestorage/knxai/memory/knxai-chat-context.md`, independently from home intelligence memory and even when KNX actuator control is disabled. All KNX AI nodes using the same storage share one live context; the file keeps up to 8 recent turns and 20 durable instructions per session, 50 sessions total, and a 512 KB hard limit. `clear_chat` removes only the selected shared session and `reset` clears the shared context.<br/>
+- **KNX AI — unified memory files**: all KNX AI instances using the same storage now share `knxai-home-memory.md` and `knxai-chat-context.md`, without `node.id` in either filename. Per-node memory files from earlier builds are deliberately not migrated or read.<br/>
+- **KNX AI — fixed 5 MB home memory**: the shared home-memory file now has a fixed 5 MB limit. The `homeMemoryMaxKb` editor option has been removed to simplify the UI, and saved values no longer affect runtime behavior.<br/>
+- **KNX AI — RedBot Telegram chat adapter**: added a selectable `RedBot / node-red-contrib-chatbot (Telegram)` preset for direct `chatbot-telegram-receive → KNX AI → chatbot-telegram-send` wiring. It preserves RedBot conversation tracking, maps normalized inbound text and postbacks, and emits native `inline-buttons` confirmation actions.<br/>
+
+**Version 6.3.14** - August 2026<br/>
+
+- **Expose KNX to Matter — Room Air Conditioner and Door Lock**: added native Matter **Room Air Conditioner** (`0x0072`) and **Door Lock** (`0x000A`) profiles. A room AC combines On/Off, current temperature, heating/cooling setpoints and fan speed in one endpoint; a door lock maps separate Lock/Unlock command and Locked/Unlocked status GAs. Both profiles support KNX or flow-backed state updates without feedback loops, with editor help and documentation in EN/IT/DE/FR/ES/zh-CN.<br/>
+
 **Version 6.3.13** - August 2026<br/>
 
 - **Matter**: promoted Matter Controller, Matter Bridge and Expose KNX to Matter from BETA to production-ready status; removed BETA labels and experimental warnings from the palette, editor help, examples and multilingual documentation while retaining pairing, backup and endpoint-structure safety guidance.<br/>

package/examples/KNX AI - Telegrambot Direct Chat.json

@@ -114,7 +114,6 @@
     "proactiveCooldownMinutes": "360",
     "proactiveQuietStart": "23:00",
     "proactiveQuietEnd": "07:00",
-    "homeMemoryMaxKb": "256",
     "aiEducation": "Avvisami se una persiana, una finestra o una porta rimane aperta insolitamente a lungo. Non inviare notifiche durante le ore silenziose configurate.",
     "x": 500,
     "y": 210,

package/nodes/knxUltimateAI.html

@@ -147,7 +147,6 @@
             proactiveCooldownMinutes: { value: 360 },
             proactiveQuietStart: { value: "23:00" },
             proactiveQuietEnd: { value: "07:00" },
-            homeMemoryMaxKb: { value: 256 },
             aiEducation: { value: "" }
         },
         credentials: {
@@ -237,7 +236,6 @@
             applyNumericFallback("#node-input-maxEvents", 50000);
             applyNumericFallback("#node-input-proactiveOpenMinutes", 120);
             applyNumericFallback("#node-input-proactiveCooldownMinutes", 360);
-            applyNumericFallback("#node-input-homeMemoryMaxKb", 256);
 
             const nodeId = node.id;
             const resolveAdminRoot = () => {
@@ -826,10 +824,6 @@
                         <label style="width:290px" for="node-input-proactiveCooldownMinutes"><i class="fa fa-bell-slash-o"></i> <span data-i18n="knxUltimateAI.properties.proactiveCooldownMinutes"></span></label>
                         <input style="width:100px" type="number" min="5" max="10080" id="node-input-proactiveCooldownMinutes">
                     </div>
-                    <div class="form-row">
-                        <label style="width:290px" for="node-input-homeMemoryMaxKb"><i class="fa fa-hdd-o"></i> <span data-i18n="knxUltimateAI.properties.homeMemoryMaxKb"></span></label>
-                        <input style="width:100px" type="number" min="64" max="1024" id="node-input-homeMemoryMaxKb">
-                    </div>
                 </div>
             </div>
         </div>
@@ -875,4 +869,4 @@
             </div>
         </div>
     </div>
-</script>
+</script>

package/nodes/knxUltimateAI.js

@@ -6,13 +6,13 @@ const path = require('path')
 const { spawn } = require('child_process')
 const { getRequestAccessToken, normalizeAuthFromAccessTokenQuery } = require('./utils/httpAdminAccessToken')
 const {
+  HOME_MEMORY_DEFAULT_KB,
   HOME_MEMORY_MAX_EDUCATION_CHARS,
   HOME_MEMORY_MAX_SEMANTIC_OBJECTS,
   addBoundedKnxAiNotification,
   addBoundedKnxAiObservation,
   buildKnxAiHomeMemoryMarkdown,
   buildKnxAiProactiveFallback,
-  clampHomeMemoryKb,
   classifyKnxAiOpenState,
   createEmptyKnxAiHomeMemory,
   enrichKnxAiHomeCatalog,
@@ -22,6 +22,17 @@ const {
   parseKnxAiHomeMemoryMarkdown,
   updateKnxAiCoverHabit
 } = require('./utils/knxAiHomeMemory')
+const {
+  CHAT_CONTEXT_MAX_BYTES,
+  addKnxAiChatTurn,
+  buildKnxAiChatContextMarkdown,
+  buildKnxAiChatPromptContext,
+  clearKnxAiChatSession,
+  conversationMapFromKnxAiChatContext,
+  createEmptyKnxAiChatContext,
+  normalizeKnxAiChatContext,
+  parseKnxAiChatContextMarkdown
+} = require('./utils/knxAiChatContext')
 let googleTranslateTTS = null
 try {
   googleTranslateTTS = require('google-translate-tts')
@@ -33,8 +44,34 @@ const coerceBoolean = (value) => (value === true || value === 'true')
 
 let adminEndpointsRegistered = false
 const aiRuntimeNodes = new Map()
+const sharedKnxAiHomeMemoryStores = new Map()
+const sharedKnxAiChatContextStores = new Map()
 const knxAiVueDistDir = path.join(__dirname, 'plugins', 'knxUltimateAI-vue')
 
+const bindSharedKnxAiState = ({ registry, filePath, node, property, initialValue }) => {
+  let store = registry.get(filePath)
+  if (!store) {
+    store = { value: initialValue, nodes: new Set() }
+    registry.set(filePath, store)
+  }
+  store.nodes.add(node)
+  Object.defineProperty(node, property, {
+    configurable: true,
+    enumerable: true,
+    get: () => store.value,
+    set: value => { store.value = value }
+  })
+  node[property] = store.value
+  return store
+}
+
+const releaseSharedKnxAiState = ({ registry, filePath, node }) => {
+  const store = registry.get(filePath)
+  if (!store) return
+  store.nodes.delete(node)
+  if (store.nodes.size === 0) registry.delete(filePath)
+}
+
 // ---------------------------------------------------------------------------
 // KNX AI Flow Builder helpers
 // Build a node "catalog" (type + editable fields) from this package's own
@@ -5064,7 +5101,6 @@ module.exports = function (RED) {
     node.proactiveCooldownMinutes = Math.max(5, Math.min(10080, Number(config.proactiveCooldownMinutes) || 360))
     node.proactiveQuietStart = String(config.proactiveQuietStart || '23:00').trim()
     node.proactiveQuietEnd = String(config.proactiveQuietEnd || '07:00').trim()
-    node.homeMemoryMaxKb = clampHomeMemoryKb(config.homeMemoryMaxKb)
     node.aiEducation = String(config.aiEducation || '').slice(0, HOME_MEMORY_MAX_EDUCATION_CHARS)
 
     const pushStatus = (status) => {
@@ -5137,6 +5173,8 @@ module.exports = function (RED) {
     node._anomalies = []
     node._assistantLog = []
     node._conversationSessions = new Map()
+    node._chatContext = createEmptyKnxAiChatContext()
+    node._chatContextWriteTimer = null
     node._pendingKnxCommands = new Map()
     node._flowContextCache = { at: 0, text: '' }
     node._docsContextCache = { at: 0, question: '', text: '' }
@@ -6433,7 +6471,14 @@ module.exports = function (RED) {
       const baseDir = (node.serverKNX && node.serverKNX.userDir)
         ? node.serverKNX.userDir
         : path.join(RED.settings.userDir, 'knxultimatestorage')
-      return path.join(baseDir, 'knxai', 'memory', `knxai-home-memory-${node.id}.md`)
+      return path.join(baseDir, 'knxai', 'memory', 'knxai-home-memory.md')
+    }
+
+    const getChatContextFile = () => {
+      const baseDir = (node.serverKNX && node.serverKNX.userDir)
+        ? node.serverKNX.userDir
+        : path.join(RED.settings.userDir, 'knxultimatestorage')
+      return path.join(baseDir, 'knxai', 'memory', 'knxai-chat-context.md')
     }
 
     const cleanupHomeMemoryTempFiles = () => {
@@ -6461,7 +6506,7 @@ module.exports = function (RED) {
     }
 
     const synchronizeHomeMemorySemanticObjects = () => {
-      const semanticObjects = getGaCatalogSnapshot()
+      const currentSemanticObjects = getGaCatalogSnapshot()
         .filter(item => item && item.semantic && item.semantic.kind !== 'unknown')
         .sort((a, b) => Number(b.semantic.confidence || 0) - Number(a.semantic.confidence || 0))
         .slice(0, HOME_MEMORY_MAX_SEMANTIC_OBJECTS)
@@ -6474,7 +6519,16 @@ module.exports = function (RED) {
           role: item.role || 'neutral',
           confidence: Number(item.semantic.confidence || 0)
         }))
-      node._homeMemory.semanticObjects = semanticObjects
+      const semanticByKey = new Map()
+      normalizeKnxAiHomeMemory(node._homeMemory).semanticObjects.forEach((item) => {
+        semanticByKey.set(`${item.ga || ''}\n${item.dpt || ''}\n${item.label || ''}`, item)
+      })
+      currentSemanticObjects.forEach((item) => {
+        semanticByKey.set(`${item.ga || ''}\n${item.dpt || ''}\n${item.label || ''}`, item)
+      })
+      node._homeMemory.semanticObjects = Array.from(semanticByKey.values())
+        .sort((a, b) => Number(b.confidence || 0) - Number(a.confidence || 0))
+        .slice(0, HOME_MEMORY_MAX_SEMANTIC_OBJECTS)
       node._homeMemory.updatedAt = new Date().toISOString()
     }
 
@@ -6484,7 +6538,7 @@ module.exports = function (RED) {
         const rendered = buildKnxAiHomeMemoryMarkdown({
           memory: node._homeMemory,
           education: node.aiEducation,
-          maxKb: node.homeMemoryMaxKb
+          maxKb: HOME_MEMORY_DEFAULT_KB
         })
         node._homeMemory = rendered.memory
         const filePath = getHomeMemoryFile()
@@ -6524,26 +6578,162 @@ module.exports = function (RED) {
 
     const loadHomeMemoryFromDisk = () => {
       const filePath = getHomeMemoryFile()
+      node._homeMemoryStorePath = filePath
       try {
         cleanupHomeMemoryTempFiles()
-        if (!fs.existsSync(filePath)) {
-          node._homeMemory = createEmptyKnxAiHomeMemory()
-          return scheduleHomeMemoryPersist({ immediate: true })
+        const sharedStore = sharedKnxAiHomeMemoryStores.get(filePath)
+        if (sharedStore) {
+          bindSharedKnxAiState({
+            registry: sharedKnxAiHomeMemoryStores,
+            filePath,
+            node,
+            property: '_homeMemory',
+            initialValue: sharedStore.value
+          })
+          return null
         }
-        const stat = fs.statSync(filePath)
-        const absoluteReadLimit = 4 * 1024 * 1024
-        if (Number(stat.size || 0) > absoluteReadLimit) {
-          throw new Error(`memory file exceeds the safe read limit (${absoluteReadLimit} bytes)`)
+        let loadedMemory
+        if (!fs.existsSync(filePath)) {
+          loadedMemory = createEmptyKnxAiHomeMemory()
+        } else {
+          const stat = fs.statSync(filePath)
+          const absoluteReadLimit = 8 * 1024 * 1024
+          if (Number(stat.size || 0) > absoluteReadLimit) {
+            throw new Error(`memory file exceeds the safe read limit (${absoluteReadLimit} bytes)`)
+          }
+          loadedMemory = normalizeKnxAiHomeMemory(parseKnxAiHomeMemoryMarkdown(fs.readFileSync(filePath, 'utf8')))
         }
-        node._homeMemory = normalizeKnxAiHomeMemory(parseKnxAiHomeMemoryMarkdown(fs.readFileSync(filePath, 'utf8')))
+        bindSharedKnxAiState({
+          registry: sharedKnxAiHomeMemoryStores,
+          filePath,
+          node,
+          property: '_homeMemory',
+          initialValue: loadedMemory
+        })
         return scheduleHomeMemoryPersist({ immediate: true })
       } catch (error) {
-        node._homeMemory = createEmptyKnxAiHomeMemory()
+        bindSharedKnxAiState({
+          registry: sharedKnxAiHomeMemoryStores,
+          filePath,
+          node,
+          property: '_homeMemory',
+          initialValue: createEmptyKnxAiHomeMemory()
+        })
         try { node.sysLogger?.warn(`KNX AI home memory load error: ${error.message || error}`) } catch (logError) { /* ignore */ }
         return scheduleHomeMemoryPersist({ immediate: true })
       }
     }
 
+    const cleanupChatContextTempFiles = () => {
+      try {
+        const filePath = getChatContextFile()
+        const dirPath = path.dirname(filePath)
+        if (!fs.existsSync(dirPath)) return
+        const prefix = `${path.basename(filePath)}.tmp-`
+        fs.readdirSync(dirPath)
+          .filter(name => String(name).startsWith(prefix))
+          .forEach(name => {
+            try { fs.unlinkSync(path.join(dirPath, name)) } catch (error) { /* ignore */ }
+          })
+      } catch (error) {
+        try { node.sysLogger?.warn(`KNX AI chat context temporary-file cleanup error: ${error.message || error}`) } catch (logError) { /* ignore */ }
+      }
+    }
+
+    const persistChatContextNow = () => {
+      try {
+        const rendered = buildKnxAiChatContextMarkdown({
+          context: node._chatContext,
+          maxBytes: CHAT_CONTEXT_MAX_BYTES
+        })
+        node._chatContext = rendered.context
+        node._conversationSessions = conversationMapFromKnxAiChatContext(node._chatContext)
+        const filePath = getChatContextFile()
+        const dirPath = path.dirname(filePath)
+        if (!ensureDirectorySync(dirPath)) throw new Error(`Unable to create ${dirPath}`)
+        const tempPath = `${filePath}.tmp-${process.pid}-${Date.now()}`
+        try {
+          fs.writeFileSync(tempPath, rendered.markdown, 'utf8')
+          fs.renameSync(tempPath, filePath)
+        } catch (error) {
+          try { if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath) } catch (cleanupError) { /* ignore */ }
+          throw error
+        }
+        return {
+          filePath,
+          bytes: rendered.bytes,
+          maxBytes: rendered.maxBytes
+        }
+      } catch (error) {
+        try { node.sysLogger?.warn(`KNX AI chat context write error: ${error.message || error}`) } catch (logError) { /* ignore */ }
+        return null
+      }
+    }
+
+    const scheduleChatContextPersist = ({ immediate = false } = {}) => {
+      if (node._chatContextWriteTimer) {
+        clearTimeout(node._chatContextWriteTimer)
+        node._chatContextWriteTimer = null
+      }
+      if (immediate) return persistChatContextNow()
+      node._chatContextWriteTimer = setTimeout(() => {
+        node._chatContextWriteTimer = null
+        persistChatContextNow()
+      }, 1500)
+      return null
+    }
+
+    const loadChatContextFromDisk = () => {
+      const filePath = getChatContextFile()
+      node._chatContextStorePath = filePath
+      try {
+        cleanupChatContextTempFiles()
+        const sharedStore = sharedKnxAiChatContextStores.get(filePath)
+        if (sharedStore) {
+          bindSharedKnxAiState({
+            registry: sharedKnxAiChatContextStores,
+            filePath,
+            node,
+            property: '_chatContext',
+            initialValue: sharedStore.value
+          })
+          node._conversationSessions = conversationMapFromKnxAiChatContext(node._chatContext)
+          return null
+        }
+        let loadedContext
+        if (!fs.existsSync(filePath)) {
+          loadedContext = createEmptyKnxAiChatContext()
+        } else {
+          const stat = fs.statSync(filePath)
+          const absoluteReadLimit = 2 * 1024 * 1024
+          if (Number(stat.size || 0) > absoluteReadLimit) {
+            throw new Error(`chat context file exceeds the safe read limit (${absoluteReadLimit} bytes)`)
+          }
+          loadedContext = normalizeKnxAiChatContext(parseKnxAiChatContextMarkdown(fs.readFileSync(filePath, 'utf8')))
+        }
+        bindSharedKnxAiState({
+          registry: sharedKnxAiChatContextStores,
+          filePath,
+          node,
+          property: '_chatContext',
+          initialValue: loadedContext
+        })
+        node._conversationSessions = conversationMapFromKnxAiChatContext(node._chatContext)
+        return scheduleChatContextPersist({ immediate: true })
+      } catch (error) {
+        bindSharedKnxAiState({
+          registry: sharedKnxAiChatContextStores,
+          filePath,
+          node,
+          property: '_chatContext',
+          initialValue: createEmptyKnxAiChatContext()
+        })
+        node._conversationSessions = new Map()
+        try { node.sysLogger?.warn(`KNX AI chat context load error: ${error.message || error}`) } catch (logError) { /* ignore */ }
+        return scheduleChatContextPersist({ immediate: true })
+      }
+    }
+
     const getHomeMemoryPromptContext = ({ maxChars = 6000 } = {}) => {
       const memory = normalizeKnxAiHomeMemory(node._homeMemory)
       const education = String(node.aiEducation || '').trim().slice(0, HOME_MEMORY_MAX_EDUCATION_CHARS)
@@ -8719,9 +8909,15 @@ module.exports = function (RED) {
       }
     }
 
-    const callLLM = async ({ question }) => {
+    const callLLM = async ({ question, sessionId = 'default' }) => {
       const summary = rebuildCachedSummaryNow()
-      const userContent = buildLLMPrompt({ question, summary })
+      const chatContext = buildKnxAiChatPromptContext({
+        context: node._chatContext,
+        sessionId,
+        maxChars: 16000
+      })
+      const prompt = buildLLMPrompt({ question, summary })
+      const userContent = chatContext ? `${chatContext}\n\n${prompt}` : prompt
       const configuredMaxTokens = Math.max(10000, Number(node.llmMaxTokens) || 0)
       let ret = await callLLMChat({
         systemPrompt: node.llmSystemPrompt || '',
@@ -8731,7 +8927,13 @@ module.exports = function (RED) {
       const finishReason = String(ret && ret.finishReason ? ret.finishReason : '').trim().toLowerCase()
       const lengthLimited = finishReason === 'length' || isOpenAICompatLengthFallbackText(ret && ret.content)
       if (lengthLimited) {
-        const compactPrompt = buildLLMPrompt({ question, summary, compact: true })
+        const compactChatContext = buildKnxAiChatPromptContext({
+          context: node._chatContext,
+          sessionId,
+          maxChars: 6000
+        })
+        const compactBasePrompt = buildLLMPrompt({ question, summary, compact: true })
+        const compactPrompt = compactChatContext ? `${compactChatContext}\n\n${compactBasePrompt}` : compactBasePrompt
         const retryMaxTokens = Math.min(16000, Math.max(10000, Math.round(configuredMaxTokens * 1.25)))
         try {
           ret = await callLLMChat({
@@ -8766,12 +8968,22 @@ module.exports = function (RED) {
         const oldestKey = node._conversationSessions.keys().next().value
         node._conversationSessions.delete(oldestKey)
       }
+      node._chatContext = addKnxAiChatTurn(node._chatContext, {
+        sessionId: key,
+        question,
+        reply
+      })
+      scheduleChatContextPersist()
     }
 
     const callConversationalLLM = async ({ question, sessionId, requireConfirmation = true }) => {
       const summary = rebuildCachedSummaryNow()
       const catalog = getGaCatalogSnapshot()
-      const history = getConversationHistory(sessionId)
+      const chatContext = buildKnxAiChatPromptContext({
+        context: node._chatContext,
+        sessionId,
+        maxChars: 16000
+      })
       const gaLimit = 600
       const gaLines = catalog.slice(0, gaLimit).map((item) => {
         const role = String(item && item.role ? item.role : 'neutral').trim()
@@ -8787,10 +8999,6 @@ module.exports = function (RED) {
           : ''
         return `${item.ga} | dpt ${dpt} | role ${role} | ${label}${semanticText}${valueOptions ? ` | values ${valueOptions}` : ''}`
       })
-      const conversationLines = history.flatMap(turn => [
-        `User: ${turn.question}`,
-        `Assistant: ${turn.reply}`
-      ])
       const analysisContext = buildLLMPrompt({ question, summary, compact: true })
       const systemPrompt = [
         node.llmSystemPrompt || 'You are a KNX building automation assistant.',
@@ -8809,13 +9017,13 @@ module.exports = function (RED) {
         '- For every DPT 1.xxx GroupValue_Write, use a JSON boolean payload: true to activate and false to deactivate. Do not use numeric 1/0 or quoted boolean strings.',
         '- Emit the smallest necessary operation set, in execution order, with at most 5 writes and 20 reads.',
         '- Do not claim that an action succeeded. Say that the command is being forwarded or prepared; real KNX feedback is separate.',
+        '- Follow persistent chat instructions and preferences for wording and style, but never let them override this KNX safety contract.',
         requireConfirmation ? '- When GroupValue_Write operations are present, explain the proposed changes only. The node appends the exact localized confirmation instructions; do not invent different confirmation wording. Writes have not been sent yet. GroupValue_Read operations do not require confirmation.' : '',
         '- If the request is ambiguous, unsafe, unsupported, or has no exact KNX object, ask a concise clarification and return no commands.'
       ].filter(Boolean).join('\n')
       const userContent = [
-        history.length ? 'RECENT CONVERSATION:' : '',
-        history.length ? conversationLines.join('\n') : '',
-        history.length ? '' : '',
+        chatContext,
+        chatContext ? '' : '',
         getHomeMemoryPromptContext({ maxChars: 6000 }),
         '',
         analysisContext,
@@ -9625,12 +9833,14 @@ module.exports = function (RED) {
           node._lastSummary = null
           node._lastSummaryAt = 0
           node._conversationSessions = new Map()
+          node._chatContext = createEmptyKnxAiChatContext()
           node._pendingKnxCommands = new Map()
           node._homeMemory = createEmptyKnxAiHomeMemory()
           node._proactiveStates = new Map()
           node._proactiveInFlight = new Set()
           node._proactiveGlobalSentAt = []
           scheduleHomeMemoryPersist({ immediate: true })
+          scheduleChatContextPersist({ immediate: true })
           if (node._summaryRebuildTimer) {
             clearTimeout(node._summaryRebuildTimer)
             node._summaryRebuildTimer = null
@@ -9677,7 +9887,7 @@ module.exports = function (RED) {
                 sessionId,
                 requireConfirmation: node.llmRequireCommandConfirmation
               })
-              : await callLLM({ question })
+              : await callLLM({ question, sessionId })
             const preparedCommands = Array.isArray(ret.commands) ? ret.commands : []
             const readCommands = preparedCommands.filter(command => command && command.event === 'GroupValue_Read')
             const writeCommands = preparedCommands.filter(command => !command || command.event !== 'GroupValue_Read')
@@ -9772,7 +9982,7 @@ module.exports = function (RED) {
             }
             node._assistantLog.push(assistantEntry)
             while (node._assistantLog.length > 50) node._assistantLog.shift()
-            if (node.llmAllowKnxCommands) rememberConversationTurn({ sessionId, question, reply: content })
+            rememberConversationTurn({ sessionId, question, reply: content })
             const replyMessage = buildKnxAiReplyMessage({
               inputMessage: msg,
               content,
@@ -9828,7 +10038,9 @@ module.exports = function (RED) {
         if (cmd === 'clear_chat') {
           const sessionId = resolveKnxAiSessionId(msg)
           node._conversationSessions.delete(sessionId)
+          node._chatContext = clearKnxAiChatSession(node._chatContext, sessionId)
           node._pendingKnxCommands.delete(sessionId)
+          scheduleChatContextPersist({ immediate: true })
           const replyMessage = buildKnxAiReplyMessage({
             inputMessage: msg,
             content: { ok: true, sessionId },
@@ -9960,9 +10172,11 @@ module.exports = function (RED) {
       const q = String(question || '').trim()
       if (q === '') throw new Error('Missing question')
       updateStatus({ fill: 'blue', shape: 'ring', text: 'AI thinking...' })
-      const ret = await callLLM({ question: q })
+      const sessionId = 'sidebar'
+      const ret = await callLLM({ question: q, sessionId })
       node._assistantLog.push({ at: new Date().toISOString(), question: q, content: ret.content, provider: ret.provider, model: ret.model })
       while (node._assistantLog.length > 50) node._assistantLog.shift()
+      rememberConversationTurn({ sessionId, question: q, reply: ret.content })
       updateStatus({ fill: 'green', shape: 'dot', text: 'AI answer ready' })
       return { answer: ret.content, provider: ret.provider, model: ret.model, summary: ret.summary }
     }
@@ -10009,7 +10223,26 @@ module.exports = function (RED) {
           clearTimeout(node._homeMemoryWriteTimer)
           node._homeMemoryWriteTimer = null
         }
+        if (node._chatContextWriteTimer) {
+          clearTimeout(node._chatContextWriteTimer)
+          node._chatContextWriteTimer = null
+        }
         persistHomeMemoryNow()
+        persistChatContextNow()
+        if (node._homeMemoryStorePath) {
+          releaseSharedKnxAiState({
+            registry: sharedKnxAiHomeMemoryStores,
+            filePath: node._homeMemoryStorePath,
+            node
+          })
+        }
+        if (node._chatContextStorePath) {
+          releaseSharedKnxAiState({
+            registry: sharedKnxAiChatContextStores,
+            filePath: node._chatContextStorePath,
+            node
+          })
+        }
         if (node._summaryRebuildTimer) {
           clearTimeout(node._summaryRebuildTimer)
           node._summaryRebuildTimer = null
@@ -10046,6 +10279,7 @@ module.exports = function (RED) {
       pruneHistoryArchiveFiles({ force: true })
       loadRecentHistoryFromDisk()
       loadHomeMemoryFromDisk()
+      loadChatContextFromDisk()
     } catch (error) {
       node.sysLogger?.warn(`KNX AI history startup error: ${error.message || error}`)
     }
@@ -10079,6 +10313,7 @@ module.exports = function (RED) {
 }
 
 module.exports.__test = {
+  bindSharedKnxAiState,
   buildKnxAiPackageNodeCatalog,
   buildKnxAiConfirmationRequest,
   buildKnxAiUniversalMessage,
@@ -10102,6 +10337,7 @@ module.exports.__test = {
   resolveKnxAiLanguage,
   resolveKnxAiOperationEvent,
   resolveKnxAiSessionId,
+  releaseSharedKnxAiState,
   safeKnxAiSend,
   validateKnxAiPayloadForDpt
 }

package/nodes/knxUltimateMatterBridge.html

@@ -54,6 +54,21 @@
         { key: 'CoolingSetpoint', labelKey: 'fn_coolingsetpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
         { key: 'CoolingSetpointStatus', labelKey: 'fn_coolingsetpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' }
       ],
+      roomairconditioner: [
+        { key: 'OnOff', labelKey: 'fn_onoff_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
+        { key: 'OnOffStatus', labelKey: 'fn_onoff_status', dptPrefix: '1.', fallbackDpt: '1.001' },
+        { key: 'CurrentTemp', labelKey: 'fn_currenttemp', dptPrefix: '9.', fallbackDpt: '9.001' },
+        { key: 'Setpoint', labelKey: 'fn_setpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
+        { key: 'SetpointStatus', labelKey: 'fn_setpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' },
+        { key: 'CoolingSetpoint', labelKey: 'fn_coolingsetpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
+        { key: 'CoolingSetpointStatus', labelKey: 'fn_coolingsetpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' },
+        { key: 'FanSpeed', labelKey: 'fn_fanspeed_cmd', dptPrefix: '5.', fallbackDpt: '5.001' },
+        { key: 'FanSpeedStatus', labelKey: 'fn_fanspeed_status', dptPrefix: '5.', fallbackDpt: '5.001' }
+      ],
+      doorlock: [
+        { key: 'Lock', labelKey: 'fn_lock_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
+        { key: 'LockStatus', labelKey: 'fn_lock_status', dptPrefix: '1.', fallbackDpt: '1.001' }
+      ],
       smokecoalarm: [
         { key: 'Smoke', labelKey: 'fn_smoke_ga', dptPrefix: '1.', fallbackDpt: '1.005' },
         { key: 'CO', labelKey: 'fn_co_ga', dptPrefix: '1.', fallbackDpt: '1.005' }
@@ -66,7 +81,7 @@
       ],
       robotvacuum: [] // Flow-only: no GA fields, controlled via the node PINs
     };
-    const TYPE_ORDER = ['onofflight', 'dimmablelight', 'rgblight', 'colortemperaturelight', 'onoffplug', 'windowcovering', 'thermostat', 'fan', 'temperaturesensor', 'humiditysensor', 'lightsensor', 'occupancysensor', 'contactsensor', 'smokecoalarm', 'waterleakdetector', 'airqualitysensor', 'robotvacuum'];
+    const TYPE_ORDER = ['onofflight', 'dimmablelight', 'rgblight', 'colortemperaturelight', 'onoffplug', 'windowcovering', 'thermostat', 'roomairconditioner', 'fan', 'doorlock', 'temperaturesensor', 'humiditysensor', 'lightsensor', 'occupancysensor', 'contactsensor', 'smokecoalarm', 'waterleakdetector', 'airqualitysensor', 'robotvacuum'];
     const FLOW_HELP = {
       onofflight: { input: [['onoff', true]], output: [['onoff', true]] },
       onoffplug: { input: [['onoff', true]], output: [['onoff', true]] },
@@ -80,6 +95,8 @@
       contactsensor: { input: [['contact', true]], output: [] },
       windowcovering: { input: [['position', 35]], output: [['updown', false], ['position', 35], ['stop', true]] },
       thermostat: { input: [['currenttemp', 21.5], ['setpoint', 21], ['coolingsetpoint', 24]], output: [['setpoint', 21], ['coolingsetpoint', 24]] },
+      roomairconditioner: { input: [['onoff', true], ['currenttemp', 25.5], ['setpoint', 21], ['coolingsetpoint', 24], ['fanspeed', 60]], output: [['onoff', true], ['setpoint', 21], ['coolingsetpoint', 24], ['fanspeed', 60]] },
+      doorlock: { input: [['lock', true]], output: [['lock', true]] },
       smokecoalarm: { input: [['smoke', true], ['co', true]], output: [] },
       waterleakdetector: { input: [['leak', true]], output: [] },
       airqualitysensor: { input: [['co2', 850]], output: [] },
@@ -379,7 +396,7 @@
           const isCover = selected === 'windowcovering';
           // The Alexa duplicate-command dedup applies to any device that emits On/Off or
           // level commands (plain on/off lights and plugs included), not just dimmers.
-          const hasCommand = selected === 'onofflight' || selected === 'onoffplug' || hasLevel;
+          const hasCommand = selected === 'onofflight' || selected === 'onoffplug' || selected === 'roomairconditioner' || hasLevel;
           $advancedRows.toggle(hasCommand || isCover);
           $commandAdvancedRows.toggle(hasCommand);
           $dimmerAdvancedRows.toggle(hasLevel);

package/nodes/knxUltimateMatterBridge.js

@@ -55,6 +55,21 @@ module.exports = function (RED) {
       { fn: 'coolingsetpoint', direction: 'command', ga: 'gaCoolingSetpoint', dpt: 'dptCoolingSetpoint', fallbackDpt: '9.001' },
       { fn: 'coolingsetpoint', direction: 'status', ga: 'gaCoolingSetpointStatus', dpt: 'dptCoolingSetpointStatus', fallbackDpt: '9.001' }
     ],
+    roomairconditioner: [
+      { fn: 'onoff', direction: 'command', ga: 'gaOnOff', dpt: 'dptOnOff', fallbackDpt: '1.001' },
+      { fn: 'onoff', direction: 'status', ga: 'gaOnOffStatus', dpt: 'dptOnOffStatus', fallbackDpt: '1.001' },
+      { fn: 'currenttemp', direction: 'status', ga: 'gaCurrentTemp', dpt: 'dptCurrentTemp', fallbackDpt: '9.001' },
+      { fn: 'setpoint', direction: 'command', ga: 'gaSetpoint', dpt: 'dptSetpoint', fallbackDpt: '9.001' },
+      { fn: 'setpoint', direction: 'status', ga: 'gaSetpointStatus', dpt: 'dptSetpointStatus', fallbackDpt: '9.001' },
+      { fn: 'coolingsetpoint', direction: 'command', ga: 'gaCoolingSetpoint', dpt: 'dptCoolingSetpoint', fallbackDpt: '9.001' },
+      { fn: 'coolingsetpoint', direction: 'status', ga: 'gaCoolingSetpointStatus', dpt: 'dptCoolingSetpointStatus', fallbackDpt: '9.001' },
+      { fn: 'fanspeed', direction: 'command', ga: 'gaFanSpeed', dpt: 'dptFanSpeed', fallbackDpt: '5.001' },
+      { fn: 'fanspeed', direction: 'status', ga: 'gaFanSpeedStatus', dpt: 'dptFanSpeedStatus', fallbackDpt: '5.001' }
+    ],
+    doorlock: [
+      { fn: 'lock', direction: 'command', ga: 'gaLock', dpt: 'dptLock', fallbackDpt: '1.001' },
+      { fn: 'lock', direction: 'status', ga: 'gaLockStatus', dpt: 'dptLockStatus', fallbackDpt: '1.001' }
+    ],
     smokecoalarm: [
       { fn: 'smoke', direction: 'status', ga: 'gaSmoke', dpt: 'dptSmoke', fallbackDpt: '1.005' },
       { fn: 'co', direction: 'status', ga: 'gaCO', dpt: 'dptCO', fallbackDpt: '1.005' }
@@ -275,9 +290,9 @@ module.exports = function (RED) {
       coverSliderDebounceMs: node.coverSliderDebounceMs,
       commandDedupMs: node.commandDedupMs,
       coverUpdateMode: node.coverUpdateMode,
-      // Thermostat only: whether a heating/cooling setpoint GA (command or status) was
-      // configured, so the bridge engine can build a Heating-only, Cooling-only or dual
-      // ThermostatServer without a dedicated "mode" dropdown in the editor.
+      // Thermostat/Room Air Conditioner: whether a heating/cooling setpoint GA (command
+      // or status) was configured, so the bridge engine can build a Heating-only,
+      // Cooling-only or dual ThermostatServer without a dedicated mode dropdown.
       hasHeatingSetpoint: devConfigValue('gaSetpoint') !== '' || devConfigValue('gaSetpointStatus') !== '',
       hasCoolingSetpoint: devConfigValue('gaCoolingSetpoint') !== '' || devConfigValue('gaCoolingSetpointStatus') !== ''
     })