Struct ConfigSnapshot 

pub struct ConfigSnapshot {
    pub temperature: f64,
    pub top_p: f64,
    pub top_k: f64,
    pub frequency_penalty: f64,
    pub presence_penalty: f64,
    pub retrieval_top_k: f64,
    pub similarity_threshold: f64,
    pub temporal_decay: f64,
}

Snapshot of all tunable parameters for a single experiment arm.

ConfigSnapshot is the bridge between Zeph’s runtime Config and the variation engine. Each experiment arm is defined by a snapshot derived from the baseline config with exactly one parameter changed via Self::apply.

The snapshot is also used to extract GenerationOverrides that are passed to the subject provider for a candidate evaluation.

Examples

use zeph_experiments::{ConfigSnapshot, ParameterKind, Variation, VariationValue};

let baseline = ConfigSnapshot::default();
let variation = Variation {
    parameter: ParameterKind::Temperature,
    value: VariationValue::from(0.9_f64),
};
let candidate = baseline.apply(&variation);
assert!((candidate.temperature - 0.9).abs() < f64::EPSILON);
assert!((candidate.top_p - baseline.top_p).abs() < f64::EPSILON); // unchanged

// Round-trip through diff
let recovered = baseline.diff(&candidate).unwrap();
assert_eq!(recovered.parameter, ParameterKind::Temperature);

Fields

temperature: f64

LLM sampling temperature.

top_p: f64

Top-p (nucleus) sampling probability.

top_k: f64

Top-k sampling cutoff (stored as f64 to match the search space representation).

frequency_penalty: f64

Frequency penalty applied to already-seen tokens.

presence_penalty: f64

Presence penalty applied to already-seen topics.

retrieval_top_k: f64

Number of memory chunks to retrieve per query.

similarity_threshold: f64

Minimum cosine similarity for cross-session memory recall.

temporal_decay: f64

Half-life in days for temporal memory decay.

Implementations

impl ConfigSnapshot

pub fn from_config(config: &Config) -> Self

Create a snapshot from the current runtime config.

LLM generation parameters come from config.llm.candle.generation when a Candle provider is configured. All other providers do not expose generation params in config — defaults are used for the experiment baseline. Memory parameters are read from config.memory.semantic.

pub fn apply(&self, variation: &Variation) -> Self

Apply a single variation and return a new snapshot with that parameter changed.

pub fn diff(&self, other: &ConfigSnapshot) -> Option<Variation>

Return the single Variation that differs between self and other, or None if zero or more than one parameter differs.

Integer parameters (TopK, RetrievalTopK) produce a VariationValue::Int variant.

pub fn get(&self, kind: ParameterKind) -> f64

Get the current value of a parameter by kind.

Unknown kinds (from #[non_exhaustive] additions) return 0.0.

Examples

use zeph_experiments::{ConfigSnapshot, ParameterKind};

let s = ConfigSnapshot::default();
assert!((s.get(ParameterKind::Temperature) - 0.7).abs() < f64::EPSILON);
assert!((s.get(ParameterKind::TopK) - 40.0).abs() < f64::EPSILON);

pub fn set(&mut self, kind: ParameterKind, value: f64)

Set the value of a parameter by kind.

Unknown kinds (from #[non_exhaustive] additions) are silently ignored.

Examples

use zeph_experiments::{ConfigSnapshot, ParameterKind};

let mut s = ConfigSnapshot::default();
s.set(ParameterKind::Temperature, 1.2);
assert!((s.temperature - 1.2).abs() < f64::EPSILON);

pub fn to_generation_overrides(&self) -> GenerationOverrides

Extract LLM-relevant parameter overrides for use by the experiment engine.

Uses .round() as usize for top_k to avoid truncation from floating-point noise.

Trait Implementations

impl Clone for ConfigSnapshot

fn clone(&self) -> ConfigSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigSnapshot

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

Formats the value using the given formatter.

impl Default for ConfigSnapshot

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ConfigSnapshot

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ConfigSnapshot

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

where __S: Serializer,

Serialize this value into the given Serde serializer.