iobroker.pi-agent 0.0.1 → 0.0.2

package/README.md

@@ -101,6 +101,12 @@ Select **DeepSeek** as provider and enter a key from the DeepSeek platform. Avai
 
 ## Changelog
 
+### 0.0.2 (2026-10-25)
+
+- Telegram answers keep their formatting: Markdown of the model is sent as Telegram HTML (bold, italic, code, links;
+  tables as a monospace block), and Telegram chats are asked for short answers without tables
+- Released through the CI workflow with npm provenance (trusted publishing)
+
 ### 0.0.1 (2026-10-25)
 
 - Initial version: durable agent with the tools `search_objects`, `get_state`, `list_instances` and `set_state`

package/io-package.json

@@ -1,8 +1,21 @@
 {
 	"common": {
 		"name": "pi-agent",
-		"version": "0.0.1",
+		"version": "0.0.2",
 		"news": {
+			"0.0.2": {
+				"en": "Telegram answers keep their formatting (bold, italic, code, links); released with npm provenance",
+				"de": "Telegram-Antworten behalten ihre Formatierung (fett, kursiv, Code, Links); mit npm-Provenance veröffentlicht",
+				"ru": "Ответы в Telegram сохраняют форматирование (жирный, курсив, код, ссылки); опубликовано с npm provenance",
+				"pt": "As respostas no Telegram mantêm a formatação (negrito, itálico, código, links); publicado com proveniência npm",
+				"nl": "Telegram-antwoorden behouden hun opmaak (vet, cursief, code, links); gepubliceerd met npm-herkomst",
+				"fr": "Les réponses Telegram gardent leur mise en forme (gras, italique, code, liens) ; publié avec la provenance npm",
+				"it": "Le risposte su Telegram mantengono la formattazione (grassetto, corsivo, codice, link); pubblicato con provenienza npm",
+				"es": "Las respuestas en Telegram conservan el formato (negrita, cursiva, código, enlaces); publicado con procedencia npm",
+				"pl": "Odpowiedzi w Telegramie zachowują formatowanie (pogrubienie, kursywa, kod, linki); opublikowano z pochodzeniem npm",
+				"uk": "Відповіді в Telegram зберігають форматування (жирний, курсив, код, посилання); опубліковано з npm provenance",
+				"zh-cn": "Telegram 回答保留格式（粗体、斜体、代码、链接）；带 npm 来源证明发布"
+			},
 			"0.0.1": {
 				"en": "Initial version: durable agent with search, read and allowlisted write tools; chat via Telegram",
 				"de": "Erste Version: dauerhafter Agent mit Such-, Lese- und Schreibwerkzeugen mit Freigabeliste; Chat über Telegram",

package/lib/telegram.js

@@ -120,7 +120,58 @@ function splitMessage(text, max = MAX_MESSAGE) {
     return parts;
 }
 
+/** Instructions for conversations that are Telegram chats. */
+const TELEGRAM_INSTRUCTIONS =
+    'This conversation is a Telegram chat. Keep answers short. Use only simple formatting (bold, italic, inline code, short lists); avoid tables and headings.';
+
+/**
+ * Escape text for Telegram's HTML parse mode.
+ *
+ * @param {string} text plain text
+ * @returns {string} text with &, < and > escaped
+ */
+function escapeHtml(text) {
+    return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+
+/**
+ * Convert the Markdown a model writes into the small HTML subset Telegram understands (parse_mode "HTML").
+ * Everything else is escaped, so a stray "<" in an answer can never break the message.
+ *
+ * @param {string} markdown answer of the model
+ * @returns {string} Telegram HTML
+ */
+function markdownToTelegramHtml(markdown) {
+    const kept = [];
+    // placeholders use a private-use character that does not occur in an answer
+    const keep = html => `${kept.push(html) - 1}`;
+    let text = String(markdown || '');
+    // fenced code blocks and tables keep their layout in a monospace block
+    text = text.replace(/```[^\n]*\n([\s\S]*?)```/g, (_, code) =>
+        keep(`<pre>${escapeHtml(code.replace(/\n$/, ''))}</pre>`),
+    );
+    text = text.replace(/(?:^[ \t]*\|.*\|[ \t]*(?:\n|$))+/gm, table => {
+        const rows = table
+            .trimEnd()
+            .split('\n')
+            .map(row => row.trim())
+            .filter(row => !/^\|[\s:|-]+\|$/.test(row));
+        return `${keep(`<pre>${escapeHtml(rows.join('\n'))}</pre>`)}\n`;
+    });
+    text = escapeHtml(text);
+    text = text.replace(/`([^`\n]+)`/g, (_, code) => keep(`<code>${code}</code>`));
+    text = text.replace(/^#{1,6}[ \t]+(.+)$/gm, '<b>$1</b>');
+    text = text.replace(/^([ \t]*)[-*+][ \t]+/gm, '$1• ');
+    text = text.replace(/\*\*(.+?)\*\*/g, '<b>$1</b>');
+    text = text.replace(/(^|[^*\w])\*(?!\s)([^*\n]+?)\*(?![*\w])/g, '$1<i>$2</i>');
+    text = text.replace(/~~(.+?)~~/g, '<s>$1</s>');
+    text = text.replace(/\[([^\]\n]+)\]\((https?:\/\/[^\s)]+)\)/g, '<a href="$2">$1</a>');
+    return text.replace(/(\d+)/g, (_, i) => kept[Number(i)]);
+}
+
 module.exports = {
+    TELEGRAM_INSTRUCTIONS,
+    markdownToTelegramHtml,
     parseAllowedUsers,
     isAllowedUser,
     parseRequest,

package/main.js

@@ -13,6 +13,8 @@ const {
     stripPrefix,
     telegramRequestId,
     splitMessage,
+    markdownToTelegramHtml,
+    TELEGRAM_INSTRUCTIONS,
 } = require('./lib/telegram');
 
 /**
@@ -164,7 +166,7 @@ class PiAgent extends utils.Adapter {
         // Chats keep their own conversation; a model change in the settings reaches them too.
         for (const id of Object.values(this.chats)) {
             const conversation = await this.harness.conversation(id, this.context);
-            await conversation?.configure({ model: this.model }, this.context);
+            await conversation?.configure({ model: this.model, instructions: TELEGRAM_INSTRUCTIONS }, this.context);
         }
         await this.subscribeForeignStatesAsync(`${this.telegram}.communicate.request`);
         const prefix = String(this.config.telegramPrefix || '').trim();
@@ -191,7 +193,7 @@ class PiAgent extends utils.Adapter {
             }
         }
         const created = await this.harness.createConversation(
-            { ownership: { kind: 'ownerless' }, agent: { model: this.model } },
+            { ownership: { kind: 'ownerless' }, agent: { model: this.model, instructions: TELEGRAM_INSTRUCTIONS } },
             this.context,
         );
         this.chats[target.chatId] = created.id;
@@ -314,7 +316,12 @@ class PiAgent extends utils.Adapter {
     async deliver(target, text) {
         if (target.kind === 'telegram') {
             for (const part of splitMessage(text)) {
-                this.sendTo(this.telegram, 'send', { text: part, chatId: target.chatId });
+                // Telegram shows Markdown literally; its HTML mode renders bold, italic, code and links
+                this.sendTo(this.telegram, 'send', {
+                    text: markdownToTelegramHtml(part),
+                    chatId: target.chatId,
+                    parse_mode: 'HTML',
+                });
             }
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "iobroker.pi-agent",
-	"version": "0.0.1",
+	"version": "0.0.2",
 	"description": "Durable LLM agent for ioBroker: crash-safe tool calls, write allowlist, idempotent triggers.",
 	"author": {
 		"name": "Alex",