Struct BackgroundTask 

pub struct BackgroundTask {
    pub id: String,
    pub prompt: String,
    pub system_prompt: String,
    pub status: TaskStatus,
    pub result: Option<String>,
    pub error: Option<String>,
    pub created_at: String,
    pub updated_at: String,
    pub iterations: usize,
    pub provider: Option<String>,
    pub model: Option<String>,
    pub checkpoint: Option<String>,
}

A single background task with full lifecycle tracking

Fields

id: String

Unique task identifier (UUID v4)

prompt: String

User-provided prompt for the agent

system_prompt: String

System prompt used for this task

status: TaskStatus

Current status

result: Option<String>

Final result (set when completed)

error: Option<String>

Error message (set when failed)

created_at: String

When the task was created (ISO 8601)

updated_at: String

When the task was last updated (ISO 8601)

iterations: usize

Number of agent loop iterations used

provider: Option<String>

Provider name that executed this task

model: Option<String>

Model name that executed this task

checkpoint: Option<String>

Serialized checkpoint state for durable execution (v0.9.12+) When set, the agent loop can resume from this checkpoint instead of starting from scratch after a process restart.

Implementations

impl BackgroundTask

pub fn new(id: String, prompt: String, system_prompt: String) -> Self

Create a new pending task

Trait Implementations

impl Clone for BackgroundTask

fn clone(&self) -> BackgroundTask

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BackgroundTask

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BackgroundTask

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BackgroundTask

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

where __S: Serializer,

Serialize this value into the given Serde serializer.