TRAJDEBUG: Tracing Error Lifecycle to Identify Critical Failures in Long-Horizon Agent Trajectories is an evidence-grounded framework for locating the earliest decisive error responsible for a failed LLM-agent trajectory. This repository provides the detector, unified data adapters, evaluation tools, and a local viewer.
TRAJDEBUG first builds multi-granularity trajectory views, then performs three auditable stages:
- Error trigger detection: identifies wrong commitments and requires verbatim evidence for both the commitment and violated reference.
- Error state classification: clusters triggers by violated object and classifies resolution and terminal impact.
- Causal attribution: selects the failure-responsible origin from terminal-relevant candidates.
See detector/README.md for implementation details and the paper.
The source code and associated data are undergoing internal review and approval. They will be made publicly available once the approval process is complete. Thank you for your patience and interest.

