Struct GarbageCollectorAgent 

pub struct GarbageCollectorAgent { /* private fields */ }

The agent responsible for garbage collection of orphaned ECS data.

Implementations

impl GarbageCollectorAgent

pub fn new() -> Self

Creates a new GarbageCollectorAgent.

pub fn with_dcc_sender(self, sender: Sender<TelemetryEvent>) -> Self

Attaches a DCC sender for telemetry events.

pub fn queue_cleanup(&mut self, page_index: PageIndex, domain: SemanticDomain)

Adds a new orphaned data location to the cleanup queue.

pub fn queue_vacuum(&mut self, page_index: u32, hole_row_index: u32)

Adds a vacuum request for a page hole.

pub fn run(&mut self, world: &mut World)

Runs the agent’s decision-making and execution logic for one frame.

pub fn pending_count(&self) -> usize

Returns the total count of pending cleanup items.

pub fn current_strategy(&self) -> StrategyId

Returns the current strategy.

pub fn max_cleanup_per_frame(&self) -> usize

Returns the maximum cleanup operations per frame.

Trait Implementations

impl Agent for GarbageCollectorAgent

fn id(&self) -> AgentId

Returns the unique identifier for this agent.

fn negotiate(&mut self, _request: NegotiationRequest) -> NegotiationResponse

Negotiates with the DCC to determine the best execution strategy given the current global resource constraints and priorities.

fn apply_budget(&mut self, budget: ResourceBudget)

Applies a resource budget issued by the DCC. The agent must adjust its internal logic (e.g., LOD, quality settings) to stay within the allocated limits.

fn update(&mut self, context: &mut EngineContext<'_>)

Periodically updates the agent’s internal state.

fn report_status(&self) -> AgentStatus

Reports the current status and health of the agent.

fn execute(&mut self)

Executes the agent’s primary function for this frame. Called after update(), this is where the agent performs its main work.

fn as_any(&self) -> &dyn Any

Allows downcasting to concrete agent types.

fn as_any_mut(&mut self) -> &mut dyn Any

Allows mutable downcasting to concrete agent types.

impl Default for GarbageCollectorAgent

fn default() -> Self

Returns the “default value” for a type.