Ivan's wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

# Backend test servers (llmcpp)

**Backend test servers** provide controlled model-API responses for native-client tests. The OpenAI fixture starts locally and exposes request history:

```cpp
llmcpp::test::TestFakeOpenAIServer server;
CHECK(server.base_url().find("http://127.0.0.1:") == 0);
CHECK(server.calls() == 0);
CHECK(server.requests().empty());
CHECK(server.problem().empty());
```

The test checks that a new fixture has a loopback endpoint, no calls, no captured requests, and no reported problem. Integration tests pass that endpoint to the native client, then verify its tool exchange and submitted request contents.

This differs from a [[llmcpp-mock-agents|mock agent]]: the server speaks a provider API format, while a mock agent speaks the compiler's external-agent protocol. Both make selected scenarios reproducible without remote service credentials or nondeterministic model choices.

Source: [test_unit_test_fake_openai_server.cpp](https://github.com/yanevskiv/llmcpp/blob/main/tests/unit/test/test_unit_test_fake_openai_server.cpp).