Struct TurnJob 

pub struct TurnJob {
    pub ctx: String,
    pub event: Option<String>,
    pub principal: Option<String>,
    pub message: Option<Msg>,
    pub skills: Vec<String>,
    pub text: String,
    pub preflight_done: bool,
    pub knowledge_done: bool,
    pub knowledge: Option<String>,
    pub msg_depth: u32,
}

A queued root/conversation turn, waiting for a worker slot and for its context to be free. One context runs at most one turn at a time, so turns for the same conversation queue behind each other rather than interleaving into the same history.

Fields

ctx: String

event: Option<String>

The triggering inbox event (marked done when the turn completes).

principal: Option<String>

message: Option<Msg>

The message appended to the context before the turn (already appended when None).

skills: Vec<String>

Skill references to preload.

text: String

The user text (for preflight / knowledge retrieval).

preflight_done: bool

Preflight ran (or was not needed).

knowledge_done: bool

Knowledge auto-context ran (or was not needed).

knowledge: Option<String>

The retrieved knowledge block (system message) for this turn.

msg_depth: u32

The message-hop depth this turn inherits (see RunState::msg_depth). A message from a person is depth 0; one a message step delivered carries that step’s depth, and anything this turn starts inherits it.

Implementations

impl TurnJob

pub fn new( ctx: String, event: Option<String>, principal: Option<String>, message: Option<Msg>, skills: Vec<String>, text: String, ) -> TurnJob

pub fn at_depth(self, depth: u32) -> TurnJob

The same job, carrying a delivered message’s hop depth.

Trait Implementations

impl Clone for TurnJob

fn clone(&self) -> TurnJob

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnJob

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

Formats the value using the given formatter.