chore: import upstream snapshot with attribution

apps/sim/tools/wordpress/list_users.ts

@@ -0,0 +1,143 @@
+import type { ToolConfig } from '@/tools/types'
+import {
+  WORDPRESS_COM_API_BASE,
+  type WordPressListUsersParams,
+  type WordPressListUsersResponse,
+} from '@/tools/wordpress/types'
+
+export const listUsersTool: ToolConfig<WordPressListUsersParams, WordPressListUsersResponse> = {
+  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',
+    },
+  },
+}