jacs 0.9.5

JACS JSON AI Communication Standard
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
93
94
95
96
97
98
99
100
101
102
103
104
105

use serde_json::{Value, json};

pub fn create_minimal_action(
    _name: &str,
    description: &str,
    tools: Option<Vec<Value>>,
    units: Option<Vec<Value>>,
) -> Value {
    let mut action = json!({
        "description": description,

    });

    if let Some(tools) = tools {
        action["tools"] = json!(tools);
    }

    if let Some(units) = units {
        action["units"] = json!(units);
    }

    action
}

// CRUD operations for future public API - will be exposed in upcoming releases
#[allow(dead_code)]
fn add_tool_to_action(action: &mut Value, tool: Value) -> Result<(), String> {
    if action.get("tools").is_none() {
        action["tools"] = json!([]);
    }
    action["tools"]
        .as_array_mut()
        .ok_or_else(|| "Invalid action format".to_string())?
        .push(tool);
    Ok(())
}

#[allow(dead_code)]
fn update_tool_in_action(
    action: &mut Value,
    old_tool: Value,
    new_tool: Value,
) -> Result<(), String> {
    let tools = action["tools"]
        .as_array_mut()
        .ok_or_else(|| "Invalid action format".to_string())?;

    let index = tools
        .iter()
        .position(|t| t == &old_tool)
        .ok_or_else(|| "Tool not found".to_string())?;

    tools[index] = new_tool;
    Ok(())
}

#[allow(dead_code)]
fn remove_tool_from_action(action: &mut Value, tool: Value) -> Result<(), String> {
    let tools = action["tools"]
        .as_array_mut()
        .ok_or_else(|| "Invalid action format".to_string())?;

    let index = tools
        .iter()
        .position(|t| t == &tool)
        .ok_or_else(|| "Tool not found".to_string())?;

    tools.remove(index);
    Ok(())
}

// Similar functions for adding, updating, and removing units.

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

    #[test]
    fn create_minimal_action_keeps_optional_collections_when_present() {
        let action = create_minimal_action(
            "summarize",
            "Summarize the document",
            Some(vec![json!({"function": {"name": "summarize"}})]),
            Some(vec![json!({"unit": "paragraph"})]),
        );

        assert_eq!(action["description"], json!("Summarize the document"));
        assert_eq!(action["tools"][0]["function"]["name"], json!("summarize"));
        assert_eq!(action["units"][0]["unit"], json!("paragraph"));
    }

    #[test]
    fn action_tool_helpers_add_update_and_remove_tools() {
        let mut action = create_minimal_action("summarize", "Summarize the document", None, None);
        let original_tool = json!({"function": {"name": "summarize"}});
        let replacement_tool = json!({"function": {"name": "classify"}});

        add_tool_to_action(&mut action, original_tool.clone()).unwrap();
        update_tool_in_action(&mut action, original_tool.clone(), replacement_tool.clone())
            .unwrap();
        remove_tool_from_action(&mut action, replacement_tool).unwrap();

        assert_eq!(action["tools"], json!([]));
    }
}