Struct ConversationRecord 

pub struct ConversationRecord {
    pub id: String,
    pub title: String,
    pub workspace: String,
    pub workspace_id: String,
    pub persona: Option<String>,
    pub turns: Vec<ConversationTurn>,
    pub scratchpad: BTreeMap<String, String>,
    pub plan: PlanSnapshot,
    pub roadmap_id: Option<String>,
    pub node_id: Option<String>,
    pub created_at_unix_nanos: u128,
    pub updated_at_unix_nanos: u128,
}

A full conversation as loaded from the store. Also the on-disk shape of the retired JSON backend’s records — kept serde-compatible so the 17.1b one-time import can parse legacy files with the exact semantics they were written under.

Fields

id: String

title: String

workspace: String

workspace_id: String

persona: Option<String>

turns: Vec<ConversationTurn>

scratchpad: BTreeMap<String, String>

The conversation’s scratchpad <state> snapshot (#713, Step 26.4): the structured working memory the model keeps via state_set / state_get. Persisted at the conversation/record level so an interrupt + auto-resume restores the <state> it already restores the transcript for — without it, the first state_get("current_task") after a resume reads an empty live store and the model blind-probes for a task that is simply gone. Additive: #[serde(default)] keeps legacy records loadable, and an empty map is skipped on serialize so it never bloats the on-disk file. Working memory, not provenance — kept OUT of the §6 content chain (it is NOT a turn field and never enters canonical_encoding_v1).

plan: PlanSnapshot

The conversation’s plan-ledger snapshot (#715, Step 26.6b): the ordered <plan> steps with each one’s done/active status. Persisted at the conversation/record level — exactly like scratchpad — so an interrupt + auto-resume re-hydrates the in-memory ledger instead of rebuilding it empty (which loses the <plan> block and plan_get after a resume). Additive: #[serde(default)] keeps legacy records loadable, and an empty snapshot is skipped on serialize so it never bloats the on-disk file. Working memory, not provenance — kept OUT of the §6 content chain (it is NOT a turn field and never enters canonical_encoding_v1).

roadmap_id: Option<String>

#1030 “Plans within Plans”: the roadmap this conversation’s Plan node belongs to. None for an ad-hoc chat — the legacy/default shape, and by far the common case. A thin pointer INTO the tree; the tree’s authoritative shape (the plan.rs::Plan of Roadmap/Phase/Plan/Task nodes) lives in the roadmaps table, never duplicated onto this row. Additive: #[serde(default)] + skip-when-None keeps legacy records loadable and never bloats the file. Metadata, NOT provenance — kept OUT of the §6 content chain (never a turn field, never in canonical_encoding_v1).

node_id: Option<String>

#1030: the id of the plan.rs::Subtask node (within [roadmap_id]’s tree) that THIS conversation realizes — the Plan node whose context window this conversation is. None for an ad-hoc chat. Same additive / metadata-not-provenance discipline as roadmap_id.

created_at_unix_nanos: u128

updated_at_unix_nanos: u128

Trait Implementations

impl Clone for ConversationRecord

fn clone(&self) -> ConversationRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConversationRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ConversationRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ConversationRecord

impl PartialEq for ConversationRecord

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ConversationRecord

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 ConversationRecord