Struct WorkItem 

pub struct WorkItem {

    pub id: String,
    pub title: String,
    pub payload: String,
    pub kind: String,
    pub target_agent: String,
    pub target_group: String,
    pub priority: i64,
    pub state: String,
    pub claimed_by: String,
    pub target_agent_uid: String,
    pub claimed_by_uid: String,
    pub claim_expires: Option<i64>,
    pub attempts: i64,
    pub max_attempts: i64,
    pub created_by: String,
    pub created_by_uid: String,
    pub created_at: i64,
    pub updated_at: i64,
    pub not_before: Option<i64>,
    pub result: String,
}

Fields

id: String

title: String

payload: String

The instruction injected into whichever agent claims this.

kind: String

Free-form tag for filtering ("review", "repro", …). Empty = untyped.

target_agent: String

Empty = any agent may claim. Non-empty = only this agent id.

target_group: String

Empty = no group restriction. Non-empty = a db_agent_groups id; any member may claim. Group membership is resolved by the CALLER (which holds the per-channel store where groups live), not here — this module stays a pure queue and does not reach across stores.

priority: i64

Higher claims first. Ties broken by created_at ascending (FIFO).

state: String

claimed_by: String

target_agent_uid: String

Identity M1b/M3 (SPEC_AGENT_IDENTITY_CARRIED_NOT_DERIVED_2026_09_23.md §9.1): the UID (db_agents.id) of target_agent, resolved once at the authoring boundary and carried in — spec §5.4, never at claim time. Since M3, an item with a target_agent_uid is claimable by that identity only. Empty = untargeted, or no UID was carried: the name path applies.

claimed_by_uid: String

The claimer’s UID — its token’s (M4c-1), else carried from its own AGENTMUX_AGENT_UID, else its block’s row. Empty when unknown. Since M4c-2 the holder transitions match it against the caller’s UID when both are known, and claimed_by otherwise (HolderMatch).

claim_expires: Option<i64>

ms epoch; None unless state == claimed.

attempts: i64

max_attempts: i64

created_by: String

created_by_uid: String

Identity M4c-1 (SPEC_AGENT_IDENTITY_CARRIED_NOT_DERIVED_2026_09_23.md §6.5.9): the enqueuer’s UID, taken from the request’s Caller — its X-Agent-Token — never from a body field. Empty = the enqueue was Unattributed; never guessed. Dual-written beside created_by; nothing branches on it.

created_at: i64

updated_at: i64

not_before: Option<i64>

ms epoch; not claimable before this. None = claimable immediately.

result: String

Completion note or failure reason.

Trait Implementations

impl Clone for WorkItem

fn clone(&self) -> WorkItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkItem

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WorkItem

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for WorkItem

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for WorkItem

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for WorkItem