vtcode-exec-events

Structured execution telemetry event schema used across VT Code crates.

This crate exposes the serialized schema for thread lifecycle updates, command execution results, and other timeline artifacts emitted by the agent runtime. Downstream applications can deserialize these structures to drive dashboards, logging, or auditing pipelines without depending on the full vtcode-core crate.

Structured execution telemetry events shared across VT Code crates.

This crate exposes the serialized schema for thread lifecycle updates, command execution results, and other timeline artifacts emitted by the automation runtime. Downstream applications can deserialize these structures to drive dashboards, logging, or auditing pipelines without depending on the full vtcode-core crate.

Agent Trace Support

This crate implements the Agent Trace specification for tracking AI-generated code attribution. See the trace module for details.

Modules

Public entrypoints

• VersionedThreadEvent — schema-versioned event wrapper
• ThreadEvent — concrete event enum (started, completed, item updates, turn lifecycle, plan approval lifecycle, …)
• EVENT_SCHEMA_VERSION — current schema version ("0.17.0"; adds optional task/turn context, input origin, recorded terminal timestamps, command activity, public decisions, and native delegation status while preserving legacy decoding)
• EventEmitter trait — sink for processing events

Usage

use vtcode_exec_events::{ThreadEvent, VersionedThreadEvent, EVENT_SCHEMA_VERSION};

let event = ThreadEvent::ThreadStarted(/* … */);
let versioned = VersionedThreadEvent::new(event);
assert_eq!(versioned.schema_version, EVENT_SCHEMA_VERSION);

let json = serde_json::to_string(&versioned)?;

Feature flags

API reference

See docs.rs/vtcode-exec-events.