Skip to main content

bamboo_engine/runtime/execution/
mod.rs

1//! Execution orchestration for background agent runs.
2//!
3//! This module provides the shared execution infrastructure used by all
4//! background execution paths: HTTP execute handler, spawn scheduler,
5//! and schedule manager.
6//!
7//! # Key types
8//!
9//! - [`AgentRunner`] / [`AgentStatus`] — lifecycle state of an agent run
10//! - [`try_reserve_runner`] — atomically reserve a runner slot
11//! - [`finalize_runner`] — update runner terminal status
12//! - [`create_event_forwarder`] — MPSC → broadcast channel forwarder
13//! - [`get_or_create_event_sender`] — session-scoped event broadcaster
14//! - [`spawn_session_execution`] — spawn agent execution with full orchestration
15
16pub mod agent_spawn;
17pub mod child_completion;
18pub mod event_forwarder;
19pub mod runner_lifecycle;
20pub mod runner_state;
21pub mod session_events;
22pub mod spawn;
23
24pub use agent_spawn::{
25    log_base_system_prompt_snapshot, reserve_session_execution, spawn_session_execution,
26    SessionCompletionHook, SessionExecutionArgs, SessionExecutionOutcome,
27    SessionExecutionReservation, SessionExecutionReserveOutcome,
28};
29pub use child_completion::{ChildCompletion, ChildCompletionHandler};
30pub use event_forwarder::{create_event_forwarder, AccountFeedInbox};
31pub use runner_lifecycle::{
32    finalize_runner, finalize_runner_exact, reserve_runner_core, status_from_execution_result,
33    try_reserve_runner, ReserveOutcome, RunnerReservation,
34};
35pub use runner_state::{AgentRunner, AgentStatus};
36pub use session_events::{get_or_create_event_sender, SESSION_EVENT_CHANNEL_CAPACITY};
37pub use spawn::{
38    ChildRunLaunchHook, ExternalChildRunner, SessionInboxRuntimeBinding, SpawnContext, SpawnJob,
39    SpawnScheduler,
40};