agentic-config 0.2.0

//! JSON Schema generation for `AgenticConfig`.
//!
//! Uses schemars to generate a JSON Schema that can be used for
//! IDE autocomplete and validation.

use crate::types::AgenticConfig;
use schemars::Schema;
use schemars::generate::SchemaSettings;

/// Generate the JSON Schema for `AgenticConfig`.
pub fn schema() -> Schema {
    SchemaSettings::default()
        .into_generator()
        .into_root_schema_for::<AgenticConfig>()
}

/// Generate the JSON Schema as a pretty-printed JSON string.
pub fn schema_json_pretty() -> anyhow::Result<String> {
    Ok(serde_json::to_string_pretty(&schema())?)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_schema_is_valid_json() {
        let json = schema_json_pretty().unwrap();
        let _: serde_json::Value = serde_json::from_str(&json).unwrap();
    }

    #[test]
    fn test_schema_has_required_properties() {
        let schema = schema();
        let json = serde_json::to_value(&schema).unwrap();

        // Check that the schema has definitions for our types
        assert!(json.get("$defs").is_some() || json.get("definitions").is_some());
    }

    #[test]
    fn test_schema_excludes_secrets() {
        let json = schema_json_pretty().unwrap();

        // API keys should not appear in schema (they're skipped via #[schemars(skip)])
        assert!(!json.contains("\"api_key\""));
    }

    #[test]
    fn test_default_config_validates_against_schema() {
        let schema = schema();
        let config = AgenticConfig::default();
        let config_json = serde_json::to_value(&config).unwrap();

        // Use jsonschema crate to validate
        let validator = jsonschema::validator_for(&serde_json::to_value(&schema).unwrap()).unwrap();
        let result = validator.validate(&config_json);

        assert!(
            result.is_ok(),
            "Default config should validate against schema: {:?}",
            result.err()
        );
    }

    #[test]
    fn test_partial_config_validates_against_schema() {
        let schema = schema();
        let config_json = serde_json::json!({
            "subagents": {
                "locator_model": "claude-haiku-4-5"
            }
        });

        let validator = jsonschema::validator_for(&serde_json::to_value(&schema).unwrap()).unwrap();
        let result = validator.validate(&config_json);

        assert!(
            result.is_ok(),
            "Partial config should validate against schema: {:?}",
            result.err()
        );
    }
}