Struct AgentContext 

pub struct AgentContext {
    pub iteration: usize,
    pub state: AgentState,
    pub cwd: PathBuf,
    pub custom: HashMap<String, Value>,
    pub tool_configs: HashMap<String, Value>,
    pub writable_roots: Vec<PathBuf>,
}

Shared context passed to tools during execution.

Fields

iteration: usize

Current iteration (step number).

state: AgentState

Agent state.

cwd: PathBuf

Working directory.

custom: HashMap<String, Value>

Domain-specific data (extensible).

tool_configs: HashMap<String, Value>

Per-tool configuration overrides. Key: tool name, Value: tool-specific config merged at execution time.

writable_roots: Vec<PathBuf>

Directories the agent is allowed to write to (sandbox). Empty = no restriction.

Implementations

impl AgentContext

pub fn new() -> Self

pub fn with_cwd(self, cwd: impl Into<PathBuf>) -> Self

pub fn with_writable_roots(self, roots: Vec<PathBuf>) -> Self

pub fn is_writable(&self, path: &Path) -> bool

Check if a path is writable under sandbox rules. Returns true if writable_roots is empty (no sandbox) or path is under any root. Canonicalizes paths to prevent traversal attacks (../ and symlinks).

pub fn set(&mut self, key: impl Into<String>, value: Value)

Set a custom value.

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

Get a custom value.

pub fn set_tool_config(&mut self, tool_name: impl Into<String>, config: Value)

Set per-tool config.

pub fn tool_config(&self, tool_name: &str) -> Option<&Value>

Get per-tool config.

pub fn merged_tool_config(&self, tool_name: &str, base: &Value) -> Value

Get tool config merged with a base config. Per-tool values override base values (shallow merge).

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.

impl Default for AgentContext

fn default() -> Self

Returns the “default value” for a type.