Enum Command 

pub enum Command {
    Infer {
        prompt: String,
        max_tokens: u32,
    },
    Open {
        path: String,
    },
    Slice {
        handle: Handle,
        offset: u64,
        len: u64,
    },
    Emit {
        progress: Value,
    },
    Done {
        result: Value,
    },
    Fail {
        code: String,
        message: String,
    },
}

What a guest asks the host to do, returned from its init/step exports.

Variants

Infer

Run a prompt against the job’s model.

Fields

prompt: String

The prompt to generate from.

max_tokens: u32

Upper bound on tokens generated. A guest can also end generation early by returning TokenAction::Stop from its on_token export.

Open

Open a file. Capability-checked against the job’s spec.

Yields a handle and a length rather than contents — see the crate docs on why bulk data does not cross this boundary.

Fields

path: String

Path to open. Denied unless the spec grants read access to it.

Slice

Pull one bounded window of an open file into guest memory.

The guest picks len, so the guest sets its own memory ceiling.

Fields

handle: Handle

Handle from a previous Command::Open.

offset: u64

Byte offset to read from. u64 so that files far larger than a guest could hold remain fully addressable.

len: u64

Maximum bytes to return. The host may return fewer; see Event::Sliced.

Emit

Report progress to whoever is watching the job’s event stream.

Fields

progress: Value

Arbitrary JSON, forwarded verbatim to the job’s subscribers.

Done

Finish successfully with this payload.

Fields

result: Value

The job’s result, shaped by the spec’s declared output.

Fail

Give up. The job ends with this code and message, and no result.

Fields

code: String

Machine-readable code; see error_codes.

message: String

Human-readable explanation.

Trait Implementations

impl Clone for Command

fn clone(&self) -> Command

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Command

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Command

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Command

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Command

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 Command