Struct Trajectory 

pub struct Trajectory {
    pub id: String,
    pub session_id: String,
    pub model: String,
    pub timestamp: i64,
    pub total_tokens: usize,
    pub tool_calls: usize,
    pub iterations: usize,
    pub success: bool,
    pub steps: Vec<TrajectoryStep>,
    pub messages: Vec<TrajectoryMessage>,
    pub metadata: HashMap<String, String>,
}

A complete trajectory (conversation) ready for training.

Fields

id: String

Unique identifier

session_id: String

Session ID this trajectory came from

model: String

Model used for generation

timestamp: i64

Unix timestamp

total_tokens: usize

Total tokens consumed

tool_calls: usize

Number of tool calls made

iterations: usize

Number of iterations (LLM rounds)

success: bool

Whether the overall task was successful

steps: Vec<TrajectoryStep>

The individual ReAct steps

messages: Vec<TrajectoryMessage>

Raw messages for full fidelity

metadata: HashMap<String, String>

Arbitrary metadata

Implementations

impl Trajectory

pub fn new( id: impl Into<String>, session_id: impl Into<String>, model: impl Into<String>, ) -> Self

pub fn add_step(&mut self, step: TrajectoryStep)

Add a ReAct step to the trajectory.

pub fn record_tool_step( &mut self, thought: Option<String>, action: String, action_args: String, observation: String, success: bool, )

Record a ReAct tool step directly (used by the agent loop).

pub fn record_response(&mut self, response: String)

Record the final text response for the current step (used by loop_runner).

pub fn add_message( &mut self, role: &str, content: &str, tool_call_id: Option<&str>, tool_name: Option<&str>, )

Add a raw message to the trajectory.

pub fn to_json(&self) -> Result<String>

Serialize to pretty JSON.

pub fn save_to_file(&self, path: &Path) -> Result<()>

Save to a JSON file (alias for save). Creates parent directories.

pub fn save(&self, path: &Path) -> Result<()>

Save to a JSON file. Creates parent directories.

Trait Implementations

impl Clone for Trajectory

fn clone(&self) -> Trajectory

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Trajectory

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Trajectory

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Trajectory

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.