Enum MessageCommand 

pub enum MessageCommand {
    SendMessage {
        target_id: TheaterId,
        message: ActorMessage,
        response_tx: Sender<Result<()>>,
    },
    OpenChannel {
        initiator_id: ChannelParticipant,
        target_id: ChannelParticipant,
        channel_id: ChannelId,
        initial_message: Vec<u8>,
        response_tx: Sender<Result<bool>>,
    },
    ChannelMessage {
        channel_id: ChannelId,
        sender_id: ChannelParticipant,
        message: Vec<u8>,
        response_tx: Sender<Result<()>>,
    },
    ChannelClose {
        channel_id: ChannelId,
        sender_id: ChannelParticipant,
        response_tx: Sender<Result<()>>,
    },
}

Message Command

Commands for the message-server handler’s messaging infrastructure.

Purpose

MessageCommand provides a separate command space from TheaterCommand specifically for actor-to-actor messaging operations. This separation allows the message-server handler to manage messaging independently from the core runtime.

Design

MessageCommand enables complete architectural separation:

• External MessageRouter manages actor registry
• Message routing is handled externally from the runtime
• Handlers register themselves during setup_host_functions

Integration

Actor WASM host functions send MessageCommands to route messages:

• send() → MessageCommand::SendMessage
• request() → MessageCommand::SendMessage (with Request type)
• open-channel() → MessageCommand::OpenChannel
• send-on-channel() → MessageCommand::ChannelMessage
• close-channel() → MessageCommand::ChannelClose

Variants

SendMessage

Send a one-way message to an actor

Delivers a message to the target actor’s mailbox without waiting for a response.

Fields

target_id: TheaterId

message: ActorMessage

response_tx: Sender<Result<()>>

OpenChannel

Open a bidirectional channel between actors

Initiates a channel creation between two participants. The target actor receives a ChannelOpen message and can accept or reject the channel.

Fields

initiator_id: ChannelParticipant

target_id: ChannelParticipant

channel_id: ChannelId

initial_message: Vec<u8>

response_tx: Sender<Result<bool>>

ChannelMessage

Send a message on an established channel

Transmits data over an existing channel to the other participant.

Fields

channel_id: ChannelId

sender_id: ChannelParticipant

message: Vec<u8>

response_tx: Sender<Result<()>>

ChannelClose

Close a channel

Terminates a channel, notifying both participants.

Fields

channel_id: ChannelId

sender_id: ChannelParticipant

response_tx: Sender<Result<()>>

Trait Implementations

impl Debug for MessageCommand

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

Formats the value using the given formatter.