feat(harmonic): add contact workflow integration (#6902)

* feat(harmonic): add contact workflow integration

* fix(harmonic): sync docs manifest

* fix(harmonic): address integration review findings

* 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.

---------

Co-authored-by: Bill Leoutsakos <billleoutsakos@Bills-MacBook-Pro.local>
Co-authored-by: Waleed Latif <walif6@gmail.com>

Author: 3 people

apps/docs/components/icons.tsx

@@ -563,6 +563,28 @@ export function ChartBarIcon(props: SVGProps<SVGSVGElement>) {
   )
 }
 
+export function HarmonicIcon(props: SVGProps<SVGSVGElement>) {
+  return (
+    <svg {...props} viewBox='0 1 26 30.1' fill='none' role='img' xmlns='http://www.w3.org/2000/svg'>
+      {/** svg-path-precision-exception: Preserves Harmonic's supplied brand-mark coordinates. */}
+      <path
+        d='M6.49743 1.08252L12.9949 4.83381V12.3364L6.49743 16.0877L0 12.3364V4.83381L6.49743 1.08252Z'
+        fill='#FE5D45'
+      />
+      {/** svg-path-precision-exception: Preserves Harmonic's supplied brand-mark coordinates. */}
+      <path
+        d='M6.49743 16.0874L12.9949 19.8387V27.3413L6.49743 31.0926L0 27.3413V19.8387L6.49743 16.0874Z'
+        fill='#FE5D45'
+      />
+      {/** svg-path-precision-exception: Preserves Harmonic's supplied brand-mark coordinates. */}
+      <path
+        d='M19.5026 8.58496L26 12.3363V19.8388L19.5026 23.5901L13.0051 19.8388V12.3363L19.5026 8.58496Z'
+        fill='#FE5D45'
+      />
+    </svg>
+  )
+}
+
 export function HubspotIcon(props: SVGProps<SVGSVGElement>) {
   return (
     <svg

apps/docs/components/ui/icon-mapping.ts

@@ -113,6 +113,7 @@ import {
   GranolaIcon,
   GreenhouseIcon,
   GreptileIcon,
+  HarmonicIcon,
   HexIcon,
   HubspotIcon,
   HuggingFaceIcon,
@@ -395,6 +396,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   granola: GranolaIcon,
   greenhouse: GreenhouseIcon,
   greptile: GreptileIcon,
+  harmonic: HarmonicIcon,
   hex: HexIcon,
   hubspot: HubspotIcon,
   huggingface: HuggingFaceIcon,

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

@@ -115,6 +115,7 @@
     "granola",
     "greenhouse",
     "greptile",
+    "harmonic",
     "hex",
     "hubspot",
     "hubspot-service-account",