node-red-contrib-knx-ultimate 6.3.28 → 6.3.30

package/nodes/utils/knxAiTelegramVoice.js

@@ -128,15 +128,47 @@ const resolveTelegramVoiceAllowedOrigin = (message) => {
 }
 
 const applyKnxAiTelegramVoiceInputPresetFallback = ({ preset, message } = {}) => {
-  if (String(preset || '') !== 'windkh-telegrambot' || !message || typeof message !== 'object') return null
+  const normalizedPreset = String(preset || '')
+  if (!['windkh-telegrambot', 'redbot-telegram'].includes(normalizedPreset) || !message || typeof message !== 'object') return null
   const telegram = message.payload && typeof message.payload === 'object' ? message.payload : null
-  if (!telegram || telegram.type !== 'voice') return null
+  if (!telegram) return null
   const chatId = telegram.chatId
   if (chatId === undefined || chatId === null || chatId === '') return null
   const original = message.originalMessage && typeof message.originalMessage === 'object'
     ? message.originalMessage
     : {}
   const voice = findTelegramVoiceMetadata(message)
+
+  if (normalizedPreset === 'redbot-telegram') {
+    const redbotType = String(telegram.type || '').trim().toLowerCase()
+    if ((redbotType !== 'audio' && redbotType !== 'voice') || !Buffer.isBuffer(telegram.content)) return null
+    const mediaType = normalizeVoiceMediaType(voice.mime_type || telegram.mimeType)
+    message.sessionId = String(chatId)
+    message.language = (original.from && original.from.language_code) ||
+      (original.message && original.message.from && original.message.from.language_code) ||
+      telegram.language ||
+      message.language ||
+      ''
+    message.topic = 'ask'
+    delete message.prompt
+    message.knxAi = Object.assign({}, message.knxAi, {
+      sessionId: String(chatId),
+      voiceInput: {
+        source: 'telegram',
+        originalType: 'voice',
+        transport: 'redbot-buffer',
+        data: telegram.content,
+        fileId: String(voice.file_id || '').trim(),
+        mediaType,
+        filename: sanitizeVoiceFilename({ filename: telegram.filename || voice.file_name, mediaType }),
+        durationSeconds: Math.max(0, Number(voice.duration || telegram.duration) || 0),
+        fileSize: Math.max(0, Number(voice.file_size || telegram.fileSize) || telegram.content.length)
+      }
+    })
+    return message
+  }
+
+  if (telegram.type !== 'voice') return null
   const mediaType = normalizeVoiceMediaType(voice.mime_type || telegram.contentType || telegram.mimeType)
   const fileId = String(telegram.content || voice.file_id || '').trim()
   const weblink = String(telegram.weblink || message.weblink || '').trim()
@@ -175,6 +207,7 @@ const redactKnxAiTelegramVoiceLocations = (message) => {
   if (!message || typeof message !== 'object') return message
   if (message.payload && typeof message.payload === 'object') {
     message.payload = Object.assign({}, message.payload)
+    if (Buffer.isBuffer(message.payload.content)) message.payload.content = ''
     delete message.payload.weblink
     delete message.payload.path
   }
@@ -182,6 +215,7 @@ const redactKnxAiTelegramVoiceLocations = (message) => {
   delete message.path
   if (message.knxAi && message.knxAi.voiceInput && typeof message.knxAi.voiceInput === 'object') {
     const voiceInput = Object.assign({}, message.knxAi.voiceInput)
+    delete voiceInput.data
     delete voiceInput.weblink
     delete voiceInput.path
     message.knxAi = Object.assign({}, message.knxAi, { voiceInput })
@@ -258,6 +292,16 @@ const fetchKnxAiTelegramVoice = async ({
   }
   const mediaType = normalizeVoiceMediaType(source.mediaType)
   const filename = sanitizeVoiceFilename({ filename: source.filename, mediaType })
+  if (Buffer.isBuffer(source.data)) {
+    if (!source.data.length) throw new Error('Telegram returned an empty voice message')
+    if (source.data.length > maxBytes) throw new Error(`Voice audio exceeds the ${Math.round(maxBytes / (1024 * 1024))} MB limit`)
+    return {
+      data: Buffer.from(source.data),
+      mediaType,
+      filename,
+      source: String(source.transport || 'telegram-buffer')
+    }
+  }
   const weblink = String(source.weblink || '').trim()
   if (weblink) {
     let parsed
@@ -409,11 +453,15 @@ const postKnxAiVoiceSpeech = async ({
 }
 
 const applyKnxAiTelegramVoiceOutputPresetFallback = ({ preset, message, inputMessage } = {}) => {
-  if (String(preset || '') !== 'windkh-telegrambot' || !message || typeof message !== 'object') return message
+  const normalizedPreset = String(preset || '')
+  if (!['windkh-telegrambot', 'redbot-telegram'].includes(normalizedPreset) || !message || typeof message !== 'object') return message
   const audio = message.knxAi && message.knxAi.audio
   if (!audio || !Buffer.isBuffer(audio.data) || !audio.data.length) return message
   const currentPayload = message.payload && typeof message.payload === 'object' ? message.payload : null
-  if (currentPayload && (currentPayload.type === 'voice' || currentPayload.type === 'photo')) return message
+  if (currentPayload && (currentPayload.type === 'voice' || currentPayload.type === 'audio' || currentPayload.type === 'photo')) return message
+  if (normalizedPreset === 'redbot-telegram' && currentPayload && currentPayload.type === 'inline-buttons') return message
+  const confirmation = message.knxAi && message.knxAi.confirmationRequest
+  if (normalizedPreset === 'redbot-telegram' && confirmation && confirmation.required === true) return message
   const source = inputMessage && typeof inputMessage === 'object'
     ? inputMessage
     : message.inputMessage && typeof message.inputMessage === 'object'
@@ -435,6 +483,28 @@ const applyKnxAiTelegramVoiceOutputPresetFallback = ({ preset, message, inputMes
     .filter(Boolean)
     .join('\n')
     .slice(0, 1024)
+
+  if (normalizedPreset === 'redbot-telegram') {
+    const transport = currentPayload && currentPayload.transport
+      ? currentPayload.transport
+      : sourcePayload.transport || 'telegram'
+    const userId = currentPayload && currentPayload.userId !== undefined
+      ? currentPayload.userId
+      : sourcePayload.userId
+    message.payload = {
+      transport,
+      chatId,
+      type: 'audio',
+      inbound: false,
+      content: audio.data,
+      filename: sanitizeVoiceFilename({ filename: audio.filename, mediaType: audio.mediaType, fallback: 'knx-ai-reply' }),
+      mimeType: normalizeVoiceMediaType(audio.mediaType),
+      caption
+    }
+    if (userId !== undefined) message.payload.userId = userId
+    return message
+  }
+
   const options = Object.assign({}, currentPayload && currentPayload.options ? currentPayload.options : {})
   if (caption) options.caption = caption
   message.payload = {

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.3.28",
+  "version": "6.3.30",
   "description": "KNX Ultimate is the most advanced KNX integration for Node-RED, providing secure KNX/IP communication, routing, ETS project import, Philips Hue, Matter Controller and Matter Bridge (control matter device via KNX and expose KNX GA via Matter), MQTT and Modbus adapters, diagnostics with AI, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.",
   "files": [
     "nodes/",

package/resources/KNXAIChatAdapterMappings.js

@@ -193,15 +193,13 @@ return msg;`
       id: 'redbot-telegram',
       title: 'RedBot / node-red-contrib-chatbot (Telegram)',
       inputCode: `// RedBot Telegram Receiver -> KNX AI
-// RedBot normalizes Telegram text and inline-button postbacks in msg.payload.
+// RedBot normalizes Telegram text, voice audio and inline-button postbacks in msg.payload.
 const redbot = msg.payload;
 if (!redbot || typeof redbot !== 'object') return;
 if (redbot.transport && redbot.transport !== 'telegram') return;
 
 const chatId = redbot.chatId;
-const content = typeof redbot.content === 'string' ? redbot.content.trim() : '';
-if (chatId === undefined || chatId === null || content === '') return;
-if (redbot.type !== 'message') return;
+if (chatId === undefined || chatId === null) return;
 
 msg.sessionId = String(chatId);
 msg.language =
@@ -210,6 +208,37 @@ msg.language =
     msg.language ||
     '';
 
+const redbotType = String(redbot.type || '').trim().toLowerCase();
+if ((redbotType === 'audio' || redbotType === 'voice') && Buffer.isBuffer(redbot.content)) {
+    const original = msg.originalMessage && typeof msg.originalMessage === 'object'
+        ? msg.originalMessage
+        : {};
+    const voice = original.voice && typeof original.voice === 'object'
+        ? original.voice
+        : original.message && original.message.voice && typeof original.message.voice === 'object'
+            ? original.message.voice
+            : {};
+    msg.topic = 'ask';
+    msg.knxAi = Object.assign({}, msg.knxAi, {
+        sessionId: String(chatId),
+        voiceInput: {
+            source: 'telegram',
+            originalType: 'voice',
+            transport: 'redbot-buffer',
+            data: redbot.content,
+            fileId: String(voice.file_id || '').trim(),
+            mediaType: String(voice.mime_type || redbot.mimeType || 'audio/ogg'),
+            filename: String(voice.file_name || redbot.filename || 'telegram-voice.ogg'),
+            durationSeconds: Math.max(0, Number(voice.duration || redbot.duration) || 0),
+            fileSize: Math.max(0, Number(voice.file_size || redbot.fileSize) || redbot.content.length)
+        }
+    });
+    return msg;
+}
+
+const content = typeof redbot.content === 'string' ? redbot.content.trim() : '';
+if (redbotType !== 'message' || content === '') return;
+
 const action = content.toLowerCase();
 if (action === 'confirm' || action === 'cancel') {
     msg.topic = action;
@@ -300,6 +329,33 @@ if (image && Buffer.isBuffer(image.data)) {
     return msg;
 }
 
+const confirmation = msg.knxAi && msg.knxAi.confirmationRequest;
+const audio = msg.knxAi && msg.knxAi.audio;
+if (audio && Buffer.isBuffer(audio.data) && !(confirmation && confirmation.required === true)) {
+    const voiceLanguage = String(msg.knxAi.language || (source && source.language) || '').trim().toLowerCase().split(/[-_]/)[0];
+    const disclosureLabels = {
+        de: 'KI-generierte Stimme',
+        en: 'AI-generated voice',
+        es: 'Voz generada por IA',
+        fr: 'Voix générée par l’IA',
+        it: 'Voce generata dall’IA',
+        zh: 'AI 生成的语音'
+    };
+    const disclosure = disclosureLabels[voiceLanguage] || disclosureLabels.en;
+    msg.payload = {
+        transport: sourcePayload.transport || 'telegram',
+        chatId: chatId,
+        type: 'audio',
+        inbound: false,
+        content: audio.data,
+        filename: audio.filename || 'knx-ai-reply.ogg',
+        mimeType: audio.mediaType || 'audio/ogg',
+        caption: [disclosure, content].filter(Boolean).join('\\n').slice(0, 1024)
+    };
+    if (sourcePayload.userId !== undefined) msg.payload.userId = sourcePayload.userId;
+    return msg;
+}
+
 const redbotPayload = {
     transport: sourcePayload.transport || 'telegram',
     chatId: chatId,
@@ -309,7 +365,6 @@ const redbotPayload = {
 };
 if (sourcePayload.userId !== undefined) redbotPayload.userId = sourcePayload.userId;
 
-const confirmation = msg.knxAi && msg.knxAi.confirmationRequest;
 if (confirmation && confirmation.required === true && Array.isArray(confirmation.actions)) {
     redbotPayload.type = 'inline-buttons';
     redbotPayload.buttons = confirmation.actions.map(function (action) {