Enum TaskPollDecision 

#[non_exhaustive]
pub enum TaskPollDecision {
    Terminal {
        status: TaskStatus,
    },
    InProgress {
        poll_hint: Option<u64>,
    },
    InputRequired,
}

The classification of a polled Task, derived purely from its already-deserialized TaskStatus — the single decision primitive every task poller consumes so the branch logic cannot drift.

Produced by Task::poll_decision. It answers the one question a poll loop asks each tick: stop, ask the user, or sleep and poll again? — without a network round-trip, a CallToolResult fetch, or any I/O. It is a pure, replay-deterministic function of the polled Task, so it is safe to call inside a memoized durable/replay step (D-01, D-03).

Non-exhaustive

This enum is #[non_exhaustive] for future-proofing (D-04): adding a variant later is a non-breaking change, so external match sites must carry a wildcard _ => arm. This is a distinct claim from TaskStatus, which is deliberately exhaustive today (D-15): #[non_exhaustive] here does NOT imply that unknown or future wire statuses are handled gracefully at runtime. An unknown status fails at serde deserialization during tasks/get, BEFORE classification ever runs — poll_decision() only ever sees one of the five known TaskStatus values.

Unlike every other type in this module, TaskPollDecision intentionally derives neither Serialize nor Deserialize: it is a returned classifier value consumed in-process, never a wire type.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Terminal

The task has reached a terminal status (TaskStatus::Completed, TaskStatus::Failed, or TaskStatus::Cancelled) and will not transition further — the poll loop should stop.

The classifier carries the terminal TaskStatus by value (it is Copy) but deliberately does NOT carry the final CallToolResult: to retrieve the result the caller still issues a separate tasks/result call (D-06/D-16). This keeps classification a pure, I/O-free decision.

Fields

status: TaskStatus

The terminal status that ended the task.

InProgress

The task is still running (TaskStatus::Working) — the poll loop should sleep and poll again.

poll_hint is the raw server-reported pollInterval in milliseconds (Task::poll_interval), passed through verbatim including None (D-07). Feed it to resolve_poll_interval to obtain the concrete sleep duration honoring the caller override, this hint, the default, and the hot-loop floor.

Fields

poll_hint: Option<u64>

The raw server-reported pollInterval in ms, verbatim (None when the server suggested no interval).

InputRequired

The task is blocked on user input (TaskStatus::InputRequired).

This is a unit variant carrying no payload (D-05): the caller already holds the polled Task, and a blocking poller cannot supply the input, so it must route to elicitation rather than continue spinning.

Trait Implementations

impl Clone for TaskPollDecision

fn clone(&self) -> TaskPollDecision

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskPollDecision

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

Formats the value using the given formatter.

impl Eq for TaskPollDecision

impl PartialEq for TaskPollDecision

fn eq(&self, other: &TaskPollDecision) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for TaskPollDecision