vtcode-exec-events 0.175.2

Structured execution telemetry event schema used across VT Code crates.
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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

//! Canonical durable contracts for local matrix execution.
use serde::{Deserialize, Serialize};
use std::collections::BTreeMap;

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
pub struct MatrixSpec {
    pub id: String,
    pub tasks: Vec<MatrixTaskSpec>,
    #[serde(default)]
    pub resources: BTreeMap<String, u32>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
pub struct MatrixTaskSpec {
    pub id: String,
    pub instructions: String,
    #[serde(default)]
    pub dependencies: Vec<String>,
    pub workspace: String,
    pub access: WorkspaceAccess,
    pub checks: Vec<String>,
    #[serde(default)]
    pub resources: BTreeMap<String, u32>,
    pub timeout_secs: u64,
    #[serde(default)]
    pub replay_safe: bool,
    #[serde(default)]
    pub inputs: Vec<String>,
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
#[serde(rename_all = "snake_case")]
pub enum WorkspaceAccess {
    Read,
    Write,
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
#[serde(rename_all = "snake_case")]
pub enum MatrixLifecycle {
    Created,
    Running,
    Paused,
    Verifying,
    Succeeded,
    Cancelled,
    Blocked,
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
#[serde(rename_all = "snake_case")]
pub enum MatrixTaskStatus {
    Queued,
    Assigned,
    Executed,
    Verified,
    Failed,
    Interrupted,
    TimedOut,
    CleanupUncertain,
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
#[serde(rename_all = "snake_case")]
pub enum MatrixPhase {
    Execute,
    Verify,
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
#[serde(rename_all = "snake_case")]
pub enum MatrixOutcome {
    Success,
    Failed,
    Interrupted,
    TimedOut,
    Cancelled,
    PermissionDenied,
    BudgetExhausted,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
pub struct MatrixCommandEvidence {
    pub command: String,
    pub attempt_id: String,
    pub worker_id: String,
    pub generation: String,
    pub event_id: String,
    pub exit_code: Option<i32>,
    pub cancelled: bool,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
pub struct MatrixAttempt {
    pub id: String,
    pub worker_id: String,
    pub phase: MatrixPhase,
    pub generation: Option<String>,
    pub launch_requested: bool,
    pub outcome: Option<MatrixOutcome>,
    pub cleanup_confirmed: bool,
    pub evidence: Vec<MatrixCommandEvidence>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
pub struct MatrixTaskState {
    pub id: String,
    pub status: MatrixTaskStatus,
    pub attempts: Vec<MatrixAttempt>,
    pub automatic_retries: u8,
}

/// A complete checkpoint carried in the canonical event log; derived views replay it.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
pub struct MatrixSnapshot {
    pub spec: MatrixSpec,
    pub lifecycle: MatrixLifecycle,
    pub tasks: Vec<MatrixTaskState>,
    pub generation: Option<String>,
    pub revision: u64,
}

/// Runtime-created assignment identity. Workers never choose these identifiers.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema-export", derive(schemars::JsonSchema))]
pub struct MatrixAssignment {
    pub task_id: String,
    pub attempt_id: String,
    pub worker_id: String,
    pub phase: MatrixPhase,
    pub generation: Option<String>,
}