prompty 2.0.0-alpha.9

Prompty is an asset class and format for LLM prompts
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

// Code generated by AgentSchema emitter; DO NOT EDIT.

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

/// Template format definition
#[derive(Debug, Clone, Default)]
pub struct FormatConfig {
    /// Template rendering engine used for slot filling prompts (e.g., mustache, jinja2)
    pub kind: String,
    /// Whether the template can emit structural text for parsing output
    pub strict: Option<bool>,
    /// Options for the template engine
    pub options: serde_json::Value,
}

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

    /// Load FormatConfig 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 FormatConfig 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 FormatConfig 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());
        if let Some(s) = value.as_str() {
            let value = s.to_string();
            let expansion = serde_json::json!({"kind":value});
            return Self::load_from_value(&expansion, ctx);
        }
        Self {
            kind: value
                .get("kind")
                .and_then(|v| v.as_str())
                .unwrap_or_default()
                .to_string(),
            strict: value.get("strict").and_then(|v| v.as_bool()),
            options: value
                .get("options")
                .cloned()
                .unwrap_or(serde_json::Value::Null),
        }
    }

    /// Serialize FormatConfig 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();
        if !self.kind.is_empty() {
            result.insert(
                "kind".to_string(),
                serde_json::Value::String(self.kind.clone()),
            );
        }
        if let Some(val) = self.strict {
            result.insert("strict".to_string(), serde_json::Value::Bool(val));
        }
        if !self.options.is_null() {
            result.insert("options".to_string(), self.options.clone());
        }
        ctx.process_dict(serde_json::Value::Object(result))
    }

    /// Serialize FormatConfig 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 FormatConfig to a YAML string.
    pub fn to_yaml(&self, ctx: &SaveContext) -> Result<String, serde_yaml::Error> {
        serde_yaml::to_string(&self.to_value(ctx))
    }
    /// Returns typed reference to the map if the field is an object.
    /// Returns `None` if the field is null or not an object.
    pub fn as_options_dict(&self) -> Option<&serde_json::Map<String, serde_json::Value>> {
        self.options.as_object()
    }
}