openclaw-threema 0.6.7 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.7.0 (2026-05-06)
+
+### Added
+- **Markdown → Threema-Markup conversion** for all outbound text. Threema natively supports `*bold*`, `_italic_`, and `~strikethrough~` since 2024 — but does NOT understand standard Markdown (`**bold**`, `# headers`, `- lists`, `[links](url)`, code fences, tables). The plugin now transparently converts Markdown into Threema-compatible markup before sending, so agent replies look correct in the Threema client without any prompt changes.
+  - New module: `markdown-to-threema.ts` (with full unit-test suite, 23/23 passing).
+  - Conversions:
+    - `**bold**` / `__bold__` → `*bold*` (Threema bold)
+    - `~~strike~~` → `~strike~` (Threema strikethrough)
+    - Single-asterisk `*x*` and underscore `_x_` left untouched.
+    - `# / ## / …` headers → `*Header*` (bold).
+    - `- / * / +` lists → `•` (Unicode bullet).
+    - Numbered lists kept as-is (Threema renders them fine plain).
+    - Blockquotes (`>`) → `│` (vertical bar).
+    - Pipe-tables → bullet-list with bold headers (`• *Header:* value`).
+    - Inline code `` `x` `` → `"x"`. Fenced code blocks → plain content, fences stripped.
+    - Links `[text](url)` → `text — url` (or just `url` when text == url).
+    - Markdown images `![alt](url)` → `[Bild: alt] — url`.
+    - Horizontal rules → unicode line.
+  - Hooked into all outbound paths: `outbound.sendText` adapter (cron / message-tool delivery), inbound text-reply callbacks (multi-chunk, voice fallback, regular DM replies), and inbound file-reply caption handling.
+  - Runs idempotently — valid Threema-already markup passes through unchanged.
+
+### Notes
+- Behaviour change: previously, agent replies containing Markdown looked unrendered in Threema (literal `**`, `##`, `|`). Now they render with Threema’s native bold/italic/strikethrough wherever possible. Plain text and existing Threema markup are unaffected.
+
 ## 0.6.7 (2026-05-04)
 
 ### Added

package/dist/index.js

@@ -12,6 +12,7 @@ import * as path from "path";
 import { spawnSync } from "child_process";
 import * as crypto from "crypto";
 import * as dns from "node:dns/promises";
+import { markdownToThreema } from "./markdown-to-threema.js";
 // ============================================================================
 // Constants
 // ============================================================================
@@ -1254,12 +1255,14 @@ const threemaChannel = {
             }
             const client = new ThreemaClient(threemaCfg);
             const to = normalizeThreemaTarget(ctx.to);
+            // Convert Markdown → Threema-Markup before sending.
+            const formatted = markdownToThreema(ctx.text);
             let messageId;
             if (client.isE2EEnabled) {
-                messageId = await client.sendE2E(to, ctx.text);
+                messageId = await client.sendE2E(to, formatted);
             }
             else {
-                messageId = await client.sendSimple(to, ctx.text);
+                messageId = await client.sendSimple(to, formatted);
             }
             return {
                 channel: "threema",
@@ -1848,13 +1851,13 @@ export default function register(api) {
                                                             if (fs.existsSync(audioPath)) {
                                                                 const audioBuffer = fs.readFileSync(audioPath);
                                                                 const mimeType = payload.mediaMimeType ?? "audio/aac";
-                                                                const caption = payload.text ?? payload.body ?? undefined;
+                                                                const caption = markdownToThreema(payload.text ?? payload.body) || undefined;
                                                                 await replyClient.sendVoiceNote(from, audioBuffer, mimeType, caption);
                                                             }
                                                             else {
                                                                 api.logger?.warn?.(`Threema: audio file not found at ${audioPath}, falling back to text`);
                                                                 // Fallback to text if audio file not found
-                                                                const text = payload.text ?? payload.body;
+                                                                const text = markdownToThreema(payload.text ?? payload.body);
                                                                 if (text) {
                                                                     await replyClient.sendE2E(from, text);
                                                                 }
@@ -1863,7 +1866,7 @@ export default function register(api) {
                                                         else {
                                                             // Voice notes only work in E2E mode; fallback to text in basic mode
                                                             api.logger?.info?.(`Threema: voice notes require E2E mode, sending text instead`);
-                                                            const text = payload.text ?? payload.body;
+                                                            const text = markdownToThreema(payload.text ?? payload.body);
                                                             if (text) {
                                                                 await replyClient.sendSimple(from, text);
                                                             }
@@ -1872,7 +1875,7 @@ export default function register(api) {
                                                     catch (audioErr) {
                                                         api.logger?.error?.(`Threema: error sending voice note: ${audioErr.message}`);
                                                         // Fallback to text on error
-                                                        const text = payload.text ?? payload.body;
+                                                        const text = markdownToThreema(payload.text ?? payload.body);
                                                         if (text) {
                                                             if (replyClient.isE2EEnabled) {
                                                                 await replyClient.sendE2E(from, text);
@@ -1885,7 +1888,7 @@ export default function register(api) {
                                                 }
                                                 else {
                                                     // Send as text (existing logic)
-                                                    const text = payload.text ?? payload.body;
+                                                    const text = markdownToThreema(payload.text ?? payload.body);
                                                     if (!text)
                                                         return;
                                                     // Chunk long replies if needed
@@ -2072,13 +2075,13 @@ export default function register(api) {
                                                             if (fs.existsSync(audioPath)) {
                                                                 const audioBuffer = fs.readFileSync(audioPath);
                                                                 const mimeType = payload.mediaMimeType ?? "audio/aac";
-                                                                const caption = payload.text ?? payload.body ?? undefined;
+                                                                const caption = markdownToThreema(payload.text ?? payload.body) || undefined;
                                                                 await replyClient.sendVoiceNote(from, audioBuffer, mimeType, caption);
                                                             }
                                                             else {
                                                                 api.logger?.warn?.(`Threema: audio file not found at ${audioPath}, falling back to text`);
                                                                 // Fallback to text if audio file not found
-                                                                const text = payload.text ?? payload.body;
+                                                                const text = markdownToThreema(payload.text ?? payload.body);
                                                                 if (text) {
                                                                     await replyClient.sendE2E(from, text);
                                                                 }
@@ -2087,7 +2090,7 @@ export default function register(api) {
                                                         else {
                                                             // Voice notes only work in E2E mode; fallback to text in basic mode
                                                             api.logger?.info?.(`Threema: voice notes require E2E mode, sending text instead`);
-                                                            const text = payload.text ?? payload.body;
+                                                            const text = markdownToThreema(payload.text ?? payload.body);
                                                             if (text) {
                                                                 await replyClient.sendSimple(from, text);
                                                             }
@@ -2096,7 +2099,7 @@ export default function register(api) {
                                                     catch (audioErr) {
                                                         api.logger?.error?.(`Threema: error sending voice note: ${audioErr.message}`);
                                                         // Fallback to text on error
-                                                        const text = payload.text ?? payload.body;
+                                                        const text = markdownToThreema(payload.text ?? payload.body);
                                                         if (text) {
                                                             if (replyClient.isE2EEnabled) {
                                                                 await replyClient.sendE2E(from, text);
@@ -2109,7 +2112,7 @@ export default function register(api) {
                                                 }
                                                 else {
                                                     // Send as text (existing logic)
-                                                    const text = payload.text ?? payload.body;
+                                                    const text = markdownToThreema(payload.text ?? payload.body);
                                                     if (!text)
                                                         return;
                                                     const limit = getThreemaConfig(currentCfg)?.textChunkLimit ?? 3500;

package/dist/markdown-to-threema.js

@@ -0,0 +1,235 @@
+/**
+ * markdown-to-threema.ts
+ *
+ * Converts a Markdown string to Threema's native text-markup conventions.
+ *
+ * Threema-Markup (offizielle Threema-Inline-Formatierung, plattformübergreifend
+ * unterstützt seit 2024):
+ *   *bold*       — fett (genau ein Sternchen pro Seite)
+ *   _italic_     — kursiv (genau ein Unterstrich pro Seite)
+ *   ~strike~     — durchgestrichen (genau eine Tilde pro Seite)
+ *
+ * Markdown-Konstrukte, die Threema NICHT unterstützt, werden in
+ * sinnvolle Plain-Text-Repräsentationen überführt:
+ *   - **bold** / __bold__   → *bold*
+ *   - *italic* / _italic_   → _italic_  (so wie es ist; sicher-stellt nur, dass wir's nicht zerschießen)
+ *   - ~~strike~~            → ~strike~
+ *   - # / ## / ### Headers  → *Header*  (fett) + Leerzeile danach
+ *   - - / * / + Liste       → •  (Unicode-Bullet)
+ *   - 1. Nummerierte Liste  → 1.  (lassen wir; Threema rendert das eh als Plain)
+ *   - > Blockquote          → │  (Vertical-Bar, optisch wie Quote)
+ *   - `inline code`         → "inline code"  (Anführungszeichen)
+ *   - ```block code```      → Block bleibt erhalten, Backticks weg
+ *   - [text](url)           → text — url   (oder nur url falls text==url)
+ *   - ![alt](url)           → [Bild: alt] — url (Markdown-Image)
+ *   - | a | b |             → a — b  (Tabelle wird zu Plain-Listen)
+ *
+ * Das Ziel ist nicht 100 % treue Markdown-Erhaltung, sondern:
+ *   1. Was Threema kann, nutzen.
+ *   2. Was Threema nicht kann, optisch ordentlich zerlegen.
+ *   3. Inhalt erhält bleiben — keine Datenverluste.
+ *
+ * Heuristik-Reihenfolge wichtig:
+ *   1. Code-Blöcke (Fenced) zuerst herausziehen → escapen → später wieder einfügen.
+ *   2. Inline-Code (Backticks) auch escapen.
+ *   3. Tabellen → Bullet-List.
+ *   4. Bold/Italic/Strikethrough → Threema-Markup.
+ *   5. Headers → fett.
+ *   6. Listen → Bullets.
+ *   7. Blockquotes → Vertical-Bar.
+ *   8. Links / Images → Plain-Auflösung.
+ */
+const PLACEHOLDER_PREFIX = "\u0001THREEMA_PH_";
+const PLACEHOLDER_SUFFIX = "\u0001";
+/**
+ * Convert Markdown → Threema text markup.
+ *
+ * Always returns a string. Empty input → empty output.
+ * The conversion is best-effort and idempotent for valid Threema-text input.
+ */
+export function markdownToThreema(input) {
+    if (!input)
+        return "";
+    let text = input;
+    // ---- 1. Stash code blocks & inline code so we don't munge them ----
+    const stash = [];
+    const stashOne = (val) => {
+        const idx = stash.length;
+        stash.push(val);
+        return `${PLACEHOLDER_PREFIX}${idx}${PLACEHOLDER_SUFFIX}`;
+    };
+    // Fenced code blocks: ```lang\n...\n``` or ~~~...~~~
+    text = text.replace(/```([a-zA-Z0-9_+-]*)?\n([\s\S]*?)\n```/g, (_m, _lang, body) => stashOne(body.replace(/\s+$/g, "")));
+    text = text.replace(/~~~([a-zA-Z0-9_+-]*)?\n([\s\S]*?)\n~~~/g, (_m, _lang, body) => stashOne(body.replace(/\s+$/g, "")));
+    // Inline code: `code` (single backticks, no embedded backticks)
+    text = text.replace(/`([^`\n]+)`/g, (_m, body) => stashOne(`"${body}"`));
+    // ---- 2. Tables → bullet lists ----
+    // A Markdown table is detected by a header row + a separator row of dashes.
+    // We turn each data row into a bullet line "col1 — col2 — col3" and
+    // the header row into "*col1 — col2*" prefix.
+    text = convertTables(text);
+    // ---- 3. Block-level transforms (line by line) ----
+    const lines = text.split("\n");
+    const outLines = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        let line = lines[i];
+        // Headers # / ## / ### → *Header*
+        const headerMatch = /^(#{1,6})\s+(.+?)\s*#*\s*$/.exec(line);
+        if (headerMatch) {
+            const headerText = headerMatch[2];
+            outLines.push(`*${stripInlineMarkers(headerText)}*`);
+            continue;
+        }
+        // Horizontal rule: ---, ___, ***
+        if (/^\s*([-*_])\1\1+\s*$/.test(line)) {
+            outLines.push("─────────────");
+            continue;
+        }
+        // Blockquote: > foo
+        const quoteMatch = /^(\s*)>\s?(.*)$/.exec(line);
+        if (quoteMatch) {
+            const [, indent, body] = quoteMatch;
+            outLines.push(`${indent}│ ${body}`);
+            continue;
+        }
+        // Unordered list: -, *, +
+        const ulMatch = /^(\s*)[-*+]\s+(.*)$/.exec(line);
+        if (ulMatch) {
+            const [, indent, body] = ulMatch;
+            outLines.push(`${indent}• ${body}`);
+            continue;
+        }
+        // Numbered list: 1. foo (keep as-is, Threema renders that fine plain)
+        // → no transform needed.
+        outLines.push(line);
+    }
+    text = outLines.join("\n");
+    // ---- 4. Inline replacements ----
+    // Markdown-Image:  ![alt](url)  →  [Bild: alt] — url   (or just url)
+    text = text.replace(/!\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g, (_m, alt, url) => {
+        if (!alt.trim())
+            return url;
+        return `[Bild: ${alt}] — ${url}`;
+    });
+    // Link:  [text](url)  →  text — url  (or just url if text === url)
+    text = text.replace(/\[([^\]]+)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g, (_m, label, url) => {
+        const trimmed = label.trim();
+        if (!trimmed || trimmed === url)
+            return url;
+        return `${trimmed} — ${url}`;
+    });
+    // Bold: **text** or __text__  →  *text*   (Threema)
+    // Run this BEFORE italic so we don't accidentally chew **x** into *_x_*.
+    text = text.replace(/\*\*([^*\n][^*\n]*?)\*\*/g, "*$1*");
+    text = text.replace(/__([^_\n][^_\n]*?)__/g, "*$1*");
+    // Strikethrough: ~~text~~ → ~text~
+    text = text.replace(/~~([^~\n]+?)~~/g, "~$1~");
+    // Italic with *text*:  Threema's *...* is BOLD, not italic. Markdown
+    // *italic* with single asterisks would render as bold in Threema.
+    // The safer move: convert single-asterisk *italic* to underscore _italic_.
+    // BUT: We just emitted *bold* above for **bold**. We must NOT touch
+    // existing *bold* output. Heuristic: only convert remaining *…* if the
+    // word inside contains no spaces around it being already-bold.
+    //
+    // Reality: distinguishing original *italic* (single asterisks) from
+    // converted *bold* (also single asterisks) post-hoc is impossible.
+    //
+    // Pragmatic decision: We do NOT touch single asterisks. Models in 2026
+    // overwhelmingly produce **bold** (double) and _italic_ (underscore),
+    // so this is a non-issue. If a model produces *italic*, it ends up as
+    // bold in Threema — minor cosmetic glitch, not a disaster.
+    // ---- 5. Restore code stash ----
+    text = text.replace(new RegExp(`${PLACEHOLDER_PREFIX}(\\d+)${PLACEHOLDER_SUFFIX}`, "g"), (_m, idx) => stash[parseInt(idx, 10)] ?? _m);
+    // ---- 6. Tidy: collapse 3+ consecutive blank lines to 2 ----
+    text = text.replace(/\n{3,}/g, "\n\n");
+    return text;
+}
+/**
+ * Strip Markdown inline markers from header text.
+ * Headers in Markdown are usually "# **Bold Text**" — we want to land at
+ * "*Bold Text*" in Threema, not "**Bold Text**".
+ */
+function stripInlineMarkers(s) {
+    let r = s;
+    r = r.replace(/\*\*(.+?)\*\*/g, "$1");
+    r = r.replace(/__(.+?)__/g, "$1");
+    r = r.replace(/~~(.+?)~~/g, "$1");
+    // single *…* and _…_ left as-is so headers can still be italic/bold inside
+    return r;
+}
+/**
+ * Convert Markdown pipe-tables into a flat bullet representation.
+ * Heuristic: We look for the classic | hdr | hdr | row, then a separator row
+ * of dashes |---|---|, then data rows.
+ */
+function convertTables(text) {
+    const lines = text.split("\n");
+    const out = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Detect potential header row
+        if (looksLikeTableRow(line) && i + 1 < lines.length && looksLikeTableSeparator(lines[i + 1])) {
+            const headers = parseTableRow(line);
+            i += 2; // skip header + separator
+            const rows = [];
+            while (i < lines.length && looksLikeTableRow(lines[i])) {
+                rows.push(parseTableRow(lines[i]));
+                i += 1;
+            }
+            // Emit: header line as bold + each data row as a bullet block
+            if (headers.length > 0 && rows.length > 0) {
+                // Multi-line per row: each row gets its own block of "*hdr:* value" lines
+                for (const row of rows) {
+                    for (let c = 0; c < headers.length; c += 1) {
+                        const h = headers[c]?.trim();
+                        const v = row[c]?.trim() ?? "";
+                        if (!h)
+                            continue;
+                        // First column gets a bullet, rest indented
+                        if (c === 0) {
+                            out.push(`• *${h}:* ${v}`);
+                        }
+                        else {
+                            out.push(`  *${h}:* ${v}`);
+                        }
+                    }
+                    out.push(""); // blank line between rows
+                }
+                // Drop the trailing blank line we added
+                if (out.length > 0 && out[out.length - 1] === "")
+                    out.pop();
+                continue;
+            }
+        }
+        out.push(line);
+        i += 1;
+    }
+    return out.join("\n");
+}
+function looksLikeTableRow(line) {
+    if (!line)
+        return false;
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("|") && !trimmed.includes("|"))
+        return false;
+    // Must contain at least 2 | characters to qualify
+    const pipeCount = (trimmed.match(/\|/g) ?? []).length;
+    return pipeCount >= 2;
+}
+function looksLikeTableSeparator(line) {
+    if (!line)
+        return false;
+    const trimmed = line.trim();
+    // | --- | --- |  or  | :--- | ---: |
+    return /^\|?\s*:?-+:?\s*(\|\s*:?-+:?\s*)+\|?$/.test(trimmed);
+}
+function parseTableRow(line) {
+    // Strip leading/trailing | and split on |
+    let s = line.trim();
+    if (s.startsWith("|"))
+        s = s.slice(1);
+    if (s.endsWith("|"))
+        s = s.slice(0, -1);
+    return s.split("|").map((cell) => cell.trim());
+}

package/index.ts

@@ -13,6 +13,7 @@ import * as path from "path";
 import { spawnSync } from "child_process";
 import * as crypto from "crypto";
 import * as dns from "node:dns/promises";
+import { markdownToThreema } from "./markdown-to-threema.js";
 
 // ============================================================================
 // Types (matching OpenClaw's expected interfaces)
@@ -1627,11 +1628,14 @@ const threemaChannel = {
       const client = new ThreemaClient(threemaCfg);
       const to = normalizeThreemaTarget(ctx.to);
 
+      // Convert Markdown → Threema-Markup before sending.
+      const formatted = markdownToThreema(ctx.text);
+
       let messageId: string;
       if (client.isE2EEnabled) {
-        messageId = await client.sendE2E(to, ctx.text);
+        messageId = await client.sendE2E(to, formatted);
       } else {
-        messageId = await client.sendSimple(to, ctx.text);
+        messageId = await client.sendSimple(to, formatted);
       }
 
       return {
@@ -2365,12 +2369,12 @@ export default function register(api: any) {
                             if (fs.existsSync(audioPath)) {
                               const audioBuffer = fs.readFileSync(audioPath);
                               const mimeType = payload.mediaMimeType ?? "audio/aac";
-                              const caption = payload.text ?? payload.body ?? undefined;
+                              const caption = markdownToThreema(payload.text ?? payload.body) || undefined;
                               await replyClient.sendVoiceNote(from, audioBuffer, mimeType, caption);
                             } else {
                               api.logger?.warn?.(`Threema: audio file not found at ${audioPath}, falling back to text`);
                               // Fallback to text if audio file not found
-                              const text = payload.text ?? payload.body;
+                              const text = markdownToThreema(payload.text ?? payload.body);
                               if (text) {
                                 await replyClient.sendE2E(from, text);
                               }
@@ -2378,7 +2382,7 @@ export default function register(api: any) {
                           } else {
                             // Voice notes only work in E2E mode; fallback to text in basic mode
                             api.logger?.info?.(`Threema: voice notes require E2E mode, sending text instead`);
-                            const text = payload.text ?? payload.body;
+                            const text = markdownToThreema(payload.text ?? payload.body);
                             if (text) {
                               await replyClient.sendSimple(from, text);
                             }
@@ -2386,7 +2390,7 @@ export default function register(api: any) {
                         } catch (audioErr: any) {
                           api.logger?.error?.(`Threema: error sending voice note: ${audioErr.message}`);
                           // Fallback to text on error
-                          const text = payload.text ?? payload.body;
+                          const text = markdownToThreema(payload.text ?? payload.body);
                           if (text) {
                             if (replyClient.isE2EEnabled) {
                               await replyClient.sendE2E(from, text);
@@ -2397,7 +2401,7 @@ export default function register(api: any) {
                         }
                       } else {
                         // Send as text (existing logic)
-                        const text = payload.text ?? payload.body;
+                        const text = markdownToThreema(payload.text ?? payload.body);
                         if (!text) return;
                         // Chunk long replies if needed
                         const limit = getThreemaConfig(currentCfg)?.textChunkLimit ?? 3500;
@@ -2593,12 +2597,12 @@ export default function register(api: any) {
                             if (fs.existsSync(audioPath)) {
                               const audioBuffer = fs.readFileSync(audioPath);
                               const mimeType = payload.mediaMimeType ?? "audio/aac";
-                              const caption = payload.text ?? payload.body ?? undefined;
+                              const caption = markdownToThreema(payload.text ?? payload.body) || undefined;
                               await replyClient.sendVoiceNote(from, audioBuffer, mimeType, caption);
                             } else {
                               api.logger?.warn?.(`Threema: audio file not found at ${audioPath}, falling back to text`);
                               // Fallback to text if audio file not found
-                              const text = payload.text ?? payload.body;
+                              const text = markdownToThreema(payload.text ?? payload.body);
                               if (text) {
                                 await replyClient.sendE2E(from, text);
                               }
@@ -2606,7 +2610,7 @@ export default function register(api: any) {
                           } else {
                             // Voice notes only work in E2E mode; fallback to text in basic mode
                             api.logger?.info?.(`Threema: voice notes require E2E mode, sending text instead`);
-                            const text = payload.text ?? payload.body;
+                            const text = markdownToThreema(payload.text ?? payload.body);
                             if (text) {
                               await replyClient.sendSimple(from, text);
                             }
@@ -2614,7 +2618,7 @@ export default function register(api: any) {
                         } catch (audioErr: any) {
                           api.logger?.error?.(`Threema: error sending voice note: ${audioErr.message}`);
                           // Fallback to text on error
-                          const text = payload.text ?? payload.body;
+                          const text = markdownToThreema(payload.text ?? payload.body);
                           if (text) {
                             if (replyClient.isE2EEnabled) {
                               await replyClient.sendE2E(from, text);
@@ -2625,7 +2629,7 @@ export default function register(api: any) {
                         }
                       } else {
                         // Send as text (existing logic)
-                        const text = payload.text ?? payload.body;
+                        const text = markdownToThreema(payload.text ?? payload.body);
                         if (!text) return;
                         const limit = getThreemaConfig(currentCfg)?.textChunkLimit ?? 3500;
                         if (text.length <= limit) {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "threema",
   "name": "Threema Gateway",
   "description": "Threema messaging channel via Threema Gateway API (E2E encrypted)",
-  "version": "0.6.7",
+  "version": "0.7.0",
   "channels": [
     "threema"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-threema",
-  "version": "0.6.7",
+  "version": "0.7.0",
   "description": "Threema Gateway channel plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.js",