bamboo-engine 2026.10.22

Execution engine and orchestration 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

//! Pre-execution validation helpers.

use bamboo_domain::Session;

/// Validate images after resolving the provider and exact executing model.
/// Explicit support bypasses the independent legacy fallback; missing support
/// retains its opt-in policy. Explicit false uses transient ViewImage references;
/// the HTTP host separately validates the explicit auxiliary target configuration.
pub fn validate_image_fallback_for_session(
    session: &Session,
    image_fallback: Option<&crate::ImageFallbackConfig>,
    _model_name: &str,
    vision_override: Option<bool>,
) -> Result<(), String> {
    use crate::ImageFallbackMode;

    if vision_override.is_some() {
        return Ok(());
    }
    let images_seen = session
        .messages
        .iter()
        .filter_map(|message| message.content_parts.as_ref())
        .flat_map(|parts| parts.iter())
        .filter(|part| matches!(part, bamboo_agent_core::MessagePart::ImageUrl { .. }))
        .count();
    if matches!(
        image_fallback,
        Some(crate::ImageFallbackConfig {
            mode: ImageFallbackMode::Error,
            ..
        })
    ) && images_seen > 0
    {
        return Err(format!(
            "This server does not currently support image inputs (found {images_seen} image part(s)). \
             Configure hooks.image_fallback.mode='placeholder' or 'ocr' to degrade gracefully."
        ));
    }

    Ok(())
}

#[cfg(test)]
mod image_reference_tests {
    use super::*;
    use bamboo_domain::{ImageUrlRef, Message, MessagePart};

    #[test]
    fn explicit_nonvision_new_upload_and_history_followup_pass_without_rewriting_messages() {
        for followup in [false, true] {
            let mut session = Session::new("image-reference-preflight", "text-only");
            session.add_message(Message::user_with_parts(
                "image",
                vec![MessagePart::ImageUrl {
                    image_url: ImageUrlRef {
                        url: "bamboo-attachment://image-reference-preflight/image1".into(),
                        detail: None,
                    },
                }],
            ));
            if followup {
                session.add_message(Message::user("inspect the earlier image"));
            }
            let before = serde_json::to_vec(&session).unwrap();
            validate_image_fallback_for_session(
                &session,
                Some(&crate::ImageFallbackConfig {
                    mode: crate::ImageFallbackMode::Error,
                    vision_model: None,
                }),
                "text-only",
                Some(false),
            )
            .unwrap();
            assert_eq!(serde_json::to_vec(&session).unwrap(), before);
        }
    }
}