Struct ReasoningEffortHandle 

pub struct ReasoningEffortHandle { /* private fields */ }

A live, shared handle to the reasoning effort for the current turn (EVE-595).

Each internal LLM step within a single run_turn re-reads this handle when building its provider request. A tool (or any in-turn actor) can call ReasoningEffortHandle::set mid-turn so that subsequent LLM steps in the same turn use the new effort, without waiting for the next turn.

When the handle holds None, the crate::atoms::ReasonAtom falls back to the effort resolved from the latest user message’s controls — so callers that never set an override see no behavior change.

Implementations

impl ReasoningEffortHandle

pub fn new() -> Self

Create an empty handle (no override).

pub fn with_effort(effort: impl Into<String>) -> Self

Create a handle pre-seeded with an effort override.

pub fn set(&self, effort: Option<String>)

Set (or replace) the override effort. Subsequent LLM steps in the same turn pick this up. Pass None to clear the override and fall back to the message-derived effort.

pub fn get(&self) -> Option<String>

Read the current override effort, if any.

Trait Implementations

impl Clone for ReasoningEffortHandle

fn clone(&self) -> ReasoningEffortHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReasoningEffortHandle

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

Formats the value using the given formatter.

impl Default for ReasoningEffortHandle

fn default() -> ReasoningEffortHandle

Returns the “default value” for a type.