clawgram 2.14.0 → 2.15.0

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.
package/README.md CHANGED
@@ -228,6 +228,7 @@ openclaw gateway restart
228
228
  | `groups` | object | `{}` | Allowed groups map keyed by explicit group id or `*` |
229
229
  | `proxy` | object | unset | Optional SOCKS4/SOCKS5 proxy for this account — see [Proxy (SOCKS4/SOCKS5)](#proxy-socks4socks5) |
230
230
  | `manageChats` | string[] | unset | Chats the assistant may **manage** — see [Chat management](#chat-management). Absent or empty = management off; `["*"]` = every chat |
231
+ | `replyParseMode` | `"html"` \| `"markdown"` \| `"none"` | unset | Outbound format for replies, core-delivered text, captions and `send` calls that omit `parseMode` — see [Message formatting](#message-formatting) |
231
232
  | `twoFaPassword` | string \| SecretRef | unset | The account's Telegram 2FA password; read only by `transferOwnership` |
232
233
 
233
234
  Group config fields:
@@ -238,6 +239,22 @@ Group config fields:
238
239
  | `groupPolicy` | `"open"` \| `"mention"` | `"mention"` | `open` replies to any group message, `mention` only on @mention or reply-to-self |
239
240
  | `allowFrom` | string[] | `["*"]` | Allowed sender IDs/usernames inside that group |
240
241
 
242
+ ### Message formatting
243
+
244
+ `replyParseMode` sets the outbound format for every path that does not name
245
+ one explicitly: replies, core-delivered text, media captions, and `send`
246
+ actions without a `parseMode` parameter. A per-call `parseMode` still wins.
247
+
248
+ | Mode | Behavior |
249
+ |---|---|
250
+ | `"html"` | **Recommended for agents.** The text is rendered before sending (2.15.0): markdown (`**bold**`, `*italic*`, `` `code` ``, ``` fences, `[text](url)`, `# headings`, `> quotes`, `~~strike~~`, `\|\|spoiler\|\|`) becomes Telegram entities, hand-written Telegram HTML (`<b>`, `<a href>`, `<code>`, …) passes through, structural HTML (`<ul>`, `<p>`, …) is dropped, and stray `<`, `>`, `&` arrive as literal text instead of vanishing into a failed tag. Markdown inside code is never converted. |
251
+ | `"markdown"` | GramJS's own markdown parser: `**`, `__`, `~~`, `` ` ``, ``` ``` ``` only — no links, no single-asterisk emphasis. |
252
+ | `"none"` | No parsing at all: the text is delivered exactly as typed. |
253
+ | unset | GramJS's historical default, which is its markdown parser — **not** plain text. Set `"none"` if you want plain. |
254
+
255
+ Agent-authored messages mix markdown and HTML freely, so `"html"` is the mode
256
+ that renders both. There is no reliable way to prompt a model out of writing
257
+ markdown; rendering it is the deterministic fix.
241
258
 
242
259
  ### Configuration variant for example
243
260
 
package/dist/channel.js CHANGED
@@ -596,7 +596,8 @@ const createChannelPlugin = (runtimes, pluginRuntime) => {
596
596
  const sendTextToConversation = async (args) => {
597
597
  const targets = [conversationTarget, ...conversationFallbackTargets];
598
598
  // Replies have no per-call parseMode slot — the format is an
599
- // account setting (2.3.1); absent keeps plain text.
599
+ // account setting (2.3.1); absent keeps the GramJS default
600
+ // (its markdown parser — not plain text, see 2.15.0 notes).
600
601
  const replyParseMode = gram.replyParseMode;
601
602
  let lastError;
602
603
  for (const target of targets) {
@@ -1762,6 +1763,10 @@ const createChannelPlugin = (runtimes, pluginRuntime) => {
1762
1763
  target: uploadTo,
1763
1764
  file,
1764
1765
  caption: caption || undefined,
1766
+ // Same resolution as the text `send`: per-call value wins, an
1767
+ // omitted one inherits the account format (2.15.0). A caption is
1768
+ // the same prose as a message and renders identically.
1769
+ parseMode: (0, helpers_1.resolveOutboundParseMode)(params, cfg, uploadAccountId),
1765
1770
  replyToMessageId: (0, helpers_1.resolveReplyToMessageIdForTarget)(rawUploadTo, uploadReplyToId),
1766
1771
  messageThreadId: parseOptionalThreadId(uploadThreadId),
1767
1772
  asVoice,
@@ -2065,6 +2070,9 @@ const createChannelPlugin = (runtimes, pluginRuntime) => {
2065
2070
  target,
2066
2071
  file,
2067
2072
  caption: ctx.caption ?? ctx.text,
2073
+ // Captions follow the account reply format like every other reply:
2074
+ // they are the same agent prose, just attached to a file (2.15.0).
2075
+ parseMode: gram.replyParseMode,
2068
2076
  replyToMessageId: (0, helpers_1.resolveReplyToMessageIdForTarget)(ctx.to, ctx.replyToId),
2069
2077
  messageThreadId,
2070
2078
  asVoice: ctx.audioAsVoice === true,
@@ -8,6 +8,7 @@ const sessions_1 = require("telegram/sessions");
8
8
  // the package has no `exports` field to forbid it.
9
9
  const Password_1 = require("telegram/Password");
10
10
  const helpers_1 = require("./helpers");
11
+ const html_render_1 = require("./html-render");
11
12
  const proxy_config_1 = require("./proxy-config");
12
13
  const secret_refs_1 = require("./secret-refs");
13
14
  const history_1 = require("./history");
@@ -323,10 +324,20 @@ class GramJsClientManager {
323
324
  const messageThreadId = args.messageThreadId ?? resolved.messageThreadId;
324
325
  const replyParams = buildForumReplyParams(messageThreadId, args.replyToMessageId);
325
326
  return this.client.sendMessage(resolved.peer, {
326
- message: args.text,
327
- // GramJS accepts "md" | "html"; absent keeps plain text so every
328
- // pre-2.3.0 caller behaves exactly as before.
329
- ...(args.parseMode ? { parseMode: args.parseMode === "markdown" ? "md" : "html" } : {}),
327
+ // In html mode the text is rendered first: the agent writes markdown,
328
+ // Telegram HTML, or both, and GramJS's HTML parser alone would ship
329
+ // the markdown as literal asterisks (2026-08-12 00:13 UTC, a whole
330
+ // monthly report of them).
331
+ message: args.parseMode === "html" ? (0, html_render_1.renderTelegramHtml)(args.text) : args.text,
332
+ // GramJS accepts "md" | "html". `false` switches parsing off — needed
333
+ // because an *absent* mode is not plain text: GramJS then applies its
334
+ // own default markdown parser, and always has. "none" is the honest
335
+ // spelling of "exactly as typed".
336
+ ...(args.parseMode === "none"
337
+ ? { parseMode: false }
338
+ : args.parseMode
339
+ ? { parseMode: args.parseMode === "markdown" ? "md" : "html" }
340
+ : {}),
330
341
  ...replyParams,
331
342
  });
332
343
  }
@@ -561,7 +572,18 @@ class GramJsClientManager {
561
572
  const replyParams = buildForumReplyParams(messageThreadId, args.replyToMessageId);
562
573
  return this.client.sendFile(resolved.peer, {
563
574
  file: args.file,
564
- caption: args.caption,
575
+ // Captions are agent prose too — the outbound path sends `caption ??
576
+ // text` — so they render exactly like sendText does. Before 2.15.0
577
+ // captions carried no mode at all, which meant GramJS's default
578
+ // markdown pass, a third rendering behavior nobody chose.
579
+ caption: args.parseMode === "html" && args.caption
580
+ ? (0, html_render_1.renderTelegramHtml)(args.caption)
581
+ : args.caption,
582
+ ...(args.parseMode === "none"
583
+ ? { parseMode: false }
584
+ : args.parseMode
585
+ ? { parseMode: args.parseMode === "markdown" ? "md" : "html" }
586
+ : {}),
565
587
  ...replyParams,
566
588
  ...buildVoiceNoteParams(args.asVoice),
567
589
  });
package/dist/helpers.js CHANGED
@@ -564,15 +564,22 @@ function normalizeParseMode(raw) {
564
564
  return "markdown";
565
565
  if (value === "html")
566
566
  return "html";
567
- throw new Error(`clawgram: invalid parseMode "${String(raw)}" use "markdown" or "html"`);
567
+ // "none" switches GramJS parsing off entirely. It exists because absent is
568
+ // NOT plain text: GramJS falls back to its own markdown parser by default,
569
+ // which quietly ate `**` from "plain" sends since the fork began.
570
+ if (value === "none")
571
+ return "none";
572
+ throw new Error(`clawgram: invalid parseMode "${String(raw)}" — use "markdown", "html" or "none"`);
568
573
  }
569
574
  /**
570
575
  * Reply parse mode for the inbound reply path (2.3.1). The action `send`
571
576
  * takes parseMode per-call, but replies to a mention run through the reply
572
577
  * pipeline, which has no per-call slot — so the format is a channel setting:
573
- * `channels.clawgram.accounts.<id>.replyParseMode: "markdown" | "html"`.
574
- * Absent means plain text, exactly as before 2.3.1. An invalid value throws
575
- * at config-read time, loud and early, rather than shipping raw markup.
578
+ * `channels.clawgram.accounts.<id>.replyParseMode: "markdown" | "html" |
579
+ * "none"`. Absent keeps GramJS's historical default its markdown parser,
580
+ * not plain text, which 2.3.1 believed and 2.15.0 disproved. An invalid
581
+ * value throws at config-read time, loud and early, rather than shipping
582
+ * raw markup.
576
583
  */
577
584
  function resolveReplyParseMode(cfg, accountId) {
578
585
  const channel = cfg?.channels?.["clawgram"];
@@ -617,8 +624,11 @@ function resolveDryRun(dryRun, params) {
617
624
  function resolveOutboundParseMode(params, cfg, accountId) {
618
625
  const raw = params?.parseMode;
619
626
  // An explicitly empty value is a decision, not an omission: send it raw.
627
+ // "none" (not undefined) is what actually delivers on that: an absent
628
+ // parseMode at the GramJS boundary means GramJS's own default markdown
629
+ // parser, which would still eat `**` out of a message about markup.
620
630
  if (raw === "" || raw === null) {
621
- return undefined;
631
+ return "none";
622
632
  }
623
633
  return raw === undefined
624
634
  ? resolveReplyParseMode(cfg, accountId)
@@ -0,0 +1,461 @@
1
+ "use strict";
2
+ /**
3
+ * Markdown → Telegram HTML rendering for outbound text (2.15.0).
4
+ *
5
+ * The account's reply format is `html`, and the agent writes what language
6
+ * models write: markdown. GramJS's HTML parser does not touch markdown, so
7
+ * every `**bold**` reached a live work chat with its asterisks showing —
8
+ * 2026-08-12 00:13 UTC, a 2167-character monthly report worth of them. The
9
+ * converse configuration is no better: GramJS's markdown mode knows five
10
+ * delimiters and no links, so the HTML links the agent is told to use would
11
+ * arrive as tag soup. Neither mode alone can carry what the agent produces,
12
+ * which is markdown, Telegram HTML, or both in one message.
13
+ *
14
+ * This renderer runs in front of GramJS's HTML parser and emits HTML that
15
+ * parser maps onto Telegram entities:
16
+ *
17
+ * - Markdown becomes tags: `**b**`, `*i*`, `_i_`, `__b__`, `~~s~~`,
18
+ * `||spoiler||`, `` `code` ``, ``` fences (with language), `[text](url)`,
19
+ * `# heading` (a bold line), `> quote` (a blockquote).
20
+ * - HTML the parser understands passes through, its attributes reduced to
21
+ * the meaningful set. Bot-API-only names are mapped to what GramJS knows
22
+ * (`tg-spoiler` → `spoiler`, `ins` → `u`, `strike` → `s`, `h1..h6` → `b`);
23
+ * `<br>` becomes a newline.
24
+ * - Structural HTML Telegram cannot render (`<p>`, `<ul>`, `<li>`…) is
25
+ * dropped exactly as the parser silently drops it today, keeping the text.
26
+ * - Everything else — a stray `<`, a bare `&`, a `<плейсхолдер>` — is
27
+ * escaped, so it survives the parser as literal text instead of being
28
+ * half-eaten as a failed tag.
29
+ *
30
+ * Markdown inside code — spans, fences, `<code>`/`<pre>` bodies — is never
31
+ * converted; code arrives verbatim. Already-valid Telegram HTML passes
32
+ * through unchanged, which is what keeps the links that are authored as
33
+ * `<a href="…">` working.
34
+ */
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.renderTelegramHtml = renderTelegramHtml;
37
+ /** Tags GramJS's HTML parser turns into entities, plus aliases it does not
38
+ * know mapped onto ones it does. `canonical` is what gets emitted; `attrs`
39
+ * is the full set of attributes worth keeping for that tag. */
40
+ const TELEGRAM_TAGS = {
41
+ b: { canonical: "b" },
42
+ strong: { canonical: "strong" },
43
+ i: { canonical: "i" },
44
+ em: { canonical: "em" },
45
+ u: { canonical: "u" },
46
+ ins: { canonical: "u" },
47
+ s: { canonical: "s" },
48
+ del: { canonical: "del" },
49
+ strike: { canonical: "s" },
50
+ spoiler: { canonical: "spoiler" },
51
+ "tg-spoiler": { canonical: "spoiler" },
52
+ a: { canonical: "a", attrs: ["href"] },
53
+ code: { canonical: "code", attrs: ["class"] },
54
+ pre: { canonical: "pre" },
55
+ blockquote: { canonical: "blockquote", attrs: ["expandable"] },
56
+ "tg-emoji": { canonical: "tg-emoji", attrs: ["emoji-id"] },
57
+ h1: { canonical: "b" },
58
+ h2: { canonical: "b" },
59
+ h3: { canonical: "b" },
60
+ h4: { canonical: "b" },
61
+ h5: { canonical: "b" },
62
+ h6: { canonical: "b" },
63
+ };
64
+ /** Structural HTML the parser swallows today; keep swallowing it rather than
65
+ * turning a `<ul>` the agent wrote into visible angle brackets. */
66
+ const DROP_TAGS = new Set([
67
+ "p", "div", "span", "ul", "ol", "li", "hr", "table", "thead", "tbody",
68
+ "tr", "td", "th", "details", "summary", "img", "small", "sup", "sub",
69
+ "font", "center", "section", "article", "header", "footer", "main", "nav",
70
+ ]);
71
+ const TAG_RE = /^<(\/?)([a-zA-Z][a-zA-Z0-9-]*)((?:"[^"]*"|'[^']*'|[^>"'])*)>/;
72
+ const ATTR_RE = /([a-zA-Z-]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+)))?/g;
73
+ /** A character reference the parser will decode; everything else is a bare `&`. */
74
+ const ENTITY_RE = /^&(?:#\d{1,7}|#[xX][0-9a-fA-F]{1,6}|[a-zA-Z][a-zA-Z0-9]{1,31});/;
75
+ const WORD_RE = /[\p{L}\p{N}_]/u;
76
+ /** GFM backslash-escapable punctuation, so `\*` means a literal asterisk. */
77
+ const ESCAPABLE = new Set([..."\\`*_{}[]()#+-.!|~<>"]);
78
+ const EMPHASIS = {
79
+ "*": [
80
+ { len: 3, open: "<b><i>", close: "</i></b>" },
81
+ { len: 2, open: "<b>", close: "</b>" },
82
+ { len: 1, open: "<i>", close: "</i>" },
83
+ ],
84
+ "_": [
85
+ { len: 3, open: "<b><i>", close: "</i></b>" },
86
+ { len: 2, open: "<b>", close: "</b>" },
87
+ { len: 1, open: "<i>", close: "</i>" },
88
+ ],
89
+ "~": [{ len: 2, open: "<s>", close: "</s>" }],
90
+ "|": [{ len: 2, open: "<spoiler>", close: "</spoiler>" }],
91
+ };
92
+ /** `&`/`<`/`>` escaped unconditionally — for code bodies generated from
93
+ * markdown, where a `&amp;` the author typed must arrive as `&amp;`. */
94
+ function escapeAll(text) {
95
+ return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
96
+ }
97
+ /** Like {@link escapeAll}, but an already-written character reference is kept,
98
+ * so hand-authored HTML (`a &lt; b`) is not double-escaped into `&amp;lt;`. */
99
+ function escapeKeepEntities(text) {
100
+ let out = "";
101
+ for (let i = 0; i < text.length; i++) {
102
+ const c = text[i];
103
+ if (c === "&") {
104
+ const m = ENTITY_RE.exec(text.slice(i));
105
+ if (m) {
106
+ out += m[0];
107
+ i += m[0].length - 1;
108
+ }
109
+ else {
110
+ out += "&amp;";
111
+ }
112
+ }
113
+ else if (c === "<") {
114
+ out += "&lt;";
115
+ }
116
+ else if (c === ">") {
117
+ out += "&gt;";
118
+ }
119
+ else {
120
+ out += c;
121
+ }
122
+ }
123
+ return out;
124
+ }
125
+ /** Attribute values may arrive raw (`?a=1&b=2`) or escaped (`&amp;`); decode
126
+ * the few references that matter, then encode once. Idempotent either way. */
127
+ function escapeAttr(value) {
128
+ const decoded = value
129
+ .replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">")
130
+ .replace(/&quot;/g, "\"").replace(/&#0?39;/g, "'");
131
+ return decoded
132
+ .replace(/&/g, "&amp;").replace(/</g, "&lt;")
133
+ .replace(/>/g, "&gt;").replace(/"/g, "&quot;");
134
+ }
135
+ /** URL schemes worth turning into a link entity. Anything else stays text:
136
+ * a relative path or a bare word in `[x](y)` position is not a Telegram link. */
137
+ const URL_RE = /^(https?:\/\/|tg:\/\/|mailto:)/i;
138
+ function parseAttrs(raw) {
139
+ const attrs = new Map();
140
+ for (const m of raw.matchAll(ATTR_RE)) {
141
+ attrs.set(m[1].toLowerCase(), m[2] ?? m[3] ?? m[4] ?? "");
142
+ }
143
+ return attrs;
144
+ }
145
+ function buildOpenTag(canonical, allowed, attrs) {
146
+ let out = `<${canonical}`;
147
+ for (const name of allowed ?? []) {
148
+ if (!attrs.has(name))
149
+ continue;
150
+ const value = attrs.get(name) ?? "";
151
+ if (name === "href" && !URL_RE.test(value.trim()))
152
+ continue;
153
+ if (name === "class" && !/^language-[\w+#.-]+$/.test(value))
154
+ continue;
155
+ if (name === "emoji-id" && !/^\d+$/.test(value))
156
+ continue;
157
+ out += value === "" && name === "expandable" ? ` ${name}` : ` ${name}="${escapeAttr(value)}"`;
158
+ }
159
+ return out + ">";
160
+ }
161
+ function tryCodeSpan(s, i) {
162
+ let run = 0;
163
+ while (s[i + run] === "`")
164
+ run++;
165
+ let k = i + run;
166
+ while (k < s.length) {
167
+ if (s[k] !== "`") {
168
+ k++;
169
+ continue;
170
+ }
171
+ let end = k;
172
+ while (s[end] === "`")
173
+ end++;
174
+ if (end - k === run) {
175
+ let inner = s.slice(i + run, k);
176
+ if (inner.includes("\n\n"))
177
+ return null;
178
+ // GFM: one space is stripped from each side when both are present,
179
+ // so `` ` code ` `` can hold a leading backtick.
180
+ if (inner.length >= 2 && inner.startsWith(" ") && inner.endsWith(" ") && inner.trim() !== "") {
181
+ inner = inner.slice(1, -1);
182
+ }
183
+ return { html: `<code>${escapeAll(inner)}</code>`, next: end };
184
+ }
185
+ k = end;
186
+ }
187
+ return null;
188
+ }
189
+ function tryLink(s, i) {
190
+ let depth = 1;
191
+ let j = i + 1;
192
+ for (; j < s.length; j++) {
193
+ const c = s[j];
194
+ if (c === "\n")
195
+ return null;
196
+ if (c === "\\")
197
+ j++;
198
+ else if (c === "[")
199
+ depth++;
200
+ else if (c === "]" && --depth === 0)
201
+ break;
202
+ }
203
+ if (depth !== 0 || s[j + 1] !== "(")
204
+ return null;
205
+ let pdepth = 1;
206
+ let k = j + 2;
207
+ for (; k < s.length; k++) {
208
+ const c = s[k];
209
+ if (c === "\n")
210
+ return null;
211
+ if (c === "\\")
212
+ k++;
213
+ else if (c === "(")
214
+ pdepth++;
215
+ else if (c === ")" && --pdepth === 0)
216
+ break;
217
+ }
218
+ if (pdepth !== 0)
219
+ return null;
220
+ const label = s.slice(i + 1, j);
221
+ let dest = s.slice(j + 2, k).trim();
222
+ if (dest.startsWith("<") && dest.endsWith(">"))
223
+ dest = dest.slice(1, -1);
224
+ const ws = dest.search(/\s/);
225
+ if (ws !== -1)
226
+ dest = dest.slice(0, ws); // an optional "title" is dropped
227
+ if (label.length === 0 || !URL_RE.test(dest))
228
+ return null;
229
+ return { html: `<a href="${escapeAttr(dest)}">${renderInline(label)}</a>`, next: k + 1 };
230
+ }
231
+ function tryEmphasis(s, i) {
232
+ const ch = s[i];
233
+ const variants = EMPHASIS[ch];
234
+ if (!variants)
235
+ return null;
236
+ let run = 0;
237
+ while (s[i + run] === ch)
238
+ run++;
239
+ for (const v of variants) {
240
+ if (run < v.len)
241
+ continue;
242
+ const after = s[i + v.len];
243
+ // Left flank: the run must hug its content. `2 * 3` stays arithmetic.
244
+ if (after === undefined || /\s/.test(after))
245
+ continue;
246
+ // `_` must not open inside a word, or snake_case_names grow italics.
247
+ if (ch === "_" && i > 0 && WORD_RE.test(s[i - 1]))
248
+ continue;
249
+ const delim = ch.repeat(v.len);
250
+ let j = s.indexOf(delim, i + v.len);
251
+ while (j !== -1) {
252
+ const between = s.slice(i + v.len, j);
253
+ if (between.includes("\n\n"))
254
+ break; // an emphasis does not cross a blank line
255
+ const before = s[j - 1];
256
+ const afterClose = s[j + v.len];
257
+ const closes = before !== undefined && !/\s/.test(before)
258
+ && (ch !== "_" || afterClose === undefined || !WORD_RE.test(afterClose));
259
+ if (closes && between.length > 0) {
260
+ return { html: v.open + renderInline(between) + v.close, next: j + v.len };
261
+ }
262
+ j = s.indexOf(delim, j + 1);
263
+ }
264
+ }
265
+ return null;
266
+ }
267
+ /** Inline pass: markdown spans, allowed HTML, and escaping, over text that
268
+ * the block pass already cleared of fences, headings and quotes. */
269
+ function renderInline(s) {
270
+ let out = "";
271
+ let i = 0;
272
+ while (i < s.length) {
273
+ const c = s[i];
274
+ if (c === "\\" && i + 1 < s.length && ESCAPABLE.has(s[i + 1])) {
275
+ const next = s[i + 1];
276
+ out += next === "<" ? "&lt;" : next === ">" ? "&gt;" : next;
277
+ i += 2;
278
+ continue;
279
+ }
280
+ if (c === "<") {
281
+ const m = TAG_RE.exec(s.slice(i));
282
+ if (m) {
283
+ const closing = m[1] === "/";
284
+ const name = m[2].toLowerCase();
285
+ if (name === "br") {
286
+ if (!closing)
287
+ out += "\n";
288
+ i += m[0].length;
289
+ continue;
290
+ }
291
+ const spec = TELEGRAM_TAGS[name];
292
+ if (spec) {
293
+ if (closing) {
294
+ out += `</${spec.canonical}>`;
295
+ i += m[0].length;
296
+ continue;
297
+ }
298
+ if (spec.canonical === "code" || spec.canonical === "pre") {
299
+ // Code bodies pass through untouched by markdown: `**` inside
300
+ // <code> is content, not emphasis.
301
+ const close = s.toLowerCase().indexOf(`</${name}>`, i + m[0].length);
302
+ if (close !== -1) {
303
+ out += buildOpenTag(spec.canonical, spec.attrs, parseAttrs(m[3]))
304
+ + escapeKeepEntities(s.slice(i + m[0].length, close))
305
+ + `</${spec.canonical}>`;
306
+ i = close + name.length + 3;
307
+ continue;
308
+ }
309
+ // An unclosed <code> is not markup; fall through to a literal `<`.
310
+ }
311
+ else {
312
+ out += buildOpenTag(spec.canonical, spec.attrs, parseAttrs(m[3]));
313
+ i += m[0].length;
314
+ continue;
315
+ }
316
+ }
317
+ else if (DROP_TAGS.has(name)) {
318
+ i += m[0].length;
319
+ continue;
320
+ }
321
+ }
322
+ out += "&lt;";
323
+ i++;
324
+ continue;
325
+ }
326
+ if (c === "&") {
327
+ const m = ENTITY_RE.exec(s.slice(i));
328
+ if (m) {
329
+ out += m[0];
330
+ i += m[0].length;
331
+ }
332
+ else {
333
+ out += "&amp;";
334
+ i++;
335
+ }
336
+ continue;
337
+ }
338
+ if (c === ">") {
339
+ out += "&gt;";
340
+ i++;
341
+ continue;
342
+ }
343
+ if (c === "`") {
344
+ const span = tryCodeSpan(s, i);
345
+ if (span) {
346
+ out += span.html;
347
+ i = span.next;
348
+ continue;
349
+ }
350
+ let run = 0;
351
+ while (s[i + run] === "`")
352
+ run++;
353
+ out += s.slice(i, i + run);
354
+ i += run;
355
+ continue;
356
+ }
357
+ if (c === "[") {
358
+ const link = tryLink(s, i);
359
+ if (link) {
360
+ out += link.html;
361
+ i = link.next;
362
+ continue;
363
+ }
364
+ out += c;
365
+ i++;
366
+ continue;
367
+ }
368
+ if (c === "*" || c === "_" || c === "~" || c === "|") {
369
+ const em = tryEmphasis(s, i);
370
+ if (em) {
371
+ out += em.html;
372
+ i = em.next;
373
+ continue;
374
+ }
375
+ let run = 0;
376
+ while (s[i + run] === c)
377
+ run++;
378
+ out += s.slice(i, i + run);
379
+ i += run;
380
+ continue;
381
+ }
382
+ out += c;
383
+ i++;
384
+ }
385
+ return out;
386
+ }
387
+ const FENCE_OPEN_RE = /^\s{0,3}(`{3,}|~{3,})\s*(.*)$/;
388
+ const FENCE_CLOSE_RE = /^\s{0,3}(`{3,}|~{3,})\s*$/;
389
+ const HEADING_RE = /^\s{0,3}(#{1,6})\s+(.*)$/;
390
+ const QUOTE_RE = /^\s{0,3}>\s?(.*)$/;
391
+ /**
392
+ * Render agent-authored text — markdown, Telegram HTML, or a mix — into
393
+ * HTML for GramJS's `html` parse mode. Block constructs are handled here;
394
+ * everything between them goes through {@link renderInline} as one chunk,
395
+ * so an emphasis may span a soft line break but never a blank line.
396
+ */
397
+ function renderTelegramHtml(input) {
398
+ const lines = input.split("\n");
399
+ const out = [];
400
+ let plain = [];
401
+ const flush = () => {
402
+ if (plain.length > 0) {
403
+ out.push(renderInline(plain.join("\n")));
404
+ plain = [];
405
+ }
406
+ };
407
+ let i = 0;
408
+ while (i < lines.length) {
409
+ const line = lines[i];
410
+ const fence = FENCE_OPEN_RE.exec(line);
411
+ if (fence) {
412
+ const marker = fence[1][0];
413
+ const minLen = fence[1].length;
414
+ const info = (fence[2].trim().split(/\s+/)[0] ?? "");
415
+ const lang = /^[\w+#.-]+$/.test(info) ? info : "";
416
+ const body = [];
417
+ let j = i + 1;
418
+ let closed = false;
419
+ for (; j < lines.length; j++) {
420
+ const close = FENCE_CLOSE_RE.exec(lines[j]);
421
+ if (close && close[1][0] === marker && close[1].length >= minLen) {
422
+ closed = true;
423
+ break;
424
+ }
425
+ body.push(lines[j]);
426
+ }
427
+ flush();
428
+ const code = escapeAll(body.join("\n"));
429
+ out.push(lang
430
+ ? `<pre><code class="language-${lang}">${code}</code></pre>`
431
+ : `<pre>${code}</pre>`);
432
+ i = closed ? j + 1 : lines.length;
433
+ continue;
434
+ }
435
+ const heading = HEADING_RE.exec(line);
436
+ if (heading) {
437
+ flush();
438
+ out.push(`<b>${renderInline(heading[2].trim())}</b>`);
439
+ i++;
440
+ continue;
441
+ }
442
+ if (QUOTE_RE.test(line)) {
443
+ flush();
444
+ const quoted = [];
445
+ let j = i;
446
+ for (; j < lines.length; j++) {
447
+ const q = QUOTE_RE.exec(lines[j]);
448
+ if (!q)
449
+ break;
450
+ quoted.push(q[1]);
451
+ }
452
+ out.push(`<blockquote>${renderInline(quoted.join("\n"))}</blockquote>`);
453
+ i = j;
454
+ continue;
455
+ }
456
+ plain.push(line);
457
+ i++;
458
+ }
459
+ flush();
460
+ return out.join("\n");
461
+ }
@@ -2,7 +2,7 @@
2
2
  "id": "clawgram",
3
3
  "name": "Clawgram",
4
4
  "description": "Clawgram — personal Telegram (MTProto userbot) channel for OpenClaw. Your AI assistant reads and responds as you.",
5
- "version": "2.14.0",
5
+ "version": "2.15.0",
6
6
  "configSchema": {
7
7
  "type": "object",
8
8
  "additionalProperties": false,
@@ -382,9 +382,10 @@
382
382
  "enum": [
383
383
  "markdown",
384
384
  "md",
385
- "html"
385
+ "html",
386
+ "none"
386
387
  ],
387
- "description": "Parse mode for replies (2.3.1). The send action takes parseMode per call; the reply pipeline has no per-call slot, so the reply format is configured here. Absent means plain text."
388
+ "description": "Outbound format for replies, core-delivered text, captions and send calls that omit parseMode. html (2.15.0) renders agent markdown and Telegram HTML into entities; markdown is GramJS's five-delimiter parser; none disables parsing entirely. Absent keeps GramJS's historical default, which is its markdown parser not plain text."
388
389
  }
389
390
  },
390
391
  "required": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "clawgram",
3
- "version": "2.14.0",
3
+ "version": "2.15.0",
4
4
  "description": "Clawgram — personal Telegram (MTProto userbot) channel for OpenClaw. Your AI assistant reads and responds as you.",
5
5
  "main": "./dist/index.js",
6
6
  "scripts": {