Enum ControlRequest 

pub enum ControlRequest {
    Authenticate {
        token: String,
    },
    Spawn {
        args: Box<SpawnArgs>,
    },
    Status {
        run_id: String,
    },
    Pause {
        run_id: String,
    },
    Resume {
        run_id: String,
    },
    Cancel {
        run_id: String,
    },
    List,
    Message {
        agent_id: String,
        content: String,
        target_region: Option<String>,
    },
    ListInteractions,
    AnswerInteraction {
        response: InteractionResponse,
    },
    CancelInteraction {
        request_id: String,
    },
    Shutdown,
    Subscribe,
}

A control request over the wire. Agents are addressed by run id (the stable id), except Message, which targets an agent id.

Variants

Authenticate

Prove the caller is this user, by quoting the daemon’s control token.

Must be the first request on a connection. Until it succeeds the daemon answers nothing else - see ControlToken for why.

Fields

token: String

The token read from <leviath-home>/control.token.

Spawn

Spawn a new agent.

Fields

args: Box<SpawnArgs>

The spawn request. Boxed because it is much larger than the other variants’ payloads.

Status

Query a run’s status.

Fields

run_id: String

The run to query.

Pause

Pause a run.

Fields

run_id: String

The run to pause.

Resume

Resume a paused run.

Fields

run_id: String

The run to resume.

Cancel

Cancel a run.

Fields

run_id: String

The run to cancel.

List

List every known live run and its status.

Message

Deliver a message to a running agent.

Fields

agent_id: String

Target agent id.

content: String

Message body.

target_region: Option<String>

Optional target region.

ListInteractions

List open interactions awaiting an answer.

AnswerInteraction

Answer an open interaction.

Fields

response: InteractionResponse

The answer (its request_id selects the interaction).

CancelInteraction

Cancel an open interaction.

Fields

request_id: String

The interaction id to cancel.

Shutdown

Shut the daemon down.

Subscribe

Switch this connection to an event stream: the daemon writes newline-JSON WorldEvents until the client disconnects. No per-request reply.

Trait Implementations

impl Clone for ControlRequest

fn clone(&self) -> ControlRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ControlRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ControlRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ControlRequest

fn eq(&self, other: &ControlRequest) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ControlRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ControlRequest