Function build_turn_envelope

atomic-agent/src/record/provenance.rs:203–244

Build a `SessionEnvelope` for embedding in `HashedChange.metadata`.

(
    options: &TurnRecordOptions<'_>,
    recorded_files: &[String],
)

/// Build a `SessionEnvelope` for embedding in `HashedChange.metadata`.
pub(crate) fn build_turn_envelope(
    options: &TurnRecordOptions<'_>,
    recorded_files: &[String],
) -> SessionEnvelope {
    let prompt_summary = options
        .prompt
        .as_deref()
        .filter(|p| is_meaningful_prompt(p))
        .map(|p| truncate_prompt(p, 200));

    let prompt_hash = options
        .prompt
        .as_deref()
        .filter(|p| is_meaningful_prompt(p))
        .map(|p| *blake3::hash(p.as_bytes()).as_bytes());

    let files_in_turn: Vec<String> = recorded_files.to_vec();

    let session_started_at = options.session.started_at.timestamp();
    let turn_ended_at = options.event.timestamp.timestamp();
    let turn_started_at = turn_ended_at - (options.turn_duration_ms as i64 / 1000);

    let mut builder =
        SessionEnvelope::builder(&options.session.session_id, &options.session.agent_name)
            .agent_display_name(&options.session.agent_display_name)
            .turn_number(options.turn_number)
            .session_started_at(session_started_at)
            .turn_started_at(turn_started_at)
            .turn_ended_at(turn_ended_at)
            .turn_duration_ms(options.turn_duration_ms)
            .files_in_turn(files_in_turn)
            .files_in_session(options.session.files_touched_count());

    if let Some(summary) = prompt_summary {
        builder = builder.prompt_summary(summary);
    }
    if let Some(hash) = prompt_hash {
        builder = builder.prompt_hash(hash);
    }

    builder.build()
}

// Step 6 Helper: Build Unhashed Turn Data