Module turn 

Turn submission, acceptance, cancellation, and queue DTOs.

Structs

TurnAccepted

Accepted turn response.

TurnAttachment

One client-read text attachment for a submitted turn.

TurnCancelParams

Parameters for cancelling an active turn.

TurnQueueRemoveParams

Parameters for removing one queued message by entry id.

TurnQueueRemoveResult

Outcome of a remove-one-queued-message request.

TurnQueueStatus

Authoritative queued-message snapshot published by the service.

TurnQueueTakeLatestParams

Parameters for popping the newest queued message back for editing.

TurnQueueTakeLatestResult

Result of popping the newest queued message.

TurnSubmitParams

Parameters for submitting a prompt to the selected session.

TurnUndoFile

One reversed file change.

TurnUndoParams

Parameters for reversing one turn’s exact file changes.

TurnUndoResult

Outcome of a turn undo request.

Constants

MAX_QUEUE_ENTRY_ID_LEN

Bounded identity token for one queue entry, minted by the service so the client can address one message for take-latest and remove without relying on positional order (which races against concurrent submits).

MAX_QUEUE_PREVIEW_CHARS

Maximum characters per queued-message preview before truncation. Mirrors the CLI sidebar preview width.

MAX_QUEUE_STATUS_PREVIEWS

Maximum queued-message previews carried by one queue-status notification. Mirrors the CLI sidebar, which renders the first few queued inputs.

SESSION_START_TURN_ID

Fallback turn id for interactions raised with no active turn (startup decisions). Produced by the service, matched by the desktop client.

STARTUP_INTERACTION_PENDING_ERROR

A turn was rejected before delivery because a startup interaction is pending.

Functions

queue_preview_label

Build the display preview for one queued message: the full text when it fits, otherwise the first MAX_QUEUE_PREVIEW_CHARS characters plus an ellipsis. Truncation is char-boundary safe; newlines are preserved for the client to render.