Struct ToolEvent 

pub struct ToolEvent {
    pub tool: String,
    pub args_digest: String,
    pub ok: bool,
    pub duration_ms: Option<u64>,
}

One tool invocation recorded during a turn (Step 17.6, issue #246).

Serialized (as an array element) into the store’s turns.events JSON column. The field names tool and args_digest are load-bearing: the FTS5 recall index derives its tool_names / tool_args_digest columns by extracting exactly $.tool and $.args_digest from each element (see store.rs — events_extract_sql, the 17.3 seam) — rename either and tool recall goes dark. Unknown extra fields are ignored on load, so the shape can grow additively without a migration.

Fields

tool: String

Tool name exactly as the model invoked it (read_file, run_command, an MCP server__tool, or a hallucinated name — recorded as called, ok = false tells the story).

args_digest: String

Privacy-preserving argument digest: the argument key names (searchable) plus a truncated BLAKE3 of the canonical args JSON (correlatable). Never raw argument values — args carry file contents and can carry secrets. Built by ToolEvent::from_call.

ok: bool

Whether the tool result read as success. Best-effort: the loop’s tool results are plain strings, so this mirrors the error: / capability denied: / unknown tool prefixes execute_tool emits.

duration_ms: Option<u64>

Wall-clock duration of the tool call in milliseconds. A display claim only (§6): never an ordering key — order within the turn is the events array position.

Implementations

impl ToolEvent

pub fn from_call( tool: impl Into<String>, args: &Value, ok: bool, duration_ms: Option<u64>, ) -> Self

Record one tool call. args are digested, never stored raw: the digest is the object’s key names (space-joined — useful FTS terms that cannot leak values) plus b3: + the first 16 hex chars of BLAKE3 over the canonical JSON, so two turns calling the same tool with identical args correlate without exposing what the args were.

Trait Implementations

impl Clone for ToolEvent

fn clone(&self) -> ToolEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ToolEvent

impl PartialEq for ToolEvent

fn eq(&self, other: &ToolEvent) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ToolEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ToolEvent