/** * Regression tests for Telegram markdown rendering helpers * Covers nested lists, code blocks, tables, links, quotes, chunking, and other Telegram-specific render edge cases */ import assert from "node:assert/strict"; import test from "node:test"; import { MAX_MESSAGE_LENGTH, renderBlockMessage, renderTelegramMessage, type DisplayMode, } from "../lib/rendering.ts"; test("renderBlockMessage returns undefined for text blocks in all modes", () => { const block = { type: "text" as const, text: "hello" }; for (const mode of ["full", "compact", "text"] as DisplayMode[]) { assert.equal(renderBlockMessage(block, mode), undefined); } }); test("renderBlockMessage renders thinking block with blockquote", () => { const block = { type: "thinking" as const, text: "Need to inspect the config first." }; const result = renderBlockMessage(block, "full"); assert.ok(result?.startsWith("**Thinking**\n>")); assert.ok(result?.includes("Need to inspect the config first.")); }); test("renderBlockMessage truncates thinking in compact mode", () => { const longText = "x".repeat(600); const block = { type: "thinking" as const, text: longText }; const compact = renderBlockMessage(block, "compact")!; const full = renderBlockMessage(block, "full")!; assert.ok(compact.length < full.length); assert.match(compact, /\[compact trace truncated; use \/trace for full\]/); assert.ok(full.includes(longText)); }); test("renderBlockMessage renders tool_call block", () => { const block = { type: "tool_call" as const, name: "read_config", argsText: '{"path":"config.json"}' }; const result = renderBlockMessage(block, "full")!; assert.ok(result.includes("**Tool call**")); assert.ok(result.includes("`read_config`")); }); test("renderBlockMessage uses code fence for long tool_call args", () => { const block = { type: "tool_call" as const, name: "write_file", argsText: '{\n "path": "out/report.md",\n "content": "long body"\n}', }; const result = renderBlockMessage(block, "full")!; assert.match(result, /\*\*Tool call\*\* `write_file`/); assert.match(result, /```json/); }); test("renderBlockMessage renders tool_result and hides it in text mode", () => { const block = { type: "tool_result" as const, text: "file contents here", toolName: "read_file" }; assert.equal(renderBlockMessage(block, "text"), undefined); const compact = renderBlockMessage(block, "compact")!; assert.ok(compact.includes("**Tool result**")); assert.ok(compact.includes("`read_file`")); assert.ok(compact.includes("file contents here")); const full = renderBlockMessage(block, "full")!; assert.ok(full.includes("file contents here")); }); test("renderBlockMessage formats bash tool_result output as visible code", () => { const block = { type: "tool_result" as const, text: "line 1\rline 2\nCommand exited with code 0", toolName: "bash", detailsText: '{\n "fullOutputPath": "/tmp/full-output.txt"\n}', }; const result = renderBlockMessage(block, "full")!; assert.match(result, /\*\*Tool result\*\* `bash`/); assert.match(result, /\*\*output\*\*/); assert.match(result, /```text\nline 1\nline 2\nCommand exited with code 0\n```/); assert.match(result, /\*\*details\*\*/); assert.match(result, /fullOutputPath/); }); test("renderBlockMessage truncates tool_result in compact mode", () => { const block = { type: "tool_result" as const, text: "x".repeat(600) }; const compact = renderBlockMessage(block, "compact")!; const full = renderBlockMessage(block, "full")!; assert.ok(compact.length < full.length); assert.match(compact, /\[compact trace truncated; use \/trace for full\]/); assert.ok(full.includes("x".repeat(600))); }); test("renderBlockMessage renders unknown trace blocks instead of dropping them", () => { const block = { type: "unknown" as const, label: "server_tool_result", text: '{\n "output": "visible fallback"\n}', }; const result = renderBlockMessage(block, "full")!; assert.match(result, /\*\*Trace block\*\* `server_tool_result`/); assert.match(result, /visible fallback/); assert.equal(renderBlockMessage(block, "text"), undefined); }); test("renderBlockMessage marks truncated tool_call args in compact mode", () => { const block = { type: "tool_call" as const, name: "write_file", argsText: "x".repeat(600), }; const compact = renderBlockMessage(block, "compact")!; const full = renderBlockMessage(block, "full")!; assert.match(compact, /\[compact trace truncated; use \/trace for full\]/); assert.ok(full.includes("x".repeat(600))); }); test("Nested lists stay out of code blocks", () => { const chunks = renderTelegramMessage( "- Level 1\n - Level 2\n - Level 3 with **bold** text", { mode: "markdown" }, ); assert.ok(chunks.length > 0); assert.equal( chunks.some((chunk) => chunk.text.includes("
")),
    false,
  );
  assert.equal(
    chunks.some((chunk) =>
      chunk.text.includes("- Level 3 with bold text"),
    ),
    true,
  );
});

test("Fenced code blocks preserve literal markdown", () => {
  const chunks = renderTelegramMessage(
    '~~~ts\nconst value = "**raw**";\n~~~',
    { mode: "markdown" },
  );
  assert.equal(chunks.length, 1);
  assert.match(chunks[0]?.text ?? "", /
/);
  assert.match(chunks[0]?.text ?? "", /\*\*raw\*\*/);
});

test("Underscores inside words do not become italic", () => {
  const chunks = renderTelegramMessage(
    "Path: foo_bar_baz.txt and **bold**",
    { mode: "markdown" },
  );
  assert.equal(chunks.length, 1);
  assert.equal((chunks[0]?.text ?? "").includes("bar"), false);
  assert.match(chunks[0]?.text ?? "", /bold<\/b>/);
});

test("Quoted nested lists stay in blockquote rendering", () => {
  const chunks = renderTelegramMessage(
    "> Quoted intro\n> - nested item\n>   - deeper item",
    { mode: "markdown" },
  );
  assert.equal(chunks.length, 1);
  assert.match(chunks[0]?.text ?? "", /
/); assert.match(chunks[0]?.text ?? "", /nested item/); assert.match(chunks[0]?.text ?? "", /-<\/code> nested item/); assert.equal((chunks[0]?.text ?? "").includes("
"), false);
});

test("Numbered lists use monospace numeric markers", () => {
  const chunks = renderTelegramMessage(
    "1. first\n  2. second",
    { mode: "markdown" },
  );
  assert.equal(chunks.length, 1);
  assert.match(chunks[0]?.text ?? "", /1\.<\/code> first/);
  assert.match(chunks[0]?.text ?? "", /2\.<\/code> second/);
});

test("Nested blockquotes flatten into one Telegram blockquote with indentation", () => {
  const chunks = renderTelegramMessage(
    "> outer\n>> inner\n>>> deepest",
    { mode: "markdown" },
  );
  assert.equal(chunks.length, 1);
  assert.equal((chunks[0]?.text.match(/
/g) ?? []).length, 1); assert.equal((chunks[0]?.text.match(/<\/blockquote>/g) ?? []).length, 1); assert.match(chunks[0]?.text ?? "", /outer/); assert.match(chunks[0]?.text ?? "", /\u00A0\u00A0inner/); assert.match(chunks[0]?.text ?? "", /\u00A0\u00A0\u00A0\u00A0deepest/); }); test("Markdown tables render as literal monospace blocks without outer side borders", () => { const chunks = renderTelegramMessage( "| Name | Value |\n| --- | --- |\n| **x** | `y` |", { mode: "markdown" }, ); assert.equal(chunks.length, 1); assert.match(chunks[0]?.text ?? "", /
/);
  assert.equal((chunks[0]?.text ?? "").includes("x"), false);
  assert.match(chunks[0]?.text ?? "", /Name\s+\|\s+Value/);
  assert.match(chunks[0]?.text ?? "", /x\s+\|\s+y/);
  assert.equal((chunks[0]?.text ?? "").includes("| Name |"), false);
  assert.equal((chunks[0]?.text ?? "").includes("| x |"), false);
});

test("Links, code spans, and underscore-heavy text coexist safely", () => {
  const chunks = renderTelegramMessage(
    "See [docs](https://example.com), run `foo_bar()` and keep foo_bar.txt literal",
    { mode: "markdown" },
  );
  assert.equal(chunks.length, 1);
  assert.match(
    chunks[0]?.text ?? "",
    /docs<\/a>/,
  );
  assert.match(chunks[0]?.text ?? "", /foo_bar\(\)<\/code>/);
  assert.equal((chunks[0]?.text ?? "").includes("bar"), false);
});

test("Long quoted blocks stay chunked with balanced blockquote tags", () => {
  const markdown = Array.from(
    { length: 500 },
    (_, index) => `> quoted **${index}** line`,
  ).join("\n");
  const chunks = renderTelegramMessage(markdown, {
    mode: "markdown",
  });
  assert.ok(chunks.length > 1);
  for (const chunk of chunks) {
    assert.ok(chunk.text.length <= MAX_MESSAGE_LENGTH);
    assert.equal(
      (chunk.text.match(/
/g) ?? []).length, (chunk.text.match(/<\/blockquote>/g) ?? []).length, ); } }); test("Long markdown replies stay chunked below Telegram limits", () => { const markdown = Array.from( { length: 600 }, (_, index) => `- item **${index}**`, ).join("\n"); const chunks = renderTelegramMessage(markdown, { mode: "markdown", }); assert.ok(chunks.length > 1); for (const chunk of chunks) { assert.ok(chunk.text.length <= MAX_MESSAGE_LENGTH); assert.equal( (chunk.text.match(//g) ?? []).length, (chunk.text.match(/<\/b>/g) ?? []).length, ); } }); test("Long mixed links and code spans stay chunked with balanced inline tags", () => { const markdown = Array.from( { length: 450 }, (_, index) => `Paragraph ${index}: see [docs ${index}](https://example.com/${index}), run \`code_${index}()\`, and keep foo_bar_${index}.txt literal`, ).join("\n\n"); const chunks = renderTelegramMessage(markdown, { mode: "markdown", }); assert.ok(chunks.length > 1); for (const chunk of chunks) { assert.ok(chunk.text.length <= MAX_MESSAGE_LENGTH); assert.equal( (chunk.text.match(//g) ?? []).length, ); assert.equal( (chunk.text.match(//g) ?? []).length, (chunk.text.match(/<\/code>/g) ?? []).length, ); assert.equal((chunk.text ?? "").includes("bar"), false); } }); test("Long multi-block markdown keeps quotes and code fences structurally balanced", () => { const markdown = Array.from({ length: 120 }, (_, index) => { return [ `## Section ${index}`, `> quoted **${index}** line`, `- item ${index}`, "```ts", `const value_${index} = \"**raw**\";`, "```", ].join("\n"); }).join("\n\n"); const chunks = renderTelegramMessage(markdown, { mode: "markdown", }); assert.ok(chunks.length > 1); for (const chunk of chunks) { assert.ok(chunk.text.length <= MAX_MESSAGE_LENGTH); assert.equal( (chunk.text.match(/
/g) ?? []).length, (chunk.text.match(/<\/blockquote>/g) ?? []).length, ); assert.equal( (chunk.text.match(/
<\/pre>/g) ?? []).length,
    );
  }
});

test("Chunked mixed block transitions keep quote and list structure balanced", () => {
  const markdown = Array.from({ length: 260 }, (_, index) => {
    return [
      `> quoted **${index}** intro`,
      `> continuation ${index}`,
      `- item ${index}`,
      `plain paragraph ${index} with [link](https://example.com/${index})`,
    ].join("\n");
  }).join("\n\n");
  const chunks = renderTelegramMessage(markdown, {
    mode: "markdown",
  });
  assert.ok(chunks.length > 1);
  for (const chunk of chunks) {
    assert.ok(chunk.text.length <= MAX_MESSAGE_LENGTH);
    assert.equal(
      (chunk.text.match(/
/g) ?? []).length, (chunk.text.match(/<\/blockquote>/g) ?? []).length, ); assert.equal( (chunk.text.match(//g) ?? []).length, ); } }); test("Chunked code fence transitions keep code blocks closed before following prose", () => { const markdown = Array.from({ length: 220 }, (_, index) => { return [ "```ts", `const block_${index} = \"value_${index}\";`, "```", `After code **${index}** and \`inline_${index}()\``, ].join("\n"); }).join("\n\n"); const chunks = renderTelegramMessage(markdown, { mode: "markdown", }); assert.ok(chunks.length > 1); for (const chunk of chunks) { assert.ok(chunk.text.length <= MAX_MESSAGE_LENGTH); assert.equal( (chunk.text.match(/
<\/pre>/g) ?? []).length,
    );
    assert.equal(
      (chunk.text.match(//g) ?? []).length,
      (chunk.text.match(/<\/code>/g) ?? []).length,
    );
  }
});

test("Long inline formatting paragraphs stay balanced across chunk boundaries", () => {
  const markdown = Array.from({ length: 500 }, (_, index) => {
    return `Segment ${index} keeps **bold_${index}** with \`code_${index}()\`, [link_${index}](https://example.com/${index}), and foo_bar_${index}.txt literal.`;
  }).join(" ");
  const chunks = renderTelegramMessage(markdown, {
    mode: "markdown",
  });
  assert.ok(chunks.length > 1);
  for (const chunk of chunks) {
    assert.ok(chunk.text.length <= MAX_MESSAGE_LENGTH);
    assert.equal(
      (chunk.text.match(//g) ?? []).length,
      (chunk.text.match(/<\/b>/g) ?? []).length,
    );
    assert.equal(
      (chunk.text.match(//g) ?? []).length,
    );
    assert.equal(
      (chunk.text.match(//g) ?? []).length,
      (chunk.text.match(/<\/code>/g) ?? []).length,
    );
    assert.equal(chunk.text.includes("bar"), false);
  }
});

test("Chunked list, code, quote, and prose cycles stay balanced across transitions", () => {
  const markdown = Array.from({ length: 180 }, (_, index) => {
    return [
      `- list item **${index}**`,
      "```ts",
      `const cycle_${index} = \"value_${index}\";`,
      "```",
      `> quoted ${index} with [link](https://example.com/${index})`,
      `Plain paragraph ${index} with \`inline_${index}()\``,
    ].join("\n");
  }).join("\n\n");
  const chunks = renderTelegramMessage(markdown, {
    mode: "markdown",
  });
  assert.ok(chunks.length > 1);
  for (const chunk of chunks) {
    assert.ok(chunk.text.length <= MAX_MESSAGE_LENGTH);
    assert.equal(
      (chunk.text.match(/
<\/pre>/g) ?? []).length,
    );
    assert.equal(
      (chunk.text.match(/
/g) ?? []).length, (chunk.text.match(/<\/blockquote>/g) ?? []).length, ); assert.equal( (chunk.text.match(//g) ?? []).length, ); } });