@mosaicstack/telegram-plugin (0.0.3-next.2677)

Published 2026-08-25 16:35:43 +00:00 by woodpecker in mosaicstack/stack

Set up this registry in your project .npmrc file:

@mosaicstack:registry=https://git.mosaicstack.dev/api/packages/mosaicstack/npm/

To install the package using npm, run the following command:

npm install @mosaicstack/[email protected]

or add it to the package.json file:

"@mosaicstack/telegram-plugin": "0.0.3-next.2677"

For more information on the npm registry, see the documentation.

`@mosaicstack/telegram-plugin` connects a Telegram bot to the Mosaic gateway chat namespace so Telegram chats can participate in the same conversation flow as the web, TUI, and Discord channels.

@mosaicstack/telegram-plugin

@mosaicstack/telegram-plugin connects a Telegram bot to the Mosaic gateway chat namespace so Telegram chats can participate in the same conversation flow as the web, TUI, and Discord channels.

Required Environment Variables

TELEGRAM_BOT_TOKEN: Bot token issued by BotFather
TELEGRAM_GATEWAY_URL: Base URL for the Mosaic gateway, for example http://localhost:3000

What It Does

Launches a Telegram bot with telegraf
Connects to ${TELEGRAM_GATEWAY_URL}/chat with socket.io-client
Maps Telegram chat.id values to Mosaic conversationId values
Forwards inbound Telegram text messages to the gateway as user messages
Buffers agent:start / agent:text / agent:end socket events and sends the completed response back to the Telegram chat