PRD: Image Recognition / Alt-Text for iMessage Attachments (AQUAPING #16)

Status

Draft — awaiting implementation team review

Context

AQUAPING is an iMessage client for the Anbernic RG40XX-V handheld (640×480, gamepad + Bluetooth keyboard). It runs a PyGame TUI over a TCP relay to BlueBubbles on a Mac via Tailscale. The client renders a chat list → message view flow with iMessage-style bubbles. Currently, the client is text-only: image and video attachments are silently ignored.

Current behavior: Messages with attachments show no content in the chat log. The user has no way to know an image was sent or received.

Target behavior: When an image attachment is present in a message, the system generates a text description of the image using a vision LLM (Minimax), and displays that description inline in the chat as a special bubble.