Struct RecallPolicy 

pub struct RecallPolicy {
    pub enabled: bool,
    pub max_k_total: usize,
    pub max_tokens_injection: usize,
    pub min_score_threshold: f64,
    pub budgets: RecallBudgets,
    pub allowed_uses: Vec<RecallUse>,
    pub prior_weight: f64,
}

Policy controlling recall behavior.

This is the declarative configuration for recall operations. It controls what is allowed, not how it is implemented.

Fields

enabled: bool

Whether recall is enabled

max_k_total: usize

Maximum number of candidates to return total

max_tokens_injection: usize

Maximum tokens to inject from recall context

min_score_threshold: f64

Minimum similarity score threshold

budgets: RecallBudgets

Budget constraints

allowed_uses: Vec<RecallUse>

Allowed recall uses (runtime, training, etc.)

Defaults to [RuntimeAugmentation] only - training use must be explicitly enabled. This preserves “Recall ≠ Training” boundary.

prior_weight: f64

How strongly recall results weight planning priors when consumed by PlanningPriorAgent. 1.0 means full weight; 0.0 disables prior adjustment without disabling recall itself. Capped to [0.0, 1.0] by consumers.

Implementations

impl RecallPolicy

pub fn enabled() -> RecallPolicy

Create an enabled recall policy with default settings.

pub fn disabled() -> RecallPolicy

Create a disabled recall policy.

pub fn is_use_allowed(&self, purpose: RecallUse) -> bool

Check if a specific recall use is allowed by this policy.

Returns true if the policy allows the given use, false otherwise. This is the primary enforcement point for “Recall ≠ Training” boundary.

pub fn snapshot_hash(&self) -> String

Compute a deterministic hash of this policy for provenance tracking.

This enables replay verification: same policy hash → same behavior. Note: Includes allowed_uses in the hash for full provenance.

Trait Implementations

impl Clone for RecallPolicy

fn clone(&self) -> RecallPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecallPolicy

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

Formats the value using the given formatter.

impl Default for RecallPolicy

fn default() -> RecallPolicy

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RecallPolicy

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RecallPolicy

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.