Struct ThreadMetadata 

pub struct ThreadMetadata {

    pub id: ThreadId,
    pub rollout_path: PathBuf,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub recency_at: DateTime<Utc>,
    pub source: String,
    pub history_mode: ThreadHistoryMode,
    pub thread_source: Option<ThreadSource>,
    pub agent_nickname: Option<String>,
    pub agent_role: Option<String>,
    pub agent_path: Option<String>,
    pub model_provider: String,
    pub model: Option<String>,
    pub reasoning_effort: Option<ReasoningEffort>,
    pub cwd: PathBuf,
    pub cli_version: String,
    pub title: String,
    pub name: Option<String>,
    pub preview: Option<String>,
    pub sandbox_policy: String,
    pub approval_mode: String,
    pub tokens_used: i64,
    pub first_user_message: Option<String>,
    pub archived_at: Option<DateTime<Utc>>,
    pub git_sha: Option<String>,
    pub git_branch: Option<String>,
    pub git_origin_url: Option<String>,
}

Canonical persisted thread metadata.

Fields

id: ThreadId

The thread identifier.

rollout_path: PathBuf

The absolute rollout path on disk.

created_at: DateTime<Utc>

The creation timestamp.

updated_at: DateTime<Utc>

The last update timestamp.

recency_at: DateTime<Utc>

The product recency timestamp.

source: String

The session source (stringified enum).

history_mode: ThreadHistoryMode

Persisted thread history contract selected when this thread was created.

thread_source: Option<ThreadSource>

Optional analytics source classification for this thread.

agent_nickname: Option<String>

Optional random unique nickname assigned to an AgentControl-spawned sub-agent.

agent_role: Option<String>

Optional role (agent_role) assigned to an AgentControl-spawned sub-agent.

agent_path: Option<String>

Optional canonical agent path assigned to an AgentControl-spawned sub-agent.

model_provider: String

The model provider identifier.

model: Option<String>

The latest observed model for the thread.

reasoning_effort: Option<ReasoningEffort>

The latest observed reasoning effort for the thread.

cwd: PathBuf

The working directory for the thread.

cli_version: String

Version of the CLI that created the thread.

title: String

A best-effort thread title.

name: Option<String>

Explicit user-facing thread name, if one was set.

preview: Option<String>

Best available user-facing preview for discovery and list display.

sandbox_policy: String

The sandbox policy (stringified enum).

approval_mode: String

The approval mode (stringified enum).

tokens_used: i64

The last observed token usage.

first_user_message: Option<String>

First user message observed for this thread, if any.

archived_at: Option<DateTime<Utc>>

The archive timestamp, if the thread is archived.

git_sha: Option<String>

The git commit SHA, if known.

git_branch: Option<String>

The git branch name, if known.

git_origin_url: Option<String>

The git origin URL, if known.

Implementations

impl ThreadMetadata

pub fn prefer_existing_git_info(&mut self, existing: &Self)

Preserve SQLite-owned Git fields when rollout-derived metadata is reconciled.

pub fn prefer_existing_explicit_title(&mut self, existing: &Self)

Preserve an existing user-facing title when reconciling rollout-derived metadata.

pub fn diff_fields(&self, other: &Self) -> Vec<&'static str>

Return the list of field names that differ between self and other.

Trait Implementations

impl Clone for ThreadMetadata

fn clone(&self) -> ThreadMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThreadMetadata

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

Formats the value using the given formatter.

impl Eq for ThreadMetadata

impl PartialEq for ThreadMetadata

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ThreadMetadata