bamboo-server 2026.5.1

HTTP server and API layer for the Bamboo agent framework
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

use crate::error::AppError;
use bamboo_infrastructure::Config;

use super::{
    status::build_setup_status,
    updates::{set_setup_complete, set_setup_incomplete},
};

#[test]
fn build_setup_status_marks_complete_when_setup_completed_flag_is_true() {
    let mut config = Config::default();
    config.extra.insert(
        "setup".to_string(),
        serde_json::json!({
            "completed": true
        }),
    );

    let status = build_setup_status(&config, &[]);
    assert!(status.is_complete);
    assert_eq!(
        status.message,
        "Setup has already been completed in config.json."
    );
}

#[test]
fn build_setup_status_reports_proxy_config_without_completion_flag() {
    let mut config = Config::default();
    config.extra.clear();
    config.http_proxy = "http://proxy.internal:8080".to_string();

    let status = build_setup_status(&config, &[]);
    assert!(!status.has_proxy_env);
    assert!(status.has_proxy_config);
    assert!(!status.is_complete);
    assert_eq!(
        status.message,
        "Proxy configuration already exists in config.json. Setup is not required."
    );
}

#[test]
fn build_setup_status_reports_proxy_environment_variables() {
    let mut config = Config::default();
    config.extra.clear();
    let status = build_setup_status(&config, &["HTTP_PROXY", "HTTPS_PROXY"]);

    assert!(status.has_proxy_env);
    assert!(status.message.contains("HTTP_PROXY, HTTPS_PROXY"));
}

#[test]
fn set_setup_complete_requires_setup_object_shape() {
    let mut config = Config::default();
    config.extra.insert(
        "setup".to_string(),
        serde_json::Value::String("invalid".to_string()),
    );

    let error = set_setup_complete(&mut config, "2026-01-01T00:00:00Z".to_string())
        .expect_err("expected setup object-shape error");

    match error {
        AppError::BadRequest(message) => {
            assert_eq!(message, "config.setup must be a JSON object");
        }
        other => panic!("unexpected error: {other}"),
    }
}

#[test]
fn set_setup_complete_and_incomplete_update_extra_fields() {
    let mut config = Config::default();

    set_setup_complete(&mut config, "2026-01-01T00:00:00Z".to_string())
        .expect("complete should succeed");
    let setup = config
        .extra
        .get("setup")
        .and_then(|value| value.as_object())
        .expect("setup should exist as object");
    assert_eq!(setup.get("completed"), Some(&serde_json::Value::Bool(true)));
    assert_eq!(
        setup.get("completed_at"),
        Some(&serde_json::Value::String(
            "2026-01-01T00:00:00Z".to_string()
        ))
    );
    assert_eq!(
        setup.get("version"),
        Some(&serde_json::Value::Number(1.into()))
    );

    set_setup_incomplete(&mut config, "2026-01-02T00:00:00Z".to_string());
    let setup = config
        .extra
        .get("setup")
        .and_then(|value| value.as_object())
        .expect("setup should still exist as object");
    assert_eq!(
        setup.get("completed"),
        Some(&serde_json::Value::Bool(false))
    );
    assert_eq!(
        setup.get("reset_at"),
        Some(&serde_json::Value::String(
            "2026-01-02T00:00:00Z".to_string()
        ))
    );
}