Core Cli Tools

All tools return structured errors:

{
  "category": "INVALID_ARGUMENT|NOT_FOUND|PERMISSION_DENIED",
  "code": "SKILL_NOT_FOUND",
  "message": "Human-readable error description",
  "recoverable": true,
  "retry": false
}

Handler Pattern

Implement tool handlers as functions:

async function handleTool(context: ToolContext, args: Record<string, unknown>) {
  // Validate inputs
  // Call service methods
  // Return structured result or error
}

Rate Limiting

• Remote skill queries use token bucket rate limiting
• Local operations are unlimited
• Configure limits in config.rateLimiting
• Catch RATE_LIMITED errors and retry with backoff

Timeout Strategy

Use tiered timeouts:

• Fast operations (config): 100ms
• Network operations: 5s
• Security scans: 30s