What changed
The text_embeds input for SAM3, EdgeTAM, and SAM3-Lite-Text vision models now expects the full text encoder output instead of just the pooler output. Code passing only the pooler output will produce silently incorrect results or raise a shape mismatch error after upgrading to v5.9.0.
Developer signal
Before running pip install --upgrade transformers, audit every pipeline that invokes SAM3, EdgeTAM, or SAM3-Lite-Text. Any call passing encoder.pooler_output (or .last_hidden_state[:, 0, :] equivalent) as text_embeds must be updated to pass the full encoder output tensor. This was a precision bug — the old pooler-only path was diverging from the reference implementation, causing subtle inaccuracies in segmentation masks. If you rely on fine-tuned checkpoints for these models, verify output consistency after the update on a held-out set before deploying. Unaffected: all non-vision models, SAM1/SAM2, any other HuggingFace model class.