Struct TaskNode 

pub struct TaskNode {
    pub id: String,
    pub description: String,
    pub status: TaskStatus,
    pub agent_config: AgentConfig,
    pub depends_on: Vec<String>,
    pub retry_count: u32,
    pub result: Option<AgentResult>,
}

A single unit of work in the orchestration graph.

Each node carries:

• A stable string id (used in dependency references).
• A human-readable description for the agent’s system context.
• The AgentConfig that the executor will use when spinning up a CoderAgent.
• A list of depends_on IDs — edges in the DAG.
• A mutable status updated by the executor as the task progresses.
• An optional result (populated on success).

AgentResult is skipped in serialisation because it contains non-serialisable futures/handles. Persist results separately if needed.

Fields

id: String

Stable identifier. Must be unique within a TaskGraph. Use lowercase-kebab-case by convention, e.g. "write-tests".

description: String

Human-readable description shown to the agent and in progress displays.

status: TaskStatus

Current lifecycle state.

agent_config: AgentConfig

Agent configuration for this specific task (can differ per task — e.g. a “generate docs” task might use a smaller model or more iterations).

depends_on: Vec<String>

IDs of tasks that must reach Completed before this task can start. Validated as existing IDs when the node is added to a TaskGraph.

retry_count: u32

Cumulative retry counter. Increments every time mark_failed is called and persists across reset_for_retry calls so we can enforce a per-task retry limit in the executor.

result: Option<AgentResult>

Execution result populated by the executor upon success. Not serialised — reconstruct from session store if needed.

Implementations

impl TaskNode

pub fn new(id: impl Into<String>, description: impl Into<String>) -> Self

Create a minimal TaskNode with no dependencies and default AgentConfig.

Use the builder methods (with_dependency, with_config, with_description) to customise before calling TaskGraph::add_task.

pub fn with_dependency(self, dep_id: impl Into<String>) -> Self

Add a single dependency by task ID.

The referenced task must exist in the TaskGraph by the time this node is added to the graph — see TaskGraph::add_task.

pub fn with_config(self, config: AgentConfig) -> Self

Replace the default AgentConfig with a custom one.

pub fn with_description(self, description: impl Into<String>) -> Self

Replace the description (useful when building nodes programmatically).

Trait Implementations

impl Clone for TaskNode

fn clone(&self) -> TaskNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskNode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskNode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TaskNode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.