Struct KodaSession 

pub struct KodaSession {
    pub id: String,
    pub agent: Arc<KodaAgent>,
    pub db: Database,
    pub provider: Box<dyn LlmProvider>,
    pub mode: TrustMode,
    pub cancel: CancellationToken,
    pub file_tracker: FileTracker,
    pub title_set: bool,
}

A single conversation session with its own state.

Each session has its own provider, trust mode, and cancel token. Multiple sessions can share the same Arc<KodaAgent>.

Fields

id: String

Unique session identifier.

agent: Arc<KodaAgent>

Shared agent configuration (tools, system prompt).

db: Database

Database handle for message persistence.

provider: Box<dyn LlmProvider>

LLM provider for this session.

mode: TrustMode

Current trust mode (Plan / Safe / Auto).

cancel: CancellationToken

Cancellation token for graceful shutdown.

file_tracker: FileTracker

File lifecycle tracker — tracks files created by Koda (#465).

title_set: bool

Whether the session title has already been set (first-message guard).

Implementations

impl KodaSession

pub async fn new( id: String, agent: Arc<KodaAgent>, db: Database, config: &KodaConfig, mode: TrustMode, ) -> Self

Create a new session from an agent, config, and database.

pub async fn run_turn( &mut self, config: &KodaConfig, pending_images: Option<Vec<ImageData>>, sink: &dyn EngineSink, cmd_rx: &mut Receiver<EngineCommand>, ) -> Result<()>

Run one inference turn: prompt → streaming → tool execution → response.

Emits TurnStart and TurnEnd lifecycle events. The loop-cap prompt is handled via EngineEvent::LoopCapReached / EngineCommand::LoopDecision through the cmd_rx channel.

pub fn update_provider(&mut self, config: &KodaConfig)

Replace the provider (e.g., after switching models or providers).