bamboo-server 2026.4.30

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

//! Error types for session use cases.

/// Errors that can occur when loading a session.
#[derive(Debug, thiserror::Error)]
pub enum SessionLoadError {
    #[error("session not found: {0}")]
    NotFound(String),
    #[error("storage error: {0}")]
    StorageError(String),
}

/// Errors that can occur when saving a session.
#[derive(Debug, thiserror::Error)]
pub enum SessionSaveError {
    #[error("storage error: {0}")]
    StorageError(String),
}

/// Errors from the chat use case.
#[derive(Debug, thiserror::Error)]
pub enum ChatError {
    #[error("session load failed: {0}")]
    LoadFailed(#[from] SessionLoadError),
    #[error("session save failed: {0}")]
    SaveFailed(#[from] SessionSaveError),
    #[error("invalid model: {0}")]
    InvalidModel(String),
}

/// Errors from the execute preparation use case.
#[derive(Debug, thiserror::Error)]
pub enum ExecutePreparationError {
    #[error("session not found: {0}")]
    NotFound(String),
    #[error("session load failed: {0}")]
    LoadFailed(#[from] SessionLoadError),
    #[error("session save failed: {0}")]
    SaveFailed(#[from] SessionSaveError),
    #[error("invalid model: model is required")]
    ModelRequired,
    #[error("invalid image fallback configuration: {0}")]
    ImageFallbackError(String),
}

/// Errors from the respond use case.
#[derive(Debug, thiserror::Error)]
pub enum RespondError {
    #[error("session not found: {0}")]
    NotFound(String),
    #[error("session load failed: {0}")]
    LoadFailed(#[from] SessionLoadError),
    #[error("session save failed: {0}")]
    SaveFailed(#[from] SessionSaveError),
    #[error("no pending question waiting for response")]
    NoPendingQuestion,
    #[error("invalid response: {0}")]
    InvalidResponse(String),
}