dspy_rs::optimizer

Generated from rustdoc JSON at dspy-rs v0.7.3 (commit f7d67a6). Do not edit by hand; regenerate with python3 docs/scripts/gen_api.py (see the script header for the rustdoc commands). Item links lead to full signatures and method docs on docs.rs.

Automatic prompt optimization.

Re-exports

Item	Description
`bootstrap::*`	Glob re-export.
`copro::*`	Glob re-export.
`engine::*`	Glob re-export.
`gepa::*`	Glob re-export.
`LeafInfo`	Re-export of `target::LeafInfo`.
`mipro::*`	Glob re-export.
`OptimizeTarget`	Re-export of `target::OptimizeTarget`.
`ProgramMetric`	Re-export of `target::ProgramMetric`.
`simba::*`	Glob re-export.
`structural::*`	Glob re-export.

Modules

Item	Description
`bootstrap`	BootstrapFewShot: the minimal end-to-end exercise of the optimizer contract (vision §5.
`copro`
`engine`	The shared evaluation engine (vision §5.4): every optimizer is a thin strategy over this core.
`gepa`
`mipro`
`simba`	SIMBA: Stochastic Introspective Mini-Batch Ascent (vision §4.3) — the cheap agentic default.
`structural`	Structural: LM-guided hill-climbing over the graph-edit calculus (RFC 0004 §6) — the sixth strategy over the shared `Engine`.
`target`	What an optimizer optimizes: `OptimizeTarget`, the lane-erased pair of (thing under optimization, evaluation harness).

Structs

Item	Description
`OptimizerCommon`	The engine/RNG knobs shared by every optimizer builder: evaluation concurrency, budget caps, cache salt, and the sampling seed.

Enums

Item	Description
`Report`	What an optimization run produced. Strategy-specific payloads for the optimizers that report more than “done”.

Traits

Item	Description
`Optimizer`	A tuning strategy over the shared `Engine`.

`optimizer::bootstrap`

BootstrapFewShot: the minimal end-to-end exercise of the optimizer contract (vision §5.

Structs

Item	Description
`BootstrapFewShot`	Few-shot demo bootstrapper — the simplest complete optimizer.
`BootstrapFewShotBuilder`	Use builder syntax to set the inputs and finish with `build()`).
`BootstrapReport`	What a `BootstrapFewShot` run did.

`optimizer::copro`

Structs

Item	Description
`COPRO`	Breadth-first instruction optimizer.
`COPROBuilder`	Use builder syntax to set the inputs and finish with `build()`).

`optimizer::engine`

The shared evaluation engine (vision §5.4): every optimizer is a thin strategy over this core.

Structs

Item	Description
`Budget`	Hard caps on evaluation spend. `None` = unlimited.
`Candidate`	A candidate is data: name-keyed per-leaf overlays plus a stable content hash (`Candidate::stable_hash`).
`CandidateEval`	A candidate’s results over one evaluation batch, in request order.
`CandidateSlot`	One leaf’s slice of a `Candidate`: which optimizable values to inject.
`Engine`	The shared evaluation core (vision §5.4).
`EngineConfig`	Engine tuning knobs.
`ParetoStatistics`	Snapshot of the Pareto frontier at a point in the search.
`ParetoView`	Dominance snapshot computed from a `ScoreMatrix`: which candidates win (or tie, within tolerance) on at least one example.
`RolloutCache`	In-memory rollout cache: `(baseline, candidate, example, salt)` → `Eval`.
`RolloutOutcome`	One evaluated (or cache-served) rollout.
`ScoreMatrix`	Per-instance score matrix: candidates × examples.
`Spend`	What the engine has consumed so far. Reported to strategies.

Enums

Item	Description
`BatchEvalOutcome`	Result of `Engine::evaluate_many`.
`EvalOutcome`	Result of `Engine::evaluate`.
`GateOutcome`	Result of `Engine::evaluate_gated`.

`optimizer::gepa`

Structs

Item	Description
`GEPA`	Genetic-Pareto instruction optimizer with feedback-driven evolution.
`GEPABuilder`	Use builder syntax to set the inputs and finish with `build()`).
`GEPACandidate`	A single instruction candidate tracked through GEPA’s evolutionary search.
`GEPAResult`	Full report from a `GEPA` optimization run.
`ReflectOnInstructionOutput`

`optimizer::mipro`

Structs

Item	Description
`MIPROv2`	Trace-guided instruction and demo optimizer.
`MIPROv2Builder`	Use builder syntax to set the inputs and finish with `build()`).
`PromptingTips`	Library of general prompting best practices used to seed candidate generation.

`optimizer::simba`

SIMBA: Stochastic Introspective Mini-Batch Ascent (vision §4.3) — the cheap agentic default.

Structs

Item	Description
`IntrospectRolloutsOutput`
`SIMBA`	Minibatch introspective ascent — the cheap agentic default (vision §4.3).
`SIMBABuilder`	Use builder syntax to set the inputs and finish with `build()`).
`SimbaReport`	What a `SIMBA` run did.
`SimbaStep`	What one SIMBA step did.

Enums

Item	Description
`SimbaMove`	Which of SIMBA’s two moves a step proposed.

`optimizer::structural`

Structural: LM-guided hill-climbing over the graph-edit calculus (RFC 0004 §6) — the sixth strategy over the shared Engine.

Structs

Item	Description
`ChooseEditOutput`
`Structural`	Structural optimizer over the graph-edit calculus (RFC 0004 §6).
`StructuralBuilder`	Use builder syntax to set the inputs and finish with `build()`).
`StructuralReport`	What a `Structural` run did. The winner is returned, not installed: bake it (`report.program.bake(&report.
`StructuralStep`	What one Structural generation did.

`optimizer::target`

What an optimizer optimizes: OptimizeTarget, the lane-erased pair of (thing under optimization, evaluation harness).

Structs

Item	Description
`LeafInfo`	The read surface strategies build candidates from: one optimizable leaf’s name, current values, and field contract.
`OptimizeTarget`	The thing an `Optimizer` optimizes: a module or a program, packaged with its example set and metric. See the module docs for the two lanes.

Traits

Item	Description
`ProgramMetric`	How a program-lane strategy tells the engine what “good” means: score one interpreter output (`JsonMap` of the program’s output signature fields) against a labeled example.

Overview

dspy-rs

Companion crates

dspy_rs::optimizer

Re-exports

Modules

Structs

Enums

Traits

`optimizer::bootstrap`

Structs

`optimizer::copro`

Structs

`optimizer::engine`

Structs

Enums

`optimizer::gepa`

Structs

`optimizer::mipro`

Structs

`optimizer::simba`

Structs

Enums

`optimizer::structural`

Structs

`optimizer::target`

Structs

Traits

​Re-exports

​Modules

​Structs

​Enums

​Traits

​optimizer::bootstrap

​Structs

​optimizer::copro

​Structs

​optimizer::engine

​Structs

​Enums

​optimizer::gepa

​Structs

​optimizer::mipro

​Structs

​optimizer::simba

​Structs

​Enums

​optimizer::structural

​Structs

​optimizer::target

​Structs

​Traits

Re-exports

Modules

Structs

Enums

Traits

`optimizer::bootstrap`

Structs

`optimizer::copro`

Structs

`optimizer::engine`

Structs

Enums

`optimizer::gepa`

Structs

`optimizer::mipro`

Structs

`optimizer::simba`

Structs

Enums

`optimizer::structural`

Structs

`optimizer::target`

Structs

Traits