1  <?xml version="1.0" encoding="UTF-8"?>
 2  <tools>
 3  <tool name="task">
 4    <description>
 5      Execute a task using a specialized sub-agent.
 6      Sub-agents are defined by markdown files in the prompt/agents/ directory.
 7      
 8      Each sub-agent has specific capabilities and instructions for handling
 9      particular types of tasks (e.g., code review, vulnerability testing, etc.)
10      
11      Use 'list_agents' to see available sub-agent types.
12    </description>
13    <parameters>
14      <parameter name="prompt" type="string" required="true">
15        The task prompt describing what the agent should do
16      </parameter>
17      <parameter name="subagent_type" type="string" required="true">
18        The type of specialized agent to use (e.g., 'code_audit', 'vuln_review')
19      </parameter>
20      <parameter name="description" type="string" required="false">
21        A short (3-5 words) description of the task
22      </parameter>
23    </parameters>
24    <returns>
25      <field name="success" type="boolean">Whether the task succeeded</field>
26      <field name="title" type="string">Task description</field>
27      <field name="output" type="string">Task execution result</field>
28      <field name="agent" type="string">The agent type used</field>
29      <field name="metadata" type="object">Additional task metadata</field>
30    </returns>
31  </tool>
32  
33  <tool name="list_agents">
34    <description>
35      List all available sub-agents that can be used with the 'task' tool.
36      Returns the name and description of each available agent.
37    </description>
38    <parameters>
39      <!-- No parameters required -->
40    </parameters>
41    <returns>
42      <field name="success" type="boolean">Whether the listing succeeded</field>
43      <field name="output" type="string">Formatted list of available agents</field>
44      <field name="agents" type="array">List of agent objects with name, description, path</field>
45    </returns>
46  </tool>
47  </tools>
48