Class Trajectory

src/agent/models.py:47–65

Full execution trace across all agent turns.

@dataclass
class Trajectory:
    """Full execution trace across all agent turns."""

    turns: list[TurnRecord] = field(default_factory=list)
    started_at: str | None = None
    """ISO-8601 UTC timestamp of when ``run()`` began, for replay
    alignment with the corresponding trace.  Populated by the runner."""

    @property
    def total_input_tokens(self) -> int:
        return sum(t.input_tokens for t in self.turns)

    @property
    def total_output_tokens(self) -> int:
        return sum(t.output_tokens for t in self.turns)

    @property
    def all_tool_calls(self) -> list[ToolCall]:
        return [tc for turn in self.turns for tc in turn.tool_calls]


@dataclass