Struct TaskRequest 

pub struct TaskRequest {

    pub description: String,
    pub subagent_type: Option<String>,
    pub profile: Option<String>,
    pub model: Option<String>,
    pub model_strength: Option<String>,
    pub thinking: Option<String>,
    pub worktree: bool,
    pub allowed_tools: Option<Vec<String>>,
    pub max_depth: Option<u32>,
    pub token_budget: Option<u64>,
    pub response_schema: Option<Value>,
    pub label: Option<String>,
    pub phase: Option<String>,
}

One task() invocation, fully resolved and validated on the VM side.

Field semantics mirror the agent tool’s spawn options; profile is the Fleet roster profile token, already trimmed + lowercased and checked against the same token rule as crates/workflow’s leaf profiles. Roster membership is resolved by the driver (tui) at spawn time — this crate never sees the saved Fleet roster.

Fields

description: String

The child prompt (JS description or prompt; required).

subagent_type: Option<String>

Subagent role (JS subagentType or type); None lets the driver apply its default (general).

profile: Option<String>

Fleet profile token, normalized (trimmed, lowercased) and validated.

model: Option<String>

Explicit model override; always wins over model_strength.

model_strength: Option<String>

Relative model strength (same/faster, plus driver-side aliases).

thinking: Option<String>

Reasoning effort (inherit/off/low/medium/high/max).

worktree: bool

Run the child in a fresh git worktree for parallel edits.

allowed_tools: Option<Vec<String>>

Explicit tool allowlist; required by the driver for custom roles.

max_depth: Option<u32>

Per-call spawn-depth override (driver clamps to its ceiling).

token_budget: Option<u64>

Explicit token budget: forks an isolated pool on the driver side. Omit it so the child inherits (and debits) the shared run pool.

response_schema: Option<Value>

JSON schema the reply must satisfy; validated in the VM after the driver returns the raw text (see crate docs for decode rules).

label: Option<String>

Short human label for progress surfaces.

phase: Option<String>

Phase name this task belongs to, for progress grouping.

Trait Implementations

impl Clone for TaskRequest

fn clone(&self) -> TaskRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TaskRequest

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TaskRequest

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 TaskRequest