1.292.17 – Oct 4, 2026

Document migration metadata preservation

Higher-revision @HandleDocument replacements now preserve metadata from the exact stored document, including through upcasting. Returning a Message explicitly replaces the payload and complete metadata map; existing document identity, timestamp precedence and deletion behavior remain unchanged.

Metadata-free documents use a lightweight scan that avoids rebuilding document entries. Custom serializers that create new envelopes or decoded messages can preserve source attribution with DocumentMessageReader.retainSource; the extension contract is documented in Javadoc.

This is the SDK 1.x maintenance backport of the fix released in SDK 2.13.0. It retains the 1.x serialization implementation and does not introduce Model diagnostics or other 2.x features.

Full changelog: 1.292.16...1.292.17