import type { ToolConfig } from '@/tools/types' import { WORDPRESS_COM_API_BASE, type WordPressListUsersParams, type WordPressListUsersResponse, } from '@/tools/wordpress/types' export const listUsersTool: ToolConfig = { id: 'wordpress_list_users', name: 'WordPress List Users', description: 'List users from WordPress.com (requires admin privileges)', version: '1.0.0', oauth: { required: true, provider: 'wordpress', requiredScopes: ['global'], }, params: { siteId: { type: 'string', required: true, visibility: 'user-or-llm', description: 'WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)', }, perPage: { type: 'number', required: false, visibility: 'user-or-llm', description: 'Number of users per request (e.g., 10, 25, 50). Default: 10, max: 100', }, page: { type: 'number', required: false, visibility: 'user-or-llm', description: 'Page number for pagination (e.g., 1, 2, 3)', }, search: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Search term to filter users (e.g., "john", "admin")', }, roles: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Comma-separated role names to filter by (e.g., "administrator,editor")', }, order: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Order direction: asc or desc', }, }, request: { url: (params) => { const queryParams = new URLSearchParams() if (params.perPage) queryParams.append('per_page', String(params.perPage)) if (params.page) queryParams.append('page', String(params.page)) if (params.search) queryParams.append('search', params.search) if (params.roles) queryParams.append('roles', params.roles) if (params.order) queryParams.append('order', params.order) const queryString = queryParams.toString() return `${WORDPRESS_COM_API_BASE}/${params.siteId}/users${queryString ? `?${queryString}` : ''}` }, method: 'GET', headers: (params) => ({ 'Content-Type': 'application/json', Authorization: `Bearer ${params.accessToken}`, }), }, transformResponse: async (response: Response) => { if (!response.ok) { const error = await response.json().catch(() => ({})) throw new Error(error.message || `WordPress API error: ${response.status}`) } const data = await response.json() const total = Number.parseInt(response.headers.get('X-WP-Total') || '0', 10) const totalPages = Number.parseInt(response.headers.get('X-WP-TotalPages') || '0', 10) return { success: true, output: { users: data.map((user: any) => ({ id: user.id, username: user.username, name: user.name, first_name: user.first_name, last_name: user.last_name, email: user.email, url: user.url, description: user.description, link: user.link, slug: user.slug, roles: user.roles || [], avatar_urls: user.avatar_urls, })), total, totalPages, }, } }, outputs: { users: { type: 'array', description: 'List of users', items: { type: 'object', properties: { id: { type: 'number', description: 'User ID' }, username: { type: 'string', description: 'Username' }, name: { type: 'string', description: 'Display name' }, first_name: { type: 'string', description: 'First name' }, last_name: { type: 'string', description: 'Last name' }, email: { type: 'string', description: 'Email address' }, url: { type: 'string', description: 'User website URL' }, description: { type: 'string', description: 'User bio' }, link: { type: 'string', description: 'Author archive URL' }, slug: { type: 'string', description: 'User slug' }, roles: { type: 'array', description: 'User roles' }, avatar_urls: { type: 'object', description: 'Avatar URLs at different sizes' }, }, }, }, total: { type: 'number', description: 'Total number of users', }, totalPages: { type: 'number', description: 'Total number of result pages', }, }, }