Struct SpeculativeHandle 

pub struct SpeculativeHandle {
    pub key: HandleKey,
    pub join: BlockingHandle<Result<Option<ToolOutput>, ToolError>>,
    pub cancel: CancellationToken,
    pub ttl_deadline: Instant,
    pub started_at: Instant,
}

An in-flight speculative execution handle.

Created when the engine dispatches a speculative tool call. Committed when the LLM confirms the same call on ToolUseStop; cancelled on mismatch or TTL expiry.

Fields

key: HandleKey

join: BlockingHandle<Result<Option<ToolOutput>, ToolError>>

cancel: CancellationToken

ttl_deadline: Instant

Absolute wall-clock deadline; handle is cancelled by the sweeper when exceeded.

started_at: Instant

Implementations

impl SpeculativeHandle

pub fn cancel(self)

Cancel the in-flight task.

pub async fn commit(self) -> Result<Option<ToolOutput>, ToolError>

Await the result; blocks until the task finishes or is cancelled.

Errors

Returns ToolError::Execution if the task was cancelled or panicked.

Trait Implementations

impl Debug for SpeculativeHandle

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

Formats the value using the given formatter.