bamboo-engine 2026.4.30

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

use crate::runtime::config::AgentLoopConfig;
use bamboo_agent_core::Session;

#[cfg(windows)]
use super::super::super::image_fallback::ensure_session_image_ocr_cached;

pub(super) async fn maybe_cache_ocr_results(
    session: &mut Session,
    config: &AgentLoopConfig,
    session_id: &str,
) {
    #[cfg(not(windows))]
    let _ = (session, config, session_id);

    // If OCR fallback is enabled, compute + cache OCR results into the persisted session
    // (but do NOT rewrite message parts). This keeps OCR available for the UI while
    // also allowing the LLM request to be built from text-only projections.
    #[cfg(windows)]
    if matches!(
        config.image_fallback,
        Some(ref cfg) if cfg.mode == crate::runtime::config::ImageFallbackMode::Ocr
    ) {
        let changed =
            ensure_session_image_ocr_cached(session, config.attachment_reader.as_deref()).await;
        if changed {
            if let Some(ref storage) = config.storage {
                if let Err(error) = storage.save_session(session).await {
                    tracing::warn!(
                        "[{}] Failed to save session after OCR caching: {}",
                        session_id,
                        error
                    );
                }
            }
        }
    }
}