Package org.mockserver.llm.analysis

Class AgentRunDiff

java.lang.Object

org.mockserver.llm.analysis.AgentRunDiff

public class AgentRunDiff
extends Object

Deterministic, prompt-level diff of two recorded agent runs. Each run is reconstructed into its canonical ParsedConversation (via AgentRunAnalyzer.canonicalConversation(java.util.List<org.mockserver.model.HttpRequest>, org.mockserver.model.Provider)), every message's text is normalised through PromptNormalizer (so cosmetic churn — whitespace, JSON key order, volatile ids/timestamps — is not reported as a change), then the two message sequences are aligned with a longest-common-subsequence diff.

Surfaces what changed between the runs: message-level additions / removals / edits, the tool calls that were added or removed, and the token / cost delta (when both sides carry usage totals, e.g. supplied from the two sides' optimisation reports).

Pure (no network, no LLM). The caller is responsible for redacting the requests before passing them in when the diff will be surfaced to a user.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	AgentRunDiff.ChangeType
static final class	AgentRunDiff.MessageDiff	A single message-level difference between the two runs.
static final class	AgentRunDiff.RunDiffResult	The full diff of two runs.
static final class	AgentRunDiff.RunSide	One side of the diff: the recorded requests, the provider, and optional usage totals.
static final class	AgentRunDiff.TokenDelta	Token / cost deltas (after − before).

Constructor Summary

Constructors

Constructor	Description
AgentRunDiff()

Method Summary

Modifier and Type	Method	Description
AgentRunDiff.RunDiffResult	diff(AgentRunDiff.RunSide before, AgentRunDiff.RunSide after, NormalizationOptions options)	Diff the before run against the after run, normalising prompt text with options (null means the NormalizationOptions defaults).

Methods inherited from class java.lang.Object

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

Constructor Details

AgentRunDiff

public AgentRunDiff()

Method Details

diff

public AgentRunDiff.RunDiffResult diff(AgentRunDiff.RunSide before,
 AgentRunDiff.RunSide after,
 NormalizationOptions options)

Diff the before run against the after run, normalising prompt text with options (null means the NormalizationOptions defaults).