Struct HelpRequest 

pub struct HelpRequest {
    pub agent: AgentName,
    pub run: RunId,
    pub itinerary: ItineraryId,
    pub blocker: Blocker,
    pub summary: String,
    pub detail: String,
    pub fatal: bool,
    pub at: Timestamp,
    pub resolved_at: Option<Timestamp>,
}

One agent asking a human for something.

Fields

agent: AgentName

Who is asking.

run: RunId

The run that raised it.

itinerary: ItineraryId

The chain it belonged to.

blocker: Blocker

What kind of thing is in the way.

summary: String

One line, for a list.

detail: String

The whole explanation: what was tried, what happened, what is needed.

fatal: bool

Whether this stopped the work or merely limited it.

The distinction matters and is easy to lose. An agent can finish its task and still have been unable to check something — that is worth reporting, and it is not an outage.

at: Timestamp

When it was raised.

resolved_at: Option<Timestamp>

When a human marked it dealt with.

Implementations

impl HelpRequest

pub fn new( agent: AgentName, run: RunId, itinerary: ItineraryId, blocker: Blocker, summary: impl Into<String>, detail: impl Into<String>, at: Timestamp, ) -> Self

Records a request.

pub fn fatal(self) -> Self

Marks the request as having stopped the work.

pub fn resolved(self, at: Timestamp) -> Self

Marks it dealt with.

pub fn is_open(&self) -> bool

Returns true when nobody has dealt with this yet.

pub fn is_same_ask_as(&self, other: &Self) -> bool

Returns true when this asks for the same thing as other.

Used to keep a recurring blocker from being filed on every run. A factory whose credentials expired does not need forty identical requests; it needs one, and a count.

Trait Implementations

impl Clone for HelpRequest

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HelpRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HelpRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for HelpRequest

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for HelpRequest

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 HelpRequest