feat(harmonic): add the missing people endpoints and fix two error paths

Extends the integration from 4 to 13 tools, covering every non-deprecated
people-scoped Harmonic endpoint, and repairs two defects found by validating
the existing tools against Harmonic's OpenAPI and API reference.

New tools:
- Enrich Person (POST /persons) — the only path from a LinkedIn URL or email
  a workflow already holds to a Harmonic contact.
- Get Person, Get Company Employees — account-based sourcing; employees returns
  URNs that chain into Batch Get People.
- Saved-search net-new results and their acknowledgement, so a monitor stops
  reprocessing the entire result set on every poll.
- Bulk email enrichment: submit, poll, and quota, plus Get Enrichment Status.

Fixes:
- The error extractor dropped Harmonic's string and object `detail` envelopes.
  A tool that names an extractor gets no fallback chain, so every FastAPI abort
  surfaced as "Request failed with status 403". The enrichment 404 also carries
  the scheduled `enrichment_urn`, which was being discarded — that URN is the
  only handle on the job, so it is now kept in the message.
- The saved-search selector failed the whole dropdown instead of degrading:
  the response cap was half the sibling value on an endpoint that is
  unpaginated and returns every saved search with its full query object, and
  the option ceiling threw rather than truncating. Raised to 1MB and switched
  to truncate-and-warn, matching the other data-driven selectors.

Clearing net-new results now requires an explicit scope. Harmonic treats an
absent `entity_urns` as "clear everything", so an empty field would have
silently discarded the backlog.

Scope deliberately excludes company-side, deal, typeahead, network, and Scout
streaming endpoints, and every endpoint retiring on 2026-11-05.

Author: waleedlatif1

apps/docs/content/docs/en/integrations/harmonic.mdx

@@ -293,7 +293,7 @@ describe('POST /api/tools/harmonic/saved-searches', () => {
     mockFetch
       .mockResolvedValueOnce(providerResponse('{not-json'))
       .mockResolvedValueOnce(
-        providerResponse('[]', 200, { 'content-length': String(512 * 1024 + 1) })
+        providerResponse('[]', 200, { 'content-length': String(1024 * 1024 + 1) })
       )
 
     for (let requestNumber = 0; requestNumber < 2; requestNumber++) {
@@ -324,18 +324,20 @@ describe('POST /api/tools/harmonic/saved-searches', () => {
     expect(body.savedSearches).toHaveLength(HARMONIC_SAVED_SEARCH_SELECTOR_MAX_OPTIONS)
   })
 
-  it('fails instead of silently truncating more than the option ceiling', async () => {
+  it('truncates to the option ceiling instead of failing the whole selector', async () => {
     mockFetch.mockResolvedValueOnce(
       providerResponse(
-        Array.from({ length: HARMONIC_SAVED_SEARCH_SELECTOR_MAX_OPTIONS + 1 }, (_, index) =>
+        Array.from({ length: HARMONIC_SAVED_SEARCH_SELECTOR_MAX_OPTIONS + 25 }, (_, index) =>
           peopleSearch(index + 1)
         )
       )
     )
 
     const response = await POST(request(REQUEST_BODY), {})
+    const body = await json(response)
 
-    expect(response.status).toBe(502)
+    expect(response.status).toBe(200)
+    expect(body.savedSearches).toHaveLength(HARMONIC_SAVED_SEARCH_SELECTOR_MAX_OPTIONS)
   })
 
   it.each([

apps/sim/app/api/tools/harmonic/saved-searches/route.test.ts

@@ -22,7 +22,7 @@ export const dynamic = 'force-dynamic'
 const logger = createLogger('HarmonicSavedSearchesAPI')
 const HARMONIC_SAVED_SEARCHES_URL = 'https://api.harmonic.ai/savedSearches'
 const SELECTOR_REQUEST_MAX_BYTES = 8 * 1024
-const PROVIDER_RESPONSE_MAX_BYTES = 512 * 1024
+const PROVIDER_RESPONSE_MAX_BYTES = 1024 * 1024
 const PROVIDER_RESPONSE_MAX_ROWS = 2_000
 const PROVIDER_FETCH_TIMEOUT_MS = 10_000
 
@@ -116,7 +116,16 @@ function normalizeSavedSearches(value: unknown): SavedSearchOption[] {
     }
     if (existingByUrn) continue
     if (byUrn.size >= HARMONIC_SAVED_SEARCH_SELECTOR_MAX_OPTIONS) {
-      throw new Error('Harmonic returned too many people saved searches')
+      /**
+       * `GET /savedSearches` is unpaginated, so this ceiling bounds customer data
+       * rather than a provider catalog. Every sibling selector with a data-driven
+       * bound truncates and warns; failing here would leave the dropdown dead with
+       * no in-place recovery.
+       */
+      logger.warn('Harmonic saved-search list hit the option ceiling; list may be incomplete', {
+        cap: HARMONIC_SAVED_SEARCH_SELECTOR_MAX_OPTIONS,
+      })
+      break
     }
     byUrn.set(option.urn, option)
     urnById.set(option.id, option.urn)

apps/sim/app/api/tools/harmonic/saved-searches/route.ts

@@ -21,9 +21,18 @@ describe('HarmonicBlock', () => {
   it('maps every dropdown operation onto exactly one registered tool', () => {
     expect(operationIds).toEqual([
       'harmonic_search_people_scout',
+      'harmonic_enrich_person',
+      'harmonic_get_person',
+      'harmonic_batch_get_people',
+      'harmonic_get_company_employees',
       'harmonic_list_people_saved_searches',
       'harmonic_get_people_saved_search_results',
-      'harmonic_batch_get_people',
+      'harmonic_get_people_saved_search_net_new_results',
+      'harmonic_clear_people_saved_search_net_new_results',
+      'harmonic_submit_email_enrichment_job',
+      'harmonic_get_email_enrichment_job',
+      'harmonic_get_email_enrichment_usage',
+      'harmonic_get_enrichment_status',
     ])
     expect(operationIds.map((id) => selectTool({ operation: id }))).toEqual(operationIds)
     expect(new Set(operationIds)).toEqual(new Set(HarmonicBlock.tools.access))
@@ -133,11 +142,39 @@ describe('HarmonicBlock', () => {
         description: 'Reusable Harmonic team API-key credential',
       },
       query: { type: 'string', description: 'Natural-language Harmonic Scout people query' },
+      linkedinUrl: { type: 'string', description: 'LinkedIn profile URL to enrich' },
+      email: { type: 'string', description: 'Email address used as an enrichment fallback' },
+      personId: { type: 'string', description: 'Harmonic person ID or full person URN' },
+      companyContextUrns: {
+        type: 'array',
+        description: 'Company URNs scoping the returned experience context',
+      },
+      companyId: { type: 'string', description: 'Harmonic company ID or full company URN' },
+      employeeGroupType: { type: 'string', description: 'Employee role group filter' },
+      employeeStatus: { type: 'string', description: 'Employment status filter' },
+      userConnectionStatus: { type: 'string', description: 'Team or user connection filter' },
       savedSearchId: { type: 'string', description: 'People saved-search ID or full URN' },
+      newResultsSince: {
+        type: 'string',
+        description: 'UTC cutoff for net-new saved-search matches',
+      },
       personIds: { type: 'array', description: 'Numeric Harmonic person IDs to retrieve' },
-      personUrns: { type: 'array', description: 'Harmonic person URNs to retrieve' },
-      size: { type: 'number', description: 'Saved-search page size, clamped to 1-100' },
-      cursor: { type: 'string', description: 'Opaque saved-search pagination cursor' },
+      personUrns: {
+        type: 'array',
+        description: 'Harmonic person URNs to retrieve or acknowledge',
+      },
+      personLinkedinUrls: {
+        type: 'array',
+        description: 'LinkedIn profile URLs to submit for email enrichment',
+      },
+      clearScope: {
+        type: 'string',
+        description: 'Whether to clear only the listed person URNs or every net-new result',
+      },
+      jobId: { type: 'string', description: 'Harmonic email enrichment job ID' },
+      enrichmentUrns: { type: 'array', description: 'Harmonic enrichment URNs to check' },
+      size: { type: 'number', description: 'Page size, clamped to 1-100' },
+      cursor: { type: 'string', description: 'Opaque pagination cursor' },
     })
   })
 
@@ -253,6 +290,7 @@ describe('HarmonicBlock', () => {
       new Set([
         'harmonic_search_people_scout',
         'harmonic_get_people_saved_search_results',
+        'harmonic_get_people_saved_search_net_new_results',
         'harmonic_batch_get_people',
       ])
     )