npm - @fastybird/smart-panel-backend - Versions diffs - 0.12.0-alpha.0 → 1.0.0-beta.2 - Mend

@fastybird/smart-panel-backend 0.12.0-alpha.0 → 1.0.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1037) hide show

package/dist/plugins/buddy-discord/buddy-discord.plugin.js CHANGED Viewed

@@ -50,32 +50,44 @@ let BuddyDiscordPlugin = class BuddyDiscordPlugin {
             description: 'Discord bot adapter for Buddy module with multi-channel space mapping',
             author: 'FastyBird',
             capabilities: [buddy_constants_1.BuddyCapability.MESSAGING],
-            readme: `# Buddy Discord Plugin
+            readme: `# Discord
-Discord bot adapter plugin for the Buddy module. Enables remote conversations and alert forwarding via Discord with multi-channel space mapping.
+> Plugin · by FastyBird · capability: messaging
+Discord bot adapter for the Buddy module. Forwards alerts and supports remote conversations from any Discord client, with optional per-space channel mapping so messages in your "kitchen" channel are answered with the kitchen's context.
+## What you get
+- Talk to your home from anywhere Discord works — desktop, web, mobile
+- A dedicated channel per room so conversations stay tidy and context-aware (the assistant scopes the home snapshot to whichever space the channel maps to)
+- Alerts and suggestions are routed to the right channel automatically — leak in the bathroom? You'll see it in #bathroom, not #general
+- Granular access control: restrict the bot to a specific Discord role so only authorised users can issue commands
 ## Features
-- **Multi-Channel Support** - Map Discord channels to smart home spaces for context-aware conversations
-- **Remote Chat** - Interact with your smart home buddy from anywhere via Discord
-- **Alert Routing** - Receive suggestion notifications in the relevant space channel
-- **Role-Based Access** - Restrict bot interaction to users with a specific Discord role
+- **Multi-channel mapping** — map Discord channels to smart-home spaces for context-aware conversations
+- **Remote chat** — talk to Buddy from anywhere Discord runs
+- **Alert routing** — suggestion notifications land in the relevant space's channel
+- **Role-based access** — restrict who can interact via a Discord role
+- **Markdown-friendly replies** — Buddy's answers render cleanly in Discord (lists, code blocks, links)
+- **Thread-aware** — keeps replies in the originating thread when the message starts in one
 ## Setup
-1. Create a bot application at the [Discord Developer Portal](https://discord.com/developers/applications)
-2. Enable the "Message Content Intent" under Bot settings
-3. Copy the bot token
-4. Add the bot to your server with required permissions (Send Messages, Read Messages, Add Reactions)
-5. Enable the plugin and configure the bot token, guild ID, and channel mappings
+1. Create a bot at the [Discord Developer Portal](https://discord.com/developers/applications)
+2. Enable the **Message Content Intent** under Bot settings and copy the bot token
+3. Invite the bot to your server with the *Send Messages*, *Read Messages* and *Add Reactions* permissions
+4. Enable the plugin and fill in the configuration
 ## Configuration
-- **Bot Token** - Discord bot token from the Developer Portal (required)
-- **Guild ID** - Discord server ID (required)
-- **General Channel ID** - Default channel for cross-space queries (required)
-- **Space-Channel Mappings** - JSON mapping of space IDs to Discord channel IDs
-- **Allowed Role ID** - Discord role required to interact (empty = allow all server members)`,
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`bot_token\` | Discord bot token (required) | — |
+| \`guild_id\` | Discord server ID (required) | — |
+| \`general_channel_id\` | Default channel for cross-space queries (required) | — |
+| \`space_channel_mappings\` | JSON map of space IDs → Discord channel IDs | \`{}\` |
+| \`allowed_role_id\` | Discord role required to interact | unrestricted |`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/plugins/buddy-discord/buddy-discord.plugin.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"buddy-discord.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-discord/buddy-discord.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,qHAA+G;AAC/G,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,uEAImC;AACnC,mEAAoF;AACpF,+DAAsE;AACtE,wDAAgE;AAChE,2EAAsE;AACtE,kGAA4F;AAYrF,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC9B,YACkB,YAAsC,EACtC,kBAAsC,EACtC,eAA6C,EAC7C,iBAAoC,EACpC,oBAAiD;QAJjD,iBAAY,GAAZ,YAAY,CAA0B;QACtC,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,yBAAoB,GAApB,oBAAoB,CAA6B;IAChE,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAuD;YACvF,IAAI,EAAE,mDAAyB;YAC/B,KAAK,EAAE,sCAAuB;YAC9B,SAAS,EAAE,+CAA2B;SACtC,CAAC,CAAC;QAEH,KAAK,MAAM,KAAK,IAAI,iEAAyC,EAAE,CAAC;YAC/D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,mDAAyB;YAC/B,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uEAAuE;YACpF,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,SAAS,CAAC;YACzC,MAAM,EAAE~~;;;;;;;;;;;;;;;;;;;;;;;;;6FAyBkF~~;~~YAC1F~~,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;QAIH,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC7D,CAAC;CACD,CAAA;~~AA9DY~~,gDAAkB;6BAAlB,kBAAkB;IAV9B,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,mDAAyB;QAClC,WAAW,EAAE,2DAAiC;QAC9C,WAAW,EAAE,kEAAwC;KACrD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,yCAAkB,EAAE,gEAA6B,CAAC;QAC9D,OAAO,EAAE,CAAC,yCAAkB,CAAC;KAC7B,CAAC;qCAG+B,sDAAwB;QAClB,yCAAkB;QACrB,8DAA4B;QAC1B,sCAAiB;QACd,4DAA2B;GANvD,kBAAkB,~~CA8D9B~~"}
1	+ {"version":3,"file":"buddy-discord.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-discord/buddy-discord.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,qHAA+G;AAC/G,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,uEAImC;AACnC,mEAAoF;AACpF,+DAAsE;AACtE,wDAAgE;AAChE,2EAAsE;AACtE,kGAA4F;AAYrF,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC9B,YACkB,YAAsC,EACtC,kBAAsC,EACtC,eAA6C,EAC7C,iBAAoC,EACpC,oBAAiD;QAJjD,iBAAY,GAAZ,YAAY,CAA0B;QACtC,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,yBAAoB,GAApB,oBAAoB,CAA6B;IAChE,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAuD;YACvF,IAAI,EAAE,mDAAyB;YAC/B,KAAK,EAAE,sCAAuB;YAC9B,SAAS,EAAE,+CAA2B;SACtC,CAAC,CAAC;QAEH,KAAK,MAAM,KAAK,IAAI,iEAAyC,EAAE,CAAC;YAC/D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,mDAAyB;YAC/B,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uEAAuE;YACpF,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,SAAS,CAAC;YACzC,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2EAqCgE;YACxE,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;QAIH,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC7D,CAAC;CACD,CAAA;AA1EY,gDAAkB;6BAAlB,kBAAkB;IAV9B,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,mDAAyB;QAClC,WAAW,EAAE,2DAAiC;QAC9C,WAAW,EAAE,kEAAwC;KACrD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,yCAAkB,EAAE,gEAA6B,CAAC;QAC9D,OAAO,EAAE,CAAC,yCAAkB,CAAC;KAC7B,CAAC;qCAG+B,sDAAwB;QAClB,yCAAkB;QACrB,8DAA4B;QAC1B,sCAAiB;QACd,4DAA2B;GANvD,kBAAkB,CA0E9B"}

package/dist/plugins/buddy-elevenlabs/buddy-elevenlabs.plugin.js CHANGED Viewed

@@ -56,27 +56,38 @@ let BuddyElevenlabsPlugin = class BuddyElevenlabsPlugin {
             description: 'STT and TTS provider for Buddy module using ElevenLabs API',
             author: 'FastyBird',
             capabilities: [buddy_constants_1.BuddyCapability.STT, buddy_constants_1.BuddyCapability.TTS],
-            readme: `# Buddy ElevenLabs Provider
+            readme: `# ElevenLabs
-STT and TTS provider plugin for the Buddy module using the ElevenLabs API.
+> Plugin · by FastyBird · capabilities: STT, TTS
-## Features
+ElevenLabs as both a speech-to-text and text-to-speech provider for the Buddy module. Uses the Scribe v2 model for transcription across 99 languages and ElevenLabs' high-quality neural voices for synthesis — easily the most realistic voice option in the bundle.
-- **Speech-to-Text** - Accurate transcription using the Scribe v2 model across 99 languages
-- **High-Quality Voices** - Natural-sounding text-to-speech
-- **Multiple Voices** - Choose from various voice profiles
+## What you get
+- Best-in-class voice quality for the assistant's spoken replies
+- Multilingual transcription with Scribe v2 (99 languages) so the panel works for non-English households out of the box
+- Configurable voice — pick any ElevenLabs voice (default, premade or cloned) by pasting its voice ID
+- Fully cloud-hosted: no on-device GPU required for high-quality voice
+## Capabilities
+- **TTS** — neural synthesis with the chosen voice; streaming where supported
+- **STT** — Scribe v2 transcription with automatic language detection
+- **Pair freely** — combine with any LLM provider (Claude, OpenAI, Ollama) for the chat brain
 ## Setup
 1. Create an account at [ElevenLabs](https://elevenlabs.io)
-2. Generate an API key from your account dashboard
-3. Enter the API key in plugin configuration
-4. Set the buddy module \`stt_plugin\` and/or \`tts_plugin\` to \`${buddy_elevenlabs_constants_1.BUDDY_ELEVENLABS_PLUGIN_NAME}\`
+2. Generate an API key from your dashboard
+3. Enter the API key in this plugin's configuration
+4. Set Buddy's \`stt_plugin\` and/or \`tts_plugin\` to \`${buddy_elevenlabs_constants_1.BUDDY_ELEVENLABS_PLUGIN_NAME}\`
 ## Configuration
-- **API Key** - Your ElevenLabs API key (required)
-- **Voice ID** - ElevenLabs voice ID for TTS (auto-detected if not set)`,
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`api_key\` | ElevenLabs API key (required) | — |
+| \`voice_id\` | Voice ID used for TTS | auto-detected |`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/plugins/buddy-elevenlabs/buddy-elevenlabs.plugin.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"buddy-elevenlabs.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-elevenlabs/buddy-elevenlabs.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,8GAAwG;AACxG,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,6EAIsC;AACtC,yEAA0F;AAC1F,+DAAyE;AACzE,wDAAmE;AACnE,iFAA4E;AAC5E,iFAA4E;AAC5E,wGAAkG;AAY3F,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACjC,YACkB,YAAsC,EACtC,mBAA+C,EAC/C,mBAA+C,EAC/C,qBAA4C,EAC5C,qBAA4C,EAC5C,eAA6C,EAC7C,iBAAoC;QANpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAA6D;YAC7F,IAAI,EAAE,yDAA4B;YAClC,KAAK,EAAE,yCAA0B;YACjC,SAAS,EAAE,kDAA8B;SACzC,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC9D,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAE9D,KAAK,MAAM,KAAK,IAAI,uEAA4C,EAAE,CAAC;YAClE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,yDAA4B;YAClC,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,4DAA4D;YACzE,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,GAAG,EAAE,iCAAe,CAAC,GAAG,CAAC;YACxD,MAAM,EAAE~~;;;;;;;;;;;;;;;oEAeyD~~,yDAA4B~~;;;;;wEAKxB~~;~~YACrE~~,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;~~AA1DY~~,sDAAqB;gCAArB,qBAAqB;IAVjC,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,yDAA4B;QACrC,WAAW,EAAE,iEAAoC;QACjD,WAAW,EAAE,wEAA2C;KACxD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,+CAAqB,EAAE,+CAAqB,EAAE,sEAAgC,CAAC;QAC3F,OAAO,EAAE,CAAC,+CAAqB,EAAE,+CAAqB,CAAC;KACvD,CAAC;qCAG+B,sDAAwB;QACjB,0DAA0B;QAC1B,0DAA0B;QACxB,+CAAqB;QACrB,+CAAqB;QAC3B,8DAA4B;QAC1B,sCAAiB;GAR1C,qBAAqB,~~CA0DjC~~"}
1	+ {"version":3,"file":"buddy-elevenlabs.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-elevenlabs/buddy-elevenlabs.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,8GAAwG;AACxG,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,6EAIsC;AACtC,yEAA0F;AAC1F,+DAAyE;AACzE,wDAAmE;AACnE,iFAA4E;AAC5E,iFAA4E;AAC5E,wGAAkG;AAY3F,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACjC,YACkB,YAAsC,EACtC,mBAA+C,EAC/C,mBAA+C,EAC/C,qBAA4C,EAC5C,qBAA4C,EAC5C,eAA6C,EAC7C,iBAAoC;QANpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAA6D;YAC7F,IAAI,EAAE,yDAA4B;YAClC,KAAK,EAAE,yCAA0B;YACjC,SAAS,EAAE,kDAA8B;SACzC,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC9D,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAE9D,KAAK,MAAM,KAAK,IAAI,uEAA4C,EAAE,CAAC;YAClE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,yDAA4B;YAClC,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,4DAA4D;YACzE,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,GAAG,EAAE,iCAAe,CAAC,GAAG,CAAC;YACxD,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;2DAwBgD,yDAA4B;;;;;;;yDAO9B;YACtD,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AArEY,sDAAqB;gCAArB,qBAAqB;IAVjC,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,yDAA4B;QACrC,WAAW,EAAE,iEAAoC;QACjD,WAAW,EAAE,wEAA2C;KACxD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,+CAAqB,EAAE,+CAAqB,EAAE,sEAAgC,CAAC;QAC3F,OAAO,EAAE,CAAC,+CAAqB,EAAE,+CAAqB,CAAC;KACvD,CAAC;qCAG+B,sDAAwB;QACjB,0DAA0B;QAC1B,0DAA0B;QACxB,+CAAqB;QACrB,+CAAqB;QAC3B,8DAA4B;QAC1B,sCAAiB;GAR1C,qBAAqB,CAqEjC"}

package/dist/plugins/buddy-ollama/buddy-ollama.plugin.js CHANGED Viewed

@@ -49,27 +49,43 @@ let BuddyOllamaPlugin = class BuddyOllamaPlugin {
             name: 'Ollama',
             description: 'LLM provider for Buddy module using local Ollama inference',
             author: 'FastyBird',
-            readme: `# Buddy Ollama Provider
+            readme: `# Ollama
-LLM provider plugin for the Buddy module using local Ollama inference.
+> Plugin · by FastyBird · capability: LLM
-## Features
+Run an LLM provider locally via [Ollama](https://ollama.ai). Supports Llama, Mistral, CodeLlama and any other model Ollama can serve. No API key, no per-request fee, and — most importantly — no data leaves your network.
-- **Local LLM** - Run AI models locally without cloud APIs
-- **Multiple Models** - Support for Llama, Mistral, CodeLlama, and more
-- **No API Key Required** - Completely offline operation
+## What you get
+- A 100% local assistant: prompts, your home snapshot and replies all stay on the host running Ollama
+- Zero recurring cost — the only resource is your CPU / GPU
+- Free choice of model: pull whichever Ollama-compatible model fits your hardware (\`llama3\`, \`llama3.1\`, \`mistral\`, \`qwen\`, \`phi\`, …) and switch by changing one config value
+- Works with a remote Ollama server too — point \`base_url\` at any reachable host and Buddy talks to it transparently
+## Capabilities
+- **LLM (chat)** — streaming completions backed by Ollama
+- **Tool calling** — uses Ollama's tool-call protocol where the chosen model supports it; falls back gracefully when it doesn't
+- **No outbound traffic** — when Ollama runs on the same host, Buddy never reaches the public internet
+## Tradeoffs
+- Quality and speed depend entirely on the model and the host's hardware; small machines should pick small models
+- Tool-calling fidelity varies between models; if scenes / device control aren't dispatched cleanly, try a larger / instruction-tuned model
 ## Setup
-1. Install [Ollama](https://ollama.ai) on your system
-2. Pull a model: \`ollama pull llama3\`
-3. Enable this plugin in configuration
-4. Set the buddy module \`provider\` to \`${buddy_ollama_constants_1.BUDDY_OLLAMA_PLUGIN_NAME}\`
+1. Install Ollama on the host running the backend (or any reachable machine)
+2. Pull at least one model — for example \`ollama pull llama3\`
+3. Enable this plugin
+4. Set Buddy's \`provider\` to \`${buddy_ollama_constants_1.BUDDY_OLLAMA_PLUGIN_NAME}\`
 ## Configuration
-- **Model** - Model name to use (default: llama3)
-- **Base URL** - Ollama API endpoint (default: http://localhost:11434)`,
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`model\` | Ollama model name | \`llama3\` |
+| \`base_url\` | Ollama HTTP endpoint | \`http://localhost:11434\` |`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/plugins/buddy-ollama/buddy-ollama.plugin.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"buddy-ollama.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-ollama/buddy-ollama.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,mEAA+D;AAC/D,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,qEAIkC;AAClC,iEAAkF;AAClF,+DAAqE;AACrE,wDAA+D;AAC/D,iEAA6D;AAC7D,gGAA0F;AAYnF,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC7B,YACkB,YAAsC,EACtC,gBAA4C,EAC5C,cAA8B,EAC9B,eAA6C,EAC7C,iBAAoC;QAJpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,qBAAgB,GAAhB,gBAAgB,CAA4B;QAC5C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAqD;YACrF,IAAI,EAAE,iDAAwB;YAC9B,KAAK,EAAE,qCAAsB;YAC7B,SAAS,EAAE,8CAA0B;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAEpD,KAAK,MAAM,KAAK,IAAI,+DAAwC,EAAE,CAAC;YAC9D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,iDAAwB;YAC9B,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4DAA4D;YACzE,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE~~;;;;;;;;;;;;;;;4CAeiC~~,iDAAwB~~;;;;;uEAKG~~;~~YACpE~~,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;~~AAtDY~~,8CAAiB;4BAAjB,iBAAiB;IAV7B,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,iDAAwB;QACjC,WAAW,EAAE,yDAAgC;QAC7C,WAAW,EAAE,gEAAuC;KACpD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,gCAAc,EAAE,8DAA4B,CAAC;QACzD,OAAO,EAAE,CAAC,gCAAc,CAAC;KACzB,CAAC;qCAG+B,sDAAwB;QACpB,0DAA0B;QAC5B,gCAAc;QACb,8DAA4B;QAC1B,sCAAiB;GAN1C,iBAAiB,~~CAsD7B~~"}
1	+ {"version":3,"file":"buddy-ollama.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-ollama/buddy-ollama.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,mEAA+D;AAC/D,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,qEAIkC;AAClC,iEAAkF;AAClF,+DAAqE;AACrE,wDAA+D;AAC/D,iEAA6D;AAC7D,gGAA0F;AAYnF,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC7B,YACkB,YAAsC,EACtC,gBAA4C,EAC5C,cAA8B,EAC9B,eAA6C,EAC7C,iBAAoC;QAJpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,qBAAgB,GAAhB,gBAAgB,CAA4B;QAC5C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAqD;YACrF,IAAI,EAAE,iDAAwB;YAC9B,KAAK,EAAE,qCAAsB;YAC7B,SAAS,EAAE,8CAA0B;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAEpD,KAAK,MAAM,KAAK,IAAI,+DAAwC,EAAE,CAAC;YAC9D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,iDAAwB;YAC9B,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4DAA4D;YACzE,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA6BwB,iDAAwB;;;;;;;qEAOU;YAClE,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AAtEY,8CAAiB;4BAAjB,iBAAiB;IAV7B,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,iDAAwB;QACjC,WAAW,EAAE,yDAAgC;QAC7C,WAAW,EAAE,gEAAuC;KACpD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,gCAAc,EAAE,8DAA4B,CAAC;QACzD,OAAO,EAAE,CAAC,gCAAc,CAAC;KACzB,CAAC;qCAG+B,sDAAwB;QACpB,0DAA0B;QAC5B,gCAAc;QACb,8DAA4B;QAC1B,sCAAiB;GAN1C,iBAAiB,CAsE7B"}

package/dist/plugins/buddy-openai/buddy-openai.plugin.js CHANGED Viewed

@@ -61,30 +61,39 @@ let BuddyOpenaiPlugin = class BuddyOpenaiPlugin {
             description: 'LLM, STT, and TTS provider for Buddy module using OpenAI API',
             author: 'FastyBird',
             capabilities: [buddy_constants_1.BuddyCapability.LLM, buddy_constants_1.BuddyCapability.STT, buddy_constants_1.BuddyCapability.TTS],
-            readme: `# Buddy OpenAI Provider
+            readme: `# OpenAI
-LLM and TTS provider plugin for the Buddy module using the OpenAI API.
+> Plugin · by FastyBird · capabilities: LLM, STT, TTS
-## Features
+OpenAI as an all-in-one provider for the Buddy module — chat completions via GPT, transcription via Whisper, and synthesis via the TTS API (\`alloy\`, \`echo\`, \`fable\`, \`onyx\`, \`nova\`, \`shimmer\`). One API key unlocks the whole assistant experience.
-- **GPT Models** - Access to GPT-4o, GPT-4o-mini, and other OpenAI models
-- **Chat Completions** - Powers Buddy text chat conversations
-- **Speech-to-Text** - OpenAI Whisper API for voice input transcription
-- **Text-to-Speech** - OpenAI TTS API for voice output (alloy, echo, fable, onyx, nova, shimmer voices)
+## What you get
+- A single key that powers chat, voice input and voice output, so Buddy is a complete experience without juggling three providers
+- High-quality streaming chat with native tool calling — the model can drive your devices and scenes through structured calls
+- Server-side speech recognition with Whisper for hands-free interaction on the panel
+- A choice of six TTS voices to match the personality you want for your home
+## Capabilities
+- **LLM (chat)** — streaming completions; native tool calls for device / scene control
+- **STT (speech-to-text)** — Whisper transcription of microphone audio captured on the panel
+- **TTS (text-to-speech)** — six voices, configurable per deployment
+- **Per-capability fan-out** — you can use OpenAI for any subset (just LLM, just TTS, …) and pair it with other providers for the rest
 ## Setup
-1. Create an account at [OpenAI](https://platform.openai.com)
-2. Generate an API key from your account dashboard
-3. Enter the API key in plugin configuration
-4. Set the buddy module \`provider\` to \`${buddy_openai_constants_1.BUDDY_OPENAI_PLUGIN_NAME}\` for chat
-5. Set the buddy module \`stt_plugin\` to \`${buddy_openai_constants_1.BUDDY_OPENAI_PLUGIN_NAME}\` for STT
-6. Set the buddy module \`tts_plugin\` to \`${buddy_openai_constants_1.BUDDY_OPENAI_PLUGIN_NAME}\` for TTS
+1. Create an account at [OpenAI Platform](https://platform.openai.com)
+2. Generate an API key in your dashboard
+3. Enter the API key in this plugin's configuration
+4. Set Buddy's \`provider\`, \`stt_plugin\` and/or \`tts_plugin\` to \`${buddy_openai_constants_1.BUDDY_OPENAI_PLUGIN_NAME}\` for the capabilities you want to use
 ## Configuration
-- **API Key** - Your OpenAI API key (required)
-- **Model** - Model name to use (default: gpt-4o)`,
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`api_key\` | OpenAI API key (required) | — |
+| \`model\` | Model used for chat completions | \`gpt-4o\` |`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/plugins/buddy-openai/buddy-openai.plugin.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"buddy-openai.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-openai/buddy-openai.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,8GAAwG;AACxG,8GAAwG;AACxG,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,qEAIkC;AAClC,iEAAkF;AAClF,+DAAqE;AACrE,wDAA+D;AAC/D,yEAAoE;AACpE,yEAAoE;AACpE,iEAA6D;AAC7D,gGAA0F;AAYnF,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC7B,YACkB,YAAsC,EACtC,mBAA+C,EAC/C,mBAA+C,EAC/C,mBAA+C,EAC/C,cAA8B,EAC9B,iBAAoC,EACpC,iBAAoC,EACpC,eAA6C,EAC7C,iBAAoC;QARpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAqD;YACrF,IAAI,EAAE,iDAAwB;YAC9B,KAAK,EAAE,qCAAsB;YAC7B,SAAS,EAAE,8CAA0B;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvD,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC1D,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAE1D,KAAK,MAAM,KAAK,IAAI,+DAAwC,EAAE,CAAC;YAC9D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,iDAAwB;YAC9B,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8DAA8D;YAC3E,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,GAAG,EAAE,iCAAe,CAAC,GAAG,EAAE,iCAAe,CAAC,GAAG,CAAC;YAC7E,MAAM,EAAE~~;;;;;;;;;;;;;;;;4CAgBiC~~,iDAAwB;~~8CACtB~~,~~iDAAwB;8CACxB,iDAAwB;;;;;kDAKpB;YAC/C,~~KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;~~AAhEY~~,8CAAiB;4BAAjB,iBAAiB;IAV7B,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,iDAAwB;QACjC,WAAW,EAAE,yDAAgC;QAC7C,WAAW,EAAE,gEAAuC;KACpD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,gCAAc,EAAE,uCAAiB,EAAE,uCAAiB,EAAE,8DAA4B,CAAC;QAC/F,OAAO,EAAE,CAAC,gCAAc,EAAE,uCAAiB,EAAE,uCAAiB,CAAC;KAC/D,CAAC;qCAG+B,sDAAwB;QACjB,0DAA0B;QAC1B,0DAA0B;QAC1B,0DAA0B;QAC/B,gCAAc;QACX,uCAAiB;QACjB,uCAAiB;QACnB,8DAA4B;QAC1B,sCAAiB;GAV1C,iBAAiB,~~CAgE7B~~"}
1	+ {"version":3,"file":"buddy-openai.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-openai/buddy-openai.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,8GAAwG;AACxG,8GAAwG;AACxG,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,qEAIkC;AAClC,iEAAkF;AAClF,+DAAqE;AACrE,wDAA+D;AAC/D,yEAAoE;AACpE,yEAAoE;AACpE,iEAA6D;AAC7D,gGAA0F;AAYnF,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC7B,YACkB,YAAsC,EACtC,mBAA+C,EAC/C,mBAA+C,EAC/C,mBAA+C,EAC/C,cAA8B,EAC9B,iBAAoC,EACpC,iBAAoC,EACpC,eAA6C,EAC7C,iBAAoC;QARpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAqD;YACrF,IAAI,EAAE,iDAAwB;YAC9B,KAAK,EAAE,qCAAsB;YAC7B,SAAS,EAAE,8CAA0B;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvD,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC1D,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAE1D,KAAK,MAAM,KAAK,IAAI,+DAAwC,EAAE,CAAC;YAC9D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,iDAAwB;YAC9B,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8DAA8D;YAC3E,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,GAAG,EAAE,iCAAe,CAAC,GAAG,EAAE,iCAAe,CAAC,GAAG,CAAC;YAC7E,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;yEAyB8D,iDAAwB;;;;;;;6DAOpC;YAC1D,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AAzEY,8CAAiB;4BAAjB,iBAAiB;IAV7B,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,iDAAwB;QACjC,WAAW,EAAE,yDAAgC;QAC7C,WAAW,EAAE,gEAAuC;KACpD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,gCAAc,EAAE,uCAAiB,EAAE,uCAAiB,EAAE,8DAA4B,CAAC;QAC/F,OAAO,EAAE,CAAC,gCAAc,EAAE,uCAAiB,EAAE,uCAAiB,CAAC;KAC/D,CAAC;qCAG+B,sDAAwB;QACjB,0DAA0B;QAC1B,0DAA0B;QAC1B,0DAA0B;QAC/B,gCAAc;QACX,uCAAiB;QACjB,uCAAiB;QACnB,8DAA4B;QAC1B,sCAAiB;GAV1C,iBAAiB,CAyE7B"}

package/dist/plugins/buddy-openai/platforms/openai.provider.js CHANGED Viewed

@@ -52,6 +52,7 @@ let OpenAiProvider = class OpenAiProvider {
         return {
             content: result.content,
             toolCalls: result.toolCalls,
+            toolErrors: result.toolErrors,
             meta: {
                 provider: buddy_openai_constants_1.BUDDY_OPENAI_PLUGIN_NAME,
                 model: result.model,

package/dist/plugins/buddy-openai/platforms/openai.provider.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"openai.provider.js","sourceRoot":"","sources":["../../../../src/plugins/buddy-openai/platforms/openai.provider.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAQ5C,wFAAsF;AACtF,oFAAgF;AAChF,sEAImC;AAI5B,IAAM,cAAc,GAApB,MAAM,cAAc;IAC1B,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAE7D,OAAO;QACN,OAAO,iDAAwB,CAAC;IACjC,CAAC;IAED,OAAO;QACN,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,cAAc;QACb,OAAO,gEAAuC,CAAC;IAChD,CAAC;IAED,eAAe;QACd,OAAO,mDAA0B,CAAC;IACnC,CAAC;IAED,YAAY,CAAC,YAAqC;QACjD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QAEnC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,aAAa;QACZ,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,WAAW,CAChB,YAAoB,EACpB,QAAuB,EACvB,KAAa,EACb,OAAoB;QAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;QAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,EAAE,KAAK,IAAI,KAAK,CAAC;QAC7C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC;QAE3C,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;QAE7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAA,oCAAiB,EACrC,MAAM,EACN,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,OAAO,EAAE,KAAK,CACd,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAEtC,OAAO;YACN,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE;gBACL,QAAQ,EAAE,iDAAwB;gBAClC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,UAAU;gBACV,eAAe,EAAE,IAAI;gBACrB,gBAAgB,EAAE,IAAI;aACtB;SACD,CAAC;IACH,CAAC;IAEO,eAAe;QACtB,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,CAAyB,iDAAwB,CAAC,CAAC;QAC7F,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;CACD,CAAA;~~AAlFY~~,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;qCAEgC,8BAAa;GAD7C,cAAc,~~CAkF1B~~"}
1	+ {"version":3,"file":"openai.provider.js","sourceRoot":"","sources":["../../../../src/plugins/buddy-openai/platforms/openai.provider.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAQ5C,wFAAsF;AACtF,oFAAgF;AAChF,sEAImC;AAI5B,IAAM,cAAc,GAApB,MAAM,cAAc;IAC1B,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAE7D,OAAO;QACN,OAAO,iDAAwB,CAAC;IACjC,CAAC;IAED,OAAO;QACN,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,cAAc;QACb,OAAO,gEAAuC,CAAC;IAChD,CAAC;IAED,eAAe;QACd,OAAO,mDAA0B,CAAC;IACnC,CAAC;IAED,YAAY,CAAC,YAAqC;QACjD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QAEnC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,aAAa;QACZ,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,WAAW,CAChB,YAAoB,EACpB,QAAuB,EACvB,KAAa,EACb,OAAoB;QAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;QAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,EAAE,KAAK,IAAI,KAAK,CAAC;QAC7C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC;QAE3C,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;QAE7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAA,oCAAiB,EACrC,MAAM,EACN,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,OAAO,EAAE,KAAK,CACd,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAEtC,OAAO;YACN,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,IAAI,EAAE;gBACL,QAAQ,EAAE,iDAAwB;gBAClC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,UAAU;gBACV,eAAe,EAAE,IAAI;gBACrB,gBAAgB,EAAE,IAAI;aACtB;SACD,CAAC;IACH,CAAC;IAEO,eAAe;QACtB,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,CAAyB,iDAAwB,CAAC,CAAC;QAC7F,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;CACD,CAAA;AAnFY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;qCAEgC,8BAAa;GAD7C,cAAc,CAmF1B"}

package/dist/plugins/buddy-openai-codex/buddy-openai-codex.plugin.js CHANGED Viewed

@@ -50,31 +50,42 @@ let BuddyOpenaiCodexPlugin = class BuddyOpenaiCodexPlugin {
             name: 'OpenAI Codex',
             description: 'LLM provider for Buddy module using OpenAI Codex with OAuth authentication',
             author: 'FastyBird',
-            readme: `# Buddy OpenAI Codex Provider
+            readme: `# OpenAI Codex
-LLM provider plugin for the Buddy module using the OpenAI Codex API with OAuth authentication.
+> Plugin · by FastyBird · capability: LLM
-## Features
+OpenAI Codex as an LLM provider for the Buddy module, authenticated with OAuth2 — so an existing Codex subscription can power the assistant without provisioning a separate API key. Access tokens are refreshed automatically; the user logs in once and the plugin keeps its own credentials fresh in the background.
-- **Codex Models** - Access to codex-mini and other OpenAI Codex models
-- **OAuth Authentication** - Uses OAuth2 client credentials for secure API access
-- **Token Refresh** - Automatic access token refresh using refresh tokens
+## What you get
+- Use a Codex subscription you already pay for instead of a separate API key
+- Automatic OAuth token refresh — the plugin renews access tokens before they expire and never blocks a chat on auth
+- Native tool calling backed by Codex models, so Buddy can drive devices and scenes through structured calls
+- Streaming chat with the same shape as the regular OpenAI plugin — switching providers requires no code change in Buddy
+## Capabilities
+- **LLM (chat)** — streaming completions
+- **Tool calls** — structured device / scene control
+- **OAuth login** — credentials are stored encrypted in config and refreshed automatically
 ## Setup
 1. Register an OAuth application at [OpenAI](https://platform.openai.com)
-2. Obtain client ID and client secret
-3. Complete the OAuth flow to get access and refresh tokens
-4. Enter the credentials in plugin configuration
-5. Set the buddy module \`provider\` to \`${buddy_openai_codex_constants_1.BUDDY_OPENAI_CODEX_PLUGIN_NAME}\`
+2. Note the client ID (and client secret, if your app uses one)
+3. Complete the OAuth flow to obtain access and refresh tokens
+4. Enter the credentials in this plugin's configuration
+5. Set Buddy's \`provider\` to \`${buddy_openai_codex_constants_1.BUDDY_OPENAI_CODEX_PLUGIN_NAME}\`
 ## Configuration
-- **Client ID** - OAuth client ID (required)
-- **Client Secret** - OAuth client secret (optional)
-- **Access Token** - OAuth access token
-- **Refresh Token** - OAuth refresh token for automatic renewal
-- **Model** - Model name to use (default: codex-mini)`,
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`client_id\` | OAuth client ID (required) | — |
+| \`client_secret\` | OAuth client secret | — |
+| \`access_token\` | Current OAuth access token | — |
+| \`refresh_token\` | OAuth refresh token used for automatic renewal | — |
+| \`model\` | Codex model to use | \`codex-mini\` |`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/plugins/buddy-openai-codex/buddy-openai-codex.plugin.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"buddy-openai-codex.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-openai-codex/buddy-openai-codex.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,mEAA+D;AAC/D,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,iFAIwC;AACxC,6EAA8F;AAC9F,qEAAiF;AACjF,+DAA0E;AAC1E,wDAAoE;AACpE,6EAAwE;AACxE,4GAAqG;AAa9F,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAClC,YACkB,YAAsC,EACtC,gBAA4C,EAC5C,mBAAwC,EACxC,eAA6C,EAC7C,iBAAoC;QAJpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,qBAAgB,GAAhB,gBAAgB,CAA4B;QAC5C,wBAAmB,GAAnB,mBAAmB,CAAqB;QACxC,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAA+D;YAC/F,IAAI,EAAE,6DAA8B;YACpC,KAAK,EAAE,0CAA2B;YAClC,SAAS,EAAE,mDAA+B;SAC1C,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAEzD,KAAK,MAAM,KAAK,IAAI,2EAA8C,EAAE,CAAC;YACpE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,6DAA8B;YACpC,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,4EAA4E;YACzF,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE~~;;;;;;;;;;;;;;;;4CAgBiC~~,6DAA8B~~;;;;;;;;sDAQpB~~;~~YACnD~~,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;~~AA1DY~~,wDAAsB;iCAAtB,sBAAsB;IAXlC,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,6DAA8B;QACvC,WAAW,EAAE,qEAAsC;QACnD,WAAW,EAAE,4EAA6C;KAC1D,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,WAAW,EAAE,CAAC,kDAA+B,CAAC;QAC9C,SAAS,EAAE,CAAC,2CAAmB,EAAE,yEAAiC,CAAC;QACnE,OAAO,EAAE,CAAC,2CAAmB,CAAC;KAC9B,CAAC;qCAG+B,sDAAwB;QACpB,0DAA0B;QACvB,2CAAmB;QACvB,8DAA4B;QAC1B,sCAAiB;GAN1C,sBAAsB,~~CA0DlC~~"}
1	+ {"version":3,"file":"buddy-openai-codex.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-openai-codex/buddy-openai-codex.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,mEAA+D;AAC/D,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,iFAIwC;AACxC,6EAA8F;AAC9F,qEAAiF;AACjF,+DAA0E;AAC1E,wDAAoE;AACpE,6EAAwE;AACxE,4GAAqG;AAa9F,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAClC,YACkB,YAAsC,EACtC,gBAA4C,EAC5C,mBAAwC,EACxC,eAA6C,EAC7C,iBAAoC;QAJpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,qBAAgB,GAAhB,gBAAgB,CAA4B;QAC5C,wBAAmB,GAAnB,mBAAmB,CAAqB;QACxC,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAA+D;YAC/F,IAAI,EAAE,6DAA8B;YACpC,KAAK,EAAE,0CAA2B;YAClC,SAAS,EAAE,mDAA+B;SAC1C,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAEzD,KAAK,MAAM,KAAK,IAAI,2EAA8C,EAAE,CAAC;YACpE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,6DAA8B;YACpC,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,4EAA4E;YACzF,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;mCAyBwB,6DAA8B;;;;;;;;;;oDAUb;YACjD,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AArEY,wDAAsB;iCAAtB,sBAAsB;IAXlC,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,6DAA8B;QACvC,WAAW,EAAE,qEAAsC;QACnD,WAAW,EAAE,4EAA6C;KAC1D,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,WAAW,EAAE,CAAC,kDAA+B,CAAC;QAC9C,SAAS,EAAE,CAAC,2CAAmB,EAAE,yEAAiC,CAAC;QACnE,OAAO,EAAE,CAAC,2CAAmB,CAAC;KAC9B,CAAC;qCAG+B,sDAAwB;QACpB,0DAA0B;QACvB,2CAAmB;QACvB,8DAA4B;QAC1B,sCAAiB;GAN1C,sBAAsB,CAqElC"}

package/dist/plugins/buddy-stt-whisper-local/buddy-stt-whisper-local.plugin.js CHANGED Viewed

@@ -50,24 +50,38 @@ let BuddySttWhisperLocalPlugin = class BuddySttWhisperLocalPlugin {
             description: 'STT provider for Buddy module using locally installed Whisper',
             author: 'FastyBird',
             capabilities: [buddy_constants_1.BuddyCapability.STT],
-            readme: `# Buddy Local Whisper STT Provider
+            readme: `# Whisper Local
-Speech-to-text provider plugin for the Buddy module using a locally installed Whisper CLI.
+> Plugin · by FastyBird · capability: STT
-## Prerequisites
+Speech-to-text provider that runs OpenAI's Whisper locally via the \`whisper\` CLI. No API key, no network calls — the audio captured on the panel never leaves your network.
-Install whisper on your system. The \`whisper\` command must be available in PATH.
+## What you get
+- A privacy-respecting STT path: voice queries are transcribed on the host running the backend
+- Free choice of model size — \`tiny\` for low-spec hardware, \`large\` for top accuracy
+- Auto language detection or a fixed language hint when you know everyone in the household speaks the same one
+- Drop-in replacement for cloud STT providers — pair with any LLM / TTS combination
+## Capabilities
+- **STT only** — pair with any LLM and any TTS provider
+- **Configurable accuracy / speed** — pick the Whisper model that fits your CPU
+- **Language hint** — optional, otherwise Whisper detects automatically
+- **No outbound traffic** — every transcription stays on the host
 ## Setup
-1. Install whisper on the system
-2. Enable the plugin
-3. Set the buddy module \`stt_plugin\` to \`${buddy_stt_whisper_local_constants_1.BUDDY_STT_WHISPER_LOCAL_PLUGIN_NAME}\`
+1. Install Whisper so that the \`whisper\` command is available on \`PATH\`
+2. Enable this plugin
+3. Set Buddy's \`stt_plugin\` to \`${buddy_stt_whisper_local_constants_1.BUDDY_STT_WHISPER_LOCAL_PLUGIN_NAME}\`
 ## Configuration
-- **Model** - Whisper model size (default: base). Options: tiny, base, small, medium, large
-- **Language** - ISO 639-1 language hint (optional, e.g. en, cs)`,
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`model\` | Whisper model size — \`tiny\`, \`base\`, \`small\`, \`medium\`, \`large\` | \`base\` |
+| \`language\` | ISO 639-1 language hint (e.g. \`en\`, \`cs\`) | auto-detect |`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/plugins/buddy-stt-whisper-local/buddy-stt-whisper-local.plugin.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"buddy-stt-whisper-local.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-stt-whisper-local/buddy-stt-whisper-local.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,2FAI6C;AAC7C,uFAAwG;AACxG,+DAA8E;AAC9E,wDAAwE;AACxE,uFAAiF;AAY1E,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACtC,YACkB,YAAsC,EACtC,mBAA+C,EAC/C,uBAAgD,EAChD,eAA6C,EAC7C,iBAAoC;QAJpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,4BAAuB,GAAvB,uBAAuB,CAAyB;QAChD,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAuE;YACvG,IAAI,EAAE,uEAAmC;YACzC,KAAK,EAAE,8CAA+B;YACtC,SAAS,EAAE,uDAAmC;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAEhE,KAAK,MAAM,KAAK,IAAI,qFAAmD,EAAE,CAAC;YACzE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,uEAAmC;YACzC,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,+DAA+D;YAC5E,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,GAAG,CAAC;YACnC,MAAM,EAAE~~;;;;;;;;;;;;8CAYmC~~,uEAAmC~~;;;;;iEAKhB~~;~~YAC9D~~,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;~~AApDY~~,gEAA0B;qCAA1B,0BAA0B;IAVtC,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,uEAAmC;QAC5C,WAAW,EAAE,+EAA2C;QACxD,WAAW,EAAE,sFAAkD;KAC/D,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,oDAAuB,CAAC;QACpC,OAAO,EAAE,CAAC,oDAAuB,CAAC;KAClC,CAAC;qCAG+B,sDAAwB;QACjB,0DAA0B;QACtB,oDAAuB;QAC/B,8DAA4B;QAC1B,sCAAiB;GAN1C,0BAA0B,~~CAoDtC~~"}
1	+ {"version":3,"file":"buddy-stt-whisper-local.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-stt-whisper-local/buddy-stt-whisper-local.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,2FAI6C;AAC7C,uFAAwG;AACxG,+DAA8E;AAC9E,wDAAwE;AACxE,uFAAiF;AAY1E,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACtC,YACkB,YAAsC,EACtC,mBAA+C,EAC/C,uBAAgD,EAChD,eAA6C,EAC7C,iBAAoC;QAJpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,4BAAuB,GAAvB,uBAAuB,CAAyB;QAChD,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAuE;YACvG,IAAI,EAAE,uEAAmC;YACzC,KAAK,EAAE,8CAA+B;YACtC,SAAS,EAAE,uDAAmC;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAEhE,KAAK,MAAM,KAAK,IAAI,qFAAmD,EAAE,CAAC;YACzE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,uEAAmC;YACzC,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,+DAA+D;YAC5E,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,GAAG,CAAC;YACnC,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;qCAwB0B,uEAAmC;;;;;;;+EAOO;YAC5E,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AAlEY,gEAA0B;qCAA1B,0BAA0B;IAVtC,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,uEAAmC;QAC5C,WAAW,EAAE,+EAA2C;QACxD,WAAW,EAAE,sFAAkD;KAC/D,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,oDAAuB,CAAC;QACpC,OAAO,EAAE,CAAC,oDAAuB,CAAC;KAClC,CAAC;qCAG+B,sDAAwB;QACjB,0DAA0B;QACtB,oDAAuB;QAC/B,8DAA4B;QAC1B,sCAAiB;GAN1C,0BAA0B,CAkEtC"}

package/dist/plugins/buddy-system-tts/buddy-system-tts.plugin.js CHANGED Viewed

@@ -50,26 +50,37 @@ let BuddySystemTtsPlugin = class BuddySystemTtsPlugin {
             description: 'Local TTS provider using piper or espeak',
             author: 'FastyBird',
             capabilities: [buddy_constants_1.BuddyCapability.TTS],
-            readme: `# Buddy System TTS Provider
+            readme: `# System TTS
-Local TTS provider plugin for the Buddy module using system-installed speech synthesizers.
+> Plugin · by FastyBird · capability: TTS
-## Features
+Local text-to-speech provider that delegates synthesis to a system-installed engine — Piper for natural neural voices, eSpeak as a lightweight fallback. No API key, no network calls, no per-request fee.
-- **Piper** - High-quality neural TTS (preferred when available)
-- **eSpeak** - Lightweight fallback TTS
-- **No API Key Required** - Runs entirely locally
+## What you get
+- 100% offline voice for the assistant — useful when you want full local control or on networks without outbound internet
+- Free choice of voice quality vs. resource cost: Piper sounds great but needs more CPU; eSpeak is tiny and works on the most modest hardware
+- Multilingual support — both engines ship voices for many languages; pick one once and the assistant uses it everywhere
+- Auto-detection of which engine is actually installed, so the same configuration works across hosts that have only one of the two
+## Capabilities
+- **TTS only** — pair with any LLM and any STT provider
+- **Multiple engines** — Piper (preferred for quality) and eSpeak (fallback for low-power hosts)
+- **Streaming output** — audio is piped to the panel as soon as the engine emits it
 ## Setup
-1. Install piper or espeak on your system
+1. Install \`piper\` and/or \`espeak\` on the host
 2. Enable this plugin
-3. Set the buddy module \`tts_plugin\` to \`${buddy_system_tts_constants_1.BUDDY_SYSTEM_TTS_PLUGIN_NAME}\`
+3. Set Buddy's \`tts_plugin\` to \`${buddy_system_tts_constants_1.BUDDY_SYSTEM_TTS_PLUGIN_NAME}\`
 ## Configuration
-- **Engine** - Preferred engine: piper or espeak (auto-detected if not set)
-- **Voice** - Voice identifier (piper model name or espeak voice code)`,
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`engine\` | Preferred engine (\`piper\` or \`espeak\`) | auto-detected |
+| \`voice\` | Voice identifier (Piper model or eSpeak voice code) | engine default |`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/plugins/buddy-system-tts/buddy-system-tts.plugin.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"buddy-system-tts.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-system-tts/buddy-system-tts.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,6EAIsC;AACtC,yEAA0F;AAC1F,+DAAwE;AACxE,wDAAkE;AAClE,yEAAoE;AAY7D,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAChC,YACkB,YAAsC,EACtC,mBAA+C,EAC/C,iBAAoC,EACpC,eAA6C,EAC7C,iBAAoC;QAJpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAA2D;YAC3F,IAAI,EAAE,yDAA4B;YAClC,KAAK,EAAE,wCAAyB;YAChC,SAAS,EAAE,iDAA6B;SACxC,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAE1D,KAAK,MAAM,KAAK,IAAI,uEAA4C,EAAE,CAAC;YAClE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,yDAA4B;YAClC,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,0CAA0C;YACvD,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,GAAG,CAAC;YACnC,MAAM,EAAE~~;;;;;;;;;;;;;;8CAcmC~~,yDAA4B~~;;;;;uEAKH~~;~~YACpE~~,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;~~AAtDY~~,oDAAoB;+BAApB,oBAAoB;IAVhC,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,yDAA4B;QACrC,WAAW,EAAE,iEAAoC;QACjD,WAAW,EAAE,wEAA2C;KACxD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,uCAAiB,CAAC;QAC9B,OAAO,EAAE,CAAC,uCAAiB,CAAC;KAC5B,CAAC;qCAG+B,sDAAwB;QACjB,0DAA0B;QAC5B,uCAAiB;QACnB,8DAA4B;QAC1B,sCAAiB;GAN1C,oBAAoB,~~CAsDhC~~"}
1	+ {"version":3,"file":"buddy-system-tts.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-system-tts/buddy-system-tts.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,8GAAwG;AACxG,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,6EAIsC;AACtC,yEAA0F;AAC1F,+DAAwE;AACxE,wDAAkE;AAClE,yEAAoE;AAY7D,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAChC,YACkB,YAAsC,EACtC,mBAA+C,EAC/C,iBAAoC,EACpC,eAA6C,EAC7C,iBAAoC;QAJpC,iBAAY,GAAZ,YAAY,CAA0B;QACtC,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAA2D;YAC3F,IAAI,EAAE,yDAA4B;YAClC,KAAK,EAAE,wCAAyB;YAChC,SAAS,EAAE,iDAA6B;SACxC,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAE1D,KAAK,MAAM,KAAK,IAAI,uEAA4C,EAAE,CAAC;YAClE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,yDAA4B;YAClC,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,0CAA0C;YACvD,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,GAAG,CAAC;YACnC,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;qCAuB0B,yDAA4B;;;;;;;qFAOoB;YAClF,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AAjEY,oDAAoB;+BAApB,oBAAoB;IAVhC,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,yDAA4B;QACrC,WAAW,EAAE,iEAAoC;QACjD,WAAW,EAAE,wEAA2C;KACxD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,uCAAiB,CAAC;QAC9B,OAAO,EAAE,CAAC,uCAAiB,CAAC;KAC5B,CAAC;qCAG+B,sDAAwB;QACjB,0DAA0B;QAC5B,uCAAiB;QACnB,8DAA4B;QAC1B,sCAAiB;GAN1C,oBAAoB,CAiEhC"}

package/dist/plugins/buddy-telegram/buddy-telegram.plugin.js CHANGED Viewed

@@ -50,27 +50,38 @@ let BuddyTelegramPlugin = class BuddyTelegramPlugin {
             description: 'Telegram bot adapter for Buddy module remote conversations and alerts',
             author: 'FastyBird',
             capabilities: [buddy_constants_1.BuddyCapability.MESSAGING],
-            readme: `# Buddy Telegram Plugin
+            readme: `# Telegram
-Telegram bot adapter plugin for the Buddy module. Enables remote conversations and alert forwarding via Telegram.
+> Plugin · by FastyBird · capability: messaging
+Telegram bot adapter for the Buddy module. Forwards alerts (with inline accept / dismiss buttons) and lets you have full Buddy conversations from any Telegram client.
+## What you get
+- Talk to your home from a Telegram chat — same brain as the panel, available worldwide
+- Inline buttons on suggestions / alerts so you can act with one tap (acknowledge a leak alarm, run a scene, dismiss a suggestion)
+- Tight access control — limit who can chat with the bot to a list of explicit Telegram user IDs
+- Zero infrastructure to host: Telegram's bot API does the heavy lifting, you only need a bot token
 ## Features
-- **Remote Chat** - Interact with your smart home buddy from anywhere via Telegram
-- **Alert Forwarding** - Receive suggestion notifications with accept/dismiss buttons
-- **User Whitelist** - Restrict access to specific Telegram user IDs
+- **Remote chat** — text Buddy from any Telegram device with the same context as the panel
+- **Inline alert buttons** — every alert / suggestion ships with quick-action buttons
+- **Allow-list** — restrict access to a comma-separated list of user IDs; everyone else is silently ignored
+- **Markdown formatting** — replies render cleanly in Telegram with lists and code blocks where useful
 ## Setup
-1. Create a bot via [@BotFather](https://t.me/BotFather) on Telegram
-2. Copy the bot token
-3. Enable the plugin and enter the bot token in configuration
-4. Optionally set allowed user IDs to restrict access
+1. Create a bot via [@BotFather](https://t.me/BotFather) and copy the token
+2. Enable the plugin and paste the token into configuration
+3. Optionally restrict access by listing allowed user IDs
 ## Configuration
-- **Bot Token** - Telegram Bot API token from @BotFather (required)
-- **Allowed User IDs** - Comma-separated Telegram user IDs (empty = allow all)`,
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`bot_token\` | Telegram Bot API token (required) | — |
+| \`allowed_user_ids\` | Comma-separated Telegram user IDs allowed to chat | unrestricted |`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/plugins/buddy-telegram/buddy-telegram.plugin.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"buddy-telegram.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-telegram/buddy-telegram.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,qHAA+G;AAC/G,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,yEAIoC;AACpC,qEAAsF;AACtF,+DAAuE;AACvE,wDAAiE;AACjE,6EAAwE;AACxE,oGAA8F;AAYvF,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC/B,YACkB,YAAsC,EACtC,mBAAwC,EACxC,eAA6C,EAC7C,iBAAoC,EACpC,oBAAiD;QAJjD,iBAAY,GAAZ,YAAY,CAA0B;QACtC,wBAAmB,GAAnB,mBAAmB,CAAqB;QACxC,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,yBAAoB,GAApB,oBAAoB,CAA6B;IAChE,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAyD;YACzF,IAAI,EAAE,qDAA0B;YAChC,KAAK,EAAE,uCAAwB;YAC/B,SAAS,EAAE,gDAA4B;SACvC,CAAC,CAAC;QAEH,KAAK,MAAM,KAAK,IAAI,mEAA0C,EAAE,CAAC;YAChE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,qDAA0B;YAChC,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,uEAAuE;YACpF,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,SAAS,CAAC;YACzC,MAAM,EAAE~~;;;;;;;;;;;;;;;;;;;;+EAoBoE~~;~~YAC5E~~,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;QAIH,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC9D,CAAC;CACD,CAAA;~~AAzDY~~,kDAAmB;8BAAnB,mBAAmB;IAV/B,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,qDAA0B;QACnC,WAAW,EAAE,6DAAkC;QAC/C,WAAW,EAAE,oEAAyC;KACtD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,2CAAmB,EAAE,kEAA8B,CAAC;QAChE,OAAO,EAAE,CAAC,2CAAmB,CAAC;KAC9B,CAAC;qCAG+B,sDAAwB;QACjB,2CAAmB;QACvB,8DAA4B;QAC1B,sCAAiB;QACd,4DAA2B;GANvD,mBAAmB,~~CAyD~~/B"}
1	+ {"version":3,"file":"buddy-telegram.plugin.js","sourceRoot":"","sources":["../../../src/plugins/buddy-telegram/buddy-telegram.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,yEAAsE;AACtE,mEAA+D;AAC/D,sEAAkE;AAClE,2GAAqG;AACrG,kFAA8E;AAC9E,6FAAyF;AACzF,qHAA+G;AAC/G,0FAA4E;AAC5E,oHAA8G;AAC9G,yEAAqE;AAErE,yEAIoC;AACpC,qEAAsF;AACtF,+DAAuE;AACvE,wDAAiE;AACjE,6EAAwE;AACxE,oGAA8F;AAYvF,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC/B,YACkB,YAAsC,EACtC,mBAAwC,EACxC,eAA6C,EAC7C,iBAAoC,EACpC,oBAAiD;QAJjD,iBAAY,GAAZ,YAAY,CAA0B;QACtC,wBAAmB,GAAnB,mBAAmB,CAAqB;QACxC,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,yBAAoB,GAApB,oBAAoB,CAA6B;IAChE,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAyD;YACzF,IAAI,EAAE,qDAA0B;YAChC,KAAK,EAAE,uCAAwB;YAC/B,SAAS,EAAE,gDAA4B;SACvC,CAAC,CAAC;QAEH,KAAK,MAAM,KAAK,IAAI,mEAA0C,EAAE,CAAC;YAChE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,qDAA0B;YAChC,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,uEAAuE;YACpF,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,CAAC,iCAAe,CAAC,SAAS,CAAC;YACzC,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4FA+BiF;YACzF,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;QAIH,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC9D,CAAC;CACD,CAAA;AApEY,kDAAmB;8BAAnB,mBAAmB;IAV/B,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,qDAA0B;QACnC,WAAW,EAAE,6DAAkC;QAC/C,WAAW,EAAE,oEAAyC;KACtD,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAY,EAAE,8BAAa,EAAE,oCAAgB,CAAC;QACrE,SAAS,EAAE,CAAC,2CAAmB,EAAE,kEAA8B,CAAC;QAChE,OAAO,EAAE,CAAC,2CAAmB,CAAC;KAC9B,CAAC;qCAG+B,sDAAwB;QACjB,2CAAmB;QACvB,8DAA4B;QAC1B,sCAAiB;QACd,4DAA2B;GANvD,mBAAmB,CAoE/B"}