mirror of
https://github.com/openai/codex.git
synced 2026-05-23 12:34:25 +00:00
79 lines
3.3 KiB
Rust
79 lines
3.3 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 code_cell;
|
|
mod compaction;
|
|
mod inference;
|
|
mod mcp;
|
|
mod model;
|
|
mod payload;
|
|
mod protocol_event;
|
|
mod raw_event;
|
|
mod reducer;
|
|
mod thread;
|
|
mod tool_dispatch;
|
|
mod writer;
|
|
|
|
/// Conventional reduced-state cache name written next to a raw trace bundle.
|
|
pub use bundle::REDUCED_STATE_FILE_NAME;
|
|
/// No-op-capable handle for recording one code-mode runtime cell.
|
|
pub use code_cell::CodeCellTraceContext;
|
|
/// 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;
|
|
/// Trace-owned MCP execution correlation propagated to bridge request metadata.
|
|
pub use mcp::McpCallTraceContext;
|
|
/// 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;
|
|
/// Replay a raw trace bundle and write/read its reduced `RolloutTrace`.
|
|
pub use reducer::replay_bundle;
|
|
/// Raw payload captured when a child agent reports completion to its parent.
|
|
pub use thread::AgentResultTracePayload;
|
|
/// Environment variable that enables local trace-bundle recording.
|
|
pub use thread::CODEX_ROLLOUT_TRACE_ROOT_ENV;
|
|
/// Raw metadata captured when a thread starts.
|
|
pub use thread::ThreadStartedTraceMetadata;
|
|
/// No-op-capable handle for recording one thread in a rollout bundle.
|
|
pub use thread::ThreadTraceContext;
|
|
/// Request data for the canonical Codex tool boundary.
|
|
pub use tool_dispatch::ToolDispatchInvocation;
|
|
/// Tool input observed at the registry boundary.
|
|
pub use tool_dispatch::ToolDispatchPayload;
|
|
/// Runtime source that caused a dispatch-level tool call.
|
|
pub use tool_dispatch::ToolDispatchRequester;
|
|
/// Result data returned from a dispatch-level tool call.
|
|
pub use tool_dispatch::ToolDispatchResult;
|
|
/// No-op-capable handle for recording one resolved tool dispatch.
|
|
pub use tool_dispatch::ToolDispatchTraceContext;
|
|
/// Append-only writer used by hot-path Codex instrumentation.
|
|
pub use writer::TraceWriter;
|