Summary (Overview)

  • TraceTrial-Bench is a novel benchmark for evaluating AI agent harnesses (the system layer connecting LLMs to tools, context, and execution environments) as distinct from the underlying models, addressing a gap in existing benchmarks that focus primarily on model capabilities and overall task outcomes.
  • The benchmark organizes harness reliability into seven components (Context, Execution, Governance, Lifecycle, Observability, Tools, Verification) across 95 expert-level, mechanism-oriented tasks with executable or state-based ground truth.
  • A two-layer evaluation framework separately assesses Agent task performance and Harness reliability using a Trajectory Tracing (TT) module for execution traces and a Multi-source Evidence Acquisition (MEA) module for evidence-based LLM judging.
  • Evaluation across 4 harnesses, 9 models, and 3,420 runs reveals that harness scores range from 59.8% to 72.0% (macro-averaged), and 31.1% of runs achieve task success despite failing at least one harness criterion—demonstrating that outcome-only evaluation is insufficient.
  • A Failure Attribution (FA) module uses explicit mechanism chains to support run-level failure attribution, distinguishing candidate links from validated failure propagation through evidence review.

Introduction and Theoretical Foundation

Background

Large language models have evolved from text generators into the foundation of AI agents capable of complex, multi-step tasks involving tools, command execution, file modification, and external environment interaction. However, an AI agent's behavior depends not only on the underlying model but also on the harness—the system layer that manages:

  • System instructions and context management
  • Available tools and their interfaces
  • Execution environments and persistent state
  • Lifecycle controls and safety mechanisms

The paper formalizes this relationship as:

 Agent = Model + Harness .(1)\text { Agent } = \text { Model } + \text { Harness }.\tag{1}

The Gap in Existing Evaluation

Most existing agent benchmarks evaluate task completion through final answers, test results, or environment states. These measures capture the combined effects of model and harness but provide limited insight into whether specific harness mechanisms function reliably. Key observations:

  • Task success may conceal lost context, misleading tool results, or lifecycle violations
  • Task failure can occur despite faithful harness execution
  • Outcome-level comparisons alone cannot identify which harness behaviors account for observed differences

Theoretical Foundation

The paper establishes a clear system boundary: the harness includes orchestration and control functions (prompts, workflows, action strategies, runtime processes), while external tool implementations, task environments, output artifacts, evaluators, and measurement apparatus remain outside that boundary.

Evidence boundaries are critical: an external result, a model-facing tool return, a native session record, and a normalized event are related observations but need not contain the same information. The paper distinguishes four levels of claim:

  1. Criterion verdict — satisfaction under selected evidence
  2. Confirmed Harness defect — requires reconciliation with authoritative sources
  3. Activated candidate link — failed endpoints with matching predeclared condition
  4. Validated propagation — requires observable intermediate distortion and supported event order

Methodology

Benchmark Architecture

The system under test (SUT) is the native harness. The model, task, environment, and resource budgets are controlled inputs. The evaluator and capture machinery are measurement apparatus.

For harness hh, model mm, task tt, and execution instance rr, one run is defined as:

Rh,m,t,r=(τ,ΔW,G,VH,VA,Lact),(2)R _ {h, m, t, r} = (\tau , \Delta W, G, V _ {H}, V _ {A}, L _ {\mathrm{act}}),\tag{2}

where τ\tau is the normalized event sequence, ΔW\Delta W is the workspace change, GG is the apparatus-admission state, VHV_H and VAV_A are criterion verdicts for Harness and Agent layers, and LactL_{\mathrm{act}} is the set of activated candidate mechanism links.

Harness Reliability Taxonomy

The seven dimensions and task coverage:

DimensionEvaluation focusTasks
Context (C)Information preservation and disclosure across boundaries15
Execution (E)Faithful process semantics, state, and result delivery27
Governance (G)Approvals, guardrails, secret redaction, and trust boundaries9
Lifecycle (L)Correct state transitions, recovery, and idempotent retries19
Observability (O)Model-visible diagnostics, replayable logs, and provenance7
Tools (T)Valid tool interfaces, faithful transport, and discovery17
Verification (V)Consistency of completion claims with authoritative outcomes1
Total95

Trajectory Tracing (TT) and Evidence Acquisition (MEA)

TT Module: Harness-specific adapters collect native execution traces and normalize them into a shared Trace Intermediate Representation (Trace IR) with a canonical event schema (lifecycle, model surface, action/observation, stateful control, accounting/archive event families). Call–result correlation uses native call identifiers; ambiguous observations remain explicitly unlinked rather than heuristically paired.

MEA Module: Combines trace records with workspace artifacts and authoritative environment state to assemble criterion-specific evidence packets. Evidence sources include:

  • Simulator ledger and final state (runner-owned private service)
  • Workspace baseline and changed artifacts
  • Native normalized trajectory
  • Provider-request evidence (structured tool declarations)
  • Execution/security probes (post-tool observers)
  • Agent claims (final messages and artifacts)

Two-Layer Evaluation

The scoring formula for layer X∈{H,A}X \in \{H, A\} with nXn_X finalized items and pXp_X passed items:

S=50pHnH+50pAnA.(3)S = 5 0 \frac {p _ {H}}{n _ {H}} + 5 0 \frac {p _ {A}}{n _ {A}}.\tag{3}

Judge states include: 0 (Unsupported/fail), 1 (Supported/pass), 2 (Not exercised—resolved from Agent outcome), and 3 (Malfunction—finalized as Harness fail).

Failure Attribution

Candidate mechanism activation is defined as:

ℓ=(hℓ,aℓ,μℓ),(5)\ell = (h _ {\ell}, a _ {\ell}, \mu_ {\ell}),\tag{5}

where hℓh_\ell and aℓa_\ell are criterion endpoints and μℓ\mu_\ell describes the intervening distortion mechanism. Activation:

Lact(R)={ℓ∈Ctrun∣hℓ∈FH,aℓ∈ZA,qℓ(R)=1}.(6)L _ {\mathrm{act}} (R) = \{\ell \in \mathcal {C} _ {t} ^ {\mathrm{run}} \mid h _ {\ell} \in F _ {H}, a _ {\ell} \in Z _ {A}, q _ {\ell} (R) = 1 \}.\tag{6}

The Harness-side failure set is:

FH=fail(VH),ZH=FH∖B,ZA=fail(VA).(4)F _ {H} = \mathsf {f a i l} (V _ {H}), \qquad Z _ {H} = F _ {H} \setminus B, \qquad Z _ {A} = \mathsf {f a i l} (V _ {A}).\tag{4}

where BB is the set of Harness criteria affected by observation bypass (e.g., a wrapper command replacing exit status).

Aggregate Metrics

Agent-level task success rate:

MA=1∣RA∣∑R∈RAI[ZA(R)=∅],(8)M _ {A} = \frac {1}{| \mathcal {R} _ {A} |} \sum_ {R \in \mathcal {R} _ {A}} \mathbb {I} [ Z _ {A} (R) = \emptyset ],\tag{8}

Harness-level micro- and macro-averaged criterion pass rates:

MH micro =∑R∈RHpH(R)∑R∈RHnH(R),MH macro =1∣RH∣∑R∈RHpH(R)nH(R).(9)M _ {H} ^ {\text { micro }} = \frac {\sum_ {R \in \mathcal {R} _ {H}} p _ {H} (R)}{\sum_ {R \in \mathcal {R} _ {H}} n _ {H} (R)}, \qquad M _ {H} ^ {\text { macro }} = \frac {1}{| \mathcal {R} _ {H} |} \sum_ {R \in \mathcal {R} _ {H}} \frac {p _ {H} (R)}{n _ {H} (R)}.\tag{9}

Empirical Validation / Results

Experimental Setup

  • 4 harnesses: Claude Code, Codex, DeepSeek Harness, OpenClaw
  • 9 models: DeepSeek-V4-Pro, Gemini 3.7 Flash, GLM-5.3, GPT-5.6-Sol, Grok-4.6, HY3, Kimi K3, Opus 5, Qwen3.8-Max
  • Full factorial matrix: 4×9×95×1=3,4204 \times 9 \times 95 \times 1 = 3{,}420 cells
  • Judge: deepseek-v4-flash (fixed identity across all evaluations)

Aggregate Results

Table 6: Aggregate results (%)

HarnessAgent PassAgent ScoreHarness MicroHarness MacroCleanOverall
Claude Code44.075.971.571.29.173.5
Codex35.870.760.259.82.865.2
DeepSeek Harness40.073.369.568.89.871.0
OpenClaw38.271.771.972.011.771.8
All harnesses39.572.968.367.98.470.4

Key findings:

  • Claude Code has the highest Agent task success (44.0%) and combined score (73.5%)
  • OpenClaw has the highest Harness macro rate (72.0%) and jointly clean rate (11.7%)
  • The harness with the highest task success is NOT the one with the highest harness reliability
  • Harness macro range: 12.2 points (Codex 59.8% to OpenClaw 72.0%)
  • Only 8.4% of runs pass every criterion in both layers

Reliability by Taxonomy Dimension

Table 9: Reliability by taxonomy dimension

DimensionTasksClaude CodeCodexDeepSeekOpenClawPooled H MicroAgent Pass
Context1574.562.064.361.665.645.2
Execution2764.751.565.377.164.649.2
Governance972.374.268.880.574.027.2
Lifecycle1971.353.071.765.965.543.6
Observability788.776.586.885.084.343.3
Tools1771.565.671.570.269.721.4
Verification193.795.282.588.990.18.3

Execution has the lowest pooled Harness micro rate (64.6%) with the largest cross-harness spread (Codex 51.5% vs. OpenClaw 77.1%). The layer gap changes direction across dimensions—Execution has Agent score 78.0% vs. Harness 64.7%, while Tools reverses this (53.2% Agent vs. 66.8% Harness).

Failure States and Candidate Attribution

Table 10: Failure states and candidate-link activation

GroupRunsCleanH-onlyA-onlyBothLinkedLink/Both (%)
All Harnesses34202861065369170084249.5
Claude Code855782989738219450.8
Codex855242825849124048.9
DeepSeek Harness855842587144218642.1
OpenClaw85510022714338522257.7

Critical finding: 31.1% of all runs (1,065 of 3,420) achieve Agent success despite at least one failed Harness criterion (the "H-only" state). This demonstrates that outcome-only evaluation cannot characterize harness reliability.

Model–Harness Interactions

  • Within-model Harness macro ranges span 10.0–16.2 percentage points
  • Grok-4.6 Agent success ranges from 33.7% (OpenClaw) to 55.8% (Claude Code)—a 22.1-point difference
  • Opus 5 ranges from 30.5% (Codex) to 53.7% (Claude Code)—a 23.2-point difference
  • Codex has the lowest Harness macro rate in every model group

Resource Usage

Mean estimated Agent costs per run: 0.436(ClaudeCode),0.436 (Claude Code), 0.595 (Codex), 0.446(DeepSeekHarness),0.446 (DeepSeek Harness), 0.633 (OpenClaw). Mean total tokens: 578.8k, 617.2k, 372.7k, 680.0k respectively.

Theoretical and Practical Implications

Theoretical Implications

  1. Agent performance is a system property: The results empirically validate the Agent=Model+Harness\text{Agent} = \text{Model} + \text{Harness} abstraction—the same model exhibits substantially different task success rates across harnesses (up to 23.2-point differences).

  2. Outcome quality and harness reliability are orthogonal: Task success and harness-criterion satisfaction yield different harness rankings, and 31.1% of runs achieve task success despite harness failures. This challenges the assumption that task outcomes proxy for system reliability.

  3. Failure attribution requires mechanism-level evidence: Co-occurrence of Harness and Agent failures does not imply propagation—fewer than half of jointly failing runs contain a stored candidate link, and 85.7% of Agent-failure runs retain at least one failed criterion not reached by any link.

Practical Implications

  1. Harness selection should be task-aware: Different harnesses excel in different dimensions (e.g., OpenClaw leads in Execution, Governance; Claude Code leads in Context, Observability). Harness choice should reflect the reliability requirements of target tasks.

  2. Diagnostic value of two-layer evaluation: The benchmark reveals mechanism-level shortfalls even when Agent task-success rates are high (e.g., cross-turn fact retention has 48.4% Harness satisfaction but 95.8% Agent success), enabling targeted improvement.

  3. Trace-guided improvement loops: The benchmark supports identifying mechanism failures, revising harness behavior, and evaluating changes on held-out tasks—a foundation for harness evolution and recursive self-improvement.

Conclusion

TraceTrial-Bench provides an auditable and reproducible foundation for comparing agent harnesses, diagnosing their failures, and studying how harness design interacts with model behavior. Key takeaways:

  • 95 mechanism-oriented tasks across seven reliability components with executable or state-based ground truth
  • Two-layer evaluation separately assesses Agent performance and Harness reliability using trajectory tracing and multi-source evidence
  • Failure attribution through explicit mechanism chains distinguishes candidate links from validated propagation
  • Empirical results show harness macro scores from 59.8% to 72.0%, with only 8.4% of runs clean across both layers, and 31.1% of runs achieving task success despite harness failures

Future directions include harness evolution through trace-guided improvement loops, evaluation for recursive self-improvement (combining task outcomes, harness behavior, and evidence quality for actionable feedback), and extending evaluation to held-out tasks and unfamiliar harnesses to assess transfer of improvements.

Related papers