Skip to content
Developer Preview

turn/interrupt

Stops the running turn on the runtime’s priority lane, optionally pairing a durable retract intent.

Type: TurnInterruptParams

turn/interrupt params: the “user pressed stop” gesture, on the runtime’s priority lane.

Field Type Stability Presence Description
commandId string required The idempotency handle (UUIDv7).
retract boolean optional Pair a retract intent with the interrupt: if the turn is cancelled before any assistant output committed, the submission is durably retracted (view event turn/retracted) so the client may restore the prompt text. A rejected retract does not undo the interrupt. Default false.
sessionId string required The target session.
turnId string optional The exact turn to interrupt. Omit to target the session’s current foreground turn, resolved at admission; prefer passing the explicit id when you have one.
Source

schema/msp/experimental/msp.schema.json#/methods/turn~2Finterrupt

{
"description": "Stops the running turn on the runtime's priority lane, optionally pairing a durable retract intent.",
"params": {
"$ref": "#/$defs/TurnInterruptParams"
},
"result": {
"$ref": "#/$defs/TurnInterruptResult"
}
}