Struct TaskTable 

pub struct TaskTable { /* private fields */ }

Bounded in-memory task owner; a host drives work by calling checkpoint/update/finish.

Implementations

impl TaskTable

pub fn new(capacity: usize) -> Self

Create a table; capacity is clamped to 1..=1024 tasks.

pub fn create( &mut self, action: &str, cancellable: bool, ) -> Result<u64, ActionError>

Allocate a pending task. Completed tasks are retained until explicitly forgotten or, when the table is full, evicted oldest first.

pub fn get(&self, id: u64) -> Result<&Task, ActionError>

Inspect one task, without allowing external callers to mutate its state directly.

pub fn request_cancel(&mut self, id: u64) -> Result<&Task, ActionError>

Request cancellation; completion is reported only when the host acknowledges it.

pub fn checkpoint(&mut self, id: u64) -> Result<bool, ActionError>

Enter a safe interruption point. False means cancelled/finished; do no more work.

pub fn update( &mut self, id: u64, progress: Option<u16>, message: &str, ) -> Result<(), ActionError>

Update progress; host work must still call checkpoint before each interruptible chunk.

pub fn finish( &mut self, id: u64, result: ActionResult, ) -> Result<(), ActionError>

Finish a task. A pending cancellation must first be resolved at a checkpoint.

pub fn fail(&mut self, id: u64, error: ActionError) -> Result<(), ActionError>

Fail a pending/running task with structured diagnostic details.

pub fn forget(&mut self, id: u64) -> Result<(), ActionError>

Remove only a terminal task, retaining monotonic IDs to prevent accidental reuse.

pub fn list(&self, after: u64, limit: usize) -> Result<Value, ActionError>

One ID-ordered page of task metadata.

Trait Implementations

impl Default for TaskTable

fn default() -> Self

Returns the “default value” for a type.