Skip to content

Image Messages

This page covers how agents and teams see images sent in Matrix rooms, which image formats they receive, and what happens when a model cannot accept an image. Images follow the same rules as other attachments for captions, routing, encryption, size limits, attachment IDs, and retention; see Attachments.

Sending Images

Send an image in a room and mention the agent or team in the caption, for example @assistant What does this diagram show?. No configuration is needed; the image is passed to the responder's model as vision input, so that model must support vision (for example Claude or GPT-6.2 Astra). A model without vision answers through the media fallback.

Captions from bridges trigger a response when they mention the agent through Matrix mention metadata, an HTML mention pill, or plain @name text.

Image Formats

MindRoom recognizes PNG, JPEG, GIF, WebP, BMP, and TIFF images from their content and sends the recognized type to the model, logging a warning when the client declared a different MIME type. Other image formats are sent with the client's declared MIME type, and the provider may reject them.

Media Fallback

When a provider rejects a request containing inline media (images, audio, video, or documents), MindRoom retries it without that media. The retry adds [Inline media unavailable for this model] to the message that carried the media and tells the agent the content was not inspected, so the agent can still open the file through the attachments tool or explain the limitation. When the error names the attachments it rejected, the retry leaves out only those, or every attachment of the same type, and the note lists them by file name, with the attachment ID of a stored attachment. Otherwise, or if the provider rejects that retry too, all of the request's media is left out. If the provider error says the model does not support that kind of input, such as does not support image input or is not a multimodal model, later requests to the same model leave that media kind out from the start until MindRoom restarts. Other rejections, such as an image the provider could not decode, drop the media from that one request only. The same note replaces only that attachment when an attachment file no longer exists or cannot be read, or when MindRoom cannot download media a tool returned as a URL, including media larger than 20 MiB. Once a reply has produced text, tool calls, or reasoning, a later provider error is reported instead of retried without media, and provider safeguard refusals and the billing refusals listed under Retries are never retried without media.