Struct CodingAgent 

pub struct CodingAgent { /* private fields */ }

A coding agent: drives run_turn over the built-in tools, one turn at a time, keeping the history in a caller-visible Session.

Implementations

impl CodingAgent

pub fn new( provider: Arc<dyn ModelProvider>, config: CodingAgentConfig, ) -> Result<Self, CodingAgentError>

A fresh agent with an empty session. The workspace is canonicalized for tool scoping; the system prompt defaults to the built-in template rendered by [crate::prompt::render_system] unless config.system replaces it. A base prompt that fails to render fails the construction.

pub fn from_session( provider: Arc<dyn ModelProvider>, config: CodingAgentConfig, session: Session, ) -> Result<Self, CodingAgentError>

A fresh agent resuming session (e.g. from CodingAgent::load_session_from); the next turn continues the prior history.

pub fn set_commit_hook(&mut self, hook: Option<CommitHook>)

Installs the commit-before-execute hook on the engine (see rhema_core::CommitHook); None disables it. A driver that persists the session sets this so a crash inside a tool call leaves a committed intent — which the next turn’s revive closes — rather than no record at all.

pub fn session(&self) -> &Session

The conversation so far.

pub fn system(&self) -> &str

The rendered system prompt this agent stamps into every request.

pub fn session_mut(&mut self) -> &mut Session

Mutable access between turns; the engine owns the history only inside a turn.

pub async fn turn( &mut self, input: impl Into<String>, sink: &mut dyn EventSink, approval: Arc<dyn Approval>, ) -> Result<ModelOutput, CodingAgentError>

One turn: push the user input, loop steps until the model stops requesting tools (capped at max_turn_steps), with approval gating the side-effecting tools. Appends to the session in place; the hook is cleared on the way out, success or failure. A history entering with unanswered calls — a crash resume — revives first, so the model sees a closed round, not a dangling one.

pub fn save_session_to(&self, path: &impl AsRef<Path>) -> Result<()>

Writes the session as pretty JSON to path.

pub fn load_session_from(path: &impl AsRef<Path>) -> Result<Session>

Reads a session written by CodingAgent::save_session_to.