Enum AgentRole 

pub enum AgentRole {
    Exploration,
    Planning,
    Verification,
    Execution,
}

Role assigned to a TaskAgent that restricts its available tools.

When no role is set an agent receives all tools in its context — equivalent to Execution. Roles are opt-in so existing callers are unaffected.

Variants

Exploration

Read-only exploration: file reads, directory listing, search, web fetch.

Safe to run against untrusted or sensitive repositories. Cannot write, execute commands, or spawn additional agents.

Planning

Planning only: task management + read access.

May create and query tasks but cannot modify files or run code. Intended for the planning phase before execution begins.

Verification

Verification: read access and build/test execution.

May read files and run validation tools (build, test, lint). Cannot write files or modify the repository. Used after Execution to confirm results.

Execution

Full execution: all tools available. Requires explicit grant.

Identical to having no role set. Named explicitly so callers are clear that they are granting unrestricted tool access.

Implementations

impl AgentRole

pub fn allowed_tools(self) -> Option<&'static [&'static str]>

Tool names allowed for this role. None means all tools are permitted.

pub fn filter_tools(self, tools: &[Tool]) -> Vec<Tool>

Filter a tool slice to only those permitted by this role.

Returns a Vec<Tool> that can be passed directly to the provider. When the role is Execution the original slice is cloned in full.

pub fn system_prompt_suffix(self) -> &'static str

Short system-prompt suffix that reminds the model of its constraints.

Trait Implementations

impl Clone for AgentRole

fn clone(&self) -> AgentRole

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentRole

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentRole

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for AgentRole

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for AgentRole

fn eq(&self, other: &AgentRole) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AgentRole

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for AgentRole

impl Eq for AgentRole

impl StructuralPartialEq for AgentRole