swink-agent 0.8.0

Core scaffolding for running LLM-powered agentic loops
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

//! Tests for the `schema_for` helper and its integration with built-in tools.

use schemars::JsonSchema;
use serde::Deserialize;
use serde_json::json;

use swink_agent::{schema_for, validate_schema, validate_tool_arguments};

// ─── schema_for generates valid schemas ─────────────────────────────────────

#[derive(Deserialize, JsonSchema)]
#[allow(dead_code)]
struct Simple {
    /// A name field.
    name: String,
    /// An optional count.
    count: Option<u32>,
}

#[test]
fn schema_for_generates_valid_schema() {
    let schema = schema_for::<Simple>();
    assert!(validate_schema(&schema).is_ok());
    assert_eq!(schema["type"], "object");
}

#[test]
fn schema_for_includes_required_fields() {
    let schema = schema_for::<Simple>();
    let required = schema["required"].as_array().expect("required array");
    assert!(required.contains(&json!("name")));
}

#[test]
fn schema_for_optional_fields_not_required() {
    let schema = schema_for::<Simple>();
    let required = schema["required"].as_array().expect("required array");
    assert!(!required.contains(&json!("count")));
}

// ─── Built-in tool schemas still validate correctly ─────────────────────────

#[cfg(feature = "builtin-tools")]
#[test]
fn bash_tool_schema_validates_valid_args() {
    use swink_agent::{AgentTool, BashTool};
    let tool = BashTool::new();
    let args = json!({"command": "echo hello"});
    assert!(validate_tool_arguments(tool.parameters_schema(), &args).is_ok());
}

#[cfg(feature = "builtin-tools")]
#[test]
fn bash_tool_schema_rejects_missing_command() {
    use swink_agent::{AgentTool, BashTool};
    let tool = BashTool::new();
    let args = json!({"timeout_ms": 5000});
    assert!(validate_tool_arguments(tool.parameters_schema(), &args).is_err());
}

#[cfg(feature = "builtin-tools")]
#[test]
fn read_file_tool_schema_validates_valid_args() {
    use swink_agent::{AgentTool, ReadFileTool};
    let tool = ReadFileTool::new();
    let args = json!({"path": "/tmp/file.txt"});
    assert!(validate_tool_arguments(tool.parameters_schema(), &args).is_ok());
}

#[cfg(feature = "builtin-tools")]
#[test]
fn write_file_tool_schema_validates_valid_args() {
    use swink_agent::{AgentTool, WriteFileTool};
    let tool = WriteFileTool::new();
    let args = json!({"path": "/tmp/file.txt", "content": "hello"});
    assert!(validate_tool_arguments(tool.parameters_schema(), &args).is_ok());
}

#[cfg(feature = "builtin-tools")]
#[test]
fn write_file_tool_schema_rejects_extra_fields() {
    use swink_agent::{AgentTool, WriteFileTool};
    let tool = WriteFileTool::new();
    let args = json!({"path": "/tmp/file.txt", "content": "hello", "extra": true});
    assert!(validate_tool_arguments(tool.parameters_schema(), &args).is_err());
}