Struct ExtensionAttempt 

pub struct ExtensionAttempt { /* private fields */ }

Per-turn trace state for one extension provider IPC invocation: the optional tracer, this turn’s monotonic clock, and the shared first-event cell. Every method is a no-op when tracing is disabled; nothing here can fail the request. Exactly one finish_* record is emitted — the tracer is taken on finish, so later calls can never double-emit.

Implementations

impl ExtensionAttempt

pub fn new(tracer: Option<RequestTracer>) -> Self

Start the turn clock. Call immediately before the IPC send.

pub fn first_event_mark(&self) -> FirstEventMark

Handle for the forwarder task to mark the first model event.

pub fn finish_success( &mut self, stop_reason: Option<StopReason>, usage: Option<UsageMeta>, )

Final record: turn completed. Stop reason/usage stay None when the extension reported nothing — never fabricated.

pub fn finish_canceled(&mut self)

Final record: canceled while the IPC turn was active.

pub fn finish_failed(&mut self, code: &str)

Final record: the extension turn failed. code must be a static literal (EXTENSION_PROVIDER_ERROR_CODE) — never extension text.