Struct InteractiveSession 

pub struct InteractiveSession {
    pub session_id: Uuid,
    pub goal_id: Uuid,
    pub channel_id: String,
    pub agent_id: String,
    pub state: InteractiveSessionState,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub messages: Vec<SessionMessage>,
    pub draft_ids: Vec<Uuid>,
}

A persistent interactive session record linking a goal to channel state.

Tracks the lifecycle of a human-agent interactive session across CLI invocations. Serialized to JSON for persistence (same pattern as ReviewSession).

Fields

session_id: Uuid

Unique session identifier.

goal_id: Uuid

The GoalRun this session is attached to.

channel_id: String

Channel identity (e.g., “cli:tty0”).

agent_id: String

Agent identity (e.g., “claude-code”).

state: InteractiveSessionState

Session lifecycle state.

created_at: DateTime<Utc>

Session creation time.

updated_at: DateTime<Utc>

Last activity time.

messages: Vec<SessionMessage>

Message log (persisted for audit and resume).

draft_ids: Vec<Uuid>

Associated draft IDs (drafts reviewed inline during this session).

Implementations

impl InteractiveSession

pub fn new(goal_id: Uuid, channel_id: String, agent_id: String) -> Self

Create a new interactive session for a goal.

pub fn log_message(&mut self, sender: &str, content: &str)

Record a message in the session log.

pub fn add_draft(&mut self, draft_id: Uuid)

Record that a draft was reviewed inline during this session.

pub fn transition( &mut self, new_state: InteractiveSessionState, ) -> Result<(), SessionChannelError>

Transition to a new state.

pub fn is_alive(&self) -> bool

Check if the session is in an active or paused state (can still be used).

pub fn elapsed(&self) -> Duration

Get elapsed time since session start.

pub fn elapsed_display(&self) -> String

Format elapsed time as a human-readable string.

Trait Implementations

impl Clone for InteractiveSession

fn clone(&self) -> InteractiveSession

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InteractiveSession

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InteractiveSession

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InteractiveSession

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

where __S: Serializer,

Serialize this value into the given Serde serializer.