Struct StageProgress 

pub struct StageProgress {
    pub total_tool_calls: usize,
    pub text_only_nudges: usize,
    pub iterations: usize,
    pub modifying_tool_calls: usize,
    pub blocked_modification_calls: usize,
    pub gate_reentries: usize,
    pub stage_started_at: Option<i64>,
    pub edits_by_path: HashMap<String, usize>,
    pub stuck_fired: bool,
}

Per-stage progress counters, reset when an agent enters a stage.

Fields

total_tool_calls: usize

Total tool calls the agent has made in this stage.

text_only_nudges: usize

Consecutive text-only responses that were nudged toward tool use.

iterations: usize

Inferences run in this stage (per-stage, unlike the run-cumulative AgentState.iteration), for enforcing the stage’s max_iterations.

modifying_tool_calls: usize

Successful file-modifying tool calls (write_file/edit_file, plus any tool named by an outgoing gate) made in this stage. Read by the transition gate to enforce require_modifications.

blocked_modification_calls: usize

Modifying tool calls the permission layer refused ([denied] ...). A gate lets the transition through when this is non-zero: the agent is trying to write and cannot, so re-running the stage only burns budget.

gate_reentries: usize

How many times a transition gate has already sent this stage back for another pass. Bounded by the gate’s max_attempts.

stage_started_at: Option<i64>

Unix seconds of the first tick this agent was ready to infer in the stage - the clock a stuck_after_minutes threshold reads. Stamped lazily by detect_stuck_stage so spawn, enter_stage and force_transition all get a fresh clock from the Default reset without threading a clock through their signatures.

edits_by_path: HashMap<String, usize>

write_file/edit_file calls made in this stage, keyed by target path. Feeds the stuck_after_same_file_edits threshold.

stuck_fired: bool

A stuck edge has already fired in this stage. One-shot per stage entry: without it a stuck interrupt whose edge became unavailable would ping-pong between detect_stuck_stage and resolve_transition’s resume arm.

Trait Implementations

impl Clone for StageProgress

fn clone(&self) -> StageProgress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for StageProgress

where Self: Send + Sync + 'static,

const STORAGE_TYPE: StorageType = bevy_ecs::component::StorageType::Table

A constant indicating the storage type used for this component.

type Mutability = Mutable

A marker type to assist Bevy with determining if this component is mutable, or immutable. Mutable components will have Component<Mutability = Mutable>, while immutable components will instead have Component<Mutability = Immutable>.

fn register_required_components( _requiree: ComponentId, required_components: &mut RequiredComponentsRegistrator<'_, '_>, )

Registers required components.

fn clone_behavior() -> ComponentCloneBehavior

Called when registering this component, allowing to override clone function (or disable cloning altogether) for this component.

fn relationship_accessor() -> Option<ComponentRelationshipAccessor<Self>>

Returns ComponentRelationshipAccessor required for working with relationships in dynamic contexts.

fn on_add() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_add ComponentHook for this Component if one is defined.

fn on_insert() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_insert ComponentHook for this Component if one is defined.

fn on_discard() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_discard ComponentHook for this Component if one is defined.

fn on_remove() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_remove ComponentHook for this Component if one is defined.

fn on_despawn() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_despawn ComponentHook for this Component if one is defined.

fn map_entities<E>(_this: &mut Self, _mapper: &mut E)

where E: EntityMapper,

Maps the entities on this component using the given EntityMapper. This is used to remap entities in contexts like scenes and entity cloning. When deriving Component, this is populated by annotating fields containing entities with #[entities]

impl Debug for StageProgress

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

Formats the value using the given formatter.

impl Default for StageProgress

fn default() -> StageProgress

Returns the “default value” for a type.