Struct MockAgentConfig 

#[non_exhaustive]
pub struct MockAgentConfig {
    pub agent: AgentConfig,
    pub mock: MockConnectionStrategy,
}

Configuration for the deterministic, offline mock backend.

Pairs the generic AgentConfig (hooks, tools, policies, triggers) with a scripted MockConnectionStrategy so an Agent can be driven entirely offline — no network, no API key, no LLM. The parallel of GeminiAgentConfig, always available (no feature flag). Build the strategy with MockConnection::builder.

Examples

use localharness::{Agent, policy};
use localharness::backends::mock::{MockAgentConfig, MockConnection};

let backend = MockConnection::builder()
    .turn(|t| t.text("the scripted answer"))
    .build();
let agent = Agent::start_mock(MockAgentConfig::new(backend)).await?;
assert_eq!(agent.chat("anything").await?.text().await?, "the scripted answer");
agent.shutdown().await?;

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

agent: AgentConfig

Backend-agnostic settings (tools, policies, triggers).

mock: MockConnectionStrategy

The scripted mock backend strategy.

Implementations

impl MockAgentConfig

pub fn new(mock: MockConnectionStrategy) -> Self

Create a mock agent configuration from a scripted backend strategy (built via MockConnection::builder).

pub fn with_system_instructions( self, instr: impl Into<SystemInstructions>, ) -> Self

Set the system instructions (recorded on the agent config; the mock ignores them — its turns are scripted, not generated).

pub fn with_capabilities(self, cap: CapabilitiesConfig) -> Self

Configure which built-in tools are enabled.

pub fn with_tool(self, tool: Arc<dyn Tool>) -> Self

Register a custom tool.

pub fn with_policies(self, policies: Vec<Policy>) -> Self

Set the safety policies for tool execution.

pub fn with_pre_tool_hook(self, hook: Arc<dyn PreToolCallDecideHook>) -> Self

Register a custom pre-tool-call decide hook (see AgentConfig::with_pre_tool_hook).

pub fn with_post_tool_hook(self, hook: Arc<dyn PostToolCallHook>) -> Self

Register a custom post-tool-call inspect hook (see AgentConfig::with_post_tool_hook).

pub fn with_workspace(self, ws: impl Into<PathBuf>) -> Self

Add a workspace root for path-containment enforcement.

pub fn with_trigger(self, trigger: Arc<dyn Trigger>) -> Self

Register a background trigger.