hnshah c7f021f70f fix: preflight invalid telegram photos (#52545) (thanks @hnshah) ...

* fix(telegram): validate photo dimensions before sendPhoto

Prevents PHOTO_INVALID_DIMENSIONS errors by checking image dimensions
against Telegram Bot API requirements before calling sendPhoto.

If dimensions exceed limits (width + height > 10,000px), automatically
falls back to sending as document instead of crashing with 400 error.

Tested in production (openclaw 2026.3.13) where this error occurred:
  [telegram] tool reply failed: GrammyError: Call to 'sendPhoto' failed!
  (400: Bad Request: PHOTO_INVALID_DIMENSIONS)

Uses existing sharp dependency to read image metadata. Gracefully
degrades if sharp fails (lets Telegram handle validation, backward
compatible behavior).

Closes: #XXXXX (will reference OpenClaw issue if one exists)

* fix(telegram): validate photo aspect ratio

* refactor: use shared telegram image metadata

* fix: fail closed on telegram image metadata

* fix: preflight invalid telegram photos (#52545) (thanks @hnshah)

---------

Co-authored-by: Bob Shah <bobshah@Macs-Mac-Studio.local>
Co-authored-by: Ayaan Zaidi <hi@obviy.us>

2026-03-25 12:00:20 +05:30

..

bot

test: speed up discord slack telegram suites

2026-03-24 16:26:58 +00:00

account-inspect.test.ts

refactor: split plugin testing seam from bundled extension helpers

2026-03-17 01:05:09 -07:00

account-inspect.ts

refactor: consolidate plugin sdk surface

2026-03-20 19:24:10 +00:00

accounts.test.ts

refactor: split plugin testing seam from bundled extension helpers

2026-03-17 01:05:09 -07:00

accounts.ts

refactor: share account id selection helpers

2026-03-22 19:45:59 +00:00

action-runtime.test.ts

refactor(telegram): unify action normalization

2026-03-18 09:15:41 +05:30

action-runtime.ts

fix: document Telegram asDocument alias (#52461) (thanks @bakhtiersizhaev)

2026-03-23 17:32:46 +05:30

allow-from.ts

refactor: remove channel shim directories, point all imports to extensions (#45967)

2026-03-14 03:43:07 -07:00

allowed-updates.test.ts

test: harden channel suite isolation

2026-03-23 12:57:43 +00:00

allowed-updates.ts

fix(telegram): harden grammy seams across tests

2026-03-22 21:46:26 -07:00

api-fetch.test.ts

feat(telegram): support custom apiRoot for alternative API endpoints (#48842)

2026-03-21 10:10:38 +05:30

api-fetch.ts

feat(telegram): support custom apiRoot for alternative API endpoints (#48842)

2026-03-21 10:10:38 +05:30

api-logging.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

approval-buttons.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

approval-buttons.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

audit-membership-runtime.ts

feat(telegram): support custom apiRoot for alternative API endpoints (#48842)

2026-03-21 10:10:38 +05:30

audit.test.ts

test: harden threaded shared-worker suites

2026-03-24 08:37:00 +00:00

audit.ts

feat(telegram): support custom apiRoot for alternative API endpoints (#48842)

2026-03-21 10:10:38 +05:30

bot-access.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

bot-access.ts

refactor: consolidate plugin sdk surface

2026-03-20 19:24:10 +00:00

bot-deps.ts

test: inject thread-safe gateway and ACP seams

2026-03-23 04:34:42 -07:00

bot-handlers.buffers.ts

refactor: consolidate plugin sdk surface

2026-03-20 19:24:10 +00:00

bot-handlers.media.ts

refactor: split remaining monitor runtime helpers

2026-03-17 20:36:03 -07:00

bot-handlers.runtime.ts

Telegram: recover General topic bindings (#53699)

2026-03-24 10:51:26 -04:00

bot-handlers.ts

refactor: dedupe channel plugin shared assembly

2026-03-17 20:13:52 -07:00

bot-message-context.acp-bindings.test.ts

fix: preserve Telegram forum topic last-route delivery (#53052) (thanks @VACInc)

2026-03-25 11:31:01 +05:30

bot-message-context.audio-transcript.test.ts

test: speed up telegram extension suites

2026-03-24 15:57:16 +00:00

bot-message-context.body.ts

refactor: consolidate plugin sdk surface

2026-03-20 19:24:10 +00:00

bot-message-context.dm-threads.test.ts

test: speed up telegram extension suites

2026-03-24 15:57:16 +00:00

bot-message-context.dm-topic-threadid.test.ts

fix: preserve Telegram forum topic last-route delivery (#53052) (thanks @VACInc)

2026-03-25 11:31:01 +05:30

bot-message-context.implicit-mention.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

bot-message-context.named-account-dm.test.ts

refactor: dedupe test helpers and harnesses

2026-03-24 21:41:46 +00:00

bot-message-context.route-test-support.ts

refactor: dedupe test helpers and harnesses

2026-03-24 21:41:46 +00:00

bot-message-context.sender-prefix.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

bot-message-context.session.ts

fix: preserve Telegram forum topic last-route delivery (#53052) (thanks @VACInc)

2026-03-25 11:31:01 +05:30

bot-message-context.test-harness.ts

test: harden channel suite isolation

2026-03-23 12:57:43 +00:00

bot-message-context.thread-binding.test.ts

fix: preserve Telegram forum topic last-route delivery (#53052) (thanks @VACInc)

2026-03-25 11:31:01 +05:30

bot-message-context.topic-agentid.test.ts

fix(ci): update vitest configs after channel move to extensions/ (openclaw#46066)

2026-03-14 13:23:25 -05:00

bot-message-context.ts

Telegram: recover General topic bindings (#53699)

2026-03-24 10:51:26 -04:00

bot-message-context.types.ts

fix(agents): avoid model catalog startup tax on telegram replies

2026-03-21 15:03:55 -07:00

bot-message-dispatch.sticker-media.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

bot-message-dispatch.test.ts

test: speed up telegram and whatsapp suites

2026-03-24 21:48:07 +00:00

bot-message-dispatch.ts

test: inject thread-safe gateway and ACP seams

2026-03-23 04:34:42 -07:00

bot-message.test.ts

test: speed up telegram extension suites

2026-03-24 15:16:18 +00:00

bot-message.ts

Telegram: recover General topic bindings (#53699)

2026-03-24 10:51:26 -04:00

bot-native-command-menu.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

bot-native-command-menu.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

bot-native-commands.fixture-test-support.ts

Plugins: internalize telegram SDK imports

2026-03-17 23:09:26 -07:00

bot-native-commands.group-auth.test.ts

Telegram: stabilize pairing/session/forum routing and reply formatting tests (#50155)

2026-03-19 00:01:14 -05:00

bot-native-commands.menu-test-support.ts

refactor: dedupe test helpers and harnesses

2026-03-24 21:41:46 +00:00

bot-native-commands.plugin-auth.test.ts

test: harden channel suite isolation

2026-03-23 11:09:12 +00:00

bot-native-commands.registry.test.ts

test: speed up telegram extension suites

2026-03-24 15:57:16 +00:00

bot-native-commands.session-meta.test.ts

test: speed up telegram extension suites

2026-03-24 15:57:16 +00:00

bot-native-commands.skills-allowlist.test.ts

test(telegram): fix native command runtime mocks

2026-03-18 12:46:09 +05:30

bot-native-commands.test-helpers.ts

test: harden channel suite isolation

2026-03-23 11:09:12 +00:00

bot-native-commands.test.ts

refactor: dedupe test helpers and harnesses

2026-03-24 21:41:46 +00:00

bot-native-commands.ts

fix: keep Telegram native commands on runtime snapshot (#53179) (thanks @nimbleenigma)

2026-03-25 11:18:54 +05:30

bot-updates.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

bot.create-telegram-bot.channel-post-media.test.ts

refactor: dedupe test helpers and harnesses

2026-03-24 21:41:46 +00:00

bot.create-telegram-bot.test-harness.ts

Telegram: recover General topic bindings (#53699)

2026-03-24 10:51:26 -04:00

bot.create-telegram-bot.test.ts

fix: scope Telegram pairing code blocks (#52784) (thanks @sumukhj1219)

2026-03-25 11:03:33 +05:30

bot.fetch-abort.test.ts

perf(core): trim provider and inbound startup imports (#51927)

2026-03-21 16:20:42 -07:00

bot.helpers.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

bot.media.downloads-media-file-path-no-file-download.e2e.test.ts

test(telegram): stabilize inbound media harness

2026-03-18 13:35:56 +05:30

bot.media.e2e-harness.ts

Telegram: stabilize pairing/session/forum routing and reply formatting tests (#50155)

2026-03-19 00:01:14 -05:00

bot.media.stickers-and-fragments.e2e.test.ts

Telegram: stabilize pairing/session/forum routing and reply formatting tests (#50155)

2026-03-19 00:01:14 -05:00

bot.media.test-utils.ts

test: stabilize e2e module isolation

2026-03-23 11:46:54 +00:00

bot.runtime.ts

test(telegram): add bot runtime seam

2026-03-18 10:12:15 +05:30

bot.test.ts

fix: keep Telegram native commands on runtime snapshot (#53179) (thanks @nimbleenigma)

2026-03-25 11:18:54 +05:30

bot.ts

perf(core): trim provider and inbound startup imports (#51927)

2026-03-21 16:20:42 -07:00

button-types.test.ts

refactor: unify telegram interactive button resolution

2026-03-16 05:54:16 +00:00

button-types.ts

refactor(plugin-sdk): split interactive runtime helpers

2026-03-18 11:30:34 +05:30

caption.test.ts

test(telegram): cover caption and forum service helpers

2026-03-22 15:58:33 -07:00

caption.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

channel-actions.test.ts

refactor(telegram): unify action normalization

2026-03-18 09:15:41 +05:30

channel-actions.ts

fix: document Telegram asDocument alias (#52461) (thanks @bakhtiersizhaev)

2026-03-23 17:32:46 +05:30

channel.setup.ts

Plugins: internalize telegram SDK imports

2026-03-17 23:09:26 -07:00

channel.test.ts

refactor(test): dedupe channel startup test setup

2026-03-22 03:50:41 +00:00

channel.ts

refactor: simplify telegram status snapshots

2026-03-22 23:37:12 +00:00

config-schema.ts

refactor: consolidate plugin sdk surface

2026-03-20 19:24:10 +00:00

conversation-route.base-session-key.test.ts

Telegram: fix named-account DM topic session keys (#48773)

2026-03-17 00:41:44 -07:00

conversation-route.ts

ACP: harden startup and move configured routing behind plugin seams (#48197)

2026-03-17 17:27:52 +01:00

directory-config.ts

perf: reduce runtime and test startup overhead

2026-03-21 20:18:16 +00:00

dm-access.test.ts

fix: scope Telegram pairing code blocks (#52784) (thanks @sumukhj1219)

2026-03-25 11:03:33 +05:30

dm-access.ts

fix: scope Telegram pairing code blocks (#52784) (thanks @sumukhj1219)

2026-03-25 11:03:33 +05:30

draft-chunking.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

draft-chunking.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

draft-stream.test-helpers.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

draft-stream.test.ts

fix: finish telegram reply fallback landing (#52524) (thanks @moltbot886)

2026-03-22 18:54:01 -07:00

draft-stream.ts

fix: finish telegram reply fallback landing (#52524) (thanks @moltbot886)

2026-03-22 18:54:01 -07:00

exec-approvals-handler.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

exec-approvals-handler.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

exec-approvals.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

exec-approvals.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

fetch.env-proxy-runtime.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

fetch.test.ts

test: speed up telegram extension suites

2026-03-24 15:16:18 +00:00

fetch.ts

fix(security): harden explicit-proxy SSRF pinning

2026-03-22 23:05:42 -07:00

format.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

format.ts

fix: defer plugin runtime globals until use

2026-03-21 11:14:48 +05:30

format.wrap-md.test.ts

fix: preserve Telegram word boundaries when rechunking HTML (#47274)

2026-03-15 18:10:49 +05:30

forum-service-message.test.ts

test(telegram): cover caption and forum service helpers

2026-03-22 15:58:33 -07:00

forum-service-message.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

group-access.base-access.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

group-access.policy-access.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

group-access.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

group-config-helpers.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

group-migration.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

group-migration.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

group-policy.ts

refactor: consolidate plugin sdk surface

2026-03-20 19:24:10 +00:00

inline-buttons.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

inline-buttons.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

lane-delivery-state.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

lane-delivery-text-deliverer.ts

fix: emit message:sent hook on Telegram streaming preview finalization (#50917)

2026-03-20 22:42:04 +05:30

lane-delivery.test.ts

fix: emit message:sent hook on Telegram streaming preview finalization (#50917)

2026-03-20 22:42:04 +05:30

lane-delivery.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

media-understanding.runtime.ts

build: remove ineffective dynamic import shims

2026-03-16 23:11:59 -07:00

message-tool-schema.ts

Plugins: move message tool schemas into channel plugins

2026-03-19 01:08:23 -04:00

model-buttons.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

model-buttons.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

monitor.test.ts

test: speed up telegram extension suites

2026-03-24 15:16:18 +00:00

monitor.ts

fix(telegram): persist sticky IPv4 fallback across polling restarts (fixes #48177) (#48282)

2026-03-17 21:56:12 +05:30

network-config.test.ts

test: harden channel suite isolation

2026-03-23 11:09:12 +00:00

network-config.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

network-errors.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

network-errors.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

normalize.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

outbound-adapter.test.ts

tests: add boundary coverage for media delivery (#53361)

2026-03-23 23:37:34 -05:00

outbound-adapter.ts

perf: reduce plugin runtime startup overhead

2026-03-22 09:35:36 +00:00

outbound-params.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

polling-session.test.ts

test: harden channel suite isolation

2026-03-23 11:09:12 +00:00

polling-session.ts

fix: harden gateway SIGTERM shutdown (#51242) (thanks @juliabush)

2026-03-23 15:01:42 +05:30

probe.test.ts

test: speed up telegram extension suites

2026-03-24 15:16:18 +00:00

probe.ts

feat(telegram): support custom apiRoot for alternative API endpoints (#48842)

2026-03-21 10:10:38 +05:30

proxy.test.ts

test: harden channel suite isolation

2026-03-23 11:09:12 +00:00

proxy.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

reaction-level.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

reaction-level.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

reasoning-lane-coordinator.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

reasoning-lane-coordinator.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

runtime.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

send.proxy.test.ts

test: speed up telegram extension suites

2026-03-24 15:57:16 +00:00

send.test-harness.ts

fix: preflight invalid telegram photos (#52545) (thanks @hnshah)

2026-03-25 12:00:20 +05:30

send.test.ts

fix: preflight invalid telegram photos (#52545) (thanks @hnshah)

2026-03-25 12:00:20 +05:30

send.ts

fix: preflight invalid telegram photos (#52545) (thanks @hnshah)

2026-03-25 12:00:20 +05:30

sendchataction-401-backoff.test.ts

test: speed up telegram extension suites

2026-03-24 15:16:18 +00:00

sendchataction-401-backoff.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

sent-message-cache.ts

refactor: dedupe extension runtime caches

2026-03-22 18:09:45 +00:00

sequential-key.test.ts

Add /btw side questions (#45444)

2026-03-14 17:27:54 +02:00

sequential-key.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

setup-core.ts

feat(telegram): support custom apiRoot for alternative API endpoints (#48842)

2026-03-21 10:10:38 +05:30

setup-surface.test.ts

test: collapse telegram and whatsapp target suites

2026-03-25 05:21:16 +00:00

setup-surface.ts

refactor: share channel setup status helpers

2026-03-23 01:56:01 +00:00

shared.ts

refactor: share scoped account accessor adapters

2026-03-22 20:30:21 +00:00

status-issues.test.ts

ci: fix workflow sanity gate

2026-03-22 23:04:04 +00:00

status-issues.ts

refactor: consolidate plugin sdk surface

2026-03-20 19:24:10 +00:00

status-reaction-variants.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

status-reaction-variants.ts

refactor: consolidate plugin sdk surface

2026-03-20 19:24:10 +00:00

sticker-cache.test.ts

refactor(channels): route media helpers through runtime

2026-03-16 22:58:55 -07:00

sticker-cache.ts

refactor(channels): route media helpers through runtime

2026-03-16 22:58:55 -07:00

target-writeback.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

targets.test.ts

test: collapse telegram and whatsapp target suites

2026-03-25 05:21:16 +00:00

targets.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

thread-bindings.test.ts

fix(telegram): serialize thread binding persists

2026-03-20 00:30:11 -07:00

thread-bindings.ts

refactor: dedupe extension runtime caches

2026-03-22 18:09:45 +00:00

token.test.ts

refactor: share normalized account lookups

2026-03-22 19:01:52 +00:00

token.ts

refactor: share normalized account lookups

2026-03-22 19:01:52 +00:00

update-offset-store.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

update-offset-store.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

voice.test.ts

refactor: move Telegram channel implementation to extensions/ (#45635)

2026-03-14 02:50:17 -07:00

voice.ts

refactor: untangle remaining plugin sdk boundaries

2026-03-16 21:16:32 -07:00

webhook.test.ts

test: speed up slack and telegram suites

2026-03-24 17:16:25 +00:00

webhook.ts

fix(telegram): harden grammy seams across tests

2026-03-22 21:46:26 -07:00