bamboo-server 2026.5.2

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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use actix_web::{web, HttpResponse, Responder};

use super::super::{internal_error, MetricsDailyQuery, MetricsSessionsQuery, MetricsSummaryQuery};
use super::filters::{
    build_sessions_filter, normalize_days, resolve_timeline_granularity, TimelineGranularity,
};
use crate::app_state::AppState;

/// Gets chat metrics summary
///
/// # HTTP Route
/// `GET /metrics/summary`
pub async fn summary(
    state: web::Data<AppState>,
    query: web::Query<MetricsSummaryQuery>,
) -> impl Responder {
    match state
        .metrics_service
        .summary(query.start_date, query.end_date)
        .await
    {
        Ok(summary) => HttpResponse::Ok().json(summary),
        Err(error) => internal_error(error),
    }
}

/// Gets metrics grouped by model
///
/// # HTTP Route
/// `GET /metrics/by-model`
pub async fn by_model(
    state: web::Data<AppState>,
    query: web::Query<MetricsSummaryQuery>,
) -> impl Responder {
    match state
        .metrics_service
        .by_model(query.start_date, query.end_date)
        .await
    {
        Ok(data) => HttpResponse::Ok().json(data),
        Err(error) => internal_error(error),
    }
}

/// Lists sessions with optional filters
///
/// # HTTP Route
/// `GET /metrics/sessions`
pub async fn sessions(
    state: web::Data<AppState>,
    query: web::Query<MetricsSessionsQuery>,
) -> impl Responder {
    let filter = build_sessions_filter(&query);

    match state.metrics_service.sessions(filter).await {
        Ok(data) => HttpResponse::Ok().json(data),
        Err(error) => internal_error(error),
    }
}

/// Gets detailed metrics for a specific session
///
/// # HTTP Route
/// `GET /metrics/sessions/{session_id}`
pub async fn session_detail(state: web::Data<AppState>, path: web::Path<String>) -> impl Responder {
    let session_id = path.into_inner();
    match state.metrics_service.session_detail(&session_id).await {
        Ok(Some(detail)) => HttpResponse::Ok().json(detail),
        Ok(None) => HttpResponse::NotFound().json(serde_json::json!({
            "error": "Metrics for session not found",
            "session_id": session_id,
        })),
        Err(error) => internal_error(error),
    }
}

/// Gets daily/weekly/monthly metrics timeline
///
/// # HTTP Route
/// `GET /metrics/daily`
pub async fn daily(
    state: web::Data<AppState>,
    query: web::Query<MetricsDailyQuery>,
) -> impl Responder {
    let days = normalize_days(query.days);

    match resolve_timeline_granularity(query.granularity.as_deref()) {
        TimelineGranularity::Weekly => {
            match state.metrics_service.weekly(days, query.end_date).await {
                Ok(data) => HttpResponse::Ok().json(data),
                Err(error) => internal_error(error),
            }
        }
        TimelineGranularity::Monthly => {
            match state.metrics_service.monthly(days, query.end_date).await {
                Ok(data) => HttpResponse::Ok().json(data),
                Err(error) => internal_error(error),
            }
        }
        TimelineGranularity::Daily => match state.metrics_service.daily(days, query.end_date).await
        {
            Ok(data) => HttpResponse::Ok().json(data),
            Err(error) => internal_error(error),
        },
    }
}