Skip to main content

TaskStore

a2a_server::task_store

Trait TaskStore 

Source 
pub trait TaskStore:
    Send
    + Sync
    + 'static {
    // Required methods
    fn create<'life0, 'async_trait>(
        &'life0 self,
        task: Task,
    ) -> Pin<Box<dyn Future<Output = Result<TaskVersion, A2AError>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait;
    fn update<'life0, 'async_trait>(
        &'life0 self,
        task: Task,
    ) -> Pin<Box<dyn Future<Output = Result<TaskVersion, A2AError>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait;
    fn get<'life0, 'life1, 'async_trait>(
        &'life0 self,
        task_id: &'life1 str,
    ) -> Pin<Box<dyn Future<Output = Result<Option<Task>, A2AError>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait;
    fn list<'life0, 'life1, 'async_trait>(
        &'life0 self,
        req: &'life1 ListTasksRequest,
    ) -> Pin<Box<dyn Future<Output = Result<ListTasksResponse, A2AError>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait;
    fn begin_cancel<'life0, 'life1, 'async_trait>(
        &'life0 self,
        task_id: &'life1 str,
    ) -> Pin<Box<dyn Future<Output = Result<Task, A2AError>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait;
}
Expand description

Interface for persisting and retrieving tasks.

Required Methods§

Source

fn create<'life0, 'async_trait>( &'life0 self, task: Task, ) -> Pin<Box<dyn Future<Output = Result<TaskVersion, A2AError>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait,

Create a new task. Returns the initial version.

Source

fn update<'life0, 'async_trait>( &'life0 self, task: Task, ) -> Pin<Box<dyn Future<Output = Result<TaskVersion, A2AError>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait,

Update an existing task. Returns the new version.

Source

fn get<'life0, 'life1, 'async_trait>( &'life0 self, task_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Task>, A2AError>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get a task by ID.

Source

fn list<'life0, 'life1, 'async_trait>( &'life0 self, req: &'life1 ListTasksRequest, ) -> Pin<Box<dyn Future<Output = Result<ListTasksResponse, A2AError>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

List tasks matching the request criteria.

An implementation must honour req.page_size and set next_page_token when more tasks remain. DefaultRequestHandler clamps page_size to MAX_PAGE_SIZE before calling this, and truncates the response to that bound if more comes back – so a store that ignores page_size will have its extra tasks dropped, and the caller loses them, because the handler cannot synthesise a continuation token for a paging scheme it does not own.

Source

fn begin_cancel<'life0, 'life1, 'async_trait>( &'life0 self, task_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Task, A2AError>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Atomically check that a task is not in a terminal state and transition it to CANCELED, returning the updated task.

TASK_NOT_CANCELABLE if the task is already terminal, TASK_NOT_FOUND if it does not exist.

Deliberately has no default implementation. A default could only read and then write, which is the check-then-act race this method exists to close, and an implementor who did not notice would inherit it silently. Serialise the check and the transition – see InMemoryTaskStore, which holds its write lock across both.

Dyn Compatibility§

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors§