Struct TaskContext 

pub struct TaskContext { /* private fields */ }

Handle passed to a running task operation, allowing it to surface server-to-client requests (elicitation, sampling, roots) mid-task and await the client’s tasks/update response.

Implementations

impl TaskContext

pub fn task_id(&self) -> &str

The id of the task this context belongs to.

pub async fn request_input( &self, key: impl Into<String>, request: InputRequest, ) -> Result<Value, TaskExit>

Surface a server-to-client request under key and wait for the client’s response delivered via tasks/update.

While at least one request is outstanding the task reports input_required from tasks/get, with all outstanding requests in inputRequests. Keys must be unique over the lifetime of the task; reusing a key returns an error.

pub fn set_status_message(&self, message: impl Into<String>)

Update the task’s human-readable status message.

pub fn is_cancel_requested(&self) -> bool

Returns true if tasks/cancel has been received for this task. Cooperative: operations should check this and stop when set.

pub async fn cancelled(&self)

Resolves once tasks/cancel has been received for this task (or immediately, if it already has). Cooperative: pair with tokio::select! around long-running work to implement a cancellation exit path.

An operation that stops in response should return TaskExit::Cancelled so the task settles as cancelled. Returning TaskExit::Error settles as failed, and finishing the work anyway settles as completed — per SEP-2663 cancellation is cooperative and a task may reach a non-cancelled terminal status.

Trait Implementations

impl Clone for TaskContext

fn clone(&self) -> TaskContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.