marona 5.5.0

Marona Agents, MCP server and App authoring, B2A, D2A, realtime and A2A
Documentation
use serde::{Deserialize, Serialize};
use serde_json::{json, Map, Value};

#[derive(Clone, Debug, Default, Serialize, Deserialize, PartialEq)]
pub struct Artifact {
    #[serde(rename = "type")]
    pub kind: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub label: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub mime_type: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub url: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub base64: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub text: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub external_id: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub filename: Option<String>,
    #[serde(default, skip_serializing_if = "Map::is_empty")]
    pub metadata: Map<String, Value>,
}

#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
pub struct MaronaResult {
    pub status: String,
    pub success: bool,
    pub message: String,
    pub content: String,
    pub content_type: String,
    pub presentation_hint: String,
    pub context: String,
    #[serde(default)]
    pub data: Value,
    #[serde(default)]
    pub items: Vec<Value>,
    #[serde(default)]
    pub count: usize,
    #[serde(default)]
    pub artifacts: Vec<Artifact>,
    #[serde(default)]
    pub job: Value,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub error: Option<Value>,
}

impl MaronaResult {
    pub fn with_data(mut self, data: Value) -> Self {
        self.data = data;
        self
    }

    pub fn with_items(mut self, items: Vec<Value>) -> Self {
        self.count = items.len();
        self.items = items;
        self
    }

    pub fn into_value(self) -> Value {
        serde_json::to_value(self).expect("MaronaResult is serializable")
    }
}

pub fn success(message: impl Into<String>) -> MaronaResult {
    let message = message.into();
    MaronaResult {
        status: "completed".into(),
        success: true,
        content: message.clone(),
        message,
        content_type: "text".into(),
        presentation_hint: "display_as_provided".into(),
        context: "Use content as the primary user-facing result. Use data/items only for structured details.".into(),
        data: json!({}),
        items: Vec::new(),
        count: 0,
        artifacts: Vec::new(),
        job: json!({}),
        error: None,
    }
}

pub fn failure(message: impl Into<String>, error_code: impl Into<String>) -> MaronaResult {
    let message = message.into();
    MaronaResult {
        status: "failed".into(),
        success: false,
        content: message.clone(),
        message: message.clone(),
        content_type: "error".into(),
        presentation_hint: "display_as_provided".into(),
        context: "This tool failed. Show content/message as the user-facing failure and use error for diagnostics.".into(),
        data: json!({}),
        items: Vec::new(),
        count: 0,
        artifacts: Vec::new(),
        job: json!({}),
        error: Some(json!({"code": error_code.into(), "message": message})),
    }
}