chore: import upstream snapshot with attribution

apps/sim/tools/hunter/email_count.ts

@@ -0,0 +1,124 @@
+import type { HunterEmailCountParams, HunterEmailCountResponse } from '@/tools/hunter/types'
+import { DEPARTMENT_OUTPUT, HUNTER_API_KEY_PREFIX, SENIORITY_OUTPUT } from '@/tools/hunter/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const emailCountTool: ToolConfig<HunterEmailCountParams, HunterEmailCountResponse> = {
+  id: 'hunter_email_count',
+  name: 'Hunter Email Count',
+  description: 'Returns the total number of email addresses found for a domain or company.',
+  version: '1.0.0',
+
+  hosting: {
+    envKeyPrefix: HUNTER_API_KEY_PREFIX,
+    apiKeyParam: 'apiKey',
+    byokProviderId: 'hunter',
+    // Email Count is free on Hunter — no credits consumed.
+    pricing: { type: 'per_request', cost: 0 },
+    rateLimit: {
+      mode: 'per_request',
+      requestsPerMinute: 60,
+    },
+  },
+
+  params: {
+    domain: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Domain to count emails for (e.g., "stripe.com"). Required if company not provided',
+    },
+    company: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Company name to count emails for (e.g., "Stripe", "Acme Inc"). Required if domain not provided',
+    },
+    type: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Filter for personal or generic emails only (e.g., "personal", "generic", "all")',
+    },
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Hunter.io API Key',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      if (!params.domain && !params.company) {
+        throw new Error('Either domain or company must be provided')
+      }
+
+      const url = new URL('https://api.hunter.io/v2/email-count')
+      url.searchParams.append('api_key', params.apiKey)
+
+      if (params.domain) url.searchParams.append('domain', params.domain)
+      if (params.company) url.searchParams.append('company', params.company)
+      if (params.type && params.type !== 'all') url.searchParams.append('type', params.type)
+
+      return url.toString()
+    },
+    method: 'GET',
+    headers: () => ({
+      'Content-Type': 'application/json',
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    return {
+      success: true,
+      output: {
+        total: data.data?.total || 0,
+        personal_emails: data.data?.personal_emails || 0,
+        generic_emails: data.data?.generic_emails || 0,
+        department: data.data?.department || {
+          executive: 0,
+          it: 0,
+          finance: 0,
+          management: 0,
+          sales: 0,
+          legal: 0,
+          support: 0,
+          hr: 0,
+          marketing: 0,
+          communication: 0,
+          education: 0,
+          design: 0,
+          health: 0,
+          operations: 0,
+        },
+        seniority: data.data?.seniority || {
+          junior: 0,
+          senior: 0,
+          executive: 0,
+        },
+      },
+    }
+  },
+
+  outputs: {
+    total: {
+      type: 'number',
+      description: 'Total number of email addresses found',
+    },
+    personal_emails: {
+      type: 'number',
+      description: 'Number of personal email addresses (individual employees)',
+    },
+    generic_emails: {
+      type: 'number',
+      description: 'Number of generic/role-based email addresses (e.g., contact@, info@)',
+    },
+    department: DEPARTMENT_OUTPUT,
+    seniority: SENIORITY_OUTPUT,
+  },
+}