Enum RemoteMessage 

pub enum RemoteMessage {
    Register {
        api_key: String,
        hostname: String,
        os: String,
        version: String,
        protocol: Option<ProtocolHello>,
        device_fingerprint: Option<String>,
    },
    Heartbeat {
        session_token: String,
        agents: Vec<RemoteAgentInfo>,
        system_load: f32,
    },
    CommandResult {
        command_id: String,
        success: bool,
        result: Option<Value>,
        error: Option<String>,
    },
    AgentEvent {
        event_type: AgentEventType,
        agent_id: String,
        data: Value,
    },
    AgentStream {
        agent_id: String,
        chunk_type: StreamChunkType,
        content: String,
    },
    Pong {
        timestamp: i64,
    },
    PermissionRequest {
        request_id: String,
        agent_id: String,
        tool_name: String,
        action: String,
        details: Value,
        timeout_secs: u32,
    },
    AttachmentReceived {
        attachment_id: String,
        success: bool,
        file_path: Option<String>,
        error: Option<String>,
    },
}

Messages FROM CLI TO Backend

Variants

Register

Initial registration with API key and protocol negotiation

Fields

api_key: String

API key for authentication.

hostname: String

Client hostname.

os: String

Client operating system.

version: String

Client version string.

protocol: Option<ProtocolHello>

Protocol negotiation (optional for backward compatibility)

device_fingerprint: Option<String>

Stable device fingerprint — SHA-256(machine_id || hostname || os). Used for device allowlist verification by the backend.

Heartbeat

Regular heartbeat with agent status

Fields

session_token: String

Session token for authentication.

agents: Vec<RemoteAgentInfo>

List of active agents.

system_load: f32

Current system load (0.0-1.0).

CommandResult

Response to a command

Fields

command_id: String

ID of the command being responded to.

success: bool

Whether the command succeeded.

result: Option<Value>

Result data if successful.

error: Option<String>

Error message if failed.

AgentEvent

Agent event (new agent, agent exit, state change)

Fields

event_type: AgentEventType

Type of agent event.

agent_id: String

ID of the agent this event relates to.

data: Value

Event-specific data payload.

AgentStream

Stream chunk from agent (for real-time viewing)

Fields

agent_id: String

ID of the agent producing the stream.

chunk_type: StreamChunkType

Type of stream chunk.

content: String

Chunk content text.

Pong

Pong response to backend ping

Fields

timestamp: i64

Timestamp from the original ping.

PermissionRequest

Request permission from the remote user for a dangerous tool call

Fields

request_id: String

Unique request identifier.

agent_id: String

Agent session ID that wants to execute the tool.

tool_name: String

Tool name (e.g., “bash”, “delete_file”, “git_push”).

action: String

Human-readable description of what the tool will do.

details: Value

Detailed context (command, file paths, etc.) as JSON.

timeout_secs: u32

Timeout in seconds (after which the request is auto-denied).

AttachmentReceived

Acknowledgment that attachment was received

Fields

attachment_id: String

The attachment ID

success: bool

Whether the attachment was successfully processed

file_path: Option<String>

Path where the file was saved (if successful)

error: Option<String>

Error message if failed

Trait Implementations

impl Clone for RemoteMessage

fn clone(&self) -> RemoteMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RemoteMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RemoteMessage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RemoteMessage

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

where __S: Serializer,

Serialize this value into the given Serde serializer.