Update spawn agents tool to emphasize the required fields and add real examples

Author: jahooma

common/src/tools/params/tool/spawn-agents.ts

@@ -39,16 +39,26 @@ Each agent available is already defined as another tool, or, dynamically defined
 
 You can call agents either as direct tool calls (e.g., \`example-agent\`) or use \`spawn_agents\`. Both formats work, but **prefer using spawn_agents** because it allows you to spawn multiple agents in parallel for better performance. When using direct tool calls, the schema is flat (prompt is a field alongside other params), whereas spawn_agents uses nested \`prompt\` and \`params\` fields.
 
+**IMPORTANT**: Many agents have REQUIRED fields in their params schema. Check the agent's schema before spawning - if params has required fields, you MUST include them in the params object. For example, code-searcher requires \`searchQueries\`, commander requires \`command\`.
+
 Example:
 ${$getNativeToolCallExampleString({
   toolName,
   inputSchema,
   input: {
     agents: [
       {
-        agent_type: 'example-agent',
-        prompt: 'Create a plan for implementing user authentication',
-        params: { filePaths: ['src/auth.ts', 'src/user.ts'] },
+        agent_type: 'commander',
+        prompt: 'Check if tests pass',
+        params: {
+          command: 'npm test',
+        },
+      },
+      {
+        agent_type: 'code-searcher',
+        params: {
+          searchQueries: [{ pattern: 'authenticate', flags: '-g *.ts' }],
+        },
       },
     ],
   },