Struct RunIdentity 

pub struct RunIdentity {
    pub run_id: String,
    pub parent_run_id: Option<String>,
    pub depth: usize,
    pub conversation_id: Option<String>,
    pub deadline_unix_ms: Option<u64>,
}

Identity of one agent run.

Threaded through child spawns so the loop, its plugins, and any trajectory sink can answer “who am I, who is my parent, how deep am I, what conversation, when do I expire” without consulting a side-channel. The fields are typed at the same level as AgentMessage — every run has identity, full stop. Today’s bridge scatters these across LoopConfig.conversation_id, RunnerJob.depth, ChildScope.parent_conversation_id, and parent_deadline; RunIdentity is the merge target.

Identity is serializable so trajectory writers can pin every event to its run without inventing a parallel key store.

Fields

run_id: String

Stable identifier for this run. UUIDv4 by default; callers may supply their own value (e.g. to keep run ids aligned with an external trace system).

parent_run_id: Option<String>

Some(parent.run_id) when this run was spawned by another run; None for top-level runs initiated by a user-facing entry point.

depth: usize

0 for top-level runs; +1 per nested spawn.

conversation_id: Option<String>

Conversation this run belongs to (when the host runtime has one). None for tests and isolated runs that don’t carry conversation identity.

deadline_unix_ms: Option<u64>

Wall-clock deadline as milliseconds since the UNIX epoch. The loop does not enforce this directly — plugins that care (wall-clock steering, soft-cancel) read it. None means no parent-imposed deadline.

Implementations

impl RunIdentity

pub fn root() -> Self

Construct a top-level identity. Generates a fresh UUIDv4 run id.

pub fn child_of(parent: &Self) -> Self

Construct a child identity from a parent. Inherits conversation_id and deadline_unix_ms, bumps depth, sets parent_run_id, and generates a fresh run_id.

pub fn with_run_id(self, id: impl Into<String>) -> Self

pub fn with_conversation_id(self, id: impl Into<String>) -> Self

pub fn with_deadline_unix_ms(self, ms: u64) -> Self

Trait Implementations

impl Clone for RunIdentity

fn clone(&self) -> RunIdentity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunIdentity

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunIdentity

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RunIdentity

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RunIdentity

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for RunIdentity

impl StructuralPartialEq for RunIdentity