Struct Chat 

pub struct Chat {
    pub schema: u32,
    pub id: String,
    pub repo: PathBuf,
    pub from: Option<String>,
    pub agent: String,
    pub status: ChatStatus,
    pub turns: Vec<Turn>,
    pub draft: Option<String>,
    pub task: Option<String>,
    pub created_at: Timestamp,
    pub updated_at: Timestamp,
    /* private fields */
}

One planning conversation.

Fields

schema: u32

On-disk format version.

id: String

Conversation id, e.g. 20260903-014455-ab12.

repo: PathBuf

Repository the task will be filed against.

from: Option<String>

The chat this one was derived from, when it began as a fork into a different repository. See derived_background. #[serde(default)] so a conversation recorded before this field existed still reads.

agent: String

Roster agent id doing the interviewing.

status: ChatStatus

Current state.

turns: Vec<Turn>

Everything said, oldest first.

draft: Option<String>

The task file, once the agent has written one.

task: Option<String>

Queue task id, once filed.

created_at: Timestamp

When the conversation was opened.

updated_at: Timestamp

Last change to this file.

Implementations

impl Chat

pub fn short(&self) -> &str

Short form used in lists and notifications, matching a run’s short id.

pub fn agent_turns(&self) -> usize

How many turns the interviewing agent has actually taken.

Read off the seat rather than counted from Chat::turns, because a failed turn appends a MAGI_NOTE message that no agent wrote. The number names artifacts, so it has to match what was invoked.

Trait Implementations

impl Clone for Chat

fn clone(&self) -> Chat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Chat

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Chat

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Chat

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

where __S: Serializer,

Serialize this value into the given Serde serializer.