chore: import upstream snapshot with attribution

apps/sim/tools/apollo/people_search.ts

@@ -0,0 +1,189 @@
+import type { ApolloPeopleSearchParams, ApolloPeopleSearchResponse } from '@/tools/apollo/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const apolloPeopleSearchTool: ToolConfig<
+  ApolloPeopleSearchParams,
+  ApolloPeopleSearchResponse
+> = {
+  id: 'apollo_people_search',
+  name: 'Apollo People Search',
+  description: "Search Apollo's database for people using demographic filters",
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Apollo API key',
+    },
+    person_titles: {
+      type: 'array',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Job titles to search for (e.g., ["CEO", "VP of Sales"])',
+    },
+    include_similar_titles: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Whether to return people with job titles similar to person_titles',
+    },
+    person_locations: {
+      type: 'array',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Locations to search in (e.g., ["San Francisco, CA", "New York, NY"])',
+    },
+    person_seniorities: {
+      type: 'array',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Seniority levels (one of: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern)',
+    },
+    organization_ids: {
+      type: 'array',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Apollo organization IDs to filter by (e.g., ["5e66b6381e05b4008c8331b8"])',
+    },
+    organization_names: {
+      type: 'array',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Company names to search within (legacy filter)',
+    },
+    organization_locations: {
+      type: 'array',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        "Headquarters locations of the people's current employer (e.g., ['texas', 'tokyo', 'spain'])",
+    },
+    q_organization_domains_list: {
+      type: 'array',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Employer domain names (e.g., ["apollo.io", "microsoft.com"]) — up to 1,000, no www. or @',
+    },
+    organization_num_employees_ranges: {
+      type: 'array',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Employee count ranges for the person\'s current employer. Each entry is "min,max" (e.g., ["1,10", "250,500", "10000,20000"])',
+    },
+    contact_email_status: {
+      type: 'array',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Email statuses to filter by: "verified", "unverified", "likely to engage", "unavailable"',
+    },
+    q_keywords: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Keywords to search for',
+    },
+    page: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Page number for pagination, default 1 (e.g., 1, 2, 3)',
+    },
+    per_page: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Results per page, default 25, max 100 (e.g., 25, 50, 100)',
+    },
+  },
+
+  request: {
+    url: 'https://api.apollo.io/api/v1/mixed_people/search',
+    method: 'POST',
+    headers: (params: ApolloPeopleSearchParams) => ({
+      'Content-Type': 'application/json',
+      'Cache-Control': 'no-cache',
+      'X-Api-Key': params.apiKey,
+    }),
+    body: (params: ApolloPeopleSearchParams) => {
+      const body: Record<string, unknown> = {
+        page: params.page || 1,
+        per_page: Math.min(params.per_page || 25, 100),
+      }
+
+      if (params.person_titles && params.person_titles.length > 0) {
+        body.person_titles = params.person_titles
+      }
+      if (params.include_similar_titles !== undefined) {
+        body.include_similar_titles = params.include_similar_titles
+      }
+      if (params.person_locations && params.person_locations.length > 0) {
+        body.person_locations = params.person_locations
+      }
+      if (params.person_seniorities && params.person_seniorities.length > 0) {
+        body.person_seniorities = params.person_seniorities
+      }
+      if (params.organization_ids && params.organization_ids.length > 0) {
+        body.organization_ids = params.organization_ids
+      }
+      if (params.organization_names && params.organization_names.length > 0) {
+        body.organization_names = params.organization_names
+      }
+      if (params.organization_locations && params.organization_locations.length > 0) {
+        body.organization_locations = params.organization_locations
+      }
+      if (params.q_organization_domains_list && params.q_organization_domains_list.length > 0) {
+        body.q_organization_domains_list = params.q_organization_domains_list
+      }
+      if (
+        params.organization_num_employees_ranges &&
+        params.organization_num_employees_ranges.length > 0
+      ) {
+        body.organization_num_employees_ranges = params.organization_num_employees_ranges
+      }
+      if (params.contact_email_status && params.contact_email_status.length > 0) {
+        body.contact_email_status = params.contact_email_status
+      }
+      if (params.q_keywords) {
+        body.q_keywords = params.q_keywords
+      }
+
+      return body
+    },
+  },
+
+  transformResponse: async (response: Response) => {
+    if (!response.ok) {
+      const errorText = await response.text()
+      throw new Error(`Apollo API error: ${response.status} - ${errorText}`)
+    }
+
+    const data = await response.json()
+
+    // The legacy /mixed_people/search endpoint nests pagination under `pagination`,
+    // while api_search returns these top-level. Read both shapes defensively.
+    const pagination = data.pagination ?? {}
+
+    return {
+      success: true,
+      output: {
+        people: data.people || [],
+        page: pagination.page ?? data.page ?? 1,
+        per_page: pagination.per_page ?? data.per_page ?? 25,
+        total_entries: pagination.total_entries ?? data.total_entries ?? 0,
+      },
+    }
+  },
+
+  outputs: {
+    people: { type: 'json', description: 'Array of people matching the search criteria' },
+    page: { type: 'number', description: 'Current page number' },
+    per_page: { type: 'number', description: 'Results per page' },
+    total_entries: { type: 'number', description: 'Total matching entries' },
+  },
+}