Struct AgentId 

pub struct AgentId { /* private fields */ }

An agent, together with the world that spawned it.

Entity is an index plus a generation minted per world, so two worlds hand out the same id for their first agent. Nothing in Entity records which one it came from, so passing one world’s entity to another was not refused - it named a real, different agent there, and the call acted on that one instead. b.pause(a_entity) paused B’s own agent while the caller believed it had paused A’s, silently.

The provenance has to travel with the id, which is what this is. It cannot be built outside this module: the only sources are PipelineWorld::spawn_agent and PipelineWorld::spawn_from_blueprint, so an id always names an agent in the world that minted it.

A tag component on the agent was tried first and does not work: looking the tag up on the foreign id resolves to the local agent, whose tag naturally matches, so the check passes and guards nothing.

Implementations

impl AgentId

pub fn in_world(world: &World, entity: Entity) -> Self

Scope a raw entity to the world it came out of.

The reverse of Self::resolve_in, for a system holding a query result that needs to call something taking an AgentId. Wrapping and then resolving inside the same world always round-trips; an id built this way in one world and resolved in another does not, which is the point.

pub fn resolve_in(self, world: &World) -> Option<Entity>

The entity, if this id belongs to world.

The check any code holding a raw World should make before touching an agent it was handed. None means the id came from a different world, in which case its raw entity would name some other agent here - which is the whole failure this type exists to prevent.

A world with no OwnWorldId resource (a bare test world assembled by hand) accepts any id: it never minted one, so there is nothing to disagree with.

pub fn entity(self) -> Entity

The raw ECS entity.

For code already inside the owning world - systems, queries, direct World access - where same-world is true by construction. Crossing a world boundary with the result is the bug this type exists to prevent.

pub fn world(self) -> WorldId

Which world minted this id.

Trait Implementations

impl Clone for AgentId

fn clone(&self) -> AgentId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AgentId

impl Debug for AgentId

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

Formats the value using the given formatter.

impl Eq for AgentId

impl Hash for AgentId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for AgentId

fn eq(&self, other: &AgentId) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for AgentId