Sweep 19 Sep 2026 · 02:36Z Build v2.1.278 500 read Stable v2.1.267 Latest v2.1.278 Next v2.1.278 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.269 ·

user_message_uuid stamping behavior for SDK streams clarified

Documentation for the SDK's user_message_uuid now matches its actual behavior across partial and complete assistant messages

TierYou'll noticehow much it should matter to you
Useful2my rating, 1 to 5
Signal1worth watching, 1 to 5
AreaSDKwhat it touches
KindImprovementsin v2.1.269,
Group of 2 You'll notice

Documentation for the SDK's user_message_uuid now matches its actual behavior across partial and complete assistant messages

What

  • The documented behavior of user_message_uuid changed: it stamps the turn's first top-level assistant message (which may be only a thinking block, or a synthetic API-error message), not simply the first reply frame.
  • With --include-partial-messages, the first non-ping stream event is now stamped independently of the completed message, so the same uuid can appear on two frames instead of the partial stream replacing the complete-message stamp.
  • The SDK docstring now also clarifies that a turn started by a typed prompt stamps both its first non-ping stream event and, independently, its first complete assistant message (SDKAssistantMessage.user_message_uuid), so both can carry the same uuid.

Why This makes the SDK's documentation match its real streaming behavior, so integrators relying on user_message_uuid to correlate partial and complete messages get accurate expectations instead of being misled by outdated docs.

Read from
Names in the bundleuser_message_uuid
What the documentation says

See this entry in the whole of v2.1.269 →