Struct InferenceTraceAttempt 

pub struct InferenceTraceAttempt { /* private fields */ }

No-op-capable handle for recording one upstream inference attempt. One concrete upstream request attempt.

A Codex turn can create multiple attempts when auth recovery retries the HTTP request or WebSocket setup falls back to HTTP. Completion is often observed after the client returns the response stream, so the attempt owns the terminal guard that prevents duplicate lifecycle events.

Implementations

impl InferenceTraceAttempt

pub fn disabled() -> Self

Builds an attempt that records nothing.

pub fn add_request_headers(&self, headers: &mut HeaderMap)

Adds rollout-trace propagation headers for this attempt when tracing is enabled.

pub fn record_started(&self, request: &impl Serialize)

Records the request payload replay should treat as the model-visible inference input.

This is usually the exact provider request. Callers may instead pass a logical request when the transport omits already-sent input, such as websocket reuse after an untraced warmup response.

pub fn record_completed( &self, response_id: &str, upstream_request_id: Option<&str>, token_usage: &Option<TokenUsage>, output_items: &[ResponseItem], )

Records successful provider completion and serializes the observed output items.

Callers pass protocol-native response items so this crate owns the trace-specific serialization rules. That keeps codex-core focused on transport behavior while preserving trace evidence that normal request serialization intentionally omits.

pub fn record_failed( &self, error: impl Display, upstream_request_id: Option<&str>, output_items: &[ResponseItem], )

Records pre-response and mid-stream failures.

pub fn record_cancelled( &self, reason: impl Display, upstream_request_id: Option<&str>, output_items: &[ResponseItem], )

Records a provider stream that Codex intentionally stopped consuming.

This happens when the turn is interrupted or when mailbox delivery preempts the current sampling request. Complete output items observed before that point are retained as partial response evidence.

Trait Implementations

impl Debug for InferenceTraceAttempt

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.