What I'm Building
Implementing "Add Important Tools" button that adds top 20 most useful tools from a toolkit (Gmail). Expecting tools ordered by importance as per docs.
What's Not Working
Tools returned in alphabetical order, not by importance. GMAIL_SEND_EMAIL appears at position 27/27 (last), not in top 20.
Steps to Reproduce
const tools = await composio.tools.get('default', {
toolkits: ['GMAIL'],
limit: 20
});
console.log(tools.map(t => t.function.name));
Expected vs Actual
Expected: SEND_EMAIL, READ_EMAIL, REPLY in top positions
Actual: ADD_LABEL, BATCH_DELETE, BATCH_MODIFY... (A-Z order)
Environment
• Node: v20.x
• composio-core: 0.2.0
• @composio/openai-agents: 0.2.0
• OS: Windows 11
• Auth: Using Composio's default OAuth
Additional Tests
REST API with important=true also returns A-Z order:
GET /api/v3/tools?toolkit_slug=gmail&important=true
Reference
Docs claim: "tools are ordered by importance"
https://docs.composio.dev/docs/fetching-tools
Questions
Is this feature implemented in 0.2.0? Need workaround?