Struct ToolAuditRecord 

pub struct ToolAuditRecord {
    pub tool_call_id: String,
    pub tool_name: String,
    pub display_name: String,
    pub tier: ToolTier,
    pub requested_input: Value,
    pub effective_input: Value,
    pub turn: usize,
    pub provenance: AuditProvenance,
    pub outcome: ToolAuditOutcome,
    pub recorded_at: OffsetDateTime,
}

Single authoritative audit record for one tool-call lifecycle event.

A tool call may produce multiple records over its lifetime — for example a RequiresConfirmation followed by a Completed after the user approves, or a Completed followed by a PersistenceFailed if the event store rejects the terminal event.

Records are self-describing: consumers do not need to correlate them with hook calls or event-store rows to understand what happened.

Fields

tool_call_id: String

Unique tool call ID (from the LLM’s tool_use).

tool_name: String

Wire-format tool name.

display_name: String

Human-readable display name.

tier: ToolTier

Permission tier of the tool at the moment the record was emitted.

requested_input: Value

Input as requested by the LLM (audit trail).

effective_input: Value

Effective input after SDK preparation (may differ for listen-tools).

turn: usize

Turn number this record belongs to.

provenance: AuditProvenance

Provider / model provenance for this turn’s LLM call.

outcome: ToolAuditOutcome

Lifecycle outcome carrying the variant-specific payload.

recorded_at: OffsetDateTime

UTC timestamp when the record was produced.

Implementations

impl ToolAuditRecord

pub fn new(params: ToolAuditRecordParams) -> ToolAuditRecord

Build a record using the current wall-clock time.

See ToolAuditRecordParams for the field list.

pub const fn outcome_kind(&self) -> &'static str

Return the outcome’s discriminant string.

Trait Implementations

impl Clone for ToolAuditRecord

fn clone(&self) -> ToolAuditRecord

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ToolAuditRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolAuditRecord

fn deserialize<__D>( __deserializer: __D, ) -> Result<ToolAuditRecord, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ToolAuditRecord

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.