ironclad-api 0.9.8

HTTP routes, WebSocket, auth, rate limiting, and dashboard for the Ironclad agent runtime
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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

use super::*;

// ── split_subtasks tests ─────────────────────────────────────

#[test]
fn split_subtasks_detects_multi_step_inputs() {
    let parts = split_subtasks("research impact and draft summary then propose next steps");
    assert!(parts.len() >= 3);
}

#[test]
fn split_subtasks_returns_single_item_for_simple_prompt() {
    let parts = split_subtasks("summarize this report");
    assert_eq!(parts.len(), 1);
    assert_eq!(parts[0], "summarize this report");
}

#[test]
fn split_subtasks_semicolons() {
    let parts = split_subtasks("task A; task B; task C");
    assert_eq!(parts.len(), 3);
    assert_eq!(parts[0], "task A");
    assert_eq!(parts[1], "task B");
    assert_eq!(parts[2], "task C");
}

#[test]
fn split_subtasks_empty() {
    let parts = split_subtasks("");
    assert!(parts.is_empty());
}

#[test]
fn split_subtasks_newlines() {
    let parts = split_subtasks("line 1\nline 2\nline 3");
    assert_eq!(parts.len(), 3);
}

#[test]
fn split_subtasks_deduplicates_adjacent() {
    let parts = split_subtasks("task A\ntask A");
    assert_eq!(parts.len(), 1);
}

// ── utility_margin_for_delegation tests ──────────────────────

#[test]
fn utility_margin_penalizes_low_fit() {
    let low_fit = utility_margin_for_delegation(0.6, 3, 0.1);
    let high_fit = utility_margin_for_delegation(0.6, 3, 0.9);
    assert!(high_fit > low_fit);
}

#[test]
fn utility_margin_increases_with_complexity_and_falls_with_low_fit() {
    let base = utility_margin_for_delegation(0.3, 2, 0.9);
    let more_complex = utility_margin_for_delegation(0.3, 4, 0.9);
    let lower_fit = utility_margin_for_delegation(0.3, 4, 0.2);
    assert!(more_complex > base);
    assert!(lower_fit < more_complex);
}

#[test]
fn utility_margin_negative_for_single_task_low_complexity() {
    let margin = utility_margin_for_delegation(0.1, 1, 0.1);
    assert!(
        margin < 0.0,
        "single trivial task should not justify delegation"
    );
}

#[test]
fn utility_margin_high_for_complex_multi_task() {
    let margin = utility_margin_for_delegation(1.0, 5, 1.0);
    assert!(
        margin > 0.0,
        "complex multi-task with perfect fit should justify delegation"
    );
}

// ── proposal_to_json tests ───────────────────────────────────

#[test]
fn proposal_json_contains_reviewable_config() {
    let proposal = SpecialistProposal {
        name: "geo-specialist".into(),
        display_name: "Geo Specialist".into(),
        description: "Monitors geopolitical risk".into(),
        skills: vec!["geopolitical".into(), "risk-analysis".into()],
        model: "auto".into(),
    };
    let payload = proposal_to_json(&proposal, "coverage gap");
    assert_eq!(payload["name"], "geo-specialist");
    assert!(payload["skills"].is_array());
    assert_eq!(payload["model"], "auto");
}

// ── capability_tokens tests ──────────────────────────────────

#[test]
fn capability_tokens_extracts_lowercase_wordlike_tokens() {
    let tokens = capability_tokens("Geo-Political analysis, RISK_123 and alerts!");
    assert!(tokens.contains(&"political".to_string()));
    assert!(tokens.contains(&"analysis".to_string()));
    assert!(tokens.contains(&"risk".to_string()));
    assert!(tokens.contains(&"alerts".to_string()));
}

#[test]
fn capability_tokens_filters_short_tokens() {
    let tokens = capability_tokens("a bb ccc dddd");
    assert!(!tokens.contains(&"a".to_string()));
    assert!(!tokens.contains(&"bb".to_string()));
    assert!(!tokens.contains(&"ccc".to_string()));
    assert!(tokens.contains(&"dddd".to_string()));
}

#[test]
fn capability_tokens_empty() {
    assert!(capability_tokens("").is_empty());
}