tracevault-core 0.8.0

Core library for TraceVault - AI code tracing and attribution
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use sha2::{Digest, Sha256};

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
#[serde(rename_all = "snake_case")]
pub enum StreamEventType {
    ToolUse,
    Transcript,
    SessionStart,
    SessionEnd,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct StreamEventRequest {
    pub protocol_version: u32,
    #[serde(default)]
    pub tool: Option<String>,
    pub event_type: StreamEventType,
    pub session_id: String,
    pub timestamp: DateTime<Utc>,
    pub hook_event_name: Option<String>,
    pub tool_name: Option<String>,
    pub tool_input: Option<serde_json::Value>,
    pub tool_response: Option<serde_json::Value>,
    pub event_index: Option<i32>,
    pub transcript_lines: Option<Vec<serde_json::Value>>,
    pub transcript_offset: Option<i64>,
    pub model: Option<String>,
    pub cwd: Option<String>,
    pub final_stats: Option<SessionFinalStats>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SessionFinalStats {
    pub duration_ms: Option<i64>,
    pub total_tokens: Option<i64>,
    pub input_tokens: Option<i64>,
    pub output_tokens: Option<i64>,
    pub cache_read_tokens: Option<i64>,
    pub cache_write_tokens: Option<i64>,
    pub user_messages: Option<i32>,
    pub assistant_messages: Option<i32>,
    pub total_tool_calls: Option<i32>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct StreamEventResponse {
    pub session_db_id: uuid::Uuid,
    pub event_db_id: Option<uuid::Uuid>,
    pub status: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CommitPushRequest {
    pub commit_sha: String,
    pub branch: Option<String>,
    pub author: String,
    pub message: Option<String>,
    pub diff_data: Option<serde_json::Value>,
    pub committed_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CommitPushResponse {
    pub commit_db_id: uuid::Uuid,
    pub attributions_count: i64,
}

#[derive(Debug, Clone)]
pub struct ExtractedFileChange {
    pub file_path: String,
    pub change_type: String,
    pub diff_text: Option<String>,
    pub content_hash: Option<String>,
}

pub fn is_file_modifying_tool(tool_name: &str) -> bool {
    matches!(tool_name, "Write" | "Edit" | "Bash")
}

pub fn extract_file_change(
    tool_name: &str,
    tool_input: &serde_json::Value,
) -> Option<ExtractedFileChange> {
    match tool_name {
        "Write" => {
            let file_path = tool_input.get("file_path")?.as_str()?.to_string();
            let content = tool_input.get("content")?.as_str()?;
            let mut hasher = Sha256::new();
            hasher.update(content.as_bytes());
            let hash = format!("{:x}", hasher.finalize());
            let diff = content
                .lines()
                .map(|l| format!("+{l}"))
                .collect::<Vec<_>>()
                .join("\n");
            Some(ExtractedFileChange {
                file_path,
                change_type: "create".to_string(),
                diff_text: Some(diff),
                content_hash: Some(hash),
            })
        }
        "Edit" => {
            let file_path = tool_input.get("file_path")?.as_str()?.to_string();
            let old_string = tool_input.get("old_string")?.as_str()?;
            let new_string = tool_input.get("new_string")?.as_str()?;
            let diff = format!("--- {old_string}\n+++ {new_string}");
            Some(ExtractedFileChange {
                file_path,
                change_type: "edit".to_string(),
                diff_text: Some(diff),
                content_hash: None,
            })
        }
        _ => None,
    }
}