prompty 2.0.0-alpha.11

Prompty is an asset class and format for LLM prompts
Documentation
// Code generated by AgentSchema emitter; DO NOT EDIT.

#![allow(
    unused_imports,
    dead_code,
    non_camel_case_types,
    unused_variables,
    clippy::all
)]

use super::super::context::{LoadContext, SaveContext};

/// The result of a guardrail evaluation. Guardrails are safety checks that run at specific phases of the agent loop and can allow, deny, or rewrite content.
#[derive(Debug, Clone, Default)]
pub struct GuardrailResult {
    /// Whether the content passed the guardrail check
    pub allowed: bool,
    /// Explanation of why the content was allowed or denied
    pub reason: Option<String>,
    /// Optional rewritten content to replace the original
    pub rewrite: Option<serde_json::Value>,
}

impl GuardrailResult {
    /// Create a new GuardrailResult with default values.
    pub fn new() -> Self {
        Self::default()
    }

    /// Load GuardrailResult from a JSON string.
    pub fn from_json(json: &str, ctx: &LoadContext) -> Result<Self, serde_json::Error> {
        let value: serde_json::Value = serde_json::from_str(json)?;
        Ok(Self::load_from_value(&value, ctx))
    }

    /// Load GuardrailResult from a YAML string.
    pub fn from_yaml(yaml: &str, ctx: &LoadContext) -> Result<Self, serde_yaml::Error> {
        let value: serde_json::Value = serde_yaml::from_str(yaml)?;
        Ok(Self::load_from_value(&value, ctx))
    }

    /// Load GuardrailResult from a `serde_json::Value`.
    ///
    /// Calls `ctx.process_input` before field extraction.
    pub fn load_from_value(value: &serde_json::Value, ctx: &LoadContext) -> Self {
        let value = ctx.process_input(value.clone());
        Self {
            allowed: value
                .get("allowed")
                .and_then(|v| v.as_bool())
                .unwrap_or(false),
            reason: value
                .get("reason")
                .and_then(|v| v.as_str())
                .map(|s| s.to_string()),
            rewrite: value.get("rewrite").cloned(),
        }
    }

    /// Serialize GuardrailResult to a `serde_json::Value`.
    ///
    /// Calls `ctx.process_dict` after serialization.
    pub fn to_value(&self, ctx: &SaveContext) -> serde_json::Value {
        let mut result = serde_json::Map::new();
        // Write base fields
        result.insert("allowed".to_string(), serde_json::Value::Bool(self.allowed));
        if let Some(ref val) = self.reason {
            result.insert("reason".to_string(), serde_json::Value::String(val.clone()));
        }
        if let Some(ref val) = self.rewrite {
            result.insert("rewrite".to_string(), val.clone());
        }
        ctx.process_dict(serde_json::Value::Object(result))
    }

    /// Serialize GuardrailResult to a JSON string.
    pub fn to_json(&self, ctx: &SaveContext) -> Result<String, serde_json::Error> {
        serde_json::to_string_pretty(&self.to_value(ctx))
    }

    /// Serialize GuardrailResult to a YAML string.
    pub fn to_yaml(&self, ctx: &SaveContext) -> Result<String, serde_yaml::Error> {
        serde_yaml::to_string(&self.to_value(ctx))
    }
    /// Create a GuardrailResult with preset field values.
    pub fn rewrite(rewrite: impl Into<serde_json::Value>) -> Self {
        GuardrailResult {
            allowed: true,
            rewrite: Some(rewrite.into()),
            ..Default::default()
        }
    }
    /// Create a GuardrailResult with preset field values.
    pub fn deny(reason: impl Into<String>) -> Self {
        GuardrailResult {
            allowed: false,
            reason: Some(reason.into()),
            ..Default::default()
        }
    }
    /// Create a GuardrailResult with preset field values.
    pub fn allow() -> Self {
        GuardrailResult {
            allowed: true,
            ..Default::default()
        }
    }
}