Struct ActivationState 

pub struct ActivationState { /* private fields */ }

Tracks per-entry activation state across conversation turns.

Owned by ContextWeaver and updated after each assembly pass. Serializable alongside persistent state for save/load support.

Implementations

impl ActivationState

pub fn new() -> Self

pub fn advance_turn(&mut self)

Advance to the next turn. Decrements sticky counters.

pub fn current_turn(&self) -> usize

Current turn number.

pub fn record_activation(&mut self, entry_id: &str, sticky_turns: usize)

Record that an entry was freshly activated on the current turn.

Updates the last_activated timestamp (used for cooldown checks) and sets (or resets) the sticky counter.

This should only be called for fresh activations (keyword, regex, constant, triggered) — NOT for sticky carry-forwards. The caller (assemble Phase 4) is responsible for distinguishing the two cases via ActivationReason.

The counter is stored as sticky_turns + 1 because advance_turn() is called before assemble(). Without the +1, the first advance after activation would immediately consume one count before the entry ever gets carried forward, making sticky_turns: N behave as N-1 additional turns.

pub fn is_on_cooldown(&self, entry_id: &str, cooldown: usize) -> bool

Check if an entry is on cooldown.

pub fn is_sticky(&self, entry_id: &str) -> Option<usize>

Check if an entry is still sticky-active. Returns remaining turns.

pub fn sticky_entries(&self) -> impl Iterator<Item = (&str, usize)>

Get all currently-sticky entry IDs with their remaining turns.

Trait Implementations

impl Clone for ActivationState

fn clone(&self) -> ActivationState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActivationState

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

Formats the value using the given formatter.

impl Default for ActivationState

fn default() -> ActivationState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ActivationState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ActivationState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.