Struct AgentContext 

pub struct AgentContext {
    pub session_id: SessionId,
    pub working_dir: String,
    pub variables: HashMap<String, ContextValue>,
    pub permissions: AgentPermissions,
    pub started_at: SystemTime,
    pub last_activity: Instant,
    pub audit: Vec<AuditEntry>,
    pub transaction: Option<TransactionScope>,
    pub budget: OperationBudget,
    pub tool_registry: Vec<ToolDefinition>,
    pub tool_calls: Vec<ToolCallRecord>,
}

Agent session context

Fields

session_id: SessionId

Unique session identifier

working_dir: String

Current working directory

variables: HashMap<String, ContextValue>

Session variables

permissions: AgentPermissions

Permissions

started_at: SystemTime

Session start time

last_activity: Instant

Last activity time

audit: Vec<AuditEntry>

Audit trail

transaction: Option<TransactionScope>

Transaction state

budget: OperationBudget

Maximum operation budget (token/cost limit)

tool_registry: Vec<ToolDefinition>

Tool registry: available tools for this agent

tool_calls: Vec<ToolCallRecord>

Tool call history for this session

Implementations

impl AgentContext

pub fn new(session_id: SessionId) -> Self

Create a new agent context

pub fn with_working_dir(session_id: SessionId, working_dir: String) -> Self

Create with custom working directory

pub fn with_full_permissions(session_id: SessionId) -> Self

Create with full permissions (for trusted agents)

pub fn register_tool(&mut self, tool: ToolDefinition)

Register a tool with this agent

pub fn record_tool_call(&mut self, call: ToolCallRecord)

Record a tool call

pub fn set_var(&mut self, name: &str, value: ContextValue)

Set a variable

pub fn get_var(&mut self, name: &str) -> Option<ContextValue>

Get a variable (returns cloned value to avoid borrow issues)

pub fn peek_var(&self, name: &str) -> Option<&ContextValue>

Get a variable reference without auditing (for read-only access)

pub fn check_fs_permission( &self, path: &str, op: AuditOperation, ) -> Result<(), ContextError>

Check filesystem permission

pub fn check_db_permission( &self, table: &str, op: AuditOperation, ) -> Result<(), ContextError>

Check database permission

pub fn consume_budget( &mut self, tokens: u64, cost: u64, ) -> Result<(), ContextError>

Consume operation budget

pub fn begin_transaction(&mut self, tx_id: u64) -> Result<(), ContextError>

Begin transaction

pub fn commit_transaction(&mut self) -> Result<(), ContextError>

Commit transaction

pub fn rollback_transaction( &mut self, ) -> Result<Vec<PendingWrite>, ContextError>

Rollback transaction

pub fn savepoint(&mut self, name: &str) -> Result<(), ContextError>

Add savepoint

pub fn record_pending_write( &mut self, resource_type: ResourceType, resource_key: String, original_value: Option<Vec<u8>>, ) -> Result<(), ContextError>

Record pending write for rollback

pub fn resolve_path(&self, path: &str) -> String

Resolve path relative to working directory

pub fn substitute_vars(&self, input: &str) -> String

Substitute variables in string ($var syntax)

pub fn age(&self) -> Duration

Get session age

pub fn idle_time(&self) -> Duration

Get idle time

pub fn is_expired(&self, idle_timeout: Duration) -> bool

Check if session is expired (default: 1 hour idle)

pub fn export_audit(&self) -> Vec<HashMap<String, String>>

Export audit log

Trait Implementations

impl Clone for AgentContext

fn clone(&self) -> AgentContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentContext

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

Formats the value using the given formatter.