Struct ResearchSession 

pub struct ResearchSession {

    pub prompt: String,
    pub provider: String,
    pub model: String,
    pub transform: String,
    pub runs: u32,
    pub total_tokens: usize,
    pub total_transformed: usize,
    pub vocabulary_diversity: f64,
    pub mean_token_length: f64,
    pub mean_perplexity: Option<f64>,
    pub mean_confidence: Option<f64>,
    pub top_perplexity_tokens: Vec<String>,
    pub estimated_cost_usd: f64,
    pub citation: String,
}

Aggregated statistics from one or more headless inference runs.

Produced by run_research_headless. Fields summarise token-level metrics across all runs; fields that require logprob data are Option because not all providers expose logprobs (Anthropic does not).

Fields

prompt: String

The prompt submitted to the provider for all runs in this session.

provider: String

Provider identifier ("openai", "anthropic", or "mock").

model: String

Model identifier used for all runs (e.g. "gpt-4").

transform: String

Transform applied to intercepted tokens (e.g. "reverse").

runs: u32

Number of inference runs executed.

total_tokens: usize

Total tokens streamed across all runs.

total_transformed: usize

Total tokens that had a transform applied across all runs.

vocabulary_diversity: f64

Unique-token fraction: unique_tokens / total_tokens.

mean_token_length: f64

Mean character length of all original (pre-transform) tokens.

mean_perplexity: Option<f64>

Mean per-token perplexity across all runs, or None when unavailable.

mean_confidence: Option<f64>

Mean per-token model confidence across all runs, or None when unavailable.

top_perplexity_tokens: Vec<String>

The 10 tokens with the highest perplexity values (most uncertain positions).

estimated_cost_usd: f64

Rough cost estimate in USD based on token count and GPT-3.5 pricing.

citation: String

Human-readable citation string recording key run parameters for reproducibility.

Trait Implementations

impl Clone for ResearchSession

fn clone(&self) -> ResearchSession

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResearchSession

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

Formats the value using the given formatter.

impl Serialize for ResearchSession

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

where __S: Serializer,

Serialize this value into the given Serde serializer.