Struct AgentCompletionMap 

pub struct AgentCompletionMap { /* private fields */ }

Frame-scoped map of agent completion handles.

Created by the scheduler at the top of each frame and inserted into the per-frame ServiceRegistry overlay. Agents must NOT retain a reference past the current frame.

Implementations

impl AgentCompletionMap

pub fn new(agent_ids: &[AgentId]) -> Self

Builds a completion map with one empty handle per agent ID.

pub fn mark(&self, id: AgentId, outcome: CompletionOutcome) -> bool

Marks an agent as having finished this frame with the given outcome.

Idempotent: subsequent calls for the same agent are no-ops. Returns false if the agent ID is unknown to this map.

pub fn outcome(&self, id: AgentId) -> Option<CompletionOutcome>

Returns the recorded outcome for id, or None if the agent has not yet been marked (or the ID is unknown).

pub fn is_done(&self, id: AgentId) -> bool

Returns true if a mark has been recorded for id.

pub async fn wait(&self, id: AgentId) -> Option<CompletionOutcome>

Awaits an agent’s completion. Returns the outcome, or None if the agent ID is unknown to this map (signals a configuration bug rather than blocking forever).

pub fn known_ids(&self) -> impl Iterator<Item = AgentId> + '_

Returns all agent IDs tracked by this map (for tests / introspection).