feat(agent): background server, management CLI, and mode-aware goal prompts

changelog.d/134.changed.md

@@ -1 +1 @@
-Refactored `plugins/team` to launch subagents through the shared `n00n.subagent` helper, consolidating structured-output and model-tier handling with `task` and `workflow`.
+Refactored `plugins/task` and `plugins/workflow` to launch subagents through the shared `n00n.subagent` helper for structured-output cases, consolidating model-tier handling. Team submodules (validation, quorum, summary) retain direct `n00n.agent.session` calls for test compatibility with mock contexts.

n00n-acp/src/server.rs

@@ -192,6 +192,7 @@ fn spawn_session(
         system_prompt_override: None,
         append_system_prompt: None,
         workflow: false,
+        mode: AgentMode::Build,
     })
 }
 

n00n-agent/src/agent/instructions.rs

@@ -71,8 +71,11 @@ pub fn build_system_prompt(
     );
     let env = format!("{env}\n- Model: {}", model.spec());
     let instructions = format!("{env}{instructions}");
-    let mut system =
-        crate::prompt::assemble_system(crate::prompt::PromptId::System, slots, &instructions);
+    let prompt_id = match mode {
+        crate::AgentMode::Research => crate::prompt::PromptId::Research,
+        _ => crate::prompt::PromptId::System,
+    };
+    let mut system = crate::prompt::assemble_system(prompt_id, slots, &instructions);
 
     if let Some(plan_path) = mode.plan_path() {
         let plan_vars = Vars::new().set("{plan_path}", plan_path.display().to_string());

n00n-agent/src/agent/run.rs

@@ -51,7 +51,7 @@ const CACHE_BREAKPOINTS_SHORT: usize = 2;
 const CACHE_BREAKPOINTS_MIN: usize = 1;
 
 fn filter_tools_for_mode(tools: &mut Value, mode: &AgentMode) {
-    if mode.plan_path().is_none() {
+    if !mode.is_readonly() {
         return;
     }
     if let Some(definitions) = tools.as_array_mut() {

n00n-agent/src/headless.rs

@@ -85,6 +85,7 @@ pub struct HeadlessParams {
     pub initial_wd: PathBuf,
     pub fast: bool,
     pub workflow: bool,
+    pub mode: AgentMode,
 }
 
 pub struct HeadlessHandle {
@@ -154,7 +155,7 @@ fn tool_definitions(
 #[must_use]
 pub fn spawn(params: HeadlessParams) -> HeadlessHandle {
     let working_dir = params.initial_wd.to_string_lossy().into_owned();
-    let mode = AgentMode::Build;
+    let mode = params.mode.clone();
     let AgentSetup {
         vars,
         instructions,
@@ -289,6 +290,7 @@ pub struct InteractiveParams {
     pub system_prompt_override: Option<String>,
     pub append_system_prompt: Option<String>,
     pub workflow: bool,
+    pub mode: AgentMode,
 }
 
 pub struct InteractiveHandle {

n00n-agent/src/lib.rs

@@ -46,16 +46,22 @@ pub enum AgentMode {
     #[default]
     Build,
     Plan(PathBuf),
+    Research,
 }
 
 impl AgentMode {
     #[must_use]
     pub fn plan_path(&self) -> Option<&Path> {
         match self {
             Self::Plan(p) => Some(p),
-            Self::Build => None,
+            Self::Build | Self::Research => None,
         }
     }
+
+    #[must_use]
+    pub fn is_readonly(&self) -> bool {
+        matches!(self, Self::Plan(_) | Self::Research)
+    }
 }
 
 pub enum ExtractedCommand {

n00n-storage/src/sessions.rs

@@ -299,6 +299,7 @@ pub enum StoredEffect {
 pub enum StoredMode {
     Build,
     Plan,
+    Research,
 }
 
 #[derive(Debug, Clone, Serialize, Deserialize)]

n00n-ui/src/app/session.rs

@@ -91,6 +91,7 @@ fn stored_message(input: AgentInput, delivery: Delivery) -> StoredQueuedMessage
             Some(StoredMode::Plan),
             Some(path.to_string_lossy().into_owned()),
         ),
+        AgentMode::Research => (Some(StoredMode::Research), None),
     };
     StoredQueuedMessage {
         text: input.message,
@@ -126,6 +127,7 @@ fn restored_submission(
             StoredMode::Plan => message
                 .plan_path
                 .map_or(input.mode, |path| AgentMode::Plan(PathBuf::from(path))),
+            StoredMode::Research => AgentMode::Research,
         };
     }
     if let Some(thinking) = message.thinking {