You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
AttachmentsArea: what it touches
ImprovementsKind: in v2.1.292,
ImprovementsSection of the release
What
A PDF can still be downloading or arriving when Claude tries to read it. That happens, for example, when it came with a message whose files were not finished, or when it was attached with an @-mention while it was still being written. Claude Code now handles this case:
New text tells the model that the PDF came with a user message whose files were still being downloaded when the turn began. The Read tool waits up to ten minutes for the download.
An @-mentioned PDF that is still arriving returns a pdf_reference marked stillArriving: true, and tengu_pdf_reference_attachment is emitted for it.
PDF page extraction and reads now take an already-open file handle (held/handle) instead of reopening the file by its path.
Oversized @-mentions call an onTooLarge callback.
Whole-PDF rendering is still controlled by the tengu_deep_starlight gate, with a fallback of true. Nothing has been read about that gate under this release.
The stock Read tool description captured under this release is unchanged.
Why
The model is less likely to conclude that a PDF is missing when it is only late. Reading through a file handle that is already open means the file being read is the one that was opened, not a different file swapped in at the same path after the check.
