58 lines
2.4 KiB
Rust
58 lines
2.4 KiB
Rust
//! Trace bundle format, writer, and reducer for Codex rollouts.
|
|
//!
|
|
//! This crate owns the trace schema. Hot-path Codex code should depend on the
|
|
//! small writer API here; semantic replay and viewer projections stay outside
|
|
//! `codex-core`.
|
|
//!
|
|
//! See `README.md` for the system diagram and reducer model.
|
|
|
|
mod bundle;
|
|
mod compaction;
|
|
mod inference;
|
|
mod model;
|
|
mod payload;
|
|
mod raw_event;
|
|
mod recorder;
|
|
mod reducer;
|
|
mod writer;
|
|
|
|
/// Conventional reduced-state cache name written next to a raw trace bundle.
|
|
pub use bundle::REDUCED_STATE_FILE_NAME;
|
|
/// Raw checkpoint payload for a remote compaction install event.
|
|
pub use compaction::CompactionCheckpointTracePayload;
|
|
/// No-op-capable handle for recording remote-compaction requests.
|
|
pub use compaction::CompactionTraceAttempt;
|
|
/// Shared recorder context for a compaction checkpoint.
|
|
pub use compaction::CompactionTraceContext;
|
|
/// No-op-capable handle for recording one upstream inference attempt.
|
|
pub use inference::InferenceTraceAttempt;
|
|
/// Shared recorder context for inference attempts within one Codex turn.
|
|
pub use inference::InferenceTraceContext;
|
|
/// Public reduced trace model returned by replay.
|
|
pub use model::*;
|
|
/// Stable identifier for one raw payload inside a rollout bundle.
|
|
pub use payload::RawPayloadId;
|
|
/// Coarse role labels for raw payload files.
|
|
pub use payload::RawPayloadKind;
|
|
/// Reference to a raw request/response/log payload stored in the bundle.
|
|
pub use payload::RawPayloadRef;
|
|
/// Monotonic sequence number assigned by the raw trace writer.
|
|
pub use raw_event::RawEventSeq;
|
|
/// Runtime requester observed before semantic reduction.
|
|
pub use raw_event::RawToolCallRequester;
|
|
/// One append-only raw trace event from `trace.jsonl`.
|
|
pub use raw_event::RawTraceEvent;
|
|
/// Event-envelope context supplied by hot-path trace producers.
|
|
pub use raw_event::RawTraceEventContext;
|
|
/// Typed payload for one raw trace event.
|
|
pub use raw_event::RawTraceEventPayload;
|
|
/// Environment variable that enables local trace-bundle recording.
|
|
pub use recorder::CODEX_ROLLOUT_TRACE_ROOT_ENV;
|
|
/// Best-effort hot-path recorder for one rollout trace bundle.
|
|
pub use recorder::RolloutTraceRecorder;
|
|
/// Raw metadata captured when a thread starts.
|
|
pub use recorder::ThreadStartedTraceMetadata;
|
|
/// Replay a raw trace bundle and write/read its reduced `RolloutTrace`.
|
|
pub use reducer::replay_bundle;
|
|
/// Append-only writer used by hot-path Codex instrumentation.
|
|
pub use writer::TraceWriter;
|