Struct Task 

pub struct Task {

    pub id: String,
    pub name: String,
    pub description: String,
    pub status: TaskStatus,
    pub parent_id: Option<String>,
    pub blocked_by: Vec<String>,
    pub background_job: Option<TaskBackgroundJob>,
    pub sort_order: i32,
    pub phase: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub session_id: String,
    pub source: TaskSource,
    pub orchestrator_task_id: Option<String>,
    pub agent_id: Option<String>,
    pub metadata: Option<Value>,
}

A task represents a unit of work to be tracked

Fields

id: String

Unique identifier for this task

name: String

Human-readable name

description: String

Detailed description

status: TaskStatus

Current status

parent_id: Option<String>

Parent task ID (for subtasks)

blocked_by: Vec<String>

IDs of tasks that block this task from being started/completed.

This is modeled as a dependency list (“blocked by”) so we can derive the inverse relationship (“blocks”) on demand.

background_job: Option<TaskBackgroundJob>

Optional background job state for tasks that run asynchronously.

sort_order: i32

Optional ordering hint for UI dashboards (lower first).

phase: Option<String>

Optional phase/group label for UI dashboards.

created_at: DateTime<Utc>

When the task was created

updated_at: DateTime<Utc>

When the task was last updated

session_id: String

Session ID this task belongs to

source: TaskSource

Source of the task (user, agent, or orchestrator)

orchestrator_task_id: Option<String>

ID linking to an orchestrator DelegatedTask (for bidirectional sync)

agent_id: Option<String>

ID of the agent that created/owns this task

metadata: Option<Value>

Additional metadata (tool calls, output, context, etc.)

Implementations

impl Task

pub fn new( session_id: impl Into<String>, name: impl Into<String>, description: impl Into<String>, parent_id: Option<String>, ) -> Task

Create a new task (defaults to User source)

pub fn new_with_source( session_id: impl Into<String>, name: impl Into<String>, description: impl Into<String>, parent_id: Option<String>, source: TaskSource, agent_id: Option<String>, ) -> Task

Create a new task with a specific source

pub fn from_orchestrator_task( session_id: impl Into<String>, orchestrator_task_id: impl Into<String>, agent_id: impl Into<String>, name: impl Into<String>, description: impl Into<String>, context: Option<Value>, ) -> Task

Create a task from an orchestrator delegated task

pub fn set_metadata(&mut self, metadata: Value)

Set metadata (e.g., tool calls, output)

pub fn set_status(&mut self, status: TaskStatus)

Update the task status

pub fn set_name(&mut self, name: impl Into<String>)

Update the task name

pub fn set_description(&mut self, description: impl Into<String>)

Update the task description

pub fn is_terminal(&self) -> bool

Returns true when the task is in a terminal (non-active) status.

pub fn set_background_job(&mut self, job: Option<TaskBackgroundJob>)

Replace the background job state and update timestamps.

pub fn add_blocked_by(&mut self, task_id: impl Into<String>)

Add a dependency (“blocked by”) to this task.

This does not validate existence; callers should validate using the session’s TaskList.

pub fn set_phase(&mut self, phase: Option<String>)

Set the phase/group label for dashboard grouping.

Trait Implementations

impl Clone for Task

fn clone(&self) -> Task

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Task

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Task

fn deserialize<__D>( __deserializer: __D, ) -> Result<Task, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Task

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

where __S: Serializer,

Serialize this value into the given Serde serializer.