iobroker.javascript 9.2.0 → 9.2.1

package/build/types.d.ts

@@ -35,6 +35,7 @@ export interface JavaScriptAdapterConfig {
     sortGlobalScriptsAlphabetically: boolean;
     gptKey: string;
     gptBaseUrl: string;
+    gptBaseUrlKey: string;
     claudeKey: string;
     geminiKey: string;
     deepseekKey: string;

package/docs/de/README.md

@@ -72,18 +72,76 @@ In den Adapter-Einstellungen unter "KI-Einstellungen" befinden sich API-Key-Feld
 | **Eigene API Base-URL** | Base-URL für eigene Anbieter (z.B. `http://localhost:11434/v1` für Ollama) |
 | **Eigener API-Schlüssel** | Optionaler API-Key für eigene Anbieter (Ollama benötigt keinen) |
 
-Es müssen nur die Keys der gewünschten Anbieter eingetragen werden. Jeder Anbieter hat einen eigenen **Test**-Button.
+Alle API-Key-Felder werden als Passwortfelder dargestellt (maskiert). Es müssen nur die Keys der gewünschten Anbieter eingetragen werden. Jeder Anbieter hat einen eigenen **Test**-Button.
+
+### Sicherheit der API-Schlüssel
+
+Die API-Keys werden durch zwei von der ioBroker-Plattform bereitgestellte Schutzebenen abgesichert:
+
+1. **`encryptedNative`** — Die Keys werden vor dem Schreiben in die Object-Datenbank automatisch mit dem System-Secret verschlüsselt. Datenbank-Dumps oder Object-Backups enthalten die Keys nicht mehr im Klartext.
+2. **`protectedNative`** — Die Keys werden niemals an Admin-Oberflächen oder fremde Adapter übertragen. Nur die `javascript`-Instanz selbst kann sie über `this.config` lesen (die ioBroker-Runtime liefert sie dort transparent entschlüsselt).
+
+Daraus folgt: Das KI-Chat-Panel, die Inline-Completion und alle anderen Frontend-Komponenten **greifen nicht mehr direkt auf die Keys zu**. Stattdessen wird jede KI-Anfrage per `sendTo` an den Adapter geschickt, und das Backend setzt den passenden Key ein:
+
+```
+Frontend                      Backend (this.config, entschlüsselt)
+────────                      ─────────────────────────────────────
+sendTo('chatCompletion', {    →   wählt Provider → nimmt gptKey/claudeKey/…
+    provider: 'openai',           → schickt HTTP-Request an Anbieter
+    model: 'gpt-4o',              → liefert Antwort zurück
+    messages: [...]
+})
+```
+
+Für die Anzeige steht ein eigener `sendTo`-Befehl zur Verfügung:
+
+| Befehl | Payload | Antwort |
+|--------|---------|---------|
+| `getAvailableAiProviders` | `{}` | `{ providers: [{ provider: 'openai' }, { provider: 'custom', baseUrl: '…' }, …] }` |
+
+Die Antwort teilt dem Frontend nur mit, **welche** Provider konfiguriert sind — der eigentliche Schlüssel ist darin nie enthalten. So lassen sich im Editor die richtigen Provider-Icons anzeigen und das Modell-Dropdown korrekt befüllen, ohne Secrets in den Browser zu laden.
+
+**Hinweis zum Upgrade:** Nach dem Upgrade von einer älteren Version bleiben vorhandene (unverschlüsselte) Keys so lange gültig, bis die Adapter-Einstellungen das erste Mal gespeichert werden. Beim Speichern verschlüsselt die Runtime die Werte. Sollte ein Schlüssel nach dem Upgrade leer erscheinen, genügt es, ihn einmal neu einzutragen und zu speichern.
 
 ### API-Verbindung testen
 
-Jeder Anbieter hat einen eigenen **Test**-Button neben seinem API-Key-Feld. Der Test:
+Jeder Anbieter hat einen eigenen **Test**-Button neben seinem API-Key-Feld. Es werden zwei Fälle unterschieden:
+
+1. **Test mit Formular-Wert** — Unmittelbar nach dem Eintragen oder Ändern eines Keys im Einstellungsdialog nutzt der `Test`-Button den aktuellen Formularwert (der liegt vor dem Speichern noch lokal im Browser). So kann ein neuer Key vor dem Persistieren geprüft werden.
+2. **Test mit gespeichertem Schlüssel** — Wird der Test aus Kontexten ohne Formular-Wert aufgerufen (z.B. beim Modell-Abruf im Skript-Editor), löst das Backend den Key über `this.config` anhand des gewählten Providers auf.
+
+Der Test:
 - Verbindet sich mit dem API-Endpunkt des Anbieters
 - Validiert den API-Schlüssel
-- Gibt die Anzahl der verfügbaren Modelle zurück
+- Gibt die Anzahl der verfügbaren Chat-Modelle zurück
+
+Die Icons der Test-Buttons sind als Inline-SVG-Data-URIs mit `fill="currentColor"` eingebettet. Dadurch folgt ihre Farbe automatisch dem aktiven Theme (Light/Dark-Mode).
 
 ### Dynamisches Laden der Modelle
 
-Beim Öffnen des KI-Codegenerator-Dialogs im Skript-Editor werden die verfügbaren Modelle automatisch vom konfigurierten API-Endpunkt abgerufen. Das Modell-Dropdown wird dynamisch befüllt — es gibt keine fest hinterlegte Modellliste.
+Beim Öffnen des KI-Codegenerator-Dialogs im Skript-Editor werden die verfügbaren Modelle automatisch von jedem konfigurierten Provider abgerufen. Das Modell-Dropdown wird dynamisch befüllt — es gibt keine fest hinterlegte Modellliste.
+
+#### Filter für nicht-Chat-Modelle
+
+Die Modelllisten, die OpenAI, Anthropic, Gemini, DeepSeek und Custom-Endpunkte (Ollama/LM Studio/OpenRouter) zurückliefern, enthalten viele Modelle, die nicht für Chat-Completion geeignet sind. Der Adapter filtert diese automatisch heraus, sodass im Dropdown nur Modelle erscheinen, die für die ioBroker-Skript-Generierung taugen.
+
+Folgende Kategorien werden ausgeschlossen:
+
+| Kategorie | Beispiel-Schlüsselwörter |
+|-----------|--------------------------|
+| Embeddings | `embedding`, `text-embedding`, `embeddinggemma`, `bge-`, `nomic-embed`, `mxbai-embed`, `arctic-embed`, `all-minilm`, `voyage-`, `gecko`, `paraphrase-multilingual` |
+| Bild-Generierung / -Bearbeitung | `dall-e`, `gpt-image`, `image-edit`, `-image-preview`, `-image-latest`, `flash-image`, `nano-banana`, `stable-diffusion`, `sdxl`, `midjourney`, `flux-`, `imagen` |
+| Video-Generierung | `sora`, `veo-`, `cogvideo`, `runway-`, `lumiere` |
+| Musik-Generierung | `lyria` |
+| Audio / Sprache / Transkription / Realtime | `whisper`, `tts-`, `-tts`, `speech-`, `audio-preview`, `-transcribe`, `native-audio`, `flash-live`, `gpt-audio`, `realtime`, `bark-`, `xtts`, `voicebox` |
+| Moderation / Safety-Klassifikatoren | `moderation`, `omni-moderation`, `llama-guard`, `shieldgemma`, `prompt-guard`, `-guardian`, `safeguard` |
+| Reranker | `rerank`, `reranker` |
+| Legacy-Completion (OpenAI GPT-3-Ära) | `babbage-`, `davinci-`, `curie-`, `text-davinci`, `instructgpt`, `code-davinci`, `code-cushman`, `-turbo-instruct` |
+| Web-Suche / Browsing-Endpoints | `-search-preview`, `-search-api` |
+| Legacy-Suche / Similarity | `code-search`, `text-search`, `similarity-` |
+| Spezial / Single-Task | `computer-use-preview`, `deep-research`, `robotics`, `aqa`, `reader-lm` (HTML→Markdown), `-nsql` (Text-zu-SQL), `minicheck` (Fact-Check), `claude-1`, `claude-instant` |
+
+Der Filter verwendet eine Substring-Prüfung ohne Beachtung der Groß-/Kleinschreibung. Wenn ein Provider künftig eine weitere Nicht-Chat-Familie einführt, lässt sich die Liste in `src-editor/src/AiChat/AiChatService.ts` (`NON_CHAT_KEYWORDS`) erweitern.
 
 ### Fehlerbehandlung
 

package/docs/en/README.md

@@ -73,18 +73,76 @@ In the adapter settings under "AI settings", you will find API key fields for ea
 | **Custom API Base URL** | Base URL for custom providers (e.g. `http://localhost:11434/v1` for Ollama) |
 | **Custom API key** | Optional API key for custom providers (Ollama doesn't need one) |
 
-Only enter the keys for providers you want to use. Each provider has its own **Test** button.
+All API key fields are rendered as password inputs (masked), and only the keys of providers you actually want to use need to be entered. Each provider has its own **Test** button.
+
+### API Key Security
+
+API keys are handled with two layers of protection provided by the ioBroker platform:
+
+1. **`encryptedNative`** — Keys are automatically encrypted using the system secret before being written to the object database. Database dumps or object backups no longer expose the raw keys.
+2. **`protectedNative`** — Keys are never transmitted to admin web UIs or foreign adapters. Only the `javascript` adapter instance itself can read them via `this.config` (where the ioBroker runtime delivers them transparently decrypted).
+
+Because of this, the AI Chat Panel, the inline completion provider, and any other frontend component **no longer access the keys directly**. Instead, they request AI services via a `sendTo` call and let the backend resolve the correct key:
+
+```
+Frontend                      Backend (this.config, decrypted)
+────────                      ───────────────────────────────
+sendTo('chatCompletion', {    →   looks up provider → picks gptKey/claudeKey/…
+    provider: 'openai',           → performs HTTP request to provider
+    model: 'gpt-4o',              → streams response back
+    messages: [...]               
+})
+```
+
+A dedicated `sendTo` command is available for discovery:
+
+| Command | Payload | Response |
+|---------|---------|----------|
+| `getAvailableAiProviders` | `{}` | `{ providers: [{ provider: 'openai' }, { provider: 'custom', baseUrl: '…' }, …] }` |
+
+The response lists only which providers have credentials configured — it never includes the keys themselves. This allows the UI to show the correct provider icons and populate the model dropdown without pulling secrets into the browser.
+
+**Upgrade note:** After upgrading from an earlier version, the existing (unencrypted) keys will remain working until the first time you save the adapter settings. When you save, the runtime re-encrypts them. If a key appears blank after the upgrade, re-enter it once in the settings dialog and save.
 
 ### Test API Connection
 
-Each provider has a dedicated **Test** button next to its API key field. The test will:
+Each provider has a dedicated **Test** button next to its API key field. Two cases are handled:
+
+1. **Form-value test** — Immediately after entering or editing a key in the settings dialog, the `Test` button uses the current form value (which is still in the browser before saving). This lets you verify a new key before persisting it.
+2. **Stored-key test** — When the button is invoked from contexts where no form value is available (e.g. the script editor during model discovery), the backend resolves the key from `this.config` based on the selected provider.
+
+The test will:
 - Connect to the provider's API endpoint
 - Validate the API key
-- Return the number of available models
+- Return the number of available chat models
+
+The test-button icons are embedded as inline SVG data URIs with `fill="currentColor"`, so their color automatically follows the active theme (light/dark mode).
 
 ### Dynamic Model Loading
 
-When opening the AI code generator dialog in the script editor, the available models are automatically fetched from the configured API endpoint. The model dropdown is populated dynamically — no hardcoded model list is used.
+When opening the AI code generator dialog in the script editor, the available models are automatically fetched from each configured provider. The model dropdown is populated dynamically — no hardcoded model list is used.
+
+#### Non-chat model filter
+
+The provider model lists returned by OpenAI, Anthropic, Gemini, DeepSeek, and custom (Ollama/LM Studio/OpenRouter) endpoints contain many models that cannot be used for chat completion. The adapter filters these automatically so that the dropdown only shows models suitable for ioBroker script generation.
+
+The following categories are excluded:
+
+| Category | Keyword examples |
+|----------|------------------|
+| Embeddings | `embedding`, `text-embedding`, `embeddinggemma`, `bge-`, `nomic-embed`, `mxbai-embed`, `arctic-embed`, `all-minilm`, `voyage-`, `gecko`, `paraphrase-multilingual` |
+| Image generation / editing | `dall-e`, `gpt-image`, `image-edit`, `-image-preview`, `-image-latest`, `flash-image`, `nano-banana`, `stable-diffusion`, `sdxl`, `midjourney`, `flux-`, `imagen` |
+| Video generation | `sora`, `veo-`, `cogvideo`, `runway-`, `lumiere` |
+| Music generation | `lyria` |
+| Audio / speech / transcribe / realtime | `whisper`, `tts-`, `-tts`, `speech-`, `audio-preview`, `-transcribe`, `native-audio`, `flash-live`, `gpt-audio`, `realtime`, `bark-`, `xtts`, `voicebox` |
+| Moderation / safety | `moderation`, `omni-moderation`, `llama-guard`, `shieldgemma`, `prompt-guard`, `-guardian`, `safeguard` |
+| Rerankers | `rerank`, `reranker` |
+| Legacy completion (OpenAI GPT-3 era) | `babbage-`, `davinci-`, `curie-`, `text-davinci`, `instructgpt`, `code-davinci`, `code-cushman`, `-turbo-instruct` |
+| Web search / browsing endpoints | `-search-preview`, `-search-api` |
+| Legacy search / similarity | `code-search`, `text-search`, `similarity-` |
+| Specialty / single-task | `computer-use-preview`, `deep-research`, `robotics`, `aqa`, `reader-lm` (HTML→Markdown), `-nsql` (text-to-SQL), `minicheck` (fact-check), `claude-1`, `claude-instant` |
+
+The filter uses case-insensitive substring matching. If a provider adds a new non-chat model family in the future, the list can be extended in `src-editor/src/AiChat/AiChatService.ts` (see `NON_CHAT_KEYWORDS`).
 
 ### Error Handling
 

package/io-package.json

@@ -1,7 +1,7 @@
 {
   "common": {
     "name": "javascript",
-    "version": "9.2.0",
+    "version": "9.2.1",
     "blockedVersions": [
       "8.0.0",
       "8.0.1"
@@ -40,6 +40,19 @@
       "Matthias Kleine <info@haus-automatisierung.com>"
     ],
     "news": {
+      "9.2.1": {
+        "en": "See previous changelog entries",
+        "de": "Siehe frühere Changelog-Einträge",
+        "ru": "См. предыдущие Changelog",
+        "pt": "Ver entradas anteriores do changelog",
+        "nl": "Zie vorige wijzigingenlog items",
+        "fr": "Voir les entrées précédentes du journal des modifications",
+        "it": "Vedere le precedenti voci di changelog",
+        "es": "Ver entradas de cambio anteriores",
+        "pl": "Zob. poprzednie wpisy dotyczące zmiennych",
+        "uk": "Переглянути попередні записи змін",
+        "zh-cn": "参见上一个更改日志条目"
+      },
       "9.2.0": {
         "en": "AI Chat panel with multi-provider support, tool calling, inline completions, and smart-apply\nFix: prevent duplicate 'Stopping script' log when script is not running\nFix: only restart scripts on the instance that owns them\nAdded OID display mode toggle for Blockly editor: 4 display modes (Name, Name path, State ID, Full ID) with toolbar dropdown, context menu, optional object icons, and translations in 11 languages\nNode 25 compatibility: replaced deprecated rmdirSync with rmSync in build tasks\nAdded support for plain import/export\nCorrecting error in configuration\ndisallow writing into node_modules folder by scripts\nCorrecting start of the script more than one time if restart is triggered\nAll delayed writings are stopped by the script stop\nAdded check if a script has been modified by another user/window\nMake the instance number more prominent",
         "de": "AI Chat-Panel mit Multi-Provider-Unterstützung, Werkzeuganruf, Inline-Vervollständigungen und intelligent-apply\nFix: verhindern Sie doppeltes 'Stopping script'-Log, wenn Skript nicht läuft\nFix: nur Skripte auf der Instanz neu starten, die sie besitzt\nOID-Anzeigemodus für Blockly Editor hinzugefügt: 4 Anzeigemodi (Name, Name Pfad, State ID, Full ID) mit Symbolleiste Dropdown, Kontextmenü, optionale Objektsymbole und Übersetzungen in 11 Sprachen\nNode 25 Kompatibilität: ersetzt deprecated rmdirSync mit rmSync in Build Aufgaben\nUnterstützung für den einfachen Import/Export\nFehler in der Konfiguration korrigieren\ndeaktivieren sie das schreiben in node modules ordner durch skripte\nKorrektur des Starts des Skripts mehr als ein Mal, wenn der Neustart ausgelöst wird\nAlle verzögerten Schriften werden durch den Skriptstop gestoppt\nCheck hinzugefügt, wenn ein Skript von einem anderen Benutzer/Fenster geändert wurde\nMachen Sie die Instanz Nummer prominenter",
@@ -341,6 +354,45 @@
           "agree",
           "cancel"
         ]
+      },
+      {
+        "condition": {
+          "operand": "and",
+          "rules": [
+            "oldVersion<=9.2.0",
+            "newVersion>9.2.0"
+          ]
+        },
+        "title": {
+          "en": "AI API keys must be re-entered",
+          "de": "AI-API-Schlüssel müssen erneut eingegeben werden",
+          "ru": "Ключи AI API необходимо ввести заново",
+          "pt": "As chaves da API de IA devem ser reinseridas",
+          "nl": "AI API-sleutels moeten opnieuw worden ingevoerd",
+          "fr": "Les clés API IA doivent être saisies à nouveau",
+          "it": "Le chiavi API AI devono essere reinserite",
+          "es": "Las claves de API de IA deben volver a introducirse",
+          "pl": "Klucze API AI muszą zostać ponownie wprowadzone",
+          "uk": "Ключі AI API необхідно ввести повторно",
+          "zh-cn": "AI API 密钥必须重新输入"
+        },
+        "text": {
+          "en": "The AI API keys (OpenAI, Anthropic, Gemini, DeepSeek) are now stored encrypted. If you had previously configured any AI API keys, you must re-enter them in the adapter settings under the \"AI settings\" tab.",
+          "de": "Die AI-API-Schlüssel (OpenAI, Anthropic, Gemini, DeepSeek) werden jetzt verschlüsselt gespeichert. Wenn Sie zuvor AI-API-Schlüssel konfiguriert haben, müssen Sie diese in den Adaptereinstellungen unter dem Tab \"AI-Einstellungen\" erneut eingeben.",
+          "ru": "Ключи AI API (OpenAI, Anthropic, Gemini, DeepSeek) теперь хранятся в зашифрованном виде. Если вы ранее настроили ключи AI API, вам необходимо повторно ввести их в настройках адаптера на вкладке \"Настройки AI\".",
+          "pt": "As chaves da API de IA (OpenAI, Anthropic, Gemini, DeepSeek) agora são armazenadas criptografadas. Se você configurou anteriormente chaves de API de IA, deve reinseri-las nas configurações do adaptador na aba \"Configurações de IA\".",
+          "nl": "De AI API-sleutels (OpenAI, Anthropic, Gemini, DeepSeek) worden nu versleuteld opgeslagen. Als u eerder AI API-sleutels heeft geconfigureerd, moet u deze opnieuw invoeren in de adapterinstellingen onder het tabblad \"AI-instellingen\".",
+          "fr": "Les clés API IA (OpenAI, Anthropic, Gemini, DeepSeek) sont désormais stockées de manière chiffrée. Si vous aviez précédemment configuré des clés API IA, vous devez les saisir à nouveau dans les paramètres de l'adaptateur sous l'onglet \"Paramètres IA\".",
+          "it": "Le chiavi API AI (OpenAI, Anthropic, Gemini, DeepSeek) sono ora memorizzate in modo crittografato. Se in precedenza erano state configurate chiavi API AI, è necessario reinserirle nelle impostazioni dell'adattatore nella scheda \"Impostazioni AI\".",
+          "es": "Las claves de API de IA (OpenAI, Anthropic, Gemini, DeepSeek) ahora se almacenan cifradas. Si previamente había configurado claves de API de IA, debe volver a introducirlas en la configuración del adaptador en la pestaña \"Configuración de IA\".",
+          "pl": "Klucze API AI (OpenAI, Anthropic, Gemini, DeepSeek) są teraz przechowywane w formie zaszyfrowanej. Jeśli wcześniej skonfigurowano klucze API AI, należy je ponownie wprowadzić w ustawieniach adaptera w zakładce \"Ustawienia AI\".",
+          "uk": "Ключі AI API (OpenAI, Anthropic, Gemini, DeepSeek) тепер зберігаються у зашифрованому вигляді. Якщо ви раніше налаштували ключі AI API, вам необхідно повторно ввести їх у налаштуваннях адаптера на вкладці \"Налаштування AI\".",
+          "zh-cn": "AI API 密钥（OpenAI、Anthropic、Gemini、DeepSeek）现在以加密方式存储。如果您之前配置了 AI API 密钥，则必须在适配器设置的\"AI 设置\"选项卡中重新输入。"
+        },
+        "level": "warn",
+        "buttons": [
+          "ok"
+        ]
       }
     ]
   },
@@ -467,10 +519,25 @@
     "maxTriggersPerScript": 100,
     "gptKey": "",
     "gptBaseUrl": "",
+    "gptBaseUrlKey": "",
     "claudeKey": "",
     "geminiKey": "",
     "deepseekKey": ""
   },
+  "encryptedNative": [
+    "gptKey",
+    "claudeKey",
+    "geminiKey",
+    "deepseekKey",
+    "gptBaseUrlKey"
+  ],
+  "protectedNative": [
+    "gptKey",
+    "claudeKey",
+    "geminiKey",
+    "deepseekKey",
+    "gptBaseUrlKey"
+  ],
   "objects": [
     {
       "_id": "_design/script",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.javascript",
-  "version": "9.2.0",
+  "version": "9.2.1",
   "description": "Rules Engine for ioBroker",
   "author": "bluefox <dogafox@gmail.com>",
   "contributors": [