Struct AgentBuilder 

pub struct AgentBuilder {
    pub verification_gates: Vec<VerificationGate>,
    /* 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.

Fields

verification_gates: Vec<VerificationGate>

Optional workflow contract override. If absent, build creates an implicit contract.

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 preloaded_lua_tools(self, tools: ToolRegistry) -> Self

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 lua_tool_loader<F>(self, f: F) -> Self

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

pub fn run_policy(self, policy: RunPolicy) -> Self

Apply a per-run policy on top of the configured agent mode.

pub fn verification_gate(self, gate: VerificationGate) -> Self

Add a verification gate to the agent run.

pub fn verification_gates<I>(self, gates: I) -> Self

where I: IntoIterator<Item = VerificationGate>,

Add verification gates to the agent run.

pub fn verify_command(self, command: impl Into<String>, required: bool) -> Self

Add a command verification gate to the agent run.

pub fn preloaded_prompt_context(self, context: SessionPromptContext) -> Self

Use preloaded mana prompt context instead of loading it during build.

pub fn workflow_contract(self, contract: WorkflowContract) -> Self

Override the implicit workflow contract for this agent run.

pub fn autonomy_mode(self, mode: AutonomyMode) -> Self

Set the autonomy mode on the implicit workflow contract.

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

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

Returns (Agent, AgentHandle) ready for use.