Enum StateEnvelope 

pub enum StateEnvelope {
    State {
        for_player: Option<String>,
        state: Value,
    },
    Display {
        event: Value,
    },
    Prompt {
        for_player: String,
        prompt: Value,
    },
    Response {
        from_player: String,
        prompt_id: u32,
        action: Value,
    },
    Directive {
        from_player: String,
        directive: Value,
    },
    Log {
        from_player: String,
        entry: GameLogEntryDto,
    },
    Snapshot {
        from_player: String,
        entry: GameSnapshotEventDto,
    },
    Fatal {
        message: String,
    },
    Error {
        for_player: String,
        error: Value,
    },
    RoomRelay {
        protocol: String,
        version: u32,
        message_id: String,
        from_player: Option<String>,
        target_player: Option<String>,
        room_id: Option<String>,
        payload: Value,
    },
}

Typed envelope carried inside ClientMessage::BroadcastState.state / ServerMessage::StateUpdate.state. One discriminator (kind) plus the payload for that variant. Constructed and parsed in every layer that touches the relay (engine, bot, host, web/Tauri UI) — anything that needs to handcraft json!({"kind": "..."}) belongs here instead.

Variants

State

Fields

for_player: Option<String>

state: Value

Display

Fields

event: Value

Prompt

Engine asks a player for a decision. prompt is AgentPrompt for the Rust engine; the Java bridge emits a different shape, so the payload is kept as raw Value here and parsed by the receiver.

Fields

for_player: String

prompt: Value

Response

Player answers a prompt. action is PlayerAction for Rust; raw value

Fields

from_player: String

prompt_id: u32

action: Value

Directive

Fields

from_player: String

directive: Value

Log

Engine log entry broadcast to observers.

Fields

from_player: String

entry: GameLogEntryDto

Snapshot

Engine snapshot broadcast to observers.

Fields

from_player: String

entry: GameSnapshotEventDto

Fatal

Fields

message: String

Error

Engine rejects a response (stale prompt, wrong player, unknown action). error is ProtocolError; recoverable unless the session is terminated.

Fields

for_player: String

error: Value

RoomRelay

Out-of-band message tunneled through the relay (manual tabletop launch, self-hosted-node control plane, heartbeats, …). The relay never interprets the payload.

Fields

protocol: String

version: u32

message_id: String

from_player: Option<String>

target_player: Option<String>

room_id: Option<String>

payload: Value

Implementations

impl StateEnvelope

pub fn for_agent_message(for_player: String, message: &AgentMessage) -> Self

Trait Implementations

impl Clone for StateEnvelope

fn clone(&self) -> StateEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StateEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StateEnvelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.