add get_logs tool to manager mcp surface

hive-ag3nt/src/mcp.rs

@@ -39,6 +39,7 @@ pub enum SocketReply {
     Status(u64),
     QuestionQueued(i64),
     Recent(Vec<hive_sh4re::InboxRow>),
+    Logs(String),
 }
 
 impl From<hive_sh4re::AgentResponse> for SocketReply {
@@ -65,6 +66,7 @@ impl From<hive_sh4re::ManagerResponse> for SocketReply {
             hive_sh4re::ManagerResponse::Status { unread } => Self::Status(unread),
             hive_sh4re::ManagerResponse::QuestionQueued { id } => Self::QuestionQueued(id),
             hive_sh4re::ManagerResponse::Recent { rows } => Self::Recent(rows),
+            hive_sh4re::ManagerResponse::Logs { content } => Self::Logs(content),
         }
     }
 }
@@ -351,6 +353,15 @@ pub struct RequestApplyCommitArgs {
     pub description: Option<String>,
 }
 
+#[derive(Debug, serde::Deserialize, schemars::JsonSchema)]
+pub struct GetLogsArgs {
+    /// Logical name of the sub-agent container to fetch logs for.
+    pub agent: String,
+    /// How many journal lines to return (default: 50, max: 500).
+    #[serde(default)]
+    pub lines: Option<u32>,
+}
+
 #[derive(Debug, Clone)]
 pub struct ManagerServer {
     socket: PathBuf,
@@ -580,6 +591,40 @@ impl ManagerServer {
         })
         .await
     }
+
+    #[tool(
+        description = "Fetch recent journal log lines for a sub-agent container. Useful \
+        for diagnosing MCP server registration failures, startup crashes, plugin install \
+        errors, or any harness issue you can't see from inside the container. `lines` \
+        defaults to 50 (max capped at 500 on the host side)."
+    )]
+    async fn get_logs(&self, Parameters(args): Parameters<GetLogsArgs>) -> String {
+        let log = format!("{args:?}");
+        let agent = args.agent.clone();
+        run_tool_envelope("get_logs", log, async move {
+            let lines = args.lines.map(|n| n.min(500));
+            let (resp, retries) = self
+                .dispatch(hive_sh4re::ManagerRequest::GetLogs {
+                    agent: agent.clone(),
+                    lines,
+                })
+                .await;
+            let s = match resp {
+                Ok(SocketReply::Logs(content)) => {
+                    if content.is_empty() {
+                        format!("(no journal output for {agent})")
+                    } else {
+                        content
+                    }
+                }
+                Ok(SocketReply::Err(m)) => format!("get_logs failed: {m}"),
+                Ok(other) => format!("get_logs unexpected response: {other:?}"),
+                Err(e) => format!("get_logs transport error: {e:#}"),
+            };
+            annotate_retries(s, retries)
+        })
+        .await
+    }
 }
 
 #[tool_handler(
@@ -635,6 +680,7 @@ pub fn allowed_mcp_tools(flavor: Flavor) -> Vec<String> {
             "update",
             "request_apply_commit",
             "ask_operator",
+            "get_logs",
         ],
     };
     let mut out: Vec<String> = names