Struct AISession 

pub struct AISession {
    pub id: SessionId,
    pub config: SessionConfig,
    pub status: RwLock<SessionStatus>,
    pub context: Arc<RwLock<SessionContext>>,
    pub created_at: DateTime<Utc>,
    pub last_activity: Arc<RwLock<DateTime<Utc>>>,
    pub metadata: Arc<RwLock<HashMap<String, Value>>>,
    pub command_history: Arc<RwLock<Vec<CommandRecord>>>,
    pub command_count: Arc<RwLock<usize>>,
    pub total_tokens: Arc<RwLock<usize>>,
    /* private fields */
}

AI-optimized session

Fields

id: SessionId

Unique session ID

config: SessionConfig

Session configuration

status: RwLock<SessionStatus>

Current status

context: Arc<RwLock<SessionContext>>

Session context (AI state, history, etc.)

created_at: DateTime<Utc>

Creation time

last_activity: Arc<RwLock<DateTime<Utc>>>

Last activity time

metadata: Arc<RwLock<HashMap<String, Value>>>

Session metadata

command_history: Arc<RwLock<Vec<CommandRecord>>>

Command history tracking

command_count: Arc<RwLock<usize>>

Command count

total_tokens: Arc<RwLock<usize>>

Total tokens used

Implementations

impl AISession

pub async fn new(config: SessionConfig) -> Result<Self>

Create a new AI session

pub async fn new_with_id( id: SessionId, config: SessionConfig, created_at: DateTime<Utc>, ) -> Result<Self>

Create an AI session with a specific ID (for restoration)

pub async fn start(&self) -> Result<()>

Start the session

pub async fn stop(&self) -> Result<()>

Stop the session

pub async fn send_input(&self, input: &str) -> Result<()>

Send input to the session

pub async fn read_output(&self) -> Result<Vec<u8>>

Read output from the session

pub async fn status(&self) -> SessionStatus

Get current session status

pub async fn set_metadata(&self, key: String, value: Value) -> Result<()>

Update session metadata

pub async fn get_metadata(&self, key: &str) -> Option<Value>

Get session metadata

pub async fn execute_command(&self, command: &str) -> Result<String>

Execute a command and record it in history

pub async fn add_tokens(&self, token_count: usize)

Add tokens to the session total

pub async fn get_command_history(&self) -> Vec<CommandRecord>

Get command history

pub async fn get_command_count(&self) -> usize

Get command count

pub async fn get_total_tokens(&self) -> usize

Get total tokens used

pub async fn trim_command_history(&self, keep_recent: usize)

Clear command history (keep recent N commands)

impl AISession

pub async fn get_ai_context(&self) -> Result<SessionContext>

Get AI context