Struct Task 

pub struct Task {
    pub id: TaskId,
    pub kind: TaskKind,
    pub status: TaskStatus,
    pub created_at: SystemTime,
    pub started_at: Option<SystemTime>,
    pub finished_at: Option<SystemTime>,
    pub session_key: Option<String>,
    pub label: Option<String>,
    pub description: Option<String>,
    pub stream_output: bool,
    pub output_buffer: String,
}

A task with full metadata.

Fields

id: TaskId

Unique task ID

kind: TaskKind

What kind of task this is

status: TaskStatus

Current status

created_at: SystemTime

When the task was created

started_at: Option<SystemTime>

When the task started running

finished_at: Option<SystemTime>

When the task finished (completed/failed/cancelled)

session_key: Option<String>

Session that owns this task

label: Option<String>

User-provided label

description: Option<String>

Short description of what the task is currently doing (agent-settable)

stream_output: bool

Whether task output should stream to chat

output_buffer: String

Accumulated output (if buffering)

Implementations

impl Task

pub fn new(kind: TaskKind) -> Self

Create a new pending task.

pub fn with_session(self, key: impl Into<String>) -> Self

Set the session key.

pub fn with_label(self, label: impl Into<String>) -> Self

Set a label.

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

Set a description.

pub fn with_streaming(self) -> Self

Enable output streaming.

pub fn start(&mut self)

Mark task as running.

pub fn background(&mut self)

Move task to background.

pub fn foreground(&mut self)

Move task to foreground.

pub fn update_progress(&mut self, progress: TaskProgress)

Update progress.

pub fn complete(&mut self, summary: Option<String>)

Mark task as completed.

pub fn fail(&mut self, error: impl Into<String>, retryable: bool)

Mark task as failed.

pub fn cancel(&mut self)

Mark task as cancelled.

pub fn elapsed(&self) -> Option<Duration>

Get elapsed time since start.

pub fn display_label(&self) -> String

Get display label (user label or auto-generated).

pub fn display_description(&self) -> String

Get short description (agent-set, or fallback to label).

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

Formats the value using the given formatter.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.