Struct StructuredValidator 

pub struct StructuredValidator { /* private fields */ }

Structured output validator: schema validation of the model’s answer + independent retry budget + feedback messages.

Used by self-implemented Agents wiring up typed output (TypedAgent): call validate each round inside the loop, and the component owns the budget counting — user code no longer writes the “validate → count → check limit” boilerplate.

Budget semantics: up to max_retries retries after a failed validation; the max_retries + 1-th failure returns Exhausted.

Examples

use molo::agent::{StructuredOutcome, StructuredValidator};

let schema = serde_json::json!({
    "type": "object",
    "properties": { "city": { "type": "string" } },
    "required": ["city"],
});
let mut validator = StructuredValidator::new(schema, 3);

assert!(matches!(validator.validate("bad"), StructuredOutcome::Retry { .. }));
assert!(matches!(
    validator.validate(r#"{"city":"Beijing"}"#),
    StructuredOutcome::Passed
));

Implementations

impl StructuredValidator

pub fn new(schema: Value, max_retries: usize) -> StructuredValidator

Construct with a schema and a retry budget; max_retries has the same semantics as AgentConfig::max_structured_retries (the built-in assembly defaults to 3).

pub fn validate(&mut self, answer: &str) -> StructuredOutcome

Validate one answer: passed → Passed; failed with budget remaining → Retry (carrying a feedback message, recorded so the model corrects itself); failed with budget exhausted → Exhausted.

Trait Implementations

impl Clone for StructuredValidator

fn clone(&self) -> StructuredValidator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StructuredValidator

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

Formats the value using the given formatter.

impl Eq for StructuredValidator

impl PartialEq for StructuredValidator

fn eq(&self, other: &StructuredValidator) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for StructuredValidator