Evidence for your next improvement
Improve your agent.
Check the outcome.
Record the calls, cache charges, and task results behind a change. Compare the whole study, including failed and missing trials.
Local trace import. Structured experiments. No model connection.
Its purpose, cache status, and cost need context.
01Import a runOTLP or your recorded counts
02Test one changeEvidence and required checks
03Compare outcomesKeep failures in view
Start with a trace
Bring your run into focus.
Your audit
Run report
The input, turn by turn
REPORTED TOKENSView all turn counts
What the trace can tell us
A closer look
Worth reviewing.
Evidence first. Changes after evaluation.
An agent can act on this
Turn a finding into a test.
Each packet contains evidence, preconditions, measurements, and a rollback condition. Your agent runs the experiment and evaluator in its own environment.
Follow the evidence
EXACT IDENTITIES & TARGETSRepeated context blocks
Extra exposure counts each identical appearance after the first. Labels can change or be reused; exact fingerprints establish identity.
Tool output in later turns
Later exposure starts after the first observed input appearance, which may be later than the result’s creation. Usefulness is unknown.
Tool schemas not selected
Repeated exploration targets
Exact kind and target matches across calls. Repeated reads and searches can be necessary refreshes; no token saving is inferred.
Keep these boundaries in view.
Before you adopt the change
Did the whole run improve?
Compare the same tasks and trials, with the same evaluator and accounting scope. Fewer tokens alone cannot tell you whether the agent still did its job.
Three task pairs from the authors’ SWE-agent study. These are external observations, not TurnScope benchmark results.
Paired observations
What this verdict establishes
Complete the evidence · new in 0.3
What did the whole run cost?
Cache writes, helper models, and retries belong in the bill. Missing trials belong in the study. Inspect both here using metadata recorded by your agent.
Try a small example
These fixtures use invented counts and prices to demonstrate the checks. Loading one stays in your browser until you choose Inspect evidence.
Recorded evidence
Full report JSON
Counts, completeness declarations, task identities, and outcomes are supplied by the caller. This report cannot independently verify them or prove future savings.
For the agent doing the work
Record. Account.
Compare.
Normalize telemetry locally or record events with the Python helper. Declare expected trials before the experiment, retain failures, and submit your evaluator’s results.
python3 turnscope.py normalize trace.json --format genai --output imported.json
python3 turnscope.py analyze imported.json --server "$TURNSCOPE_BASE_URL" --output report.jsoncurl "$TURNSCOPE_BASE_URL/api/v1/analyze" \
-H 'Content-Type: application/json' \
--data-binary @run.jsonFingerprints and reported counts are enough.
Raw prompts and documents are optional.