Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python

Escape Telegram MarkdownV2 image fallback as plain text (#1526)

Sepuri Sai Krishnaf405a929f7c1
diff --git a/pyproject.toml b/pyproject.toml
index b58ec960..fd914bd2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "5.13.9"
+version = "5.13.10"
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
requires-python = ">=3.14.0"
diff --git a/src/free_claude_code/messaging/rendering/telegram_markdown.py b/src/free_claude_code/messaging/rendering/telegram_markdown.py
index b0c24c6a..a59a330a 100644
--- a/src/free_claude_code/messaging/rendering/telegram_markdown.py
+++ b/src/free_claude_code/messaging/rendering/telegram_markdown.py
@@ -128,10 +128,14 @@ def render_markdown_to_mdv2(text: str) -> str:
if key == "src":
href = val
break
+ # MarkdownV2 has no image entity, so an image degrades to plain
+ # text. Escape it as text: escape_md_v2_link_url only covers the
+ # link-destination set and would leave '(', ')', '.', '_' bare,
+ # which Telegram rejects with "can't parse entities".
if alt:
- out.append(f"{escape_md_v2(alt)} ({escape_md_v2_link_url(href)})")
+ out.append(escape_md_v2(f"{alt} ({href})"))
else:
- out.append(escape_md_v2_link_url(href))
+ out.append(escape_md_v2(href))
else:
out.append(escape_md_v2(tok.content or ""))
i += 1
diff --git a/tests/messaging/test_handler_markdown_and_status_edges.py b/tests/messaging/test_handler_markdown_and_status_edges.py
index 48156cbf..614dd24a 100644
--- a/tests/messaging/test_handler_markdown_and_status_edges.py
+++ b/tests/messaging/test_handler_markdown_and_status_edges.py
@@ -7,6 +7,7 @@ from free_claude_code.messaging.command_context import StopOutcome
from free_claude_code.messaging.models import IncomingMessage, MessageScope
from free_claude_code.messaging.node_event_pipeline import process_parsed_cli_event
from free_claude_code.messaging.rendering.telegram_markdown import (
+ escape_md_v2,
render_markdown_to_mdv2,
)
from free_claude_code.messaging.trees import (
@@ -85,10 +86,34 @@ def test_render_markdown_to_mdv2_covers_common_structures():
assert "3\\." in out
assert "> quote" in out
assert "[link]" in out
- assert "alt (http://example.com/img.png)" in out
+ assert escape_md_v2("alt (http://example.com/img.png)") in out
assert "```" in out
+def test_render_markdown_to_mdv2_escapes_image_fallback_as_plain_text():
+ out = render_markdown_to_mdv2("![alt](http://x.com/a_b.png)")
+
+ assert out == escape_md_v2("alt (http://x.com/a_b.png)")
+ assert "(" not in out.replace("\\(", "")
+ assert ")" not in out.replace("\\)", "")
+ assert "." not in out.replace("\\.", "")
+ assert "_" not in out.replace("\\_", "")
+
+
+def test_render_markdown_to_mdv2_escapes_image_without_alt_text():
+ out = render_markdown_to_mdv2("![](http://x.com/a-b.png)")
+
+ assert out == escape_md_v2("http://x.com/a-b.png")
+ assert "." not in out.replace("\\.", "")
+ assert "-" not in out.replace("\\-", "")
+
+
+def test_render_markdown_to_mdv2_escapes_image_embedded_in_text():
+ out = render_markdown_to_mdv2("see ![d](https://e.com/d-1.png) here")
+
+ assert escape_md_v2("d (https://e.com/d-1.png)") in out
+
+
def test_render_markdown_to_mdv2_renders_table_as_code_block():
md = "| a | b |\n|---|---|\n| 1 | 2 |\n| 3 | 4 |\n\nAfter.\n"
out = render_markdown_to_mdv2(md)
diff --git a/uv.lock b/uv.lock
index 067dd732..d93cc6b7 100644
--- a/uv.lock
+++ b/uv.lock
@@ -607,7 +607,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "5.13.9"
+version = "5.13.10"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },