Struct CompiledProgram 

pub struct CompiledProgram {
    pub instruction: String,
    pub demo_indices: SmallVec<[u32; 8]>,
    pub score: f64,
    pub optimizer: String,
    pub metadata: BTreeMap<String, String>,
}

A compiled program from optimization, serializable to disk.

This captures the artifacts produced by an optimizer run:

• The tuned instruction/system prompt
• Indices into a demo pool for few-shot examples
• The score achieved during optimization
• Which optimizer produced the result
• Arbitrary string metadata

Serialization

CompiledProgram supports JSON serialization via save / load, and a compact format via save_compact.

Fields

instruction: String

The optimized instruction/prompt.

demo_indices: SmallVec<[u32; 8]>

Indices of selected demonstration examples.

score: f64

Final optimization score achieved.

optimizer: String

Name of the optimizer that produced this.

metadata: BTreeMap<String, String>

Optional metadata (e.g., hyperparameters, dataset info).

Implementations

impl CompiledProgram

pub fn new( instruction: String, demo_indices: SmallVec<[u32; 8]>, score: f64, optimizer: String, ) -> Self

Create a new compiled program.

Arguments

• instruction - The optimized instruction/system prompt
• demo_indices - Indices into the training set for selected demos
• score - Final optimization score (typically 0.0..=1.0)
• optimizer - Name of the optimizer that produced this result

pub fn with_meta(self, key: impl Into<String>, value: impl Into<String>) -> Self

Add a metadata entry, returning self for chaining.

pub fn save(&self, path: &str) -> Result<()>

Save to a pretty-printed JSON file.

Errors

Returns an error if the file cannot be created or serialization fails.

pub fn load(path: &str) -> Result<Self>

Load from a JSON file.

Errors

Returns an error if the file cannot be read or deserialization fails.

pub fn save_compact(&self, path: &str) -> Result<()>

Save to a compact (non-pretty) JSON file.

This produces a smaller file than save by omitting whitespace formatting. Uses serde_json for broad compatibility; a binary format (e.g., bincode) could be swapped in without changing the public API.

Errors

Returns an error if the file cannot be created or serialization fails.

pub fn from_json(json: &str) -> Result<Self>

Deserialize from a JSON string (useful for embedding in configs).

pub fn to_json(&self) -> Result<String>

Serialize to a JSON string.

pub fn to_json_compact(&self) -> Result<String>

Serialize to a compact JSON string (no whitespace).

Trait Implementations

impl Clone for CompiledProgram

fn clone(&self) -> CompiledProgram

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompiledProgram

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CompiledProgram

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CompiledProgram

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

where __S: Serializer,

Serialize this value into the given Serde serializer.