Struct AgentThread 

pub struct AgentThread {

    pub id: ThreadId,
    pub kind: ThreadKind,
    pub label: String,
    pub description: Option<String>,
    pub status: ThreadStatus,
    pub parent_id: Option<ThreadId>,
    pub created_at: SystemTime,
    pub last_activity: SystemTime,
    pub is_foreground: bool,
    pub messages: VecDeque<ThreadMessage>,
    pub compact_summary: Option<String>,
    pub result: Option<String>,
    pub share_context: bool,
}

An agent thread — the unified representation of all concurrent work.

Fields

id: ThreadId

Unique identifier

kind: ThreadKind

What kind of thread this is

label: String

User-visible label

description: Option<String>

Agent-settable description of current activity

status: ThreadStatus

Current status

parent_id: Option<ThreadId>

Parent thread that spawned this (if any)

created_at: SystemTime

When the thread was created

last_activity: SystemTime

When the thread last had activity

is_foreground: bool

Is this the foreground (user-focused) thread?

messages: VecDeque<ThreadMessage>

Conversation history (for interactive threads)

compact_summary: Option<String>

Compacted summary of older messages

result: Option<String>

Result value (for task/sub-agent threads)

share_context: bool

Should this thread’s context be shared with parent?

Implementations

impl AgentThread

pub fn task_id(&self) -> ThreadId

Backwards-compatible alias for id (used by gateway code).

pub fn new_chat(label: impl Into<String>) -> Self

Create a new chat thread.

pub fn new_subagent( label: impl Into<String>, agent_id: impl Into<String>, task: impl Into<String>, parent_id: Option<ThreadId>, ) -> Self

Create a new sub-agent thread.

pub fn new_background( label: impl Into<String>, purpose: impl Into<String>, parent_id: Option<ThreadId>, ) -> Self

Create a new background thread.

pub fn new_task( label: impl Into<String>, action: impl Into<String>, parent_id: Option<ThreadId>, ) -> Self

Create a new task thread.

pub fn set_description(&mut self, description: impl Into<String>)

Update the description.

pub fn set_status(&mut self, status: ThreadStatus)

Update the status.

pub fn complete(&mut self, summary: Option<String>, result: Option<String>)

Mark as completed with optional result.

pub fn fail(&mut self, error: impl Into<String>)

Mark as failed.

pub fn add_message(&mut self, role: MessageRole, content: impl Into<String>)

Add a message to the conversation history.

pub fn message_count(&self) -> usize

Get message count.

pub fn compaction_prompt(&self) -> String

Generate a prompt for compacting this thread’s conversation.

pub fn apply_compaction(&mut self, summary: String)

Apply a compaction summary, keeping only recent messages.

pub fn build_context(&self) -> String

Build context string for this thread (for system prompt injection).

pub fn to_info(&self) -> ThreadInfo

Get info for sidebar display.

Trait Implementations

impl Clone for AgentThread

fn clone(&self) -> AgentThread

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentThread

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentThread

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentThread

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

where __S: Serializer,

Serialize this value into the given Serde serializer.