Struct SkillUseTrace 

pub struct SkillUseTrace { /* private fields */ }

Shared, cloneable buffer of skill names, deduplicated, in first-use order.

Deduplicated because — unlike a tool trace, where repetition is signal about the approach — a skill re-read three times is still one skill, and Episode::skills is a set-membership question (“was X in play?”).

Implementations

impl SkillUseTrace

pub fn new() -> Self

pub fn note(&self, name: impl Into<String>)

Record that the run is following name. Idempotent.

pub fn snapshot(&self) -> Vec<String>

The skills recorded so far.

pub fn drain(&self) -> Vec<String>

Take the recorded skills and reset the buffer (call after a run).

pub fn hook(&self) -> Arc<dyn Hook>

A Hook that fills this buffer from Event::Custom { name: "skill.activated", data: {"skill": "<name>"} }.

Event::Custom is the framework’s escape hatch for signals it doesn’t model natively, which is exactly what skill activation currently is. Emitting one keeps the host’s skill-injection code from having to hold a SkillUseTrace handle.

Trait Implementations

impl Clone for SkillUseTrace

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for SkillUseTrace

fn default() -> Self

Returns the “default value” for a type.