bamboo-sdk 2026.7.25

Ergonomic top-level Agent SDK facade 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

//! Ergonomic builder for [`bamboo_engine::ExecuteRequest`].
//!
//! The builder itself now lives in `bamboo-engine` (beside `ExecuteRequest`) so
//! the in-crate server layer (e.g. the schedule manager) and this root SDK
//! facade construct requests through one shared builder — no forked assembly.
//! This module re-exports it so `bamboo_agent::ExecuteRequestBuilder` and
//! `bamboo_agent::agent::ExecuteRequestBuilder` stay stable.

pub use bamboo_engine::ExecuteRequestBuilder;

#[cfg(test)]
mod tests {
    use std::collections::BTreeSet;

    use tokio::sync::mpsc;
    use tokio_util::sync::CancellationToken;

    use bamboo_agent_core::AgentEvent;

    use super::ExecuteRequestBuilder;

    #[test]
    fn build_with_only_required_fields_defaults_optionals_to_none() {
        let (tx, _rx) = mpsc::channel::<AgentEvent>(8);
        let req = ExecuteRequestBuilder::new("hello", tx, CancellationToken::new()).build();

        assert_eq!(req.initial_message, "hello");
        assert!(req.tools.is_none());
        assert!(req.provider_override.is_none());
        assert!(req.model_roster.model.is_none());
        assert!(req.model_roster.provider_name.is_none());
        assert!(req.model_roster.provider_type.is_none());
        assert!(req.model_roster.fast.is_none());
        assert!(req.model_roster.fast_model().is_none());
        assert!(req.model_roster.fast_model_provider().is_none());
        assert!(req.model_roster.background.is_none());
        assert!(req.model_roster.background_model().is_none());
        assert!(req.model_roster.background_model_provider().is_none());
        assert!(req.model_roster.summarization.is_none());
        assert!(req.model_roster.summarization_model().is_none());
        assert!(req.model_roster.summarization_model_provider().is_none());
        assert!(req.reasoning_effort.is_none());
        assert!(req.auxiliary_model_resolver.is_none());
        assert!(req.disabled_tools.is_none());
        assert!(req.disabled_skill_ids.is_none());
        assert!(req.selected_skill_ids.is_none());
        assert!(req.selected_skill_mode.is_none());
        assert!(req.image_fallback.is_none());
        assert!(req.gold_config.is_none());
        assert!(req.app_data_dir.is_none());
    }

    #[test]
    fn setters_round_trip_into_request() {
        let (tx, _rx) = mpsc::channel::<AgentEvent>(8);
        let mut disabled = BTreeSet::new();
        disabled.insert("Edit".to_string());

        let req = ExecuteRequestBuilder::new("go", tx, CancellationToken::new())
            .model("claude-x")
            .provider_name("anthropic")
            .disabled_tools(disabled.clone())
            .build();

        assert_eq!(req.model_roster.model.as_deref(), Some("claude-x"));
        assert_eq!(req.model_roster.provider_name.as_deref(), Some("anthropic"));
        assert_eq!(req.disabled_tools, Some(disabled));
    }
}