Struct Session 

pub struct Session {
    pub id: Uuid,
    /* private fields */
}

Session for managing multiple documents.

Provides automatic caching of document trees and cross-document operations.

Fields

id: Uuid

Session ID.

Implementations

impl Session

pub fn with_config(self, config: SessionConfig) -> Self

Create with configuration.

pub fn id(&self) -> Uuid

Get the session ID.

pub fn age(&self) -> Duration

Get session age.

pub async fn index(&self, path: impl AsRef<Path>) -> Result<String>

Index a document into this session.

The document is indexed, saved to workspace, and cached in this session.

pub async fn index_with_options( &self, path: impl AsRef<Path>, options: IndexOptions, ) -> Result<String>

Index a document with options.

pub async fn query(&self, doc_id: &str, question: &str) -> Result<QueryResult>

Query a document within this session.

Uses the cached tree if available, otherwise loads from workspace.

pub async fn query_with_options( &self, doc_id: &str, question: &str, options: RetrieveOptions, ) -> Result<QueryResult>

Query a document with options.

pub async fn query_all(&self, question: &str) -> Result<Vec<QueryResult>>

Query across all documents in this session.

Searches each document and merges results.

pub async fn query_all_with_options( &self, question: &str, options: RetrieveOptions, ) -> Result<Vec<QueryResult>>

Query across all documents with options.

pub fn list_documents(&self) -> Vec<DocumentInfo>

Get list of documents in this session.

pub async fn get_tree(&self, doc_id: &str) -> Result<DocumentTree>

Get a document tree (from cache or workspace).

pub async fn preload(&self, doc_ids: &[&str]) -> Result<usize>

Preload documents into the session cache.

Useful for warming up the cache before querying.

pub fn remove_document(&self, doc_id: &str) -> bool

Remove a document from the session.

pub fn clear_cache(&self)

Clear all documents from the session cache.

pub fn stats(&self) -> SessionStats

Get session statistics.

pub fn cached_count(&self) -> usize

Get the number of cached documents.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.