agm-core 1.1.0

Core library for parsing, validating, loading, and rendering AGM (Agent Graph Memory) files
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

//! Renderer: converts AST (or filtered views) to output formats.
//!
//! Supported formats: JSON, JSON canonical (S37), Markdown, canonical AGM
//! text, and graph visualization (DOT/Mermaid).

pub mod canonical;
pub mod graph;
pub mod json;
pub mod json_canonical;
pub mod markdown;
pub mod mem;
pub mod state;

use crate::model::file::AgmFile;

// ---------------------------------------------------------------------------
// RenderError
// ---------------------------------------------------------------------------

/// Errors produced by the fallible [`json_canonical::json_to_agm`] function.
#[derive(Debug, Clone, PartialEq, thiserror::Error)]
pub enum RenderError {
    #[error("missing required field: {field}")]
    MissingField { field: String },

    #[error("invalid field type for '{field}': expected {expected}, got {actual}")]
    InvalidType {
        field: String,
        expected: String,
        actual: String,
    },

    #[error("invalid enum value for '{field}': {value}")]
    InvalidEnumValue { field: String, value: String },

    #[error("JSON deserialization error: {0}")]
    JsonError(String),
}

// ---------------------------------------------------------------------------
// RenderFormat
// ---------------------------------------------------------------------------

/// Output format selector for the top-level [`render`] function.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum RenderFormat {
    Json,
    JsonCanonical,
    Markdown,
    Canonical,
    Dot,
    Mermaid,
}

// ---------------------------------------------------------------------------
// render
// ---------------------------------------------------------------------------

/// Renders an `AgmFile` in the requested format.
///
/// All variants are infallible — they operate on a valid AST and produce
/// best-effort output.
#[must_use]
pub fn render(file: &AgmFile, format: RenderFormat) -> String {
    match format {
        RenderFormat::Json => json::render_json(file),
        RenderFormat::JsonCanonical => json_canonical::render_json_canonical(file),
        RenderFormat::Markdown => markdown::render_markdown(file),
        RenderFormat::Canonical => canonical::render_canonical(file),
        RenderFormat::Dot => graph::render_graph_dot(file),
        RenderFormat::Mermaid => graph::render_graph_mermaid(file),
    }
}