Struct Agent 

pub struct Agent { /* private fields */ }

Agent for deterministic AI-driven code operations.

The agent follows a strict loop:

1. Observe: Gather context from the graph
2. Constrain: Apply policy rules
3. Plan: Generate execution steps
4. Mutate: Apply changes
5. Verify: Validate results
6. Commit: Finalize transaction

Implementations

impl Agent

pub async fn new(codebase_path: impl AsRef<Path>) -> Result<Self>

Creates a new agent for the given codebase.

Arguments

• codebase_path - Path to the codebase

pub async fn observe(&self, query: &str) -> Result<Observation>

Observes the codebase to gather context for a query.

Arguments

• query - The natural language query or request

pub async fn constrain( &self, observation: Observation, policies: Vec<Policy>, ) -> Result<ConstrainedPlan>

Applies policy constraints to the observation.

Arguments

• observation - The observation to constrain
• policies - The policies to validate

pub async fn plan(&self, constrained: ConstrainedPlan) -> Result<ExecutionPlan>

Generates an execution plan from the constrained observation.

pub async fn mutate(&self, plan: ExecutionPlan) -> Result<MutationResult>

Executes the mutation phase of the plan.

pub async fn verify( &self, _result: MutationResult, ) -> Result<VerificationResult>

Verifies the mutation result.

pub async fn commit(&self, result: VerificationResult) -> Result<CommitResult>

Commits the verified mutation.