Struct Question 

pub struct Question {

    pub schema: u32,
    pub id: String,
    pub run: String,
    pub node: String,
    pub seat: String,
    pub summary: String,
    pub detail: String,
    pub choices: Vec<String>,
    pub panel: bool,
    pub assets: Vec<String>,
    pub status: QuestionStatus,
    pub asked_at: Timestamp,
    pub answered_at: Option<Timestamp>,
    pub answer: Option<Answer>,
}

One decision magi will not take on the owner’s behalf.

Fields

schema: u32

On-disk format version.

id: String

Question id, e.g. 20260902-231501-ab12. Same shape as a run’s and a task’s, so the operator can paste any of them at any prefix argument.

run: String

Run that is parked behind this question.

node: String

Graph node the asking agent was working in, e.g. implement.

seat: String

Seat that asked, e.g. impl-A. Recorded because “which agent needs this” decides whether the answer unblocks one candidate or all of them.

summary: String

One line: the question itself. This is what a notification carries and what the phone shows above the answer controls.

detail: String

The reasoning behind the question, as markdown. May be long, may be empty. Rendered as text nodes by the UI, never as markup.

choices: Vec<String>

The admissible answers. Empty means free text - that one condition is the whole difference between the two kinds of question, on disk, in the UI, and in Question::answer’s validation.

panel: bool

Does this question have an agent-authored HTML panel beside it?

Serialised with a default so a question written by an older magi - or by hand - still deserialises rather than failing the whole store, which under Questions::list’s skip-unreadable rule would quietly hide the open question the operator was looking for.

assets: Vec<String>

Files copied in beside the panel’s html, by base name, sorted.

The list exists so a reader knows what a panel is made of without walking the directory, and every entry satisfies valid_asset_name. Sorted because it is compared - a question re-asked with the same assets in a different argument order is not a different question.

status: QuestionStatus

Current state.

asked_at: Timestamp

When the agent asked.

answered_at: Option<Timestamp>

When the owner answered, if they did.

answer: Option<Answer>

What they said.

Implementations

impl Question

pub fn new( run: String, node: String, seat: String, summary: String, detail: String, choices: Vec<String>, ) -> Self

Ask something. Persist it with Questions::put, or hand it to ask_and_wait, which files it and waits.

pub fn short(&self) -> &str

Short form used in reports and on the phone, matching a run’s short id.

pub fn free_text(&self) -> bool

Does this question want free text rather than one of a set?

pub fn answer(&mut self, answer: Answer) -> Result<()>

Record an answer. Rejects a choice the question does not offer, free text on a multiple-choice question, an empty answer, and a second answer.

Every rejection here is a case where accepting would put a fabrication in front of an agent as if the owner had said it. The messages are distinct because the caller is a web handler that shows them verbatim, and “that is not one of the choices” and “this question is multiple choice” are different mistakes with different fixes.

pub fn abandon(&mut self, why: impl Into<String>)

Give up on an answer, keeping the record of what was asked.

An answered question is left alone, which matters at exactly one moment: the owner answering in the same second the wait’s deadline passes. The answer is the thing worth keeping there, and it has already been written by another process.

The reason is appended to Question::detail because the on-disk shape is a contract with the front end and has no field of its own for it - and “asked at 3am, nobody home for a day” belongs with the question, not only in a log the operator will never open.

pub fn resolution(&self) -> Option<String>

The answer as the asking agent should read it.

One string for both kinds of question: the agent’s prompt says “the owner answered:”, and a chosen option and a typed sentence are the same thing at that point. None while the question is open or abandoned, so a caller cannot mistake silence for a decision.

Trait Implementations

impl Clone for Question

fn clone(&self) -> Question

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Question

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Question

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Question

impl PartialEq for Question

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Question

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 Question