Package org.mockserver.llm.drift

Class DriftDetector

java.lang.Object

org.mockserver.llm.drift.DriftDetector

public class DriftDetector
extends Object

Replays recorded LLM request/response exchanges against a live provider and reports structural drift in the responses (new/removed fields, type changes) — closing the loop on stale VCR cassettes.

Drift is structural, not semantic: it compares response shape, not values, so it never flags benign wording changes. Each exchange fails closed independently — a network error or non-2xx live response is reported as COULD_NOT_CHECK, never as drift and never thrown. The detector takes an injected LlmTransport so it unit-tests offline; the live HTTP call is only made when a backend is configured (opt-in).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	DriftDetector.RecordedExchange	A recorded request and the body of its recorded response.

Constructor Summary

Constructors

Constructor	Description
DriftDetector(LlmClientRegistry clientRegistry, ProviderCodecRegistry codecRegistry, LlmTransport transport, long timeoutMillis)
DriftDetector(LlmTransport transport, long timeoutMillis)

Method Summary

Modifier and Type	Method	Description
DriftReport	detect(List<DriftDetector.RecordedExchange> exchanges, Provider provider, LlmBackend backend)	Replay each recorded exchange against backend and diff the live response shape against the recorded one.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DriftDetector

public DriftDetector(LlmTransport transport,
 long timeoutMillis)

DriftDetector

public DriftDetector(LlmClientRegistry clientRegistry,
 ProviderCodecRegistry codecRegistry,
 LlmTransport transport,
 long timeoutMillis)

Method Details

detect

public DriftReport detect(List<DriftDetector.RecordedExchange> exchanges,
 Provider provider,
 LlmBackend backend)

Replay each recorded exchange against backend and diff the live response shape against the recorded one. Never throws.