dsh-attachment-downscale

DSH image attachment admission rejects files that are over 2000px on one side, over 3.5MB, or over 40 million pixels, which makes uploading phone originals or high-resolution photos frustrating. dsh-attachment-downscale hooks into the attachments service entry point saveImages and uses sharp to automatically normalize oversized images before they are stored: proportional scaling keeps the long side at or below 2000px, and if the result is still too large, it steps down jpeg/webp quality or falls back to webp.

Animated multi-frame GIF and WebP files are skipped so their animation is not damaged, and any processing failure falls back to the original admission logic, preserving the existing rejection behavior without hiding errors. As a result, stored images always meet DSH limits, and later model requests, vision-bridge calls, and history exports receive compliant files.

It is useful for developers and agent-workflow users who regularly attach high-resolution phone photos, on-site images, or external visual assets to DSH, and who want fewer upload rejections, less manual compression, and safe handling of animated images.