Skip to main content

bamboo_engine/
lib.rs

1//! Bamboo engine — runtime, agent loop, and orchestration.
2
3pub mod app_context;
4pub mod auto_dream;
5pub mod events;
6pub mod external_agents;
7pub mod gardener;
8pub mod gold_auto_answer;
9pub mod ledger_gardener;
10pub mod llm_summarizer;
11pub mod message_hooks;
12pub mod model_areas;
13pub mod model_config_helper;
14pub mod prompt_defaults;
15pub mod resolved_defaults;
16pub mod runtime;
17pub mod sdk;
18pub mod session_app;
19pub mod session_repository;
20pub use session_repository::SessionRepository;
21pub mod title_gen;
22pub mod token_usage_log;
23pub mod workflow_run;
24pub use token_usage_log::TokenUsageRecord;
25pub use workflow_run::{
26    AgentStepPort, AgentStepResult, FileWorkflowRunRepository, NamedAgentSpec, PermissionDecision,
27    WorkflowDefinitionPort, WorkflowPolicyPort, WorkflowPolicyTarget, WorkflowRunEngine,
28    WorkflowRunError, WorkflowRunRepository, WorkflowSecretMaterial, WorkflowSecretResolverPort,
29};
30
31pub use app_context::AgentSessionContext;
32pub use runtime::execution::agent_spawn::{read_cached_session, SessionCache};
33pub use session_app::child_completion_coordinator::ChildCompletionCoordinator;
34
35// Re-export commonly used types from agent (via dependency)
36pub use bamboo_agent_core::{
37    AgentError, AgentEvent, AgentHook, FunctionCall, FunctionSchema, Message, MessageContent,
38    MessagePart, MessagePhase, PromptSnapshot, Role, Session, TokenUsage, Tool, ToolCall,
39    ToolError, ToolExecutionContext, ToolExecutor, ToolRegistry, ToolResult, ToolSchema,
40};
41
42// Re-export hook contracts and runtime persistence so consumers can configure
43// lifecycle hooks without depending on the domain crate directly.
44pub use bamboo_domain::{
45    AgentHookPoint, HookPayload, HookResult, HookToolOutcome, RuntimeSessionPersistence,
46};
47pub use runtime::agent::AgentBuilder;
48// `AgentLoopConfig` is intentionally NOT re-exported: its fields are `pub(crate)`,
49// so it cannot be constructed outside the engine. Execution funnels solely through
50// `AgentRuntime::execute`.
51pub use runtime::config::{
52    ApprovalDelegate, AuxiliaryModelConfig, BashResumeHook, ChildApprovalOutcome,
53    ChildApprovalRequest, GuardianConfig, GuardianSpawner, ImageFallbackConfig, ImageFallbackMode,
54};
55pub use runtime::execution::runner_state::{AgentRunner, AgentStatus};
56pub use runtime::hooks::{
57    test_lifecycle_shell_command, HookRunner, ShellCommandHook, ShellHookEvent, ShellHookTestOutput,
58};
59pub use runtime::managers::{
60    LifecycleManager, LlmManager, MemoryManager, MiniLoopExecutor, PromptManager, ToolManager,
61};
62pub use runtime::model_roster::{ModelRoster, RoleModel};
63pub use runtime::runtime::{
64    AgentRuntime, AgentRuntimeBuilder, ExecuteRequest, ExecuteRequestBuilder,
65};
66pub use runtime::task_context::TaskLoopContext;
67pub use runtime::task_evaluation::{evaluate_task_progress, TaskEvaluationResult};
68pub use runtime::Agent;
69
70// Re-export from the ergonomic SDK surface (anti-fork single spawn core).
71pub use sdk::runner::{child_runner, ChildRunner, RunChildInput};
72pub use sdk::spawn::run_child_spawn;
73
74// Sub-module re-exports for engine's own runtime modules
75pub mod runner {
76    pub use crate::runtime::runner::*;
77}
78pub mod context {
79    pub use crate::runtime::context::*;
80}
81pub mod execution {
82    pub use crate::runtime::execution::*;
83}
84pub mod config {
85    pub use crate::runtime::config::*;
86}
87pub mod hooks {
88    pub use crate::runtime::hooks::*;
89}
90pub mod managers {
91    pub use crate::runtime::managers::*;
92}
93pub mod stream {
94    pub use crate::runtime::stream::*;
95}
96pub mod task_context {
97    pub use crate::runtime::task_context::*;
98}
99pub mod task_evaluation {
100    pub use crate::runtime::task_evaluation::*;
101}
102pub mod agent {
103    pub use crate::runtime::agent::*;
104}