node-red-contrib-knx-ultimate 7.1.0-beta.2 → 7.1.2

package/nodes/knxUltimateAIHomeAssistant.html

@@ -0,0 +1,40 @@
+<script type="text/javascript">
+    RED.nodes.registerType('knxUltimateAIHomeAssistant', {
+        category: 'deprecated',
+        color: '#41BDF5',
+        defaults: {
+            name: { value: "Legacy Home Assistant bridge" },
+            requestTimeoutMs: { value: 15000, validate: RED.validators.number() }
+        },
+        inputs: 1,
+        outputs: 1,
+        outputLabels: function () { return "ha-api request"; },
+        icon: "font-awesome/fa-home",
+        label: function () { return this.name || "Legacy Home Assistant bridge"; },
+        paletteLabel: "Legacy Home Assistant bridge"
+    });
+    try { RED.palette.remove('knxUltimateAIHomeAssistant'); } catch (error) { }
+</script>
+
+<script type="text/html" data-template-name="knxUltimateAIHomeAssistant">
+    <div class="form-tips" style="margin-bottom:10px;"><b>Legacy node:</b> for new installations use the Home Assistant bridge included with <a href="https://github.com/Supergiovane/node-red-contrib-cerebrum-ultimate#readme" target="_blank"><b>Cerebrum Ultimate</b></a>.</div>
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-requestTimeoutMs"><i class="fa fa-clock-o"></i> API timeout</label>
+        <input type="number" id="node-input-requestTimeoutMs" min="3000" max="60000" step="1000">
+    </div>
+    <div class="form-tips">
+        Connect this node's output to a Home Assistant <b>API</b> node (<code>ha-api</code>), then connect the API output back to this node's input. Home Assistant event nodes may also feed this input so Cerebrum can observe their state changes.
+    </div>
+</script>
+
+<script type="text/html" data-help-name="knxUltimateAIHomeAssistant">
+    <p>Connects Cerebrum to the Home Assistant Node-RED API node without storing Home Assistant credentials in KNX Ultimate.</p>
+    <h3>Required round trip</h3>
+    <p><code>Cerebrum Home Assistant → API (ha-api) → Cerebrum Home Assistant</code></p>
+    <p>The bridge sends dynamic WebSocket requests under <code>msg.payload</code>, correlates the returned message and exposes entity, state, service and event capabilities to the in-process Cerebrum registry.</p>
+    <p>Writes are only a provider capability. Cerebrum Ultimate must still apply its normal proposal, validation and confirmation policy before a Home Assistant service call can be executed.</p>
+</script>

package/nodes/knxUltimateAIHomeAssistant.js

@@ -0,0 +1,152 @@
+const {
+  getKnxAiHomeAutomationRegistry,
+  normalizeKnxAiHomeAutomationEvent
+} = require('./utils/knxAiCerebrum')
+
+const HOME_ASSISTANT_ADAPTER_ID = 'home-assistant'
+const DEFAULT_REQUEST_TIMEOUT_MS = 15000
+
+module.exports = function (RED) {
+  function knxUltimateAIHomeAssistant (config) {
+    RED.nodes.createNode(this, config)
+    const node = this
+    const registry = getKnxAiHomeAutomationRegistry()
+    const requestTimeoutMs = Math.max(3000, Math.min(60000, Number(config.requestTimeoutMs) || DEFAULT_REQUEST_TIMEOUT_MS))
+    const pendingRequests = new Map()
+    const listeners = new Set()
+    let requestSequence = 0
+    let closing = false
+
+    node.name = config.name || 'Cerebrum Home Assistant'
+
+    const updateStatus = ({ fill = 'grey', shape = 'ring', text = '' } = {}) => {
+      try { node.status({ fill, shape, text }) } catch (error) { /* ignore */ }
+    }
+
+    const notifyEvent = event => {
+      listeners.forEach(listener => {
+        try { listener(event) } catch (error) { /* ignore */ }
+      })
+    }
+
+    const sendApiRequest = data => new Promise((resolve, reject) => {
+      if (closing) return reject(new Error('Cerebrum Home Assistant is closing'))
+      requestSequence += 1
+      const requestId = `${node.id}:${Date.now()}:${requestSequence}`
+      const timer = setTimeout(() => {
+        pendingRequests.delete(requestId)
+        updateStatus({ fill: 'yellow', shape: 'ring', text: 'ha-api timeout' })
+        reject(new Error('Home Assistant ha-api request timed out; verify the round-trip wiring'))
+      }, requestTimeoutMs)
+      pendingRequests.set(requestId, { resolve, reject, timer })
+      node.send({
+        payload: {
+          protocol: 'websocket',
+          data,
+          location: 'payload',
+          locationType: 'msg'
+        },
+        knxAiCerebrum: {
+          requestId,
+          adapterId: HOME_ASSISTANT_ADAPTER_ID,
+          providerId: node.id,
+          direction: 'request'
+        }
+      })
+      updateStatus({ fill: 'blue', shape: 'dot', text: 'querying ha-api' })
+    })
+
+    const provider = {
+      id: node.id,
+      adapterId: HOME_ASSISTANT_ADAPTER_ID,
+      title: node.name,
+      capabilities: ['entities', 'events', 'services', 'states'],
+      listEntities: () => sendApiRequest({ type: 'get_states' }).then(result => Array.isArray(result) ? result : []),
+      getEntity: entityId => sendApiRequest({ type: 'get_states' }).then(result => {
+        const requested = String(entityId || '').trim().toLowerCase()
+        return (Array.isArray(result) ? result : []).find(entity => String(entity && entity.entity_id || '').trim().toLowerCase() === requested) || null
+      }),
+      listServices: () => sendApiRequest({ type: 'get_services' }),
+      callService: ({ domain, service, serviceData, target, authorization } = {}) => {
+        const safeDomain = String(domain || '').trim()
+        const safeService = String(service || '').trim()
+        if (!safeDomain || !safeService) return Promise.reject(new Error('Home Assistant domain and service are required'))
+        if (!authorization || authorization.confirmed !== true || authorization.source !== 'knxUltimateAI') {
+          return Promise.reject(new Error('Home Assistant service calls require an explicit Cerebrum Ultimate confirmation authorization'))
+        }
+        return sendApiRequest({
+          type: 'call_service',
+          domain: safeDomain,
+          service: safeService,
+          service_data: serviceData && typeof serviceData === 'object' ? serviceData : {},
+          target: target && typeof target === 'object' ? target : {}
+        })
+      },
+      subscribe: listener => {
+        if (typeof listener !== 'function') return () => {}
+        listeners.add(listener)
+        return () => listeners.delete(listener)
+      }
+    }
+
+    registry.registerAdapter({
+      id: HOME_ASSISTANT_ADAPTER_ID,
+      title: 'Home Assistant',
+      packageName: 'node-red-contrib-home-assistant-websocket',
+      capabilities: provider.capabilities
+    })
+    registry.registerProvider(provider)
+
+    node.on('input', function (msg, send, done) {
+      try {
+        const metadata = msg && msg.knxAiCerebrum && typeof msg.knxAiCerebrum === 'object' ? msg.knxAiCerebrum : {}
+        const requestId = String(metadata.requestId || '')
+        const pending = requestId ? pendingRequests.get(requestId) : null
+        if (pending) {
+          clearTimeout(pending.timer)
+          pendingRequests.delete(requestId)
+          if (msg && msg.error) pending.reject(new Error(String(msg.error.message || msg.error)))
+          else pending.resolve(msg ? msg.payload : undefined)
+          updateStatus({ fill: 'green', shape: 'dot', text: 'ha-api ready' })
+          if (typeof done === 'function') done()
+          return
+        }
+
+        const event = normalizeKnxAiHomeAutomationEvent(msg, {
+          adapterId: HOME_ASSISTANT_ADAPTER_ID,
+          providerId: node.id
+        })
+        if (event) {
+          notifyEvent(event)
+          updateStatus({ fill: 'green', shape: 'dot', text: event.entityId || event.eventType })
+        }
+        if (typeof done === 'function') done()
+      } catch (error) {
+        updateStatus({ fill: 'red', shape: 'dot', text: error.message || String(error) })
+        if (typeof done === 'function') done(error)
+        else node.error(error, msg)
+      }
+    })
+
+    node.on('close', function (done) {
+      closing = true
+      registry.unregisterProvider(node.id)
+      pendingRequests.forEach(pending => {
+        clearTimeout(pending.timer)
+        pending.reject(new Error('Cerebrum Home Assistant node closed'))
+      })
+      pendingRequests.clear()
+      listeners.clear()
+      if (typeof done === 'function') done()
+    })
+
+    updateStatus({ fill: 'yellow', shape: 'ring', text: 'wire output → ha-api → input' })
+  }
+
+  RED.nodes.registerType('knxUltimateAIHomeAssistant', knxUltimateAIHomeAssistant)
+}
+
+module.exports.__test = {
+  DEFAULT_REQUEST_TIMEOUT_MS,
+  HOME_ASSISTANT_ADAPTER_ID
+}

package/nodes/knxUltimateHueController.html

@@ -305,7 +305,7 @@
     };
 
     RED.nodes.registerType('knxUltimateHueController', {
-      category: 'KNX Ultimate HUE',
+      category: 'KNX Ultimate',
       color: '#C0C7E9',
       defaults: buildDefaults(),
       // catalogDefaults is consumed by the Cerebrum Ultimate catalog. It intentionally

package/nodes/knxUltimateMatterBridge.html

@@ -134,7 +134,7 @@
     });
 
     RED.nodes.registerType('knxUltimateMatterBridge', {
-      category: 'KNX Ultimate Matter',
+      category: 'deprecated',
       color: '#8FB1FA',
       defaults: gaDefaults,
       inputs: 0,
@@ -672,4 +672,4 @@ section directly below, with copyable examples filtered to the selected device t
 
 - input: `msg.payload = { function: "onoff", value: true }` updates the Matter state without the KNX bus
 - output: every command from a Matter controller is forwarded as `msg` (topic = device name, payload = value, `msg.matter` = raw command)
-</script>
+</script>

package/nodes/knxUltimateMatterControllerDevice.html

@@ -9,7 +9,7 @@
   (function () {
 
     RED.nodes.registerType("knxUltimateMatterControllerDevice", {
-      category: "KNX Ultimate Matter",
+      category: "deprecated",
       color: "#8FB1FA",
       defaults: {
         //buttonState: {value: true},
@@ -2834,4 +2834,4 @@ _Basic Matter effects_
 The Dimming function works in **KNX mode `start` and`stop` ** . To start dimming, send only one "start" KNX telegram. To stop dimming, send a "stop" KNX telegram. Please**remember that** , when you set your wall swiches properties.
 
 <br/>
-</script>
+</script>

package/nodes/locales/de/knxUltimateAI.html

@@ -0,0 +1,5 @@
+<script type="text/html" data-help-name="knxUltimateAI">
+  <p><b>Dies ist ein ausgeblendeter Legacy-Knoten, der nur für vorhandene Flows erhalten bleibt.</b></p>
+  <p>Für neue Installationen verwenden Sie den eigenständigen Knoten <b>Cerebrum Ultimate</b> aus <code>node-red-contrib-cerebrum-ultimate</code>. Er ersetzt diesen Knoten und verwendet KNX Ultimate als optionale kompatible Integration.</p>
+  <p><a href="https://github.com/Supergiovane/node-red-contrib-cerebrum-ultimate#readme" target="_blank">Dokumentation zu Cerebrum Ultimate öffnen</a>.</p>
+</script>

package/nodes/locales/de/knxUltimateAI.json

@@ -0,0 +1,231 @@
+{
+  "knxUltimateAI": {
+    "title": "Legacy-KI-Knoten — Cerebrum Ultimate verwenden",
+    "sections": {
+      "groupAssistant": "KI-Assistent",
+      "groupChatHome": "Cerebrum (BETA)",
+      "setupDoctor": "Setup Doctor",
+      "webIntelligence": "Web-Intelligenz",
+      "detectedAdapters": "Erkannte und im Chat verwendete kompatible Nodes",
+      "chatContextOverview": "Übersicht des Chat-Kontexts",
+      "chatLearning": "KI-Chat-Lernen",
+      "cerebrumMemory": "Cerebrum-Speicher",
+      "quickSetup": "Assistent einrichten",
+      "etsAccess": "Zugriff auf ETS-Objekte",
+      "llmConnection": "KI-Assistent-Verbindung",
+      "chatAdapter": "Chat-Pins für Ein- und Ausgang",
+      "homeIntelligence": "KI-Erziehung & Gedächtnis",
+      "advanced": "Anbieter & Grenzen"
+    },
+    "properties": {
+      "server": "Gateway",
+      "name": "Name",
+      "topic": "Topic",
+      "llmEnabled": "Enable LLM assistant",
+      "llmProvider": "Provider",
+      "llmBaseUrl": "Endpoint URL",
+      "llmApiKey": "API key",
+      "llmModel": "Model",
+      "llmReasoningEffort": "Denkaufwand",
+      "llmLocalContextTokens": "Lokales Kontextfenster",
+      "llmSystemPrompt": "System prompt",
+      "llmIncludeRaw": "Include raw payload hex",
+      "llmAllowKnxCommands": "KI darf KNX-Zustände lesen und Aktoren steuern",
+      "llmRequireCommandConfirmation": "Vor dem Senden von KNX-Befehlen bestätigen lassen",
+      "webAccessEnabled": "Der KI die Nutzung des Webs erlauben",
+      "webMaxCallsPerHour": "Maximale Web-Aufrufe pro Stunde",
+      "chatAdapterPreset": "Adapter für Ein-/Ausgangsnachrichten",
+      "chatInputCode": "Eingangszuordnung (Chat → Cerebrum Ultimate)",
+      "chatOutputCode": "Ausgangszuordnung (Cerebrum Ultimate → Chat)",
+      "aiEducation": "KI-Erziehung (vom Benutzer verwaltet)"
+    },
+    "outputs": {
+      "summary": "Zusammenfassung/Statistik",
+      "anomalies": "Anomalien",
+      "assistant": "KI-Assistent",
+      "knxCommands": "KNX-Operationen",
+      "ttsUltimate": "TTS-Ultimate-Ansagen"
+    },
+    "selectlists": {
+      "llmProvider": {
+        "openai_compat": "OpenAI / OpenAI-kompatibel",
+        "anthropic": "Anthropic (Claude)",
+        "ollama": "Ollama (lokal)",
+        "lmstudio": "Bionic LM Studio"
+      },
+      "reasoningEffort": {
+        "default": "Automatisch (Modell-/Anbieterstandard)",
+        "none": "Keiner",
+        "minimal": "Minimal",
+        "low": "Niedrig",
+        "medium": "Mittel",
+        "high": "Hoch",
+        "xhigh": "Sehr hoch",
+        "max": "Maximal"
+      },
+      "localContext": {
+        "maximum": "Maximum",
+        "k4": "4K",
+        "k8": "8K",
+        "k16": "16K",
+        "k32": "32K",
+        "k64": "64K",
+        "k128": "128K",
+        "k256": "256K"
+      },
+      "chatAdapter": {
+        "none": "Kein Adapter"
+      }
+    },
+    "placeholder": {
+      "llmBaseUrl": "https://api.openai.com/v1/chat/completions (or your compatible endpoint)",
+      "llmApiKey": "Paste API key (starts with sk-)",
+      "llmModel": "e.g. gpt-4o-mini",
+      "llmSystemPrompt": "Optional. Leave empty for default.",
+      "aiEducation": "Beispiel: Antworte knapp. Benachrichtige meinen letzten Chat, wenn ein Fenster 30 Minuten offen bleibt; zwischen 23:00 und 07:00 keine Meldungen."
+    },
+    "messages": {
+      "setupDoctorLoading": "Diese Installation wird analysiert…",
+      "setupDoctorUnavailable": "Setup Doctor ist vorübergehend nicht verfügbar.",
+      "setupDoctorPromptsTitle": "Installation ausprobieren",
+      "setupDoctorPromptsHint": "Jeder Vorschlag öffnet den Web-Assistenten mit einer personalisierten, sicheren Anfrage. Nichts wird automatisch ausgeführt.",
+      "setupDoctorDeployHint": "Setup Doctor liest den zuletzt bereitgestellten Flow. Änderungen bereitstellen und danach erneut prüfen.",
+      "setupDoctorPass": "OK",
+      "setupDoctorWarn": "Prüfen",
+      "setupDoctorFail": "Beheben",
+      "setupDoctorInfo": "Optional",
+      "webAccessHint": "Das Modell wählt dieses allgemeine Web-Tool semantisch für jede klare Chat- oder geplante Anfrage. Fehlt ein wesentlicher Umfang, fragt es vor der Suche beim Benutzer nach; Hintergrund-Polling, Schlüsselwörter oder Intent-Klassifikatoren werden nicht verwendet. Externe Websites und der Suchdienst erhalten die Anfrage und die öffentliche IP dieses Servers. Private KNX-, Kamera-, Chat-, Speicher- und Zugangsdaten werden nie automatisch hinzugefügt.",
+      "webBudgetHint": "Das gleitende Budget zählt echte externe Aufrufe aus Unterhaltungen und vom Benutzer erstellten geplanten Aufgaben.",
+      "lmStudioContextAvailable": "Maximaler Modellkontext",
+      "lmStudioContextLoading": "Aktiver Modellkontext wird geprüft",
+      "lmStudioContextInactive": "Modell inaktiv; bei der ersten Anfrage werden die Bionic-Standardwerte verwendet",
+      "lmStudioContextConfigured": "Aktiver Modellkontext",
+      "lmStudioContextFailed": "Der Modellkontext konnte nicht konfiguriert werden",
+      "lmStudioContextCurrentlyLoaded": "derzeit geladen",
+      "etsAccessHint": "Wähle die für Cerebrum Ultimate verfügbaren Gruppenadressen. Jede ausgewählte Adresse ist aktiv und lesbar; jede ausgewählte Adresse ohne Markierung Nur Lesen ist schreibbar. Cloud-Anbieter erhalten den vollständigen ausgewählten semantischen ETS-Katalog; lokale Modelle erhalten so viel, wie in das gewählte Kontextfenster passt, und können fehlende Details lokal abrufen.",
+      "etsFilterPlaceholder": "Nach Name, GA oder DPT filtern…",
+      "etsSelected": "ausgewählt",
+      "etsReadOnly": "Nur lesen",
+      "etsReadOnlyBulk": "Nur lesen für angezeigte Adressen",
+      "etsNoGateway": "Wähle ein KNX-Gateway aus.",
+      "etsNoGa": "Keine Gruppenadressen gefunden. Importiere die ETS-Liste im KNX-Gateway.",
+      "etsCsvError": "Die Gruppenadressliste konnte nicht vom Gateway geladen werden.",
+      "reasoningEffortHint": "Optionale Vorgabe für Modelle, die einen Denkaufwand unterstützen. Automatisch sendet keine Vorgabe; lehnt der Anbieter oder das Modell den gewählten Wert ab, versucht Cerebrum Ultimate es ohne diesen erneut.",
+      "localContextBudget": "Lokales Kontextfenster",
+      "localContextHint": "Legt den maximalen Kontext nur für lokale Modelle fest. Maximum verwendet das bekannte Kontextfenster des ausgewählten Modells; nicht verfügbare Größen werden ausgeblendet. Cloud-Anbieter ignorieren diese Auswahl und erhalten den vollständigen ausgewählten semantischen ETS-Katalog.",
+      "ollamaNotSupported": "Ollama local mode: API key not required. Default endpoint is http://localhost:11434/api/chat.",
+      "ollamaNoModels": "No local Ollama model found. Install one or pick one from the library.",
+      "installingOllamaModel": "Starting Ollama and installing model…",
+      "installedOllamaModel": "Ollama model installed",
+      "installOllamaModelFailed": "Failed to install Ollama model",
+      "ollamaInstallSteps": "1) Open the model library and copy the model name (for example llama3.1). 2) Put the name in the Model field and click Install it.",
+      "ollamaStartedAuto": "Ollama server started automatically.",
+      "detectedAdaptersLoading": "Installierte kompatible Nodes werden erkannt…",
+      "detectedAdaptersNone": "Kein kompatibler Node erkannt.",
+      "detectedAdaptersUnavailable": "Die Erkennung kompatibler Nodes ist vorübergehend nicht verfügbar.",
+      "detectedAdapterDetected": "Erkannt",
+      "detectedAdapterControllers": "Controller",
+      "detectedAdapterCameras": "Kameras",
+      "detectedAdapterNodes": "Nodes",
+      "chatContextLoading": "Zusammenfassung des Chat-Kontexts wird geladen…",
+      "chatContextUnavailable": "Die Zusammenfassung des Chat-Kontexts ist vorübergehend nicht verfügbar.",
+      "chatLearningOpenHint": "Öffnet die Weboberfläche direkt im gemeinsamen CHAT-Lerneditor, um die persistente Datei anzuzeigen, zu bearbeiten, zu kopieren oder zu sichern.",
+      "cerebrumMemoryOpenHint": "Öffnet den lesbaren Cerebrum-Speicher für gelernte Gewohnheiten, Entscheidungen der Bewohner und zwischengespeicherte Hauszustände.",
+      "chatContextIntro": "Der Chat erhält diese Quellen automatisch. Die folgenden Pfade werden von dieser Node-RED-Installation tatsächlich verwendet.",
+      "chatContextLimitLabel": "Maximaler operativer Kontext",
+      "chatContextProviderManaged": "vom ausgewählten Anbieter/Modell verwaltet",
+      "chatContextTokens": "Token",
+      "chatContextLastPromptLabel": "Tatsächliche Größe des letzten Chat-Prompts",
+      "chatContextLastPromptUnavailable": "bis zur ersten Chat-Anfrage nicht verfügbar",
+      "chatContextExactInputTokens": "vom Anbieter gemessene Eingabe-Token",
+      "chatContextEstimatedInputTokens": "geschätzte Eingabe-Token",
+      "chatContextImages": "Bilder",
+      "chatContextSourcesTitle": "Enthaltene Quellen",
+      "chatContextFilesTitle": "Dauerhafte Kontextdateien",
+      "chatContextDirectoriesTitle": "KNX-Telegrammarchiv",
+      "chatContextSourceKnxTraffic": "Abgeleitete KNX-Analyse plus die neuesten exakten Ereignisse aus dem standardmäßigen 20-Minuten- oder expliziten Zeitraum, automatisch an das aktive lokale Modellfenster angepasst.",
+      "chatContextSourceAdapterHistory": "Neueste exakte Adapterereignisse aus demselben Zeitraum, automatisch an das aktive lokale Modellfenster angepasst.",
+      "chatContextSourceEtsProject": "Vollständiger ausgewählter semantischer ETS-Katalog für Cloud-Modelle. Lokale Modelle erhalten den vollständigen Katalog, wenn er in das Fenster passt, andernfalls einen fenstergroßen Index und die vom Modell angeforderten exakten Details. Function-Quelltext nur bei ausdrücklicher Codeprüfung.",
+      "chatContextSourceMemoryEducation": "Sitzungskontext, KI-Erziehung, begrenztes Hausgedächtnis und aktive Pläne.",
+      "chatContextSourceCameras": "Erkannte Kameras und ihre verfügbaren Funktionen.",
+      "chatContextSourceBadge": "Quelle",
+      "chatContextFileChatContext": "Dauerhafte Gesprächsverläufe, Anweisungen und Regeln für Kamerabenachrichtigungen.",
+      "chatContextFileHomeMemory": "Nur begrenztes gelerntes Hausgedächtnis; die KI-Erziehung bleibt in der Node-Eigenschaft.",
+      "chatContextFileSchedules": "Verbindlicher dauerhafter Laufzeitstatus der Pläne und Erinnerungen dieses Nodes.",
+      "chatContextFileSchedulesReadable": "Erzeugte menschenlesbare Ansicht der Pläne und Erinnerungen dieses Nodes.",
+      "chatContextFileAssistantConfig": "Dauerhafte Cerebrum-Konfiguration und semantische Bereiche dieses Nodes.",
+      "chatContextFileLastChatPrompt": "Temporäre lokale Kopie der letzten System- und Benutzernachricht an das Chatmodell; wird bei jeder Chatanfrage überschrieben.",
+      "chatContextFileBadge": "Datei",
+      "chatContextDirectoryRoot": "Stammverzeichnis des Telegrammarchivs",
+      "chatContextDirectoryNode": "Telegrammarchiv dieses Nodes",
+      "chatContextDirectoryBadge": "KNX",
+      "chatContextDirectoryAdapterRoot": "Stammverzeichnis des Adapterereignisarchivs",
+      "chatContextDirectoryAdapterNode": "Adapterereignisarchiv dieses Nodes",
+      "chatContextDirectoryAdapterBadge": "Adapter",
+      "chatContextTelegramPattern": "Tagesdateien",
+      "chatAdapterIntro": "Wählen Sie eine Vorlage, um den Code für Ein- und Ausgang einzufügen. Die Liste wird aus der mitgelieferten Chat-Adapter-Datei geladen; der erzeugte Code bleibt bearbeitbar.",
+      "chatAdapterCodeHelp": "Zuordnungen laufen synchron. Geben Sie msg zurück, um fortzufahren, oder keinen Wert, um die Nachricht zu verwerfen. Fehler werden abgefangen und gemeldet, ohne Node-RED anzuhalten.",
+      "homeIntelligenceIntro": "Der Node erstellt ein mehrsprachiges semantisches ETS-Modell. Proaktive Benachrichtigungen werden nur berücksichtigt, wenn die KI-Erziehung sie ausdrücklich verlangt; der Node sendet niemals selbstständig einen KNX-Befehl.",
+      "aiEducationHelp": "Nur der Benutzer kann diese Node-Eigenschaft bearbeiten. Verwenden Sie sie für dauerhafte Vorgaben und Regeln für proaktive Benachrichtigungen, einschließlich Bedingungen, Dauer, Ruhezeiten und Wiederholung. Das Modell liest sie als verbindliche Vorgabe, schreibt sie aber niemals. Im Chat angeforderte Fakten und Präferenzen werden im gelernten Chat-Gedächtnis gespeichert; einmalige oder wiederkehrende Pläne, Erinnerungen, Überwachungen und zukünftige Befehle speichert der semantische Scheduler. Es sind weder Auslösephrasen noch Intent-Routing erforderlich. Maximal 16.000 Zeichen."
+    },
+    "sidebar": {
+      "ui": {
+        "refreshNodeList": "Knotenliste aktualisieren",
+        "refreshSummary": "Zusammenfassung aktualisieren",
+        "auto": "Auto",
+        "sections": {
+          "summary": "Zusammenfassung",
+          "anomalies": "Anomalien",
+          "ask": "Fragen"
+        },
+        "empty": {
+          "noNodes": "Keine Cerebrum Ultimate-Knoten gefunden.",
+          "noAnomalies": "Keine Anomalien."
+        },
+        "chat": {
+          "placeholder": "Stelle eine Frage zum KNX-Verkehr…",
+          "send": "Senden",
+          "pending": "Ich denke nach…",
+          "llmDisabled": "LLM in der Knoten-Konfiguration deaktiviert",
+          "emptyAnswer": "(leere Antwort)"
+        },
+        "status": {
+          "ready": "Bereit",
+          "loadingNodes": "Lade Knoten…",
+          "loading": "Laden…",
+          "asking": "Frage…"
+        },
+        "errors": {
+          "loadNodes": "Knoten konnten nicht geladen werden",
+          "loadState": "Status konnte nicht geladen werden",
+          "askFailed": "Anfrage fehlgeschlagen"
+        }
+      },
+      "summary": {
+        "noData": "Keine Daten verfügbar.",
+        "header": {
+          "gateway": "Gateway: {{gatewayName}}",
+          "updated": "Aktualisiert: {{at}}"
+        },
+        "analysisWindowLine": "Analysefenster: {{seconds}}s",
+        "statsLine": "Telegramme: {{telegrams}} · Rate: {{rate}}/s · Echoed: {{echoed}} · Unbekannte DPT: {{unknownDpt}}",
+        "topGAsTitle": "Top-Gruppenadressen:",
+        "eventsTitle": "Ereignisse:",
+        "patternsTitle": "Muster (wiederkehrende Sequenzen):",
+        "patternItem": "{{from}} → {{to}}  ({{count}} mal innerhalb von {{withinMs}}ms)"
+      }
+    },
+    "buttons": {
+      "refreshSetupDoctor": "Erneut prüfen",
+      "installOllamaModel": "2) Install it",
+      "ollamaLibrary": "Model library",
+      "downloadOllamaModel": "1) Download model",
+      "openChatLearning": "KI-Chat-Lernen öffnen",
+      "openCerebrumMemory": "Cerebrum-Speicher öffnen",
+      "etsSelectAll": "Alle auswählen",
+      "etsSelectNone": "Alle abwählen",
+      "etsReadOnlyAll": "Nur lesen setzen",
+      "etsReadOnlyNone": "Nur lesen entfernen"
+    }
+  }
+}

package/nodes/locales/de/knxUltimateUtility.json

@@ -10,6 +10,14 @@
     "migration_success": "Der Download der Flow-Sicherung wurde gestartet. {{count}} Knoten in KNX Utility konvertiert. Prüfen Sie das Ergebnis und klicken Sie auf Deploy, um es anzuwenden. Mit Rückgängig können Sie die Konvertierung aufheben.",
     "migration_backup_failed": "Die Flow-Sicherung konnte nicht gestartet werden. Es wurden keine Knoten konvertiert:",
     "migration_failed": "Konvertierung in KNX Utility fehlgeschlagen:",
+    "startup_migration": {
+      "title": "Veraltete KNX Ultimate-Knoten",
+      "message": "Veraltete Knoten in deinen Flows und Subflows gefunden: HUE: {{hue}}; KNX-Utility: {{knx}}. Diese Knoten funktionieren weiterhin, sind aber in der Palette ausgeblendet. Migriere sie zu HUE Controller und KNX Utility. Bei jeder Migration wird eine Sicherung der Flows heruntergeladen; prüfe das Ergebnis vor dem Deploy.",
+      "hue_button": "HUE migrieren ({{count}})",
+      "knx_button": "KNX migrieren ({{count}})",
+      "later": "Später",
+      "unavailable": "Das Migrationstool ist nicht verfügbar. Starte Node-RED neu und lade anschließend den Editor neu."
+    },
     "locale": "de",
     "function": "Funktion",
     "gateway": "KNX-Gateway",

package/nodes/locales/en/knxUltimateAI.html

@@ -0,0 +1,5 @@
+<script type="text/html" data-help-name="knxUltimateAI">
+  <p><b>This is a hidden legacy node retained only for existing flows.</b></p>
+  <p>For new installations use the standalone <b>Cerebrum Ultimate</b> node from <code>node-red-contrib-cerebrum-ultimate</code>. It replaces this node and uses KNX Ultimate as an optional compatible integration.</p>
+  <p><a href="https://github.com/Supergiovane/node-red-contrib-cerebrum-ultimate#readme" target="_blank">Open the Cerebrum Ultimate documentation</a>.</p>
+</script>