Enum ClientMessage 

pub enum ClientMessage {
    HelloMath {
        client_instance_id: String,
        version: String,
        min_supported_version: String,
        resume_thread_id: Option<Uuid>,
        automagic: bool,
        system_info: ClientSystemInfo,
    },
    SendMessage {
        request_id: Uuid,
        thread_id: Option<Uuid>,
        text: String,
        runtime_mode: Option<RuntimeMode>,
        model_override: Option<ThreadModelOverride>,
    },
    UpdateAuthToken {
        token: String,
    },
    UpdateWorkspaceRoots {
        workspace_roots: Vec<WorkspaceRoot>,
    },
    RejectToolCall {
        id: String,
        reason: Option<String>,
    },
    AcceptToolCall {
        id: String,
    },
    ResolveSubagentEscalation {
        parent_message_id: Uuid,
        subagent_run_id: Uuid,
        escalation_id: String,
        resolution: SubagentEscalationResolution,
    },
    ToolCallOutputs {
        outputs: Vec<ToolCallOutput>,
    },
    CancelGeneration {
        message_id: Uuid,
    },
}

Variants

HelloMath

Fields

client_instance_id: String

Random per-client-instance id (generated on client startup).

Used for multi-client tool-call claiming/coordination. Not derived from auth token.

version: String

Client version.

min_supported_version: String

Minimum supported server version (the client can work with any server >= this).

resume_thread_id: Option<Uuid>

Optional thread root message id used by reconnecting clients to restore active thread state.

automagic: bool

Whether the client is currently running in automagic mode.

system_info: ClientSystemInfo

Normalized snapshot of the client machine.

Older clients may omit this; missing values deserialize as “unknown”.

SendMessage

Send a user message.

If thread_id is None, the server creates a new thread and returns it in SendMessageAck. request_id is a client-generated correlation id for 1:1 request↔response mapping.

Fields

request_id: Uuid

thread_id: Option<Uuid>

text: String

runtime_mode: Option<RuntimeMode>

Optional runtime mode update to apply to the thread before generation.

model_override: Option<ThreadModelOverride>

Optional model override update to apply to the thread before generation.

• None: do not change current override.
• Some(value): set override to value.

UpdateAuthToken

Update/refresh auth token without reconnecting the WebSocket.

Fields

token: String

UpdateWorkspaceRoots

Replace the client-local workspace snapshot exposed to the server for this connection.

Sent separately from HelloMath so workspace state can be updated without reconnecting.

Fields

workspace_roots: Vec<WorkspaceRoot>

RejectToolCall

Fields

id: String

reason: Option<String>

AcceptToolCall

Fields

id: String

ResolveSubagentEscalation

Fields

parent_message_id: Uuid

subagent_run_id: Uuid

escalation_id: String

resolution: SubagentEscalationResolution

ToolCallOutputs

Fields

outputs: Vec<ToolCallOutput>

CancelGeneration

Cancel the current in-progress generation for a specific assistant message.

Fields

message_id: Uuid

Trait Implementations

impl Clone for ClientMessage

fn clone(&self) -> ClientMessage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ClientMessage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ClientMessage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ClientMessage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.