Struct AgentBuilder 

pub struct AgentBuilder { /* private fields */ }

Builder for creating a fully wired Agent from config and context.

Handles resource discovery, hook loading, system prompt assembly, and tool registration so callers don’t need to repeat this boilerplate.

Implementations

impl AgentBuilder

pub fn new(config: Config, cwd: PathBuf, model: Model, api_key: String) -> Self

Create a new builder.

pub fn role(self, role: Role) -> Self

Set the role for this agent.

pub fn task(self, task: TaskContext) -> Self

Set the task context (headless/task mode — Layer 5 of the system prompt).

pub fn facts(self, facts: Vec<Fact>) -> Self

Set task-specific facts to inject into the system prompt.

pub fn system_prompt(self, prompt: String) -> Self

Override the assembled system prompt with a custom string. When set, resource discovery and assembly are skipped.

pub fn extra_tools<F>(self, f: F) -> Self

where F: FnOnce(&mut ToolRegistry) + Send + 'static,

Register additional tools after the native tools are registered.

pub fn lua_tool_loader<F>(self, f: F) -> Self

where F: Fn(&LuaCapabilityPolicy, &mut ToolRegistry) + Send + Sync + 'static,

Register a Lua extension tool loader.

The provided closure should discover .lua extensions, create a LuaRuntime, and register the resulting tools onto the registry. This is called after native + extra tools are registered but before mode filtering.

The binary crate typically calls this with a closure that invokes imp_lua::load_lua_extensions().

pub fn build(self) -> Result<(Agent, AgentHandle)>

Build the agent, wiring config → thresholds, hooks, resources, and tools.

Returns (Agent, AgentHandle) ready for use.