Struct AgentSession 

pub struct AgentSession {

    pub id: AgentSessionId,
    pub name: Option<String>,
    pub cursor: TraversalCursor,
    pub capabilities: AgentCapabilities,
    pub limits: SessionLimits,
    pub budget: BudgetTracker,
    pub metrics: SessionMetrics,
    pub state: SessionState,
    pub created_at: DateTime<Utc>,
    pub last_active: DateTime<Utc>,
    pub last_results: Vec<BlockId>,
    pub context_blocks: HashSet<BlockId>,
    pub focus_block: Option<BlockId>,
    pub codegraph_context: Option<CodeGraphContextSession>,
}

Agent session state - tracks individual agent’s position and history.

Fields

id: AgentSessionId

Unique session identifier.

name: Option<String>

Human-readable session name.

cursor: TraversalCursor

Current cursor position in the graph.

capabilities: AgentCapabilities

Agent capabilities.

limits: SessionLimits

Safety limits for this session.

budget: BudgetTracker

Budget tracker.

metrics: SessionMetrics

Metrics and telemetry.

state: SessionState

Session state.

created_at: DateTime<Utc>

Creation timestamp.

last_active: DateTime<Utc>

Last activity timestamp.

last_results: Vec<BlockId>

Last search/find results for CTX ADD RESULTS.

context_blocks: HashSet<BlockId>

Generic selected blocks in the context window.

focus_block: Option<BlockId>

Focus block for context (protected from pruning).

codegraph_context: Option<CodeGraphContextSession>

Codegraph-specific working set state when the active document is a codegraph.

Implementations

impl AgentSession

pub fn new(start_block: BlockId, config: SessionConfig) -> Self

pub fn is_active(&self) -> bool

Check if session is active.

pub fn is_timed_out(&self) -> bool

Check if session has timed out.

pub fn touch(&mut self)

Update last activity timestamp.

pub fn complete(&mut self)

Mark session as completed.

pub fn error(&mut self, reason: String)

Mark session as errored.

pub fn pause(&mut self)

Pause the session.

pub fn resume(&mut self) -> Result<()>

Resume the session.

pub fn check_active(&self) -> Result<()>

Check if session can perform an operation.

pub fn check_can_traverse(&self) -> Result<()>

Check if session can traverse.

pub fn check_can_search(&self) -> Result<()>

Check if session can search.

pub fn check_can_modify_context(&self) -> Result<()>

Check if session can modify context.

pub fn store_results(&mut self, results: Vec<BlockId>)

Store last search/find results.

pub fn get_last_results(&self) -> Result<&[BlockId]>

Get last results (for CTX ADD RESULTS).

pub fn set_focus(&mut self, block_id: Option<BlockId>)

Set focus block.

pub fn ensure_codegraph_context(&mut self) -> &mut CodeGraphContextSession

pub fn info(&self) -> SessionInfo

Get session info as serializable struct.