{"version":"2.1.290","anchor":"user-message-uuid-schema-description-updated","canonical_anchor":"user-message-uuid-schema-description-updated","heading":"Headless sessions report more about interrupted and resumed turns","tier":"notice","area":"SDK","scope":"individual","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.290\/e\/user-message-uuid-schema-description-updated","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.290","markdown":"### Headless sessions report more about interrupted and resumed turns\n\nHeadless and SDK sessions now report the turn's state when it is interrupted, and carry the original prompt's ID and resume reason when they resume it\n\n**What**\n\nA headless session is Claude Code running without its interactive screen, usually driven by another program through the SDK, the kit developers use to build on Claude Code. This release changes how such sessions describe an interrupted turn and its resumption. A turn is one round of you asking and Claude answering.\n\n- The receipt for an interrupt now includes a `turn` field describing the turn's state. Before, it held only `still_queued` and `cancelled`. A new `headless_interrupt_turn` event is also emitted.\n\n- When an interrupted turn is resumed, the queued command now carries `resumedTurnUserMessageUuid`, `resumedTurnOpenerVouched` and `resumeReason`.\n\n- The description of `user_message_uuid` was rewritten to match. A turn that carries `resume_reason` now stamps the interrupted turn's last user prompt \"where that can be vouched for\". A turn that continues after a permission answer may send the assistant message again without a stamp. The old description talked about a start-up rescue turn re-running a turn that a worker restart had cut off.\n\n**Why**\n\nPrograms built on Claude Code can tell what state a turn was in when it was interrupted. They can also link a resumed turn back to the prompt that started it, and they know when that link cannot be trusted.\n\n- Area: SDK\n- Names: `user_message_uuid`\n- Tier: You'll notice\n- Useful: 2\/5\n- Signal: 2\/5\n- Scope: individual\n- Heads-up: no"}