iobroker.assistant 1.2.0 → 1.3.0

package/admin/i18n/uk.json

@@ -1,7 +1,7 @@
 {
   "A fired timer/alarm keeps ringing (looping the sound) for up to this long, or until you say 'stop'/'halt'/'aufhören'/'cancel' (or write the stopRinging state). 0 = play the sound once.": "Увімкнений таймер/будильник дзвонить (зациклюється) протягом певного часу, або доки ви не скажете «стоп»/«зупинити»/«почути»/«скасувати» (або не запишете стан stopRinging). 0 = відтворити звук один раз.",
   "A phrase that runs a list of actions: \"Gute Nacht\" switches off five things and answers once. Phrases: several separated by commas (matched anywhere in the sentence, upper/lower case and umlauts do not matter). Actions as JSON, same shape as a trigger: [{\"setState\":{\"id\":\"hm-rpc.0.ABC.1.STATE\",\"value\":false}},{\"say\":\"Schlaf gut\",\"room\":\"Schlafzimmer\"}]. Reply: what the assistant answers (leave empty to stay silent). Matched before the offline rule engine and before the LLM, so a routine is never reinterpreted.": "Фраза, яка запускає список дій: \"Gute Nacht\" вимикає п'ять пристроїв і відповідає один раз. Фрази: кілька через кому (розпізнаються будь-де в реченні, регістр і умлаути не мають значення). Дії у форматі JSON, як у тригера: [{\"setState\":{\"id\":\"hm-rpc.0.ABC.1.STATE\",\"value\":false}},{\"say\":\"Schlaf gut\",\"room\":\"Schlafzimmer\"}]. Відповідь: що каже асистент (залиште порожнім, щоб нічого не казати). Перевіряється до офлайн-рушія правил і до LLM, тому рутина ніколи не буде витлумачена інакше.",
-  "A successful switch command is confirmed by a short tone on the satellite instead of a spoken sentence - instant, where speaking costs a text-to-speech call. Questions, errors and the text channels are unaffected.": "Успішна команда перемикання підтверджується коротким сигналом на сателіті замість вимовленої фрази — миттєво, тоді як мовлення потребує виклику синтезу мовлення. Запитань, помилок і текстових каналів це не стосується.",
+  "A switch command that worked (on, off, set to a value) is confirmed by a short tone on the satellite instead of a spoken sentence, whether the offline rules or the AI carried it out. Questions, errors and the text channels are unaffected.": "Успішна команда перемикання (увімкнути, вимкнути, встановити значення) підтверджується коротким сигналом на сателіті замість вимовленої фрази — незалежно від того, чи виконали її офлайн-правила, чи ШІ. Питання, помилки й текстові канали не змінюються.",
   "A trigger watches states or the clock and then speaks, writes a state, or asks you a question and acts on your answer. Switch single triggers off at runtime with triggers.items.<id>.enabled, test one with its fire button, and all of them with triggers.enabled.": "Тригер стежить за станами або часом, а потім говорить, записує стан або ставить вам запитання й діє відповідно до вашої відповіді. Окремі тригери можна вимкнути під час роботи через triggers.items.<id>.enabled, перевірити кнопкою fire, а всі разом — через triggers.enabled.",
   "API key": "Ключ API",
   "API password (usually empty)": "Пароль API (зазвичай порожній)",
@@ -194,5 +194,28 @@
   "TV power (optional)": "Живлення ТВ (необов’язково)",
   "Start delay (s)": "Затримка старту (с)",
   "Name": "Ім’я",
-  "TVs and devices of the youtube-remote adapter the assistant may play on, e.g. \"play the channel Sailing OceanAir\". The first row is the default when no player is named; a request from a satellite in the room of a row goes to that row. Player: the youtube-remote instance - it finds its paired TV itself, also after the TV was paired again; with several TVs in one instance pick one of them. Power: optional state that switches the TV on (e.g. samsungtv.0.<tv>.control.power) - if it is off, the TV is switched on first and the video starts after the start delay. A power button (toggle) is never pressed, because it would switch a running TV off. Needs \"Allow writing states\".": "Телевізори та пристрої адаптера youtube-remote, на яких асистент може відтворювати, наприклад «увімкни канал Sailing OceanAir». Перший рядок використовується за замовчуванням, якщо плеєр не названо; запит від супутника в кімнаті рядка йде на цей рядок. Плеєр: екземпляр youtube-remote — він сам знаходить пов’язаний телевізор, зокрема після повторного прив’язування; якщо в екземплярі кілька телевізорів, виберіть один із них. Живлення: необов’язковий стан, що вмикає телевізор (наприклад samsungtv.0.<tv>.control.power) — якщо телевізор вимкнено, його спочатку вмикають, а відео стартує після затримки. Кнопку живлення (перемикач) ніколи не натискають, бо вона вимкнула б працюючий телевізор. Потрібно «Дозволити запис станів»."
+  "TVs and devices of the youtube-remote adapter the assistant may play on, e.g. \"play the channel Sailing OceanAir\". The first row is the default when no player is named; a request from a satellite in the room of a row goes to that row. Player: the youtube-remote instance - it finds its paired TV itself, also after the TV was paired again; with several TVs in one instance pick one of them. Power: optional state that switches the TV on (e.g. samsungtv.0.<tv>.control.power) - if it is off, the TV is switched on first and the video starts after the start delay. A power button (toggle) is never pressed, because it would switch a running TV off. Needs \"Allow writing states\".": "Телевізори та пристрої адаптера youtube-remote, на яких асистент може відтворювати, наприклад «увімкни канал Sailing OceanAir». Перший рядок використовується за замовчуванням, якщо плеєр не названо; запит від супутника в кімнаті рядка йде на цей рядок. Плеєр: екземпляр youtube-remote — він сам знаходить пов’язаний телевізор, зокрема після повторного прив’язування; якщо в екземплярі кілька телевізорів, виберіть один із них. Живлення: необов’язковий стан, що вмикає телевізор (наприклад samsungtv.0.<tv>.control.power) — якщо телевізор вимкнено, його спочатку вмикають, а відео стартує після затримки. Кнопку живлення (перемикач) ніколи не натискають, бо вона вимкнула б працюючий телевізор. Потрібно «Дозволити запис станів».",
+  "Adapter pi-agent": "Адаптер pi-agent",
+  "pi-agent instance": "Екземпляр pi-agent",
+  "pi-agent timeout (s)": "Тайм-аут pi-agent (с)",
+  "Everything the local tiers cannot answer goes to the adapter pi-agent: its model and key (also the system-wide AI settings of admin), its tools and its write permissions. Every request source gets a conversation of its own there. The tools of this adapter (timers, memory, announcements, YouTube) are not available to it; the rule-based commands still handle timers and alarms.": "Усе, на що не можуть відповісти локальні рівні, передається адаптеру pi-agent: його модель і ключ (зокрема загальносистемні налаштування ШІ в admin), його інструменти та права запису. Кожне джерело запитів отримує там власну розмову. Інструменти цього адаптера (таймери, пам'ять, оголошення, YouTube) йому недоступні; таймери й будильники й надалі обробляють команди на основі правил.",
+  "System-wide AI settings (admin)": "Загальносистемні налаштування ШІ (admin)",
+  "OpenRouter": "OpenRouter",
+  "Provider, model and API key come from the system settings of admin (tab \"AI\"). A change there restarts this instance.": "Провайдер, модель і API-ключ беруться з системних налаштувань admin (вкладка «ШІ»). Їх зміна перезапускає цей екземпляр.",
+  "Empty: the system-wide AI settings of admin are used": "Порожньо: використовуються загальносистемні налаштування ШІ з admin",
+  "OpenRouter key for speech (optional)": "Ключ OpenRouter для мовлення (необов’язково)",
+  "OpenRouter credential": "Облікові дані OpenRouter",
+  "Empty: the key of the AI provider is used if that is OpenRouter (also from the system-wide AI settings).": "Порожньо: використовується ключ ШІ-провайдера, якщо це OpenRouter (також із загальносистемних налаштувань ШІ).",
+  "OpenRouter STT model (optional)": "Модель OpenRouter STT (необов’язково)",
+  "Empty = openai/whisper-large-v3-turbo.": "Порожньо = openai/whisper-large-v3-turbo.",
+  "OpenRouter TTS model (optional)": "Модель OpenRouter TTS (необов’язково)",
+  "Empty = elevenlabs/eleven-flash-v2.5.": "Порожньо = elevenlabs/eleven-flash-v2.5.",
+  "OpenRouter voice (optional)": "Голос OpenRouter (необов’язково)",
+  "The voices depend on the model. Empty = the first voice of the model for the language.": "Голоси залежать від моделі. Порожньо = перший голос моделі для мови.",
+  "Calendar for commands for later": "Календар для відкладених команд",
+  "A fullcalendar instance: \"turn off the light in 2 hours\" or \"blinds to 50 % at 10 pm\" becomes an event in this calendar, and the AI can plan, list and cancel events. Without it such commands go to the AI.": "Екземпляр fullcalendar: «вимкни світло через 2 години» або «жалюзі на 50 % о 22:00» стає подією в цьому календарі, а ШІ може планувати, показувати й видаляти події. Без нього такі команди йдуть до ШІ.",
+  "Person": "Людина",
+  "Guest": "Гість",
+  "Pet": "Улюбленець",
+  "Group": "Група"
 }

package/admin/i18n/zh-cn.json

@@ -1,7 +1,7 @@
 {
   "A fired timer/alarm keeps ringing (looping the sound) for up to this long, or until you say 'stop'/'halt'/'aufhören'/'cancel' (or write the stopRinging state). 0 = play the sound once.": "触发的定时器/警报会持续响铃（循环播放声音），最长可达设定时间，或直到您说“停止”、“暂停”、“取消”（或写入 stopRinging 状态）。0 = 播放一次声音。",
   "A phrase that runs a list of actions: \"Gute Nacht\" switches off five things and answers once. Phrases: several separated by commas (matched anywhere in the sentence, upper/lower case and umlauts do not matter). Actions as JSON, same shape as a trigger: [{\"setState\":{\"id\":\"hm-rpc.0.ABC.1.STATE\",\"value\":false}},{\"say\":\"Schlaf gut\",\"room\":\"Schlafzimmer\"}]. Reply: what the assistant answers (leave empty to stay silent). Matched before the offline rule engine and before the LLM, so a routine is never reinterpreted.": "一个执行一系列动作的短语：\"Gute Nacht\" 关闭五个设备并只回答一次。短语：多个短语用逗号分隔（在句子任意位置匹配，不区分大小写和变音符号）。动作为 JSON，格式与触发器相同：[{\"setState\":{\"id\":\"hm-rpc.0.ABC.1.STATE\",\"value\":false}},{\"say\":\"Schlaf gut\",\"room\":\"Schlafzimmer\"}]。回复：助手的回答（留空则不出声）。在离线规则引擎和 LLM 之前匹配，因此例程永远不会被重新解读。",
-  "A successful switch command is confirmed by a short tone on the satellite instead of a spoken sentence - instant, where speaking costs a text-to-speech call. Questions, errors and the text channels are unaffected.": "成功的开关命令会在卫星设备上以短促提示音确认，而不是说出一句话——即时完成，而语音播报需要一次文字转语音调用。问题、错误和文本通道不受影响。",
+  "A switch command that worked (on, off, set to a value) is confirmed by a short tone on the satellite instead of a spoken sentence, whether the offline rules or the AI carried it out. Questions, errors and the text channels are unaffected.": "执行成功的开关命令（开、关、设为某值）会在卫星设备上用一声短促的提示音确认，而不是说出一句话，无论是离线规则还是 AI 执行的。问题、错误和文本渠道不受影响。",
   "A trigger watches states or the clock and then speaks, writes a state, or asks you a question and acts on your answer. Switch single triggers off at runtime with triggers.items.<id>.enabled, test one with its fire button, and all of them with triggers.enabled.": "触发器监视状态或时钟，然后播报、写入状态，或向你提问并根据你的回答执行操作。运行时可通过 triggers.items.<id>.enabled 关闭单个触发器，用其 fire 按钮测试单个触发器，通过 triggers.enabled 控制全部触发器。",
   "API key": "API密钥",
   "API password (usually empty)": "API 密码（通常为空）",
@@ -194,5 +194,28 @@
   "TV power (optional)": "电视电源（可选）",
   "Start delay (s)": "启动延迟（秒）",
   "Name": "名称",
-  "TVs and devices of the youtube-remote adapter the assistant may play on, e.g. \"play the channel Sailing OceanAir\". The first row is the default when no player is named; a request from a satellite in the room of a row goes to that row. Player: the youtube-remote instance - it finds its paired TV itself, also after the TV was paired again; with several TVs in one instance pick one of them. Power: optional state that switches the TV on (e.g. samsungtv.0.<tv>.control.power) - if it is off, the TV is switched on first and the video starts after the start delay. A power button (toggle) is never pressed, because it would switch a running TV off. Needs \"Allow writing states\".": "助手可以在其上播放的 youtube-remote 适配器的电视和设备，例如“播放频道 Sailing OceanAir”。未指定播放器时使用第一行；来自某行所在房间卫星的请求发送到该行。播放器：youtube-remote 实例——它会自行找到已配对的电视，重新配对后也一样；一个实例中有多台电视时，选择其中一台。电源：可选的开启电视的状态（例如 samsungtv.0.<tv>.control.power）——如果电视关闭，会先开机，视频在启动延迟后开始。电源按钮（切换键）永远不会被按下，因为它会关闭正在运行的电视。需要“允许写入状态”。"
+  "TVs and devices of the youtube-remote adapter the assistant may play on, e.g. \"play the channel Sailing OceanAir\". The first row is the default when no player is named; a request from a satellite in the room of a row goes to that row. Player: the youtube-remote instance - it finds its paired TV itself, also after the TV was paired again; with several TVs in one instance pick one of them. Power: optional state that switches the TV on (e.g. samsungtv.0.<tv>.control.power) - if it is off, the TV is switched on first and the video starts after the start delay. A power button (toggle) is never pressed, because it would switch a running TV off. Needs \"Allow writing states\".": "助手可以在其上播放的 youtube-remote 适配器的电视和设备，例如“播放频道 Sailing OceanAir”。未指定播放器时使用第一行；来自某行所在房间卫星的请求发送到该行。播放器：youtube-remote 实例——它会自行找到已配对的电视，重新配对后也一样；一个实例中有多台电视时，选择其中一台。电源：可选的开启电视的状态（例如 samsungtv.0.<tv>.control.power）——如果电视关闭，会先开机，视频在启动延迟后开始。电源按钮（切换键）永远不会被按下，因为它会关闭正在运行的电视。需要“允许写入状态”。",
+  "Adapter pi-agent": "pi-agent 适配器",
+  "pi-agent instance": "pi-agent 实例",
+  "pi-agent timeout (s)": "pi-agent 超时（秒）",
+  "Everything the local tiers cannot answer goes to the adapter pi-agent: its model and key (also the system-wide AI settings of admin), its tools and its write permissions. Every request source gets a conversation of its own there. The tools of this adapter (timers, memory, announcements, YouTube) are not available to it; the rule-based commands still handle timers and alarms.": "本地层级无法回答的所有内容都会交给 pi-agent 适配器：使用它的模型和密钥（也可以是 admin 的系统级 AI 设置）、它的工具和写入权限。每个请求来源在那里都有自己的对话。本适配器的工具（计时器、记忆、广播、YouTube）在那里不可用；计时器和闹钟仍由基于规则的命令处理。",
+  "System-wide AI settings (admin)": "系统级 AI 设置（admin）",
+  "OpenRouter": "OpenRouter",
+  "Provider, model and API key come from the system settings of admin (tab \"AI\"). A change there restarts this instance.": "提供商、模型和 API 密钥来自 admin 的系统设置（“AI”选项卡）。在那里更改会重启此实例。",
+  "Empty: the system-wide AI settings of admin are used": "留空：使用 admin 的系统级 AI 设置",
+  "OpenRouter key for speech (optional)": "用于语音的 OpenRouter 密钥（可选）",
+  "OpenRouter credential": "OpenRouter 凭据",
+  "Empty: the key of the AI provider is used if that is OpenRouter (also from the system-wide AI settings).": "留空：如果 AI 提供商是 OpenRouter（也包括系统级 AI 设置），则使用其密钥。",
+  "OpenRouter STT model (optional)": "OpenRouter STT 模型（可选）",
+  "Empty = openai/whisper-large-v3-turbo.": "留空 = openai/whisper-large-v3-turbo。",
+  "OpenRouter TTS model (optional)": "OpenRouter TTS 模型（可选）",
+  "Empty = elevenlabs/eleven-flash-v2.5.": "留空 = elevenlabs/eleven-flash-v2.5。",
+  "OpenRouter voice (optional)": "OpenRouter 语音（可选）",
+  "The voices depend on the model. Empty = the first voice of the model for the language.": "可用语音取决于模型。留空 = 该模型在此语言下的第一个语音。",
+  "Calendar for commands for later": "用于延时命令的日历",
+  "A fullcalendar instance: \"turn off the light in 2 hours\" or \"blinds to 50 % at 10 pm\" becomes an event in this calendar, and the AI can plan, list and cancel events. Without it such commands go to the AI.": "fullcalendar 实例：“2 小时后关灯”或“晚上 10 点把百叶窗调到 50 %”会成为此日历中的事件，AI 也可以计划、列出和删除事件。未设置时，此类命令交给 AI 处理。",
+  "Person": "人员",
+  "Guest": "访客",
+  "Pet": "宠物",
+  "Group": "组"
 }

package/admin/jsonConfig.json

@@ -21,25 +21,38 @@
                     "type": "select",
                     "label": "Provider",
                     "options": [
+                        { "label": "System-wide AI settings (admin)", "value": "system" },
                         { "label": "OpenAI", "value": "openai" },
                         { "label": "Anthropic (Claude)", "value": "anthropic" },
                         { "label": "Google Gemini", "value": "gemini" },
                         { "label": "DeepSeek", "value": "deepseek" },
+                        { "label": "OpenRouter", "value": "openrouter" },
                         { "label": "OpenAI-compatible (custom)", "value": "custom" },
+                        { "label": "Adapter pi-agent", "value": "pi-agent" },
                         { "label": "None (local only)", "value": "none" }
                     ],
-                    "default": "openai",
+                    "default": "system",
                     "xs": 12,
                     "sm": 12,
                     "md": 4,
                     "lg": 4,
                     "xl": 4
                 },
+                "_systemAiInfo": {
+                    "type": "staticText",
+                    "text": "Provider, model and API key come from the system settings of admin (tab \"AI\"). A change there restarts this instance.",
+                    "hidden": "data.provider !== 'system'",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 8,
+                    "lg": 8,
+                    "xl": 8
+                },
                 "credentialType": {
                     "newLine": true,
                     "type": "select",
                     "label": "Credential mode",
-                    "hidden": "data.provider === 'none'",
+                    "hidden": "data.provider === 'none' || data.provider === 'pi-agent' || data.provider === 'system'",
                     "options": [
                         { "label": "Store key in adapter", "value": "manual" },
                         { "label": "Central credential store", "value": "manager" }
@@ -54,7 +67,8 @@
                 "apiKey": {
                     "type": "password",
                     "label": "API key",
-                    "hidden": "data.provider === 'none' || data.credentialType === 'manager'",
+                    "help": "Empty: the system-wide AI settings of admin are used",
+                    "hidden": "data.provider === 'none' || data.provider === 'pi-agent' || data.provider === 'system' || data.credentialType === 'manager'",
                     "xs": 12,
                     "sm": 12,
                     "md": 4,
@@ -65,7 +79,7 @@
                     "type": "credential",
                     "credentialType": "ai",
                     "label": "API-key credential",
-                    "hidden": "data.provider === 'none' || data.credentialType !== 'manager'",
+                    "hidden": "data.provider === 'none' || data.provider === 'pi-agent' || data.provider === 'system' || data.credentialType !== 'manager'",
                     "xs": 12,
                     "sm": 12,
                     "md": 4,
@@ -81,7 +95,7 @@
                     "freeSolo": true,
                     "label": "Model",
                     "help": "Loaded from the provider (instance must run); you can also type a model id.",
-                    "hidden": "data.provider === 'none'",
+                    "hidden": "data.provider === 'none' || data.provider === 'pi-agent' || data.provider === 'system'",
                     "default": "gpt-4o-mini",
                     "xs": 12,
                     "sm": 12,
@@ -107,14 +121,50 @@
                     "command": "testApiConnection",
                     "jsonData": "{\"provider\":\"${data.provider}\",\"apiKey\":\"${data.apiKey}\",\"credentialType\":\"${data.credentialType}\",\"model\":\"${data.model}\",\"baseUrl\":\"${data.baseUrl}\",\"credentialId\":\"${data.credentialIdApiKey}\"}",
                     "variant": "outlined",
-                    "hidden": "data.provider === 'none'",
-                    "disabled": "data.provider !== 'custom' && (data.credentialType === 'manager' ? !data.credentialIdApiKey : !data.apiKey)",
+                    "hidden": "data.provider === 'none' || data.provider === 'pi-agent'",
+                    "disabled": "data.provider !== 'custom' && data.provider !== 'system' && (data.credentialType === 'manager' ? !data.credentialIdApiKey : !data.apiKey)",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 4,
+                    "lg": 4,
+                    "xl": 4
+                },
+                "piAgentInstance": {
+                    "newLine": true,
+                    "type": "instance",
+                    "adapter": "pi-agent",
+                    "label": "pi-agent instance",
+                    "hidden": "data.provider !== 'pi-agent'",
                     "xs": 12,
                     "sm": 12,
                     "md": 4,
                     "lg": 4,
                     "xl": 4
                 },
+                "piAgentTimeoutSec": {
+                    "type": "number",
+                    "label": "pi-agent timeout (s)",
+                    "hidden": "data.provider !== 'pi-agent'",
+                    "default": 60,
+                    "min": 5,
+                    "max": 600,
+                    "xs": 12,
+                    "sm": 6,
+                    "md": 2,
+                    "lg": 2,
+                    "xl": 2
+                },
+                "_piAgentInfo": {
+                    "newLine": true,
+                    "type": "staticText",
+                    "text": "Everything the local tiers cannot answer goes to the adapter pi-agent: its model and key (also the system-wide AI settings of admin), its tools and its write permissions. Every request source gets a conversation of its own there. The tools of this adapter (timers, memory, announcements, YouTube) are not available to it; the rule-based commands still handle timers and alarms.",
+                    "hidden": "data.provider !== 'pi-agent'",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
                 "_noneInfo": {
                     "newLine": true,
                     "type": "staticText",
@@ -130,7 +180,7 @@
                     "newLine": true,
                     "type": "number",
                     "label": "Max tokens",
-                    "hidden": "data.provider === 'none'",
+                    "hidden": "data.provider === 'none' || data.provider === 'pi-agent'",
                     "default": 1024,
                     "min": 64,
                     "max": 8192,
@@ -154,9 +204,9 @@
                 "confirmWithTone": {
                     "type": "checkbox",
                     "label": "Confirm switch commands with a beep",
-                    "help": "A successful switch command is confirmed by a short tone on the satellite instead of a spoken sentence - instant, where speaking costs a text-to-speech call. Questions, errors and the text channels are unaffected.",
+                    "help": "A switch command that worked (on, off, set to a value) is confirmed by a short tone on the satellite instead of a spoken sentence, whether the offline rules or the AI carried it out. Questions, errors and the text channels are unaffected.",
                     "default": false,
-                    "hidden": "!data.useLocalNlu",
+                    "hidden": "!data.voiceEnabled",
                     "xs": 12,
                     "sm": 6,
                     "md": 4,
@@ -243,6 +293,19 @@
                     "lg": 6,
                     "xl": 6
                 },
+                "calendarInstance": {
+                    "newLine": true,
+                    "type": "instance",
+                    "adapter": "fullcalendar",
+                    "allowDeactivate": true,
+                    "label": "Calendar for commands for later",
+                    "help": "A fullcalendar instance: \"turn off the light in 2 hours\" or \"blinds to 50 % at 10 pm\" becomes an event in this calendar, and the AI can plan, list and cancel events. Without it such commands go to the AI.",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 6,
+                    "xl": 6
+                },
                 "presence": {
                     "newLine": true,
                     "type": "table",
@@ -254,9 +317,20 @@
                     "lg": 12,
                     "xl": 12,
                     "items": [
-                        { "type": "text", "attr": "id", "title": "State id", "width": "45%" },
+                        { "type": "objectId", "attr": "id", "title": "State id", "width": "45%" },
                         { "type": "text", "attr": "name", "title": "Name", "width": "25%" },
-                        { "type": "text", "attr": "kind", "title": "Kind (person/guest/pet)", "width": "15%" },
+                        {
+                            "type": "select",
+                            "attr": "kind",
+                            "title": "Kind (person/guest/pet)",
+                            "width": "15%",
+                            "options": [
+                                { "label": "Person", "value": "person" },
+                                { "label": "Guest", "value": "guest" },
+                                { "label": "Pet", "value": "pet" }
+                            ],
+                            "default": "person"
+                        },
                         { "type": "text", "attr": "homeValue", "title": "Home value (empty = auto)", "width": "15%" }
                     ]
                 },
@@ -912,7 +986,17 @@
                             "title": "Satellites, rooms or devices (comma separated)",
                             "width": "60%"
                         },
-                        { "type": "text", "attr": "kind", "title": "Kind (group/person)", "width": "15%" }
+                        {
+                            "type": "select",
+                            "attr": "kind",
+                            "title": "Kind (group/person)",
+                            "width": "15%",
+                            "options": [
+                                { "label": "Group", "value": "group" },
+                                { "label": "Person", "value": "person" }
+                            ],
+                            "default": "group"
+                        }
                     ]
                 },
                 "sttProvider": {
@@ -921,6 +1005,7 @@
                     "label": "Speech-to-text provider",
                     "options": [
                         { "label": "OpenAI (Whisper)", "value": "openai" },
+                        { "label": "OpenRouter", "value": "openrouter" },
                         { "label": "Azure Speech", "value": "azure" },
                         { "label": "AWS Transcribe", "value": "aws" },
                         { "label": "Vosk (local)", "value": "vosk" }
@@ -938,6 +1023,7 @@
                     "label": "Text-to-speech provider",
                     "options": [
                         { "label": "OpenAI", "value": "openai" },
+                        { "label": "OpenRouter", "value": "openrouter" },
                         { "label": "Azure Speech", "value": "azure" },
                         { "label": "AWS Polly", "value": "aws" },
                         { "label": "Piper (local)", "value": "piper" }
@@ -958,6 +1044,7 @@
                     "options": [
                         { "label": "None", "value": "" },
                         { "label": "OpenAI (Whisper)", "value": "openai" },
+                        { "label": "OpenRouter", "value": "openrouter" },
                         { "label": "Azure Speech", "value": "azure" },
                         { "label": "AWS Transcribe", "value": "aws" },
                         { "label": "Vosk (local)", "value": "vosk" }
@@ -977,6 +1064,7 @@
                     "options": [
                         { "label": "None", "value": "" },
                         { "label": "OpenAI", "value": "openai" },
+                        { "label": "OpenRouter", "value": "openrouter" },
                         { "label": "Azure Speech", "value": "azure" },
                         { "label": "AWS Polly", "value": "aws" },
                         { "label": "Piper (local)", "value": "piper" }
@@ -1081,6 +1169,87 @@
                     "lg": 4,
                     "xl": 4
                 },
+                "_openrouterSpeechHeader": {
+                    "newLine": true,
+                    "type": "header",
+                    "size": 3,
+                    "text": "OpenRouter",
+                    "hidden": "!data.voiceEnabled || (data.sttProvider !== 'openrouter' && data.ttsProvider !== 'openrouter' && data.sttFallback !== 'openrouter' && data.ttsFallback !== 'openrouter')",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "openrouterSpeechKey": {
+                    "newLine": true,
+                    "type": "password",
+                    "label": "OpenRouter key for speech (optional)",
+                    "help": "Empty: the key of the AI provider is used if that is OpenRouter (also from the system-wide AI settings).",
+                    "hidden": "!data.voiceEnabled || (data.sttProvider !== 'openrouter' && data.ttsProvider !== 'openrouter' && data.sttFallback !== 'openrouter' && data.ttsFallback !== 'openrouter') || data.voiceCredentialType === 'manager'",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 8,
+                    "lg": 8,
+                    "xl": 8
+                },
+                "openrouterCredentialId": {
+                    "newLine": true,
+                    "type": "credential",
+                    "credentialType": "ai",
+                    "label": "OpenRouter credential",
+                    "help": "Empty: the key of the AI provider is used if that is OpenRouter (also from the system-wide AI settings).",
+                    "hidden": "!data.voiceEnabled || (data.sttProvider !== 'openrouter' && data.ttsProvider !== 'openrouter' && data.sttFallback !== 'openrouter' && data.ttsFallback !== 'openrouter') || data.voiceCredentialType !== 'manager'",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 6,
+                    "xl": 6
+                },
+                "openrouterSttModel": {
+                    "newLine": true,
+                    "type": "autocompleteSendTo",
+                    "command": "getSttModels",
+                    "jsonData": "{\"sttProvider\":\"openrouter\",\"language\":\"${data.voiceLanguage}\"}",
+                    "freeSolo": true,
+                    "label": "OpenRouter STT model (optional)",
+                    "help": "Empty = openai/whisper-large-v3-turbo.",
+                    "hidden": "!data.voiceEnabled || (data.sttProvider !== 'openrouter' && data.sttFallback !== 'openrouter')",
+                    "xs": 12,
+                    "sm": 6,
+                    "md": 4,
+                    "lg": 4,
+                    "xl": 4
+                },
+                "openrouterTtsModel": {
+                    "type": "autocompleteSendTo",
+                    "command": "getTtsModels",
+                    "jsonData": "{\"ttsProvider\":\"openrouter\"}",
+                    "freeSolo": true,
+                    "label": "OpenRouter TTS model (optional)",
+                    "help": "Empty = elevenlabs/eleven-flash-v2.5.",
+                    "hidden": "!data.voiceEnabled || (data.ttsProvider !== 'openrouter' && data.ttsFallback !== 'openrouter')",
+                    "xs": 12,
+                    "sm": 6,
+                    "md": 4,
+                    "lg": 4,
+                    "xl": 4
+                },
+                "openrouterVoice": {
+                    "type": "autocompleteSendTo",
+                    "command": "getVoices",
+                    "jsonData": "{\"ttsProvider\":\"openrouter\",\"language\":\"${data.voiceLanguage}\",\"openrouterTtsModel\":\"${data.openrouterTtsModel}\"}",
+                    "alsoDependsOn": ["openrouterTtsModel", "voiceLanguage"],
+                    "freeSolo": true,
+                    "label": "OpenRouter voice (optional)",
+                    "help": "The voices depend on the model. Empty = the first voice of the model for the language.",
+                    "hidden": "!data.voiceEnabled || (data.ttsProvider !== 'openrouter' && data.ttsFallback !== 'openrouter')",
+                    "xs": 12,
+                    "sm": 6,
+                    "md": 4,
+                    "lg": 4,
+                    "xl": 4
+                },
                 "_azureSpeechHeader": {
                     "newLine": true,
                     "type": "header",
@@ -1284,6 +1453,21 @@
                     "md": 5,
                     "lg": 5,
                     "xl": 5
+                },
+                "_voiceTest": {
+                    "newLine": true,
+                    "type": "custom",
+                    "i18n": true,
+                    "url": "custom/customComponents.js",
+                    "name": "ConfigCustomAssistant/Components/VoiceTestComponent",
+                    "bundlerType": "module",
+                    "guiApi": 2,
+                    "hidden": "!data.voiceEnabled",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 8,
+                    "lg": 8,
+                    "xl": 8
                 }
             }
         },

package/build/lib/credentials.js

@@ -111,23 +111,28 @@ function str(v) {
     return '';
 }
 /**
- * Resolve the speech (STT/TTS) credentials for OpenAI, Azure and AWS.
+ * Resolve the speech (STT/TTS) credentials for OpenAI, OpenRouter, Azure and AWS.
  *  - 'manual':  the encrypted key/region config fields.
  *  - 'manager': the central credential store, keyed by the *CredentialId fields
  *               (azure values: { key, region }; aws values: { accessKeyId, secretAccessKey, region }).
- * `mainApiKey` is reused for OpenAI speech when no dedicated OpenAI speech credential is set and the
- * LLM provider is already OpenAI.
+ * The key of the cloud LLM (`llm`) is reused for OpenAI or OpenRouter speech when that speech vendor has no key of
+ * its own and the LLM is of the same vendor.
  */
-async function resolveVoiceCredentials(adapter, config, mainApiKey) {
-    const openaiFallback = config.provider === 'openai' ? mainApiKey : '';
+async function resolveVoiceCredentials(adapter, config, llm) {
+    const openaiFallback = llm?.provider === 'openai' ? llm.apiKey : '';
+    const openrouterFallback = llm?.provider === 'openrouter' ? llm.apiKey : '';
     if (config.voiceCredentialType === 'manager') {
         const openaiKey = config.voiceCredentialId
             ? await readCentralKey(adapter, config.voiceCredentialId)
             : openaiFallback;
+        const openrouterKey = config.openrouterCredentialId
+            ? await readCentralKey(adapter, config.openrouterCredentialId)
+            : openrouterFallback;
         const azure = config.azureCredentialId ? await readCentralValues(adapter, config.azureCredentialId) : {};
         const aws = config.awsCredentialId ? await readCentralValues(adapter, config.awsCredentialId) : {};
         return {
             openaiKey,
+            openrouterKey,
             azureKey: str(azure.key),
             azureRegion: str(azure.region),
             aws: {
@@ -139,6 +144,7 @@ async function resolveVoiceCredentials(adapter, config, mainApiKey) {
     }
     return {
         openaiKey: str(config.voiceApiKey) || openaiFallback,
+        openrouterKey: str(config.openrouterSpeechKey) || openrouterFallback,
         azureKey: str(config.azureSpeechKey),
         azureRegion: str(config.azureSpeechRegion),
         aws: {

package/build/lib/credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/lib/credentials.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resolve the LLM API key from the adapter config.\n *\n * Two modes (`config.credentialType`):\n *  - 'manual':  the key is stored directly in the (encrypted) adapter config (`config.apiKey`).\n *  - 'manager': the config only stores the ID of a credential in the central ioBroker\n *               credential store (`system.credentials.*`); the real key is resolved at runtime\n *               via the Credentials API.\n *\n * The central Credentials API (`Credentials.getCredentials`) is only available with\n * js-controller >= 7.2 / a recent \\@iobroker/adapter-core. We access it defensively so the\n * adapter still compiles and runs (in `manual` mode) on older controllers.\n */\nimport * as Credentials from '@iobroker/adapter-core/credentials';\nimport type { AdapterConfig } from '../types';\nimport type { VoiceCredentials } from './voice/engines';\n\n/** Read and decrypt a single credential's key from the central store; '' (and a warning) on error. */\nexport async function readCentralKey(adapter: ioBroker.Adapter, id: string): Promise<string> {\n    if (!id) {\n        return '';\n    }\n    if (!Credentials?.getCredentials) {\n        adapter.log.warn(`Cannot read credential \"${id}\": the central Credentials API needs js-controller >= 7.2`);\n        return '';\n    }\n    try {\n        const cred = await Credentials.getCredentials(adapter, id);\n        return ((cred?.values?.key as string) || '').trim();\n    } catch (e) {\n        adapter.log.warn(`Cannot read credential \"${id}\": ${(e as Error).message}`);\n        return '';\n    }\n}\n\n/**\n * Resolve the effective API key for the configured provider.\n * `overrideKey`/`overrideCredentialId` win over the stored config (used by the settings-dialog\n * Test button, where unsaved form values should be used).\n */\nexport async function resolveApiKey(\n    adapter: ioBroker.Adapter,\n    config: AdapterConfig,\n    override?: { credentialType?: 'manual' | 'manager'; apiKey?: string; credentialId?: string },\n): Promise<string> {\n    const mode = override?.credentialType || config.credentialType || 'manual';\n    if (mode === 'manager') {\n        const id = (override?.credentialId || config.credentialIdApiKey || '').trim();\n        return readCentralKey(adapter, id);\n    }\n    return (override?.apiKey || config.apiKey || '').trim();\n}\n\n/** Read and decrypt all fields of a credential from the central store; {} (and a warning) on error. */\nexport async function readCentralValues(adapter: ioBroker.Adapter, id: string): Promise<Record<string, unknown>> {\n    if (!id) {\n        return {};\n    }\n    if (!Credentials?.getCredentials) {\n        adapter.log.warn(`Cannot read credential \"${id}\": the central Credentials API needs js-controller >= 7.2`);\n        return {};\n    }\n    try {\n        const cred = await Credentials.getCredentials(adapter, id);\n        return cred?.values || {};\n    } catch (e) {\n        adapter.log.warn(`Cannot read credential \"${id}\": ${(e as Error).message}`);\n        return {};\n    }\n}\n\n/** Safe stringify of a credential/config field (values are strings/numbers/booleans). */\nfunction str(v: unknown): string {\n    if (typeof v === 'string') {\n        return v.trim();\n    }\n    if (typeof v === 'number' || typeof v === 'boolean') {\n        return String(v);\n    }\n    return '';\n}\n\n/**\n * Resolve the speech (STT/TTS) credentials for OpenAI, Azure and AWS.\n *  - 'manual':  the encrypted key/region config fields.\n *  - 'manager': the central credential store, keyed by the *CredentialId fields\n *               (azure values: { key, region }; aws values: { accessKeyId, secretAccessKey, region }).\n * `mainApiKey` is reused for OpenAI speech when no dedicated OpenAI speech credential is set and the\n * LLM provider is already OpenAI.\n */\nexport async function resolveVoiceCredentials(\n    adapter: ioBroker.Adapter,\n    config: AdapterConfig,\n    mainApiKey: string,\n): Promise<VoiceCredentials> {\n    const openaiFallback = config.provider === 'openai' ? mainApiKey : '';\n\n    if (config.voiceCredentialType === 'manager') {\n        const openaiKey = config.voiceCredentialId\n            ? await readCentralKey(adapter, config.voiceCredentialId)\n            : openaiFallback;\n        const azure = config.azureCredentialId ? await readCentralValues(adapter, config.azureCredentialId) : {};\n        const aws = config.awsCredentialId ? await readCentralValues(adapter, config.awsCredentialId) : {};\n        return {\n            openaiKey,\n            azureKey: str(azure.key),\n            azureRegion: str(azure.region),\n            aws: {\n                accessKeyId: str(aws.accessKeyId),\n                secretAccessKey: str(aws.secretAccessKey),\n                region: str(aws.region),\n            },\n        };\n    }\n\n    return {\n        openaiKey: str(config.voiceApiKey) || openaiFallback,\n        azureKey: str(config.azureSpeechKey),\n        azureRegion: str(config.azureSpeechRegion),\n        aws: {\n            accessKeyId: str(config.awsAccessKeyId),\n            secretAccessKey: str(config.awsSecretAccessKey),\n            region: str(config.awsRegion),\n        },\n    };\n}\n"]}
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/lib/credentials.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resolve the LLM API key from the adapter config.\n *\n * Two modes (`config.credentialType`):\n *  - 'manual':  the key is stored directly in the (encrypted) adapter config (`config.apiKey`).\n *  - 'manager': the config only stores the ID of a credential in the central ioBroker\n *               credential store (`system.credentials.*`); the real key is resolved at runtime\n *               via the Credentials API.\n *\n * The central Credentials API (`Credentials.getCredentials`) is only available with\n * js-controller >= 7.2 / a recent \\@iobroker/adapter-core. We access it defensively so the\n * adapter still compiles and runs (in `manual` mode) on older controllers.\n */\nimport * as Credentials from '@iobroker/adapter-core/credentials';\nimport type { AdapterConfig } from '../types';\nimport type { VoiceCredentials } from './voice/engines';\n\n/** Read and decrypt a single credential's key from the central store; '' (and a warning) on error. */\nexport async function readCentralKey(adapter: ioBroker.Adapter, id: string): Promise<string> {\n    if (!id) {\n        return '';\n    }\n    if (!Credentials?.getCredentials) {\n        adapter.log.warn(`Cannot read credential \"${id}\": the central Credentials API needs js-controller >= 7.2`);\n        return '';\n    }\n    try {\n        const cred = await Credentials.getCredentials(adapter, id);\n        return ((cred?.values?.key as string) || '').trim();\n    } catch (e) {\n        adapter.log.warn(`Cannot read credential \"${id}\": ${(e as Error).message}`);\n        return '';\n    }\n}\n\n/**\n * Resolve the effective API key for the configured provider.\n * `overrideKey`/`overrideCredentialId` win over the stored config (used by the settings-dialog\n * Test button, where unsaved form values should be used).\n */\nexport async function resolveApiKey(\n    adapter: ioBroker.Adapter,\n    config: AdapterConfig,\n    override?: { credentialType?: 'manual' | 'manager'; apiKey?: string; credentialId?: string },\n): Promise<string> {\n    const mode = override?.credentialType || config.credentialType || 'manual';\n    if (mode === 'manager') {\n        const id = (override?.credentialId || config.credentialIdApiKey || '').trim();\n        return readCentralKey(adapter, id);\n    }\n    return (override?.apiKey || config.apiKey || '').trim();\n}\n\n/** Read and decrypt all fields of a credential from the central store; {} (and a warning) on error. */\nexport async function readCentralValues(adapter: ioBroker.Adapter, id: string): Promise<Record<string, unknown>> {\n    if (!id) {\n        return {};\n    }\n    if (!Credentials?.getCredentials) {\n        adapter.log.warn(`Cannot read credential \"${id}\": the central Credentials API needs js-controller >= 7.2`);\n        return {};\n    }\n    try {\n        const cred = await Credentials.getCredentials(adapter, id);\n        return cred?.values || {};\n    } catch (e) {\n        adapter.log.warn(`Cannot read credential \"${id}\": ${(e as Error).message}`);\n        return {};\n    }\n}\n\n/** Safe stringify of a credential/config field (values are strings/numbers/booleans). */\nfunction str(v: unknown): string {\n    if (typeof v === 'string') {\n        return v.trim();\n    }\n    if (typeof v === 'number' || typeof v === 'boolean') {\n        return String(v);\n    }\n    return '';\n}\n\n/** Vendor and key of the cloud LLM the instance works with (its own, or the one of the system-wide AI settings) */\nexport interface LlmKey {\n    provider: string;\n    apiKey: string;\n}\n\n/**\n * Resolve the speech (STT/TTS) credentials for OpenAI, OpenRouter, Azure and AWS.\n *  - 'manual':  the encrypted key/region config fields.\n *  - 'manager': the central credential store, keyed by the *CredentialId fields\n *               (azure values: { key, region }; aws values: { accessKeyId, secretAccessKey, region }).\n * The key of the cloud LLM (`llm`) is reused for OpenAI or OpenRouter speech when that speech vendor has no key of\n * its own and the LLM is of the same vendor.\n */\nexport async function resolveVoiceCredentials(\n    adapter: ioBroker.Adapter,\n    config: AdapterConfig,\n    llm: LlmKey | null,\n): Promise<VoiceCredentials> {\n    const openaiFallback = llm?.provider === 'openai' ? llm.apiKey : '';\n    const openrouterFallback = llm?.provider === 'openrouter' ? llm.apiKey : '';\n\n    if (config.voiceCredentialType === 'manager') {\n        const openaiKey = config.voiceCredentialId\n            ? await readCentralKey(adapter, config.voiceCredentialId)\n            : openaiFallback;\n        const openrouterKey = config.openrouterCredentialId\n            ? await readCentralKey(adapter, config.openrouterCredentialId)\n            : openrouterFallback;\n        const azure = config.azureCredentialId ? await readCentralValues(adapter, config.azureCredentialId) : {};\n        const aws = config.awsCredentialId ? await readCentralValues(adapter, config.awsCredentialId) : {};\n        return {\n            openaiKey,\n            openrouterKey,\n            azureKey: str(azure.key),\n            azureRegion: str(azure.region),\n            aws: {\n                accessKeyId: str(aws.accessKeyId),\n                secretAccessKey: str(aws.secretAccessKey),\n                region: str(aws.region),\n            },\n        };\n    }\n\n    return {\n        openaiKey: str(config.voiceApiKey) || openaiFallback,\n        openrouterKey: str(config.openrouterSpeechKey) || openrouterFallback,\n        azureKey: str(config.azureSpeechKey),\n        azureRegion: str(config.azureSpeechRegion),\n        aws: {\n            accessKeyId: str(config.awsAccessKeyId),\n            secretAccessKey: str(config.awsSecretAccessKey),\n            region: str(config.awsRegion),\n        },\n    };\n}\n"]}

package/build/lib/llm.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LlmAgent = exports.PROVIDER_PRESETS = void 0;
+exports.LlmAgent = exports.OPENROUTER_HEADERS = exports.PROVIDER_PRESETS = void 0;
 exports.resolveProvider = resolveProvider;
 exports.effectiveApiKey = effectiveApiKey;
 const openai_1 = __importDefault(require("openai"));
@@ -19,8 +19,12 @@ exports.PROVIDER_PRESETS = {
         defaultModel: 'gemini-2.0-flash',
     },
     deepseek: { sdk: 'openai', baseUrl: 'https://api.deepseek.com', defaultModel: 'deepseek-chat' },
+    // OpenRouter names a model with its vendor in front
+    openrouter: { sdk: 'openai', baseUrl: 'https://openrouter.ai/api/v1', defaultModel: 'openai/gpt-4o-mini' },
     custom: { sdk: 'openai', baseUrl: '', defaultModel: '' },
 };
+/** OpenRouter shows the calling app in its statistics (same attribution as `@iobroker/ai-core`) */
+exports.OPENROUTER_HEADERS = { 'HTTP-Referer': 'https://www.iobroker.net', 'X-Title': 'ioBroker' };
 /** Resolve the effective SDK, base URL and default model for a provider (custom uses `configBaseUrl`). */
 function resolveProvider(provider, configBaseUrl) {
     const preset = exports.PROVIDER_PRESETS[provider || 'openai'] || exports.PROVIDER_PRESETS.openai;
@@ -103,7 +107,11 @@ class LlmAgent {
             this.anthropic = new sdk_1.default({ apiKey: opts.apiKey, baseURL: opts.baseUrl || undefined });
         }
         else {
-            this.openai = new openai_1.default({ apiKey: opts.apiKey, baseURL: opts.baseUrl || undefined });
+            this.openai = new openai_1.default({
+                apiKey: opts.apiKey,
+                baseURL: opts.baseUrl || undefined,
+                defaultHeaders: opts.provider === 'openrouter' ? exports.OPENROUTER_HEADERS : undefined,
+            });
         }
     }
     /** The model requests go to — empty until {@link ensureModel} has looked it up, if none was configured. */
@@ -302,7 +310,13 @@ class LlmAgent {
             }
             else {
                 const client = this.openai;
-                await client.models.list();
+                if (this.providerName === 'openrouter') {
+                    // its model list is public and accepts any key; /key needs a valid one
+                    await client.get('/key');
+                }
+                else {
+                    await client.models.list();
+                }
             }
             return { ok: true };
         }