Skip to main content

Crate everruns_test_support

Crate everruns_test_support 

Source
Expand description

In-memory loops, test doubles, writable fixtures, and demo capabilities for testing Everruns agents.

everruns-test-support is the testing and demonstration companion to the production-safe everruns-llmsim crate. It keeps reusable helpers out of production compositions:

  • in_memory_loop — a full in-memory agentic loop with no database or network (sim + host features)
  • in_memory — deterministic message and event fixtures for isolated tests; hosted loops use canonical event history instead
  • doubles — mock/echo/failing tool executors and a mock chat driver
  • mcp — a stateful mock MCP resource and OAuth authorization server
  • capabilities — fake AWS/CRM/financial/warehouse demo capabilities and the test math/weather, sample-data, and noop fixtures (fixtures feature)
  • a source-compatible 0.18 migration bridge for the simulator types and host extension previously published here, including registration-only .llm_sim(...) and explicit .llm_sim_as_default(...) (sim / host features)

Production code should use everruns::Model::simulated or depend on everruns-llmsim directly. Do not add a production dependency on this crate or register its fixture capabilities.

§Example

use everruns_test_support::{InMemoryAgenticLoop, TestMathCapability};

let agent = InMemoryAgenticLoop::builder()
    .with_simulated_response("2 + 2 = 4")
    .capability(TestMathCapability)
    .build()
    .await?;
let result = agent.run_turn("What is 2 + 2?").await?;
assert!(result.success);

Re-exports§

pub use doubles::EchoToolExecutor;
pub use doubles::FailingToolExecutor;
pub use doubles::MockLlmResponse;
pub use doubles::MockProvider;
pub use doubles::MockToolExecutor;
pub use in_memory::InMemoryEventEmitter;
pub use in_memory::InMemoryMessageRetriever;
pub use in_memory_loop::InMemoryAgenticLoop;
pub use in_memory_loop::InMemoryAgenticLoopBuilder;
pub use mcp::MockCallResponse;
pub use mcp::MockMcpOAuthServer;
pub use mcp::MockMcpProtocolEra;
pub use mcp::MockOAuthError;
pub use mcp::RecordedMcpRequest;
pub use mcp::RecordedOAuthRequest;
pub use capabilities::FAKE_AWS_CAPABILITY_ID;
pub use capabilities::FAKE_CRM_CAPABILITY_ID;
pub use capabilities::FAKE_FINANCIAL_CAPABILITY_ID;
pub use capabilities::FAKE_WAREHOUSE_CAPABILITY_ID;
pub use capabilities::FakeAwsCapability;
pub use capabilities::FakeCrmCapability;
pub use capabilities::FakeFinancialCapability;
pub use capabilities::FakeWarehouseCapability;
pub use capabilities::NOOP_CAPABILITY_ID;
pub use capabilities::NoopCapability;
pub use capabilities::SAMPLE_DATA_CAPABILITY_ID;
pub use capabilities::SampleDataCapability;
pub use capabilities::TEST_MATH_CAPABILITY_ID;
pub use capabilities::TEST_WEATHER_CAPABILITY_ID;
pub use capabilities::TestMathCapability;
pub use capabilities::TestWeatherCapability;

Modules§

capabilities
Demo and test fixture capabilities.
doubles
in_memory
Deterministic in-memory fixtures for isolated tests.
in_memory_loop
llmsim_driver
Compatibility module preserving the 0.17 simulator path during the 0.18 migration.
mcp
Shared MCP and OAuth test harness. In-memory MCP resource and OAuth authorization server for integration tests.

Structs§

LlmSimConfig
Configuration for the LlmSim driver.
LlmSimDriver
Deterministic LLM simulator driver.
SimToolCall
A single tool call inside a scripted turn.
ToolCallPattern
Pattern for conditional tool calls

Enums§

OnExhausted
Behavior when a scripted config has consumed all turns.
ResponseConfig
Response generation configuration.
SimError
Error to inject for a scripted turn.
SimTurn
A single scripted assistant turn.
ToolCallConfig
Tool call configuration.

Constants§

LLMSIM_MODEL_ID
Canonical model id served by the llmsim provider.
LLMSIM_PROVIDER
Canonical provider name and model id used by simulated runtimes.

Traits§

LlmSimRuntimeExt
Deterministic-simulation sugar for runtime builders.

Functions§

llm_sim_provider
Build an llmsim provider from a simulator configuration.
reason_atom_with_stores
Compose a reason atom from in-memory stores for tests and examples.