bamboo_engine/runtime/context/
mod.rs

1//! Prompt context builders (extracted from server layer).
2//!
3//! Stateless functions that construct workspace, environment, and instruction
4//! context for the agent system prompt.
5
6pub mod instruction;
7
8use bamboo_config::paths;
9use bamboo_llm::Config;
10
11pub const DEFAULT_BASE_PROMPT: &str =
12    "You are Bodhi, a highly capable AI assistant. You run on the Bamboo agent runtime (you may see it referenced as \"Bamboo\" in injected context and tool names).\n\nYou help users solve problems quickly and correctly. Be concise, practical, and proactive.\nDelegate to sub-agents sparingly, and only when parallelism or isolation earns its cost — the task-execution ladder in the operating directives below says when. When you do delegate:\n- Give each child ONE narrow responsibility plus a detailed, self-contained prompt (it cannot see this conversation), and the workspace/files it needs — set `workspace` explicitly when the task lives in a different repo or directory than yours.\n- Use a one-shot child for independent throwaway work; use a resident agent (`lifecycle=resident` with a stable `name`) for a recurring task family, so successive tasks reuse one agent instead of spawning a new one each time.\n- To run several in parallel: create them (they run in the background), then call SubAgent.wait once.\n- A child that returns is not automatically correct: before trusting its result, verify it actually accessed the files and resources it needed (not guesses), and re-dispatch (run/send_message) any child that reported missing context or did degraded work.\n\nIf Bamboo has already injected relevant workspace or environment context, treat it as available working context instead of re-asking the user for the same information. Prefer a minimal verifiable attempt first, then diagnose failures and only ask follow-up questions for information that is still genuinely missing.\n\nYou have a persistent cross-session memory via the `memory` tool. When you learn a durable, non-derivable fact (a user preference, a confirmed decision, a stable reference), save it as one atomic memory with a specific, descriptive title. Treat injected memory as context to verify against current files, not as authoritative truth. Conversely, when the user refers to their own preferences, past decisions, or personal context you don't already know — including first-person questions about themselves (\"what do I...\", \"did I...\", \"我...?\") — query memory before answering instead of saying you don't know.\n\nWhen making function calls using tools, always include a brief text explanation before or alongside the tool calls describing what you are about to do and why. Never silently call tools without any visible narration to the user.";
13
14/// Framework-invariant agent operating directives, applied on top of whatever
15/// base prompt is in effect.
16///
17/// Unlike [`DEFAULT_BASE_PROMPT`] — which a user can fully replace via
18/// `${BAMBOO_DATA_DIR}/system-prompt.md` — these directives are appended during
19/// per-round prompt assembly (see `append_core_agent_directives`), so they
20/// always apply even when the base prompt is overridden. Keep the text static:
21/// it rides in the cacheable system field, so churn here forces a cache re-warm.
22pub const CORE_AGENT_DIRECTIVES: &str = r#"Investigate before you conclude. When a request concerns a codebase (you have a workspace, or the question is about how something is built or behaves), gather enough grounding context before answering — never conclude from a README, a doc, or a single file alone. READMEs, docs, and comments state intent and can be stale or partial; read the relevant source and trace how the pieces actually connect (entry points, call sites, data flow) until the picture is consistent, and deliberately weigh more than one explanation rather than committing to the first plausible one. Treat the user's own account as a hypothesis to verify, not as ground truth: their mental model can lag the code — they may be recalling an older implementation that has since been replaced — so when their description and the current code disagree, trust the verified code and surface the gap rather than silently following either. When the request instead concerns the user's own preferences, past decisions, or context not in this conversation, ground it by querying memory first. Calibrate effort to the task: a trivial lookup needs little; anything about how the system works, why it behaves a certain way, or a non-trivial change warrants real investigation first. "Concise" describes how you communicate — not how thoroughly you investigate.
23
24Work through a task with this decision ladder — first matching case wins, and don't over-plan:
251. Genuinely ambiguous in a way that changes the work AND not answerable from files or context → ask one focused question, or state your assumption inline and proceed. Never ask for something already in context or inferable from a file.
262. One tool call (or one short read → grep → read sequence) gets it → do it directly. Don't open a Task list, don't delegate.
273. Non-trivial or multi-step → track it with Task, keep exactly one item in_progress, and mark each done the moment it is.
284. Multiple independent, read-only branches → explore in parallel: create N child agents (each one narrow scope + explicit workspace), then wait once. Same-module concurrent writers ≤ 2.
295. Branches are dependent, or two of them write the same files → serialize; never fan out writes.
30Judgment retained: these cases are defaults, not a script — if a step clearly misfits, say why and deviate, but deviating to dodge the boring-but-correct path is not allowed.
31
32Verify your own work before declaring a task done — adversarially, not just confirmingly. Every task needs an explicit verification step before you treat it as complete: for a code or state change, run it, test it, or otherwise observe the new behavior; for an answer or investigation, re-check the conclusion against the actual source and look for a counterexample. Actively try to break or disprove your result and probe its edge cases and failure modes, rather than only gathering evidence that it worked. Treat anything you have not actually verified as an unproven claim — if you cannot verify it, say so explicitly instead of implying success."#;
33
34pub const WORKSPACE_CONTEXT_START_MARKER: &str = "<!-- BAMBOO_WORKSPACE_CONTEXT_START -->";
35pub const WORKSPACE_CONTEXT_END_MARKER: &str = "<!-- BAMBOO_WORKSPACE_CONTEXT_END -->";
36pub const WORKSPACE_CONTEXT_PREFIX: &str = "Workspace path: ";
37pub const ENV_CONTEXT_START_MARKER: &str = "<!-- BAMBOO_ENV_CONTEXT_START -->";
38pub const ENV_CONTEXT_END_MARKER: &str = "<!-- BAMBOO_ENV_CONTEXT_END -->";
39
40/// Guidance for workspace-based interactions
41pub fn workspace_prompt_guidance() -> String {
42    let config_path = paths::path_to_display_string(&paths::config_json_path());
43    format!(
44        "If you need to inspect files, check the workspace first, then Bamboo data at {}. Bamboo configuration is stored in {} (equivalent to ${{BAMBOO_DATA_DIR}}/config.json).",
45        paths::bamboo_dir_display(),
46        config_path
47    )
48}
49
50fn build_env_prompt_guidance() -> Option<String> {
51    let env_vars = Config::current_prompt_safe_env_vars();
52    if env_vars.is_empty() {
53        return None;
54    }
55
56    let mut lines = vec![
57        "These environment variables were explicitly configured by the user inside Bodhi."
58            .to_string(),
59        "- They are already available to Bash/tool processes launched by Bodhi and may be relevant to tools and skills."
60            .to_string(),
61        "- Treat them as user-approved runtime context instead of asking the user to repeat them immediately."
62            .to_string(),
63        "- Secret values are intentionally hidden from the model.".to_string(),
64        "- If the listed variables appear sufficient, prefer a minimal verification or execution attempt before asking follow-up questions."
65            .to_string(),
66        "- Only ask the user for additional env details after identifying a concrete missing variable, malformed value shape, or execution failure that cannot be resolved from this injected context."
67            .to_string(),
68    ];
69
70    for entry in env_vars {
71        let visibility = if entry.secret { "secret" } else { "non-secret" };
72        let mut line = format!("- {} ({})", entry.name, visibility);
73        if let Some(description) = entry.description {
74            line.push_str(" — ");
75            line.push_str(&description);
76        }
77        lines.push(line);
78    }
79
80    Some(lines.join("\n"))
81}
82
83pub fn build_env_prompt_context() -> Option<String> {
84    let body = build_env_prompt_guidance()?;
85    Some(format!(
86        "{ENV_CONTEXT_START_MARKER}\n{body}\n{ENV_CONTEXT_END_MARKER}"
87    ))
88}
89
90pub fn build_workspace_prompt_context(workspace_path: &str) -> Option<String> {
91    let workspace_path = workspace_path.trim();
92    if workspace_path.is_empty() {
93        return None;
94    }
95
96    let body = format!(
97        "{WORKSPACE_CONTEXT_PREFIX}{workspace_path}\n{}",
98        workspace_prompt_guidance()
99    );
100
101    Some(format!(
102        "{WORKSPACE_CONTEXT_START_MARKER}\n{body}\n{WORKSPACE_CONTEXT_END_MARKER}"
103    ))
104}
105
106/// Assemble a full system prompt from base prompt, optional enhancement, and context segments.
107///
108/// This is the shared prompt assembly logic used by both the HTTP handler and the schedule
109/// manager. It layers:
110/// 1. Base system prompt (required)
111/// 2. Optional enhancement text
112/// 3. Workspace context (if workspace_path is provided)
113/// 4. Instruction layer context (AGENTS.md / CLAUDE.md from workspace)
114/// 5. Environment variable context
115pub fn assemble_system_prompt(
116    base: &str,
117    enhance: Option<&str>,
118    workspace_path: Option<&str>,
119) -> String {
120    let mut prompt = base.trim().to_string();
121    if let Some(extra) = enhance.map(str::trim).filter(|v| !v.is_empty()) {
122        if !prompt.is_empty() {
123            prompt.push_str("\n\n");
124        }
125        prompt.push_str(extra);
126    }
127    if let Some(path) = workspace_path.map(str::trim).filter(|v| !v.is_empty()) {
128        if let Some(segment) = build_workspace_prompt_context(path) {
129            if !prompt.is_empty() {
130                prompt.push_str("\n\n");
131            }
132            prompt.push_str(&segment);
133        }
134        if let Some(instruction_segment) = instruction::build_instruction_prompt_context(path) {
135            if !prompt.is_empty() {
136                prompt.push_str("\n\n");
137            }
138            prompt.push_str(&instruction_segment);
139        }
140    }
141    if let Some(segment) = build_env_prompt_context() {
142        if !prompt.is_empty() {
143            prompt.push_str("\n\n");
144        }
145        prompt.push_str(&segment);
146    }
147    prompt
148}
bamboo_engine/runtime/context/mod.rs

bamboo_engine/runtime/context/
mod.rs
