Skip to main content

StandardMagenticManager

Struct StandardMagenticManager 

Source
pub struct StandardMagenticManager { /* private fields */ }
Expand description

The standard LLM-driven manager. Rust analogue of StandardMagenticManager.

§Safe to share between runs

This manager holds no run state. The decomposed task ledger it plans lives on MagenticContext::task_ledger — the run’s own state — so a manager shared by two concurrent runs, whether through one Arc handed to two builders or through Workflow::run taking &self, serves each from its own facts and plan.

That is a change in this port (upstream #8581, which made the same guarantee by creating a manager per build). The ledger used to be cached on the manager, where a second run’s planning overwrote the first’s, and the cache was read at three places: replan, which builds its “update these facts” prompt from it — so a run could be told to update the other run’s facts, corrupting its reasoning rather than only a display — and the plan-review and stall-intervention requests, where a human could be shown, and asked to approve, the other run’s plan. None of it raised an error.

Moving the ledger onto the context also put it inside the run’s checkpointed state, so a resumed run can replan; previously the ledger died with the process and the first stall after a resume failed with replan() called before plan().

Implementations§

Source§

impl StandardMagenticManager

Source

pub fn new(agent: Arc<dyn SupportsAgentRun>) -> StandardMagenticManager

Create a manager driven by agent.

Source

pub fn max_stall_count(self, n: usize) -> StandardMagenticManager

Set the stall threshold (default 3).

Source

pub fn max_reset_count(self, n: usize) -> StandardMagenticManager

Set the maximum number of replans (default unbounded).

Source

pub fn max_round_count(self, n: usize) -> StandardMagenticManager

Set the maximum number of rounds (default unbounded).

Source

pub fn progress_ledger_retry_count(self, n: usize) -> StandardMagenticManager

Set the progress-ledger parse retry budget (default 3).

Trait Implementations§

Source§

impl MagenticManager for StandardMagenticManager

Source§

fn plan<'life0, 'life1, 'async_trait>( &'life0 self, context: &'life1 mut MagenticContext, ) -> Pin<Box<dyn Future<Output = Result<Message, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, StandardMagenticManager: 'async_trait,

Gather facts and produce the initial plan (returns the combined ledger). Read more
Source§

fn replan<'life0, 'life1, 'async_trait>( &'life0 self, context: &'life1 mut MagenticContext, ) -> Pin<Box<dyn Future<Output = Result<Message, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, StandardMagenticManager: 'async_trait,

Update facts and plan after a stall (returns the combined ledger). Read more
Source§

fn create_progress_ledger<'life0, 'life1, 'async_trait>( &'life0 self, context: &'life1 MagenticContext, ) -> Pin<Box<dyn Future<Output = Result<MagenticProgressLedger, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, StandardMagenticManager: 'async_trait,

Produce the structured progress ledger for the current round.
Source§

fn prepare_final_answer<'life0, 'life1, 'async_trait>( &'life0 self, context: &'life1 MagenticContext, ) -> Pin<Box<dyn Future<Output = Result<Message, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, StandardMagenticManager: 'async_trait,

Synthesize the final answer addressed to the user.
Source§

fn max_stall_count(&self) -> usize

The stall threshold that triggers a replan.
Source§

fn max_reset_count(&self) -> Option<usize>

The maximum number of replans, if bounded.
Source§

fn max_round_count(&self) -> Option<usize>

The maximum number of rounds, if bounded.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more