thepopebot 1.1.1 → 1.1.2

package/lib/tools/telegram.js

@@ -3,6 +3,73 @@ const { hydrateReply } = require('@grammyjs/parse-mode');
 
 const MAX_LENGTH = 4096;
 
+/**
+ * Convert markdown to Telegram-compatible HTML.
+ * Handles: code blocks, inline code, links, bold, italic, strikethrough, headings, lists.
+ * Strips unsupported HTML tags.
+ * @param {string} text - Markdown text
+ * @returns {string} Telegram HTML
+ */
+function markdownToTelegramHtml(text) {
+  if (!text) return '';
+
+  const placeholders = [];
+  function placeholder(content) {
+    const id = `\x00PH${placeholders.length}\x00`;
+    placeholders.push(content);
+    return id;
+  }
+
+  // 1. Protect existing supported HTML tags (so they survive escaping)
+  text = text.replace(/<(\/?(b|i|s|u|code|pre|a)\b[^>]*)>/g, (match) => {
+    return placeholder(match);
+  });
+
+  // 2. Extract fenced code blocks (``` ... ```)
+  text = text.replace(/```[\w]*\n([\s\S]*?)```/g, (_, code) => {
+    return placeholder(`<pre>${escapeHtml(code.replace(/\n$/, ''))}</pre>`);
+  });
+
+  // 3. Extract inline code (` ... `)
+  text = text.replace(/`([^`\n]+)`/g, (_, code) => {
+    return placeholder(`<code>${escapeHtml(code)}</code>`);
+  });
+
+  // 4. Escape remaining HTML special chars (after code + existing tags are protected)
+  text = text.replace(/&/g, '&amp;');
+  text = text.replace(/</g, '&lt;');
+  text = text.replace(/>/g, '&gt;');
+
+  // 5. Links: [text](url)
+  text = text.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
+
+  // 6. Bold: **text** or __text__
+  text = text.replace(/\*\*(.+?)\*\*/g, '<b>$1</b>');
+  text = text.replace(/__(.+?)__/g, '<b>$1</b>');
+
+  // 7. Italic: *text* or _text_ (but not inside words for underscores)
+  text = text.replace(/(?<!\w)\*([^*\n<]+)\*(?!\w)/g, '<i>$1</i>');
+  text = text.replace(/(?<!\w)_([^_\n<]+)_(?!\w)/g, '<i>$1</i>');
+
+  // 8. Strikethrough: ~~text~~
+  text = text.replace(/~~(.+?)~~/g, '<s>$1</s>');
+
+  // 9. Headings: ## text → bold (must be at line start)
+  text = text.replace(/^#{1,6}\s+(.+)$/gm, '<b>$1</b>');
+
+  // 10. List items: - item or * item → bullet
+  text = text.replace(/^[\s]*[-*]\s+/gm, '• ');
+
+  // 11. Numbered list items: 1. item → keep as-is (already plain text friendly)
+
+  // 12. Restore placeholders
+  for (let i = 0; i < placeholders.length; i++) {
+    text = text.replace(`\x00PH${i}\x00`, placeholders[i]);
+  }
+
+  return text;
+}
+
 let bot = null;
 let currentToken = null;
 
@@ -101,6 +168,7 @@ function escapeHtml(text) {
  */
 async function sendMessage(botToken, chatId, text, options = {}) {
   const b = getBot(botToken);
+  text = markdownToTelegramHtml(text);
   // Strip HTML comments — Telegram's HTML parser doesn't support them
   text = text.replace(/<!--[\s\S]*?-->/g, '');
   const chunks = smartSplit(text, MAX_LENGTH);
@@ -215,6 +283,7 @@ module.exports = {
   sendMessage,
   smartSplit,
   escapeHtml,
+  markdownToTelegramHtml,
   formatJobNotification,
   downloadFile,
   reactToMessage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thepopebot",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Create autonomous AI agents with a two-layer architecture: Next.js Event Handler + Docker Agent.",
   "bin": {
     "thepopebot": "./bin/cli.js"

package/templates/CLAUDE.md

@@ -15,7 +15,6 @@ This is an autonomous AI agent powered by [thepopebot](https://github.com/stephe
 │   ├── CHATBOT.md              # Telegram chat system prompt
 │   ├── JOB_SUMMARY.md          # Job completion summary prompt
 │   ├── HEARTBEAT.md            # Periodic check instructions
-│   ├── TELEGRAM.md             # Telegram formatting guidelines
 │   ├── AGENT.md                # Agent runtime environment
 │   ├── CRONS.json              # Scheduled job definitions
 │   └── TRIGGERS.json           # Webhook trigger definitions

package/templates/config/CHATBOT.md

@@ -77,8 +77,6 @@ Use the `get_job_status` tool when the user asks about job progress, running job
 - Be helpful, direct, and efficient
 - When you use web search, summarize the key findings concisely
 
-{{config/TELEGRAM.md}}
-
 # Technical Reference
 
 Below are technical details on how thepopebot is built.

package/templates/config/JOB_SUMMARY.md

@@ -14,8 +14,6 @@ You convert job result data into concise summaries for non-technical people. Adj
 - Provide a 1–2 sentence summary of the agent logs (what it did). Keep it brief on success, more detailed on failure.
 - Only include a Challenges section when the bot struggled significantly.
 
-{{config/TELEGRAM.md}}
-
 ## Output Format
 
 ```

package/templates/config/TELEGRAM.md

@@ -1,21 +0,0 @@
-## Formatting for Telegram
-
-Your responses are sent via Telegram with HTML parse mode. Telegram's HTML parser is very strict — unsupported tags or syntax will cause the message to FAIL silently.
-
-Keep formatting minimal. Write plain text. Only use these tags sparingly:
-- <b>bold</b> for key terms
-- <i>italic</i> for subtle emphasis
-- <code>code</code> for job IDs, commands, file names
-
-NEVER use:
-- Any other HTML tags (no <div>, <p>, <h1>, <ul>, <li>, <br>, <pre>, <blockquote>, etc.)
-- HTML comments (<!-- -->)
-- Markdown syntax (no **bold**, *italic*, `backticks`, ```code blocks```, ## headings, [links](url))
-- Unclosed or malformed tags
-
-Style:
-- Write short, plain text responses
-- Use • or - for lists (plain text bullets, not HTML)
-- Use CAPS or <b>bold</b> for section headers, not heading tags
-- One thought per line, blank lines between sections
-- Keep under 1000 chars when possible