everruns_test_support/lib.rs
1//! In-memory loops, test doubles, writable fixtures, and demo capabilities for testing
2//! [Everruns](https://everruns.com) agents.
3//!
4//! `everruns-test-support` is the testing and demonstration companion to the
5//! production-safe [`everruns-llmsim`](https://docs.rs/everruns-llmsim) crate.
6//! It keeps reusable helpers out of production compositions:
7//!
8//! - [`in_memory_loop`] — a full in-memory agentic loop with no database or
9//! network (`sim` + `host` features)
10//! - [`in_memory`] — deterministic message and event fixtures for isolated
11//! tests; hosted loops use canonical event history instead
12//! - [`doubles`] — mock/echo/failing tool executors and a mock chat driver
13//! - [`mcp`] — a stateful mock MCP resource and OAuth authorization server
14//! - [`capabilities`] — fake AWS/CRM/financial/warehouse demo capabilities
15//! and the test math/weather, sample-data, and noop fixtures
16//! (`fixtures` feature)
17//! - a source-compatible 0.18 migration bridge for the simulator types and
18//! host extension previously published here, including registration-only
19//! `.llm_sim(...)` and explicit `.llm_sim_as_default(...)` (`sim` / `host`
20//! features)
21//!
22//! Production code should use `everruns::Model::simulated` or depend on
23//! `everruns-llmsim` directly. Do not add a production dependency on this
24//! crate or register its fixture capabilities.
25//!
26//! # Example
27//!
28//! ```
29//! # #[tokio::main]
30//! # async fn main() -> Result<(), Box<dyn std::error::Error>> {
31//! use everruns_test_support::{InMemoryAgenticLoop, TestMathCapability};
32//!
33//! let agent = InMemoryAgenticLoop::builder()
34//! .with_simulated_response("2 + 2 = 4")
35//! .capability(TestMathCapability)
36//! .build()
37//! .await?;
38//! let result = agent.run_turn("What is 2 + 2?").await?;
39//! assert!(result.success);
40//! # Ok(())
41//! # }
42//! ```
43
44/// Compatibility module preserving the 0.17 simulator path during the 0.18
45/// migration.
46///
47/// New production code should import these items from `everruns_llmsim`.
48#[cfg(feature = "sim")]
49pub mod llmsim_driver {
50 pub use everruns_llmsim::*;
51}
52
53// In-memory agentic loop built on the llmsim driver.
54#[cfg(all(feature = "sim", feature = "host"))]
55pub mod in_memory_loop;
56
57pub mod in_memory;
58
59// Test doubles for the core execution traits.
60pub mod doubles;
61/// Shared MCP and OAuth test harness.
62pub mod mcp;
63
64// Demo/test fixture capabilities (behind the `fixtures` feature).
65#[cfg(feature = "fixtures")]
66pub mod capabilities;
67
68#[cfg(feature = "host")]
69mod store_reason_atom;
70
71pub use doubles::{
72 EchoToolExecutor, FailingToolExecutor, MockLlmResponse, MockProvider, MockToolExecutor,
73};
74#[cfg(feature = "sim")]
75pub use everruns_llmsim::{
76 LlmSimConfig, LlmSimDriver, OnExhausted, ResponseConfig, SimError, SimToolCall, SimTurn,
77 ToolCallConfig, ToolCallPattern,
78};
79pub use in_memory::{InMemoryEventEmitter, InMemoryMessageRetriever};
80#[cfg(all(feature = "sim", feature = "host"))]
81pub use in_memory_loop::{InMemoryAgenticLoop, InMemoryAgenticLoopBuilder};
82pub use mcp::{
83 MockCallResponse, MockMcpOAuthServer, MockMcpProtocolEra, MockOAuthError, RecordedMcpRequest,
84 RecordedOAuthRequest,
85};
86
87#[cfg(feature = "fixtures")]
88pub use capabilities::{
89 FAKE_AWS_CAPABILITY_ID, FAKE_CRM_CAPABILITY_ID, FAKE_FINANCIAL_CAPABILITY_ID,
90 FAKE_WAREHOUSE_CAPABILITY_ID, FakeAwsCapability, FakeCrmCapability, FakeFinancialCapability,
91 FakeWarehouseCapability, NOOP_CAPABILITY_ID, NoopCapability, SAMPLE_DATA_CAPABILITY_ID,
92 SampleDataCapability, TEST_MATH_CAPABILITY_ID, TEST_WEATHER_CAPABILITY_ID, TestMathCapability,
93 TestWeatherCapability,
94};
95
96#[cfg(feature = "host")]
97pub use everruns_llmsim::{LLMSIM_MODEL_ID, LLMSIM_PROVIDER, LlmSimRuntimeExt, llm_sim_provider};
98
99#[cfg(feature = "host")]
100pub use store_reason_atom::reason_atom_with_stores;