From daffe1aeae77cc19113133d621a996e3e7d4e3db Mon Sep 17 00:00:00 2001
From: TheArchitectit <roger@vroger.com>
Date: Tue, 28 Apr 2026 12:26:55 -0500
Subject: [PATCH] fix: improve SubAgent/Agent descriptions to steer model
 toward SubAgent for exploration

---
 rust/crates/tools/src/lib.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/rust/crates/tools/src/lib.rs b/rust/crates/tools/src/lib.rs
index 897a2433..a2df1305 100644
--- a/rust/crates/tools/src/lib.rs
+++ b/rust/crates/tools/src/lib.rs
@@ -675,7 +675,7 @@ pub fn mvp_tool_specs() -> Vec<ToolSpec> {
         },
         ToolSpec {
             name: "Agent",
-            description: "Launch a specialized agent task and persist its handoff metadata.",
+            description: "Launch a background agent task that runs asynchronously. For synchronous read-only exploration, use SubAgent instead. Agent is for long-running background work that should not block the conversation.",
             input_schema: json!({
                 "type": "object",
                 "properties": {