simstudioai--sim/apps/sim/blocks/blocks/findymail.ts

import { FindymailIcon } from '@/components/icons'
import { AuthMode, type BlockConfig, type BlockMeta, IntegrationType } from '@/blocks/types'
import type { FindymailResponse } from '@/tools/findymail/types'

export const FindymailBlock: BlockConfig<FindymailResponse> = {
  type: 'findymail',
  name: 'Findymail',
  description: 'Find and verify B2B emails, phones, employees, and company data',
  authMode: AuthMode.ApiKey,
  longDescription:
    'Integrate Findymail to find verified work emails by name, domain, or LinkedIn URL, verify deliverability, reverse-lookup profiles from emails, enrich company data, find employees by job title, look up phone numbers, search technology stacks, and check credit usage.',
  docsLink: 'https://docs.sim.ai/integrations/findymail',
  category: 'tools',
  integrationType: IntegrationType.Sales,
  bgColor: '#FFFFFF',
  icon: FindymailIcon,
  subBlocks: [
    {
      id: 'operation',
      title: 'Operation',
      type: 'dropdown',
      options: [
        { label: 'Find Email From Name', id: 'findymail_find_email_from_name' },
        { label: 'Find Email From LinkedIn', id: 'findymail_find_email_from_linkedin' },
        { label: 'Find Emails By Domain', id: 'findymail_find_emails_by_domain' },
        { label: 'Verify Email', id: 'findymail_verify_email' },
        { label: 'Reverse Email Lookup', id: 'findymail_reverse_email_lookup' },
        { label: 'Get Company Info', id: 'findymail_get_company' },
        { label: 'Find Employees', id: 'findymail_find_employees' },
        { label: 'Find Phone', id: 'findymail_find_phone' },
        { label: 'Search Technologies', id: 'findymail_search_technologies' },
        { label: 'Lookup Technologies By Domain', id: 'findymail_lookup_technologies' },
        { label: 'Get Remaining Credits', id: 'findymail_get_credits' },
      ],
      value: () => 'findymail_find_email_from_name',
    },
    // Find Email From Name
    {
      id: 'fn_name',
      title: 'Full Name',
      type: 'short-input',
      required: true,
      placeholder: 'John Doe',
      condition: { field: 'operation', value: 'findymail_find_email_from_name' },
    },
    {
      id: 'fn_domain',
      title: 'Company Domain or Name',
      type: 'short-input',
      required: true,
      placeholder: 'stripe.com',
      condition: { field: 'operation', value: 'findymail_find_email_from_name' },
    },
    // Find Email From LinkedIn
    {
      id: 'fefl_linkedin_url',
      title: 'LinkedIn URL',
      type: 'short-input',
      required: true,
      placeholder: 'https://linkedin.com/in/johndoe',
      condition: { field: 'operation', value: 'findymail_find_email_from_linkedin' },
    },
    // Find Emails By Domain
    {
      id: 'fed_domain',
      title: 'Domain',
      type: 'short-input',
      required: true,
      placeholder: 'stripe.com',
      condition: { field: 'operation', value: 'findymail_find_emails_by_domain' },
    },
    {
      id: 'roles',
      title: 'Target Roles',
      type: 'long-input',
      required: true,
      placeholder: '["CEO", "Founder"]',
      condition: { field: 'operation', value: 'findymail_find_emails_by_domain' },
      wandConfig: {
        enabled: true,
        prompt:
          'Generate a JSON array of job roles/titles to target at the company (max 3). Return ONLY the JSON array - no explanations, no extra text.',
        placeholder: 'e.g. CEO, Founder, CTO',
      },
    },
    // Verify Email
    {
      id: 've_email',
      title: 'Email Address',
      type: 'short-input',
      required: true,
      placeholder: 'john@example.com',
      condition: { field: 'operation', value: 'findymail_verify_email' },
    },
    // Reverse Email Lookup
    {
      id: 'rel_email',
      title: 'Email Address',
      type: 'short-input',
      required: true,
      placeholder: 'john@example.com',
      condition: { field: 'operation', value: 'findymail_reverse_email_lookup' },
    },
    {
      id: 'with_profile',
      title: 'Return Full Profile',
      type: 'dropdown',
      options: [
        { label: 'No', id: 'false' },
        { label: 'Yes', id: 'true' },
      ],
      value: () => 'false',
      condition: { field: 'operation', value: 'findymail_reverse_email_lookup' },
      mode: 'advanced',
    },
    // Get Company Info — provide at least one of LinkedIn URL, domain, or name
    {
      id: 'gc_linkedin_url',
      title: 'Company LinkedIn URL',
      type: 'short-input',
      placeholder: 'LinkedIn URL (at least one of URL/domain/name required)',
      condition: { field: 'operation', value: 'findymail_get_company' },
    },
    {
      id: 'gc_domain',
      title: 'Company Domain',
      type: 'short-input',
      placeholder: 'stripe.com (at least one of URL/domain/name required)',
      condition: { field: 'operation', value: 'findymail_get_company' },
    },
    {
      id: 'gc_name',
      title: 'Company Name',
      type: 'short-input',
      placeholder: 'Stripe (at least one of URL/domain/name required)',
      condition: { field: 'operation', value: 'findymail_get_company' },
    },
    // Find Employees
    {
      id: 'website',
      title: 'Company Website',
      type: 'short-input',
      required: true,
      placeholder: 'google.com',
      condition: { field: 'operation', value: 'findymail_find_employees' },
    },
    {
      id: 'job_titles',
      title: 'Job Titles',
      type: 'long-input',
      required: true,
      placeholder: '["Software Engineer", "CEO"]',
      condition: { field: 'operation', value: 'findymail_find_employees' },
      wandConfig: {
        enabled: true,
        prompt:
          'Generate a JSON array of job titles to search for at the company (max 10). Return ONLY the JSON array - no explanations, no extra text.',
        placeholder: 'e.g. Software Engineer, CEO, Product Manager',
      },
    },
    {
      id: 'count',
      title: 'Number of Contacts',
      type: 'short-input',
      placeholder: '1',
      condition: { field: 'operation', value: 'findymail_find_employees' },
      mode: 'advanced',
    },
    // Find Phone
    {
      id: 'fp_linkedin_url',
      title: 'LinkedIn URL',
      type: 'short-input',
      required: true,
      placeholder: 'https://linkedin.com/in/johndoe',
      condition: { field: 'operation', value: 'findymail_find_phone' },
    },
    // Search Technologies
    {
      id: 'q',
      title: 'Search Term',
      type: 'short-input',
      required: true,
      placeholder: 'React',
      condition: { field: 'operation', value: 'findymail_search_technologies' },
      wandConfig: {
        enabled: true,
        prompt:
          'Generate a technology search term to look up in the Findymail technology catalog. Return ONLY the search term - no explanations, no extra text.',
        placeholder: 'e.g. React, Stripe, Salesforce',
      },
    },
    // Lookup Technologies By Domain
    {
      id: 'lt_domain',
      title: 'Company Domain',
      type: 'short-input',
      required: true,
      placeholder: 'stripe.com',
      condition: { field: 'operation', value: 'findymail_lookup_technologies' },
    },
    {
      id: 'technologies',
      title: 'Filter Technologies',
      type: 'long-input',
      placeholder: '["React", "TypeScript"]',
      condition: { field: 'operation', value: 'findymail_lookup_technologies' },
      mode: 'advanced',
      wandConfig: {
        enabled: true,
        prompt:
          'Generate a JSON array of technology names to filter by (case-insensitive). Return ONLY the JSON array - no explanations, no extra text.',
        placeholder: 'e.g. React, TypeScript, Node.js',
      },
    },
    // API Key — hidden on hosted Sim for operations with hosted-key support
    {
      id: 'apiKey',
      title: 'API Key',
      type: 'short-input',
      required: true,
      placeholder: 'Enter your Findymail API key',
      password: true,
      hideWhenHosted: true,
      condition: { field: 'operation', value: 'findymail_get_credits', not: true },
    },
    // API Key — always required for the credit-balance lookup (no hosted key)
    {
      id: 'apiKey',
      title: 'API Key',
      type: 'short-input',
      required: true,
      placeholder: 'Enter your Findymail API key',
      password: true,
      condition: { field: 'operation', value: 'findymail_get_credits' },
    },
  ],
  tools: {
    access: [
      'findymail_verify_email',
      'findymail_find_email_from_name',
      'findymail_find_emails_by_domain',
      'findymail_find_email_from_linkedin',
      'findymail_reverse_email_lookup',
      'findymail_get_company',
      'findymail_find_employees',
      'findymail_find_phone',
      'findymail_search_technologies',
      'findymail_lookup_technologies',
      'findymail_get_credits',
    ],
    config: {
      tool: (params) => {
        switch (params.operation) {
          case 'findymail_verify_email':
          case 'findymail_find_email_from_name':
          case 'findymail_find_emails_by_domain':
          case 'findymail_find_email_from_linkedin':
          case 'findymail_reverse_email_lookup':
          case 'findymail_get_company':
          case 'findymail_find_employees':
          case 'findymail_find_phone':
          case 'findymail_search_technologies':
          case 'findymail_lookup_technologies':
          case 'findymail_get_credits':
            return params.operation
          default:
            return 'findymail_find_email_from_name'
        }
      },
      params: (params) => {
        const { operation: _operation, ...rest } = params

        // Map unique subBlock IDs back to tool param names
        const idToParam: Record<string, string> = {
          fn_name: 'name',
          fn_domain: 'domain',
          fefl_linkedin_url: 'linkedin_url',
          fed_domain: 'domain',
          ve_email: 'email',
          rel_email: 'email',
          gc_linkedin_url: 'linkedin_url',
          gc_domain: 'domain',
          gc_name: 'name',
          fp_linkedin_url: 'linkedin_url',
          lt_domain: 'domain',
        }

        const result: Record<string, unknown> = {}
        for (const [key, value] of Object.entries(rest)) {
          if (value === undefined || value === null || value === '') continue
          const mappedKey = idToParam[key] ?? key
          if (mappedKey === 'count') {
            const n = Number(value)
            if (!Number.isNaN(n)) result[mappedKey] = n
          } else if (mappedKey === 'with_profile') {
            result[mappedKey] = value === true || value === 'true'
          } else if (
            mappedKey === 'roles' ||
            mappedKey === 'job_titles' ||
            mappedKey === 'technologies'
          ) {
            if (Array.isArray(value)) {
              result[mappedKey] = value
            } else if (typeof value === 'string') {
              const trimmed = value.trim()
              if (trimmed.startsWith('[')) {
                try {
                  const parsed = JSON.parse(trimmed)
                  if (Array.isArray(parsed)) {
                    result[mappedKey] = parsed
                    continue
                  }
                } catch {
                  // fall through to comma-split
                }
              }
              result[mappedKey] = trimmed
                .split(',')
                .map((s) => s.trim())
                .filter(Boolean)
            }
          } else {
            result[mappedKey] = value
          }
        }
        return result
      },
    },
  },
  inputs: {
    operation: { type: 'string', description: 'Operation to perform' },
    apiKey: { type: 'string', description: 'Findymail API key' },
    fn_name: { type: 'string', description: 'Full name (find email from name)' },
    fn_domain: { type: 'string', description: 'Company domain or name (find email from name)' },
    fefl_linkedin_url: { type: 'string', description: 'LinkedIn URL (find email from LinkedIn)' },
    fed_domain: { type: 'string', description: 'Company domain (find emails by domain)' },
    roles: { type: 'array', description: 'Target roles (max 3)' },
    ve_email: { type: 'string', description: 'Email address to verify' },
    rel_email: { type: 'string', description: 'Email address for reverse lookup' },
    with_profile: { type: 'boolean', description: 'Return full profile data on reverse lookup' },
    gc_linkedin_url: { type: 'string', description: 'Company LinkedIn URL (get company info)' },
    gc_domain: { type: 'string', description: 'Company domain (get company info)' },
    gc_name: { type: 'string', description: 'Company name (get company info)' },
    website: { type: 'string', description: 'Company website for employee search' },
    job_titles: { type: 'array', description: 'Target job titles (max 10)' },
    count: { type: 'number', description: 'Number of contacts to return (max 5)' },
    fp_linkedin_url: { type: 'string', description: 'LinkedIn URL (find phone)' },
    q: { type: 'string', description: 'Technology search query' },
    lt_domain: { type: 'string', description: 'Company domain (lookup technologies)' },
    technologies: { type: 'array', description: 'Technology names to filter by' },
  },
  outputs: {
    // Verify Email
    verified: { type: 'boolean', description: 'Whether the email is deliverable' },
    provider: { type: 'string', description: 'Email service provider' },
    // Find Email / LinkedIn
    contact: {
      type: 'json',
      description: 'Contact found (name, email, domain)',
    },
    contacts: {
      type: 'array',
      description: 'Contacts found at the domain (name, email, domain)',
    },
    // Reverse Email Lookup
    linkedin_url: { type: 'string', description: 'LinkedIn URL' },
    fullName: { type: 'string', description: 'Full name from LinkedIn profile' },
    username: { type: 'string', description: 'LinkedIn username' },
    headline: { type: 'string', description: 'Profile headline' },
    jobTitle: { type: 'string', description: 'Job title' },
    summary: { type: 'string', description: 'Profile summary' },
    city: { type: 'string', description: 'City' },
    region: { type: 'string', description: 'Region/state' },
    country: { type: 'string', description: 'Country' },
    companyLinkedinUrl: {
      type: 'string',
      description: 'Current company LinkedIn URL',
    },
    companyName: { type: 'string', description: 'Current company name' },
    companyWebsite: { type: 'string', description: 'Current company website' },
    isPremium: {
      type: 'boolean',
      description: 'Whether the profile has LinkedIn Premium',
    },
    isOpenProfile: { type: 'boolean', description: 'Whether the profile is open' },
    skills: { type: 'array', description: 'Profile skills' },
    jobs: { type: 'array', description: 'Job history entries' },
    educations: {
      type: 'array',
      description: 'Education history (school, degree, fieldOfStudy, startDate, endDate)',
    },
    certificates: {
      type: 'array',
      description: 'Certifications (name, issuingOrganization, issueDate, expirationDate)',
    },
    // Get Company
    name: { type: 'string', description: 'Company name' },
    domain: { type: 'string', description: 'Company domain' },
    company_size: {
      type: 'string',
      description: 'Headcount range (e.g., 1001-5000)',
    },
    industry: { type: 'string', description: 'Industry classification' },
    description: { type: 'string', description: 'Company description' },
    // Find Employees
    employees: {
      type: 'array',
      description: 'Employees found (name, linkedinUrl, companyWebsite, companyName, jobTitle)',
    },
    // Find Phone
    phone: {
      type: 'string',
      description: 'Phone number in E.164 format (US only)',
    },
    line_type: {
      type: 'string',
      description: 'Phone line type (Mobile, Landline)',
    },
    // Technologies
    technologies: {
      type: 'array',
      description: 'Technologies (name, category, subcategory, last_detected_at)',
    },
    // Get Credits
    credits: { type: 'number', description: 'Remaining finder credits' },
    verifier_credits: {
      type: 'number',
      description: 'Remaining verifier credits',
    },
    // Verify / Reverse shared
    email: { type: 'string', description: 'Email address' },
  },
}

export const FindymailBlockMeta = {
  tags: ['enrichment', 'sales-engagement'],
  url: 'https://www.findymail.com',
  templates: [
    {
      icon: FindymailIcon,
      title: 'Findymail email finder',
      prompt:
        'Build a workflow that takes a prospect name and company domain from a table, runs Findymail to find the verified work email, and writes the deliverable contact back to the row.',
      modules: ['tables', 'agent', 'workflows'],
      category: 'sales',
      tags: ['sales', 'research'],
    },
    {
      icon: FindymailIcon,
      title: 'Findymail LinkedIn enricher',
      prompt:
        'Create a workflow that takes a list of LinkedIn profile URLs, finds the matching verified work email via Findymail, and writes the enriched contacts into a research table.',
      modules: ['tables', 'agent', 'workflows'],
      category: 'sales',
      tags: ['sales', 'research'],
    },
    {
      icon: FindymailIcon,
      title: 'Findymail email verifier',
      prompt:
        'Build a workflow that runs a list of email addresses through Findymail verification, removes undeliverable addresses, and writes a clean list for outbound sends.',
      modules: ['tables', 'agent', 'workflows'],
      category: 'sales',
      tags: ['sales', 'automation'],
    },
    {
      icon: FindymailIcon,
      title: 'Findymail company team mapper',
      prompt:
        'Create a workflow that takes a target company domain, uses Findymail to find employees by job title and enrich company data, and writes the org map into a tables-based account base.',
      modules: ['tables', 'agent', 'workflows'],
      category: 'sales',
      tags: ['sales', 'research'],
    },
    {
      icon: FindymailIcon,
      title: 'Findymail CRM gap-filler',
      prompt:
        'Build a scheduled workflow that finds HubSpot contacts missing verified emails, looks them up with Findymail, verifies each, and updates the contact record.',
      modules: ['scheduled', 'agent', 'workflows'],
      category: 'sales',
      tags: ['sales', 'crm'],
      alsoIntegrations: ['hubspot'],
    },
    {
      icon: FindymailIcon,
      title: 'Findymail LinkedIn list builder',
      prompt:
        "Create a workflow that reads a list of LinkedIn profile URLs from a table, finds and verifies each prospect's work email and phone with Findymail, enriches their company, and writes a clean, ready-to-contact prospect table.",
      modules: ['tables', 'agent', 'workflows'],
      category: 'sales',
      tags: ['sales', 'research', 'enrichment'],
    },
    {
      icon: FindymailIcon,
      title: 'Findymail domain prospecting',
      prompt:
        'Build a workflow that takes a target company domain, uses Findymail to find employees and their verified emails by role, validates each address, and pushes the qualified contacts into the outbound sequence.',
      modules: ['agent', 'workflows'],
      category: 'sales',
      tags: ['sales', 'research', 'enrichment'],
    },
  ],
  skills: [
    {
      name: 'find-verified-email',
      description:
        'Find a prospect verified work email from their name and company, or from a LinkedIn URL.',
      content:
        '# Find Verified Email\n\nUse Findymail to discover a deliverable work email for a prospect.\n\n## Steps\n1. If you have a name plus company domain, use Find Email From Name. If you have a LinkedIn profile URL, use Find Email From LinkedIn.\n2. Findymail verifies the email at discovery time, so the returned address is already checked for deliverability.\n3. Capture the contact name, email, and domain from the response.\n\n## Output\nReturn the verified email, the matched contact name, and the source company domain. If no email was found, say so clearly rather than guessing an address.',
    },
    {
      name: 'verify-email-list',
      description:
        'Run a list of email addresses through Findymail verification and split into deliverable and undeliverable.',
      content:
        '# Verify Email List\n\nUse Findymail to clean an email list before an outbound send.\n\n## Steps\n1. For each email address, run Verify Email.\n2. Read the verified flag and the detected provider for each result.\n3. Partition the list into deliverable addresses and undeliverable ones.\n\n## Output\nReturn two lists: deliverable emails (with provider) and undeliverable emails. Include a short summary count so the caller knows how many were removed.',
    },
    {
      name: 'map-company-team',
      description:
        'Given a company domain, find employees by job title and enrich the company profile into a team map.',
      content:
        '# Map Company Team\n\nUse Findymail to build an org map for a target account.\n\n## Steps\n1. Use Get Company Info on the domain to pull industry, size, and description.\n2. Use Find Employees with the company website and a list of target job titles to pull matching people.\n3. Optionally find each contact verified email or phone for the highest-priority roles.\n\n## Output\nReturn the company profile plus a list of employees (name, job title, LinkedIn URL, and email where available), grouped by function so the account team can see the buying committee.',
    },
    {
      name: 'enrich-from-email',
      description:
        'Reverse-lookup an email address with Findymail to recover the full LinkedIn profile and current company.',
      content:
        '# Enrich From Email\n\nUse Findymail to turn a bare email address into a full contact record.\n\n## Steps\n1. Run Reverse Email Lookup on the email, requesting the full profile.\n2. Pull the full name, headline, job title, location, current company, and profile details.\n3. Optionally call Get Company Info on the recovered company domain for firmographics.\n\n## Output\nReturn a structured contact record: name, title, company, location, LinkedIn URL, and the original email. Note any fields the lookup could not resolve.',
    },
  ],
} as const satisfies BlockMeta