Enum EdgeToServer 

pub enum EdgeToServer {
    Hello {
        edge_id: String,
        version: String,
        capabilities: Vec<String>,
    },
    State {
        service_type: String,
        target: String,
        property: String,
        output_id: Option<String>,
        value: Value,
    },
    DeviceState {
        device_type: String,
        device_id: String,
        property: String,
        value: Value,
    },
    Pong,
    SwitchTarget {
        mapping_id: Uuid,
        service_target: String,
    },
    Command {
        service_type: String,
        target: String,
        intent: String,
        params: Value,
        result: CommandResult,
        latency_ms: Option<u32>,
        output_id: Option<String>,
    },
    Error {
        context: String,
        message: String,
        severity: ErrorSeverity,
    },
    EdgeStatus {
        wifi: Option<u8>,
    },
    DispatchIntent {
        service_type: String,
        service_target: String,
        intent: String,
        params: Value,
        output_id: Option<String>,
    },
    SwitchActiveConnection {
        device_type: String,
        device_id: String,
        active_mapping_id: Uuid,
    },
}

Frames sent from an edge-agent to weave-server.

Variants

Hello

First frame after connect. Declares identity and adapter capabilities.

Fields

edge_id: String

version: String

capabilities: Vec<String>

State

State update for a service target (e.g. Roon zone playback / volume).

Fields

service_type: String

target: String

property: String

output_id: Option<String>

value: Value

DeviceState

State update for a device (battery, RSSI, connected).

Fields

device_type: String

device_id: String

property: String

value: Value

Pong

Reply to server Ping.

SwitchTarget

The edge committed a target switch via on-device selection mode. Server replies by calling the same code path as POST /api/mappings/:id/target: persist the new service_target, then broadcast a ConfigPatch upsert back to all edges (including the sender) and a MappingChanged to UI subscribers.

Fields

mapping_id: Uuid

service_target: String

Command

A command that the edge’s adapter emitted to an external service (Roon MOO RPC, Hue REST, …). One frame per adapter.send_intent call, carrying the outcome and measured latency so the UI live stream can show “sent → ok (42ms)” rows alongside input and state-echo rows.

Fields

service_type: String

target: String

intent: String

Snake-case intent name (volume_change, play_pause, …).

params: Value

Intent parameters serialized as JSON. Shape matches the weave-engine::Intent discriminant’s payload.

result: CommandResult

latency_ms: Option<u32>

output_id: Option<String>

Error

Adapter-level or routing-level error not tied to a specific command (bridge disconnect, auth token expired, pairing lost). Command-level failures use Command { result: Err { .. } } instead — Error is for ambient conditions.

Fields

context: String

message: String

severity: ErrorSeverity

EdgeStatus

Periodic edge-side metrics. Emitted on a fixed cadence (typically every 10 s) so the server can surface edge health in /ws/ui dashboards. Server-side latency is measured separately from Ping/Pong round trips and is not carried here.

Fields

wifi: Option<u8>

Wifi signal strength normalized to 0..=100 percent. None when the platform doesn’t expose a signal-strength API to user code, when the host has no wifi adapter, or when the API call failed (entitlement missing, permission denied).

DispatchIntent

Edge routed an input locally but has no adapter for the resulting service_type and asks the server to forward to a capable peer. The server resolves a target edge from Hello capabilities and re-emits as ServerToEdge::DispatchIntent. Wire shape mirrors Command (intent name + params) so the same reassembly logic works on both ends.

The originating edge does NOT emit a Command frame for forwarded intents — the executing edge does that after running the adapter, so latency measurement reflects the full path.

Fields

service_type: String

service_target: String

intent: String

params: Value

output_id: Option<String>

SwitchActiveConnection

The edge advanced its local cycle (typically via cycle_gesture firing on the device) and asks the server to persist the new active. Server applies the change, broadcasts UiFrame::DeviceCycleChanged to web UIs, and echoes ServerToEdge::SwitchActiveConnection to other edges that observe the same device so they stay in sync.

Fields

device_type: String

device_id: String

active_mapping_id: Uuid

Trait Implementations

impl Clone for EdgeToServer

fn clone(&self) -> EdgeToServer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EdgeToServer

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EdgeToServer

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for EdgeToServer

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

where __S: Serializer,

Serialize this value into the given Serde serializer.