Struct Task 

pub struct Task {
    pub id: String,
    pub created_at: DateTime<Utc>,
    pub last_updated_at: DateTime<Utc>,
    pub ttl: usize,
    pub status: TaskStatus,
    pub status_msg: Option<String>,
    pub poll_interval: Option<usize>,
}

Represents a task. Tasks are durable state machines that carry information about the underlying execution state of the request they wrap, and are intended for requestor polling and deferred result retrieval.

Each task is uniquely identifiable by a receiver-generated task ID.

See the schema for details

Fields

id: String

The task identifier.

created_at: DateTime<Utc>

ISO 8601 timestamp when the task was created.

last_updated_at: DateTime<Utc>

ISO 8601 timestamp when the task was last updated.

ttl: usize

Time To Live: Actual retention duration from creation in milliseconds, null for unlimited.

status: TaskStatus

Current task state.

status_msg: Option<String>

Optional human-readable message describing the current task state. This can provide context for any status, including

• Reasons for cancelled status
• Summaries for completed status
• Diagnostic information for failed status (e.g., error details, what went wrong)

poll_interval: Option<usize>

Suggested polling interval in milliseconds.

Implementations

impl Task

pub fn new() -> Self

Creates a new Task in working status and with a default TTL of 30 seconds.

pub fn set_message(&mut self, msg: impl Into<String>)

Sets the status message of the task.

pub fn reset(&mut self)

Sets the working status.

pub fn cancel(self) -> Self

Sets the cancelled status.

pub fn complete(&mut self)

Sets the completed status.

pub fn fail(&mut self)

Sets the failed status.

pub fn require_input(&mut self)

Sets the input_required status.

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 Default for Task

fn default() -> Self

Returns the “default value” for a type.

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 From<TaskMetadata> for Task

fn from(meta: TaskMetadata) -> Self

Converts to this type from the input type.

impl IntoResponse for Task

fn into_response(self, req_id: RequestId) -> Response

Converts a type into MCP server response

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.