Follow Discord
Sweep 25 Sep 2026 · 19:33Z Build v2.1.283 504 read Stable v2.1.274 Latest v2.1.283 Next v2.1.283 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.281 ·

SDK conversation_reset messages say what caused the reset

The SDK conversation_reset message gains optional trigger, user_message_uuid and timestamp fields, and ultraplan's fresh-session flow sets its trigger

Group of 2 Use it now No documentation found Improvements
JSON All of v2.1.281
Use it nowTier: how much it should matter to you
2Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
SDKArea: what it touches
ImprovementsKind: in v2.1.281,
What probably matters to youSection of the release

What

The SDK (the kit developers use to build their own programs on top of Claude Code) sends a conversation_reset message whenever the current conversation is thrown away. That message now has three new optional fields:

  • trigger says what discarded the conversation: clear, plan_mode_exit, fresh_session or onboarding. clear means the /clear command or its aliases /reset and /new.
  • user_message_uuid lets a program match the reset to the /clear message it has already seen.
  • timestamp is an ISO time that can be shown to the user.

The description of the message now also lists onboarding re-runs as a cause. The ultraplan flow that implements a plan "in a fresh session" now marks its reset as fresh_session.

Why

Programs built on the SDK, and Remote Control clients, can now tell why a conversation was reset. They can also clear a transcript exactly once, even when the related messages arrive out of order.

Read from
Names in the bundleconversation_reset
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Confirmed since Anthropic's documentation has since written up conversation_reset, on Agent SDK reference - TypeScript. * `trigger`: what discarded the conversation. Reset your transcript on every `conversation_reset` message, including one where this field is absent or carries a value you don't recognize. agent-sdk/typescript see the edit
How sure we are
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up conversation_reset, on Agent SDK reference - TypeScript.

See this entry in the whole of v2.1.281 →

Feedback