bamboo-agent 2026.4.2

A fully self-contained AI agent backend framework with built-in web services, multi-LLM provider support, and comprehensive tool execution
Documentation
//! Image fallback and attachment resolution helpers for the agent loop runner.

use std::sync::Arc;

use crate::agent::core::storage::AttachmentReader;
use crate::agent::core::{AgentError, Message};
use crate::agent::llm::LLMProvider;
use crate::agent::loop_module::config::ImageFallbackConfig;

mod attachment_urls;
#[cfg(windows)]
mod ocr;
mod placeholder;
mod rewrite;

#[cfg(windows)]
pub(super) async fn ensure_session_image_ocr_cached(
    session: &mut crate::agent::core::Session,
    attachment_reader: Option<&dyn AttachmentReader>,
) -> bool {
    ocr::ensure_session_image_ocr_cached(session, attachment_reader).await
}

pub(super) async fn resolve_bamboo_attachments_for_llm(
    messages: &mut [Message],
    reader: &dyn AttachmentReader,
) -> std::result::Result<(), AgentError> {
    attachment_urls::resolve_bamboo_attachments_for_llm(messages, reader).await
}

#[cfg(any(test, windows))]
pub(super) fn persistable_image_urls(
    parts: &[crate::agent::llm::models::ContentPart],
) -> Vec<String> {
    placeholder::persistable_image_urls(parts)
}

pub(super) async fn apply_image_fallback_to_llm_messages(
    messages: &mut [Message],
    fallback: ImageFallbackConfig,
    attachment_reader: Option<&dyn AttachmentReader>,
    llm: Option<&Arc<dyn LLMProvider>>,
) -> std::result::Result<(), AgentError> {
    rewrite::apply_image_fallback_to_llm_messages(messages, fallback, attachment_reader, llm).await
}

#[cfg(test)]
mod tests;