@tangle-network/agent-integrations 0.40.0 → 0.41.0

package/dist/{chunk-4TI3WXAD.js → chunk-COKK7BOH.js}

@@ -12,7 +12,7 @@ import {
   TangleIdentityUnreachableError,
   createTangleIdentityClient,
   tangleIdentity
-} from "./chunk-OMLQCESJ.js";
+} from "./chunk-EQB46PIG.js";
 import {
   __export
 } from "./chunk-PZ5AY32C.js";
@@ -28,6 +28,7 @@ __export(adapters_exports, {
   activecampaignConnector: () => activecampaignConnector,
   acumbamailConnector: () => acumbamailConnector,
   adobeCreativeCloudConnector: () => adobeCreativeCloudConnector,
+  adpConnector: () => adpConnector,
   afforaiConnector: () => afforaiConnector,
   agentxConnector: () => agentxConnector,
   aidbaseConnector: () => aidbaseConnector,
@@ -106,6 +107,7 @@ __export(adapters_exports, {
   chatwootConnector: () => chatwootConnector,
   checkoutConnector: () => checkoutConnector,
   circleConnector: () => circleConnector,
+  clayConnector: () => clayConnector,
   clearoutConnector: () => clearoutConnector,
   clicdataConnector: () => clicdataConnector,
   clickupConnector: () => clickupConnector,
@@ -117,6 +119,7 @@ __export(adapters_exports, {
   cloudinaryConnector: () => cloudinaryConnector,
   cloutlyConnector: () => cloutlyConnector,
   codaConnector: () => codaConnector,
+  cognismConnector: () => cognismConnector,
   cognitoFormsConnector: () => cognitoFormsConnector,
   cohereConnector: () => cohereConnector,
   cometapiConnector: () => cometapiConnector,
@@ -363,6 +366,7 @@ __export(adapters_exports, {
   paperformConnector: () => paperformConnector,
   parseurConnector: () => parseurConnector,
   pastefyConnector: () => pastefyConnector,
+  paychexConnector: () => paychexConnector,
   paywhirlConnector: () => paywhirlConnector,
   pdfmonkeyConnector: () => pdfmonkeyConnector,
   peekshotConnector: () => peekshotConnector,
@@ -412,6 +416,7 @@ __export(adapters_exports, {
   scrapegraphaiConnector: () => scrapegraphaiConnector,
   scrapelessConnector: () => scrapelessConnector,
   seekTableConnector: () => seekTableConnector,
+  semrushConnector: () => semrushConnector,
   sendgridConnector: () => sendgridConnector,
   sendinblueConnector: () => sendinblueConnector,
   sendpulseConnector: () => sendpulseConnector,
@@ -425,6 +430,7 @@ __export(adapters_exports, {
   shortIoConnector: () => shortIoConnector,
   signNowConnector: () => signNowConnector,
   signrequestConnector: () => signrequestConnector,
+  similarwebConnector: () => similarwebConnector,
   simplirouteConnector: () => simplirouteConnector,
   simplybookmeConnector: () => simplybookmeConnector,
   skyprepConnector: () => skyprepConnector,
@@ -514,6 +520,7 @@ __export(adapters_exports, {
   zohoBookingsConnector: () => zohoBookingsConnector,
   zohoCrmConnector: () => zohoCrmConnector,
   zohoDeskConnector: () => zohoDeskConnector,
+  zoominfoConnector: () => zoominfoConnector,
   zuoraConnector: () => zuoraConnector
 });
 
@@ -2295,12 +2302,13 @@ function declarativeRestConnector(spec) {
     async test(source) {
       if (!spec.test) return { ok: true };
       try {
-        await executeRestRequest(spec, spec.test, {
+        const response = await executeRestRequest(spec, spec.test, {
           source,
           capabilityName: "__test__",
           args: {},
           idempotencyKey: "test"
         });
+        validateTestResponse(spec, spec.test, response.data);
         return { ok: true };
       } catch (error) {
         return { ok: false, reason: error instanceof Error ? error.message : "unknown error" };
@@ -2309,6 +2317,25 @@ function declarativeRestConnector(spec) {
   };
   return adapter;
 }
+function validateTestResponse(spec, test, data) {
+  const expectations = Array.isArray(test.expectResponse) ? test.expectResponse : test.expectResponse ? [test.expectResponse] : [];
+  for (const expectation of expectations) {
+    const actual = readPathFromUnknown(data, expectation.path);
+    if (!isJsonEqual(actual, expectation.equals)) {
+      throw new Error(
+        `${spec.displayName} test response expected ${expectation.path}=${formatValue(expectation.equals)}, got ${formatValue(actual)}`
+      );
+    }
+  }
+}
+function isJsonEqual(left, right) {
+  if (Object.is(left, right)) return true;
+  return JSON.stringify(left) === JSON.stringify(right);
+}
+function formatValue(value) {
+  if (value === void 0) return "undefined";
+  return JSON.stringify(value);
+}
 function operationToCapability(op) {
   const base = {
     name: op.name,
@@ -2461,6 +2488,14 @@ function readPath(input, path) {
     return void 0;
   }, input);
 }
+function readPathFromUnknown(input, path) {
+  return path.split(".").reduce((value, part) => {
+    if (value && typeof value === "object" && part in value) {
+      return value[part];
+    }
+    return void 0;
+  }, input);
+}
 async function safeErrorText(res) {
   return await res.text().catch(() => res.statusText) || res.statusText;
 }
@@ -47997,7 +48032,11 @@ var apolloConnector = declarativeRestConnector({
     "content-type": "application/json",
     "cache-control": "no-cache"
   },
-  test: { method: "GET", path: "/api/v1/auth/health" },
+  test: {
+    method: "GET",
+    path: "/api/v1/auth/health",
+    expectResponse: { path: "is_logged_in", equals: true }
+  },
   capabilities: [
     {
       name: "match.person",
@@ -48262,6 +48301,1532 @@ var apolloConnector = declarativeRestConnector({
   ]
 });
 
+// src/connectors/adapters/similarweb.ts
+var similarwebConnector = declarativeRestConnector({
+  kind: "similarweb",
+  displayName: "Similarweb",
+  description: "Market intelligence on any website: estimated traffic and engagement, global/country/category rank, traffic sources, geography, similar sites, audience interests, and search keywords via the Similarweb Digital Marketing Intelligence API.",
+  auth: {
+    kind: "api-key",
+    hint: "Similarweb API key from Account \u2192 API Management. Sent as the `api_key` query parameter on every request."
+  },
+  category: "market-intelligence",
+  defaultConsistencyModel: "cache",
+  baseUrl: "https://api.similarweb.com",
+  credentialPlacement: { kind: "query", parameter: "api_key" },
+  // `/capabilities` is free (no data-credit cost) and proves the key is valid.
+  test: { method: "GET", path: "/capabilities" },
+  capabilities: [
+    {
+      name: "rank.global",
+      class: "read",
+      description: "Similarweb Global Rank for a domain (estimated monthly unique visitors and pageviews, desktop + mobile). Lower is more popular.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          start_date: { type: "string", description: "Inclusive start month, YYYY-MM." },
+          end_date: { type: "string", description: "Inclusive end month, YYYY-MM." },
+          main_domain_only: { type: "boolean", description: "Exclude subdomains (default false)." }
+        },
+        required: ["domain"]
+      },
+      request: {
+        method: "GET",
+        path: "/v1/website/{domain}/global-rank/global-rank",
+        query: { start_date: "{start_date}", end_date: "{end_date}", main_domain_only: "{main_domain_only}" }
+      }
+    },
+    {
+      name: "rank.country",
+      class: "read",
+      description: "Monthly rank of a domain within a single country.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: "Lowercase ISO 3166-1 alpha-2 code, e.g. us." },
+          start_date: { type: "string", description: "Inclusive start month, YYYY-MM." },
+          end_date: { type: "string", description: "Inclusive end month, YYYY-MM." },
+          main_domain_only: { type: "boolean" }
+        },
+        required: ["domain", "country"]
+      },
+      request: {
+        method: "GET",
+        path: "/v1/website/{domain}/country-rank/country-rank",
+        query: {
+          country: "{country}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}"
+        }
+      }
+    },
+    {
+      name: "rank.category",
+      class: "read",
+      description: "Industry/category rank for a domain relative to its category globally (latest value; no date range).",
+      parameters: {
+        type: "object",
+        properties: { domain: { type: "string", description: "Bare host, e.g. cnn.com." } },
+        required: ["domain"]
+      },
+      request: { method: "GET", path: "/v1/website/{domain}/category-rank/category-rank" }
+    },
+    {
+      name: "total-traffic.visits",
+      class: "read",
+      description: "Estimated total visits (desktop + mobile combined) for a domain over a date range.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          granularity: { type: "string", description: "daily | weekly | monthly." },
+          start_date: { type: "string", description: "Inclusive start month, YYYY-MM." },
+          end_date: { type: "string", description: "Inclusive end month, YYYY-MM." },
+          main_domain_only: { type: "boolean" },
+          show_verified: { type: "boolean", description: "Surface shared Google Analytics data when available." }
+        },
+        required: ["domain", "country", "granularity"]
+      },
+      request: {
+        method: "GET",
+        path: "/v1/website/{domain}/total-traffic-and-engagement/visits",
+        query: {
+          country: "{country}",
+          granularity: "{granularity}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}",
+          show_verified: "{show_verified}"
+        }
+      }
+    },
+    {
+      name: "total-traffic.pages-per-visit",
+      class: "read",
+      description: "Average pages per visit (desktop + mobile combined).",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          granularity: { type: "string", description: "daily | weekly | monthly." },
+          start_date: { type: "string", description: "YYYY-MM." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          main_domain_only: { type: "boolean" }
+        },
+        required: ["domain", "country", "granularity"]
+      },
+      request: {
+        method: "GET",
+        path: "/v1/website/{domain}/total-traffic-and-engagement/pages-per-visit",
+        query: {
+          country: "{country}",
+          granularity: "{granularity}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}"
+        }
+      }
+    },
+    {
+      name: "total-traffic.average-visit-duration",
+      class: "read",
+      description: "Average visit duration in seconds (desktop + mobile combined).",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          granularity: { type: "string", description: "daily | weekly | monthly." },
+          start_date: { type: "string", description: "YYYY-MM." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          main_domain_only: { type: "boolean" }
+        },
+        required: ["domain", "country", "granularity"]
+      },
+      request: {
+        method: "GET",
+        path: "/v1/website/{domain}/total-traffic-and-engagement/average-visit-duration",
+        query: {
+          country: "{country}",
+          granularity: "{granularity}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}"
+        }
+      }
+    },
+    {
+      name: "total-traffic.bounce-rate",
+      class: "read",
+      description: "Bounce rate (desktop + mobile combined) over a date range.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          granularity: { type: "string", description: "daily | weekly | monthly." },
+          start_date: { type: "string", description: "YYYY-MM." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          main_domain_only: { type: "boolean" }
+        },
+        required: ["domain", "country", "granularity"]
+      },
+      request: {
+        method: "GET",
+        path: "/v1/website/{domain}/total-traffic-and-engagement/bounce-rate",
+        query: {
+          country: "{country}",
+          granularity: "{granularity}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}"
+        }
+      }
+    },
+    {
+      name: "desktop-traffic.visits",
+      class: "read",
+      description: "Estimated desktop-only visits for a domain. Supports a US state filter when country=us.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          granularity: { type: "string", description: "daily | weekly | monthly." },
+          start_date: { type: "string", description: "YYYY-MM." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          state: { type: "string", description: "US state filter, valid only when country=us." },
+          main_domain_only: { type: "boolean" }
+        },
+        required: ["domain", "country", "granularity"]
+      },
+      request: {
+        method: "GET",
+        path: "/v1/website/{domain}/traffic-and-engagement/visits",
+        query: {
+          country: "{country}",
+          granularity: "{granularity}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          state: "{state}",
+          main_domain_only: "{main_domain_only}"
+        }
+      }
+    },
+    {
+      name: "traffic-sources.overview-share",
+      class: "read",
+      description: "Share of visits by marketing channel (direct, search, social, referrals, mail, display, paid) over time.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          granularity: { type: "string", description: "daily | weekly | monthly." },
+          start_date: { type: "string", description: "YYYY-MM." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          main_domain_only: { type: "boolean" }
+        },
+        required: ["domain", "country", "granularity"]
+      },
+      request: {
+        method: "GET",
+        path: "/v1/website/{domain}/traffic-sources/overview-share",
+        query: {
+          country: "{country}",
+          granularity: "{granularity}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}"
+        }
+      }
+    },
+    {
+      name: "traffic-sources.referrals",
+      class: "read",
+      description: "Top referring websites sending traffic to a domain: traffic share per referrer and total referral visits.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          start_date: { type: "string", description: "YYYY-MM." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          main_domain_only: { type: "boolean" },
+          limit: { type: "integer", description: "Max rows (default 100)." },
+          offset: { type: "integer" }
+        },
+        required: ["domain", "country"]
+      },
+      request: {
+        method: "GET",
+        path: "/v4/website/{domain}/traffic-sources/referrals",
+        query: {
+          country: "{country}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}",
+          limit: "{limit}",
+          offset: "{offset}"
+        }
+      }
+    },
+    {
+      name: "traffic-sources.social",
+      class: "read",
+      description: "Leading social networks sending traffic to a domain: traffic share per network and social visits.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          start_date: { type: "string", description: "YYYY-MM." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          main_domain_only: { type: "boolean" },
+          limit: { type: "integer" },
+          offset: { type: "integer" }
+        },
+        required: ["domain", "country"]
+      },
+      request: {
+        method: "GET",
+        path: "/v4/website/{domain}/traffic-sources/social",
+        query: {
+          country: "{country}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}",
+          limit: "{limit}",
+          offset: "{offset}"
+        }
+      }
+    },
+    {
+      name: "geo.traffic-by-country",
+      class: "read",
+      description: "Distribution of a domain\u2019s traffic across countries: per-country traffic share, visits, pages/visit, average duration, bounce rate, and rank.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          start_date: { type: "string", description: "YYYY-MM." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          main_domain_only: { type: "boolean" },
+          limit: { type: "integer" },
+          offset: { type: "integer" }
+        },
+        required: ["domain"]
+      },
+      request: {
+        method: "GET",
+        path: "/v4/website/{domain}/geo/traffic-by-country",
+        query: {
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}",
+          limit: "{limit}",
+          offset: "{offset}"
+        }
+      }
+    },
+    {
+      name: "audience.similar-sites",
+      class: "read",
+      description: "Up to 40 websites most similar to a domain, with a similarity score per site. No date or country params.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          limit: { type: "integer", description: "Max similar sites (max 40)." }
+        },
+        required: ["domain"]
+      },
+      request: {
+        method: "GET",
+        path: "/v4/website/{domain}/similar-sites/similarsites",
+        query: { limit: "{limit}" }
+      }
+    },
+    {
+      name: "audience.also-visited",
+      class: "read",
+      description: "Other websites visited by the same audience (desktop + mobile): affinity score and audience overlap. Useful for competitive/adjacency analysis.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          start_date: { type: "string", description: "YYYY-MM." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          main_domain_only: { type: "boolean" },
+          limit: { type: "integer" },
+          offset: { type: "integer" }
+        },
+        required: ["domain", "country", "start_date", "end_date"]
+      },
+      request: {
+        method: "GET",
+        path: "/v4/website/{domain}/total-audience-interests/also-visited",
+        query: {
+          country: "{country}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}",
+          limit: "{limit}",
+          offset: "{offset}"
+        }
+      }
+    },
+    {
+      name: "keywords.website-keywords",
+      class: "read",
+      description: "Search keywords driving clicks to a domain (Similarweb Search 3.0). Filter by traffic_source (Organic/Paid/All) and web_source (Desktop/MobileWeb/Total). The domain is passed as the `URL` query parameter.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com (sent as the URL query param)." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          start_date: { type: "string", description: "YYYY-MM (defaults to ~last 28 days if omitted)." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          traffic_source: { type: "string", description: "Organic | Paid | All." },
+          web_source: { type: "string", description: "Desktop | MobileWeb | Total." },
+          limit: { type: "integer" },
+          offset: { type: "integer" }
+        },
+        required: ["domain", "country"]
+      },
+      request: {
+        method: "GET",
+        path: "/v4/website-analysis/keywords",
+        query: {
+          URL: "{domain}",
+          country: "{country}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          traffic_source: "{traffic_source}",
+          web_source: "{web_source}",
+          limit: "{limit}",
+          offset: "{offset}"
+        }
+      }
+    },
+    {
+      name: "lead-enrichment",
+      class: "read",
+      description: "Firmographics plus website traffic and engagement for a domain in one call (Similarweb Lead Enrichment). Up to 12 months of history; set show_verified to surface shared Google Analytics data.",
+      parameters: {
+        type: "object",
+        properties: {
+          domain: { type: "string", description: "Bare host, e.g. cnn.com." },
+          country: { type: "string", description: 'Lowercase ISO alpha-2 code or "world".' },
+          start_date: { type: "string", description: "YYYY-MM." },
+          end_date: { type: "string", description: "YYYY-MM." },
+          main_domain_only: { type: "boolean" },
+          show_verified: { type: "boolean" }
+        },
+        required: ["domain", "country", "start_date", "end_date"]
+      },
+      request: {
+        method: "GET",
+        path: "/v1/website/{domain}/lead-enrichment/all",
+        query: {
+          country: "{country}",
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          main_domain_only: "{main_domain_only}",
+          show_verified: "{show_verified}"
+        }
+      }
+    }
+  ]
+});
+
+// src/connectors/adapters/semrush.ts
+var semrushConnector = declarativeRestConnector({
+  kind: "semrush",
+  displayName: "Semrush",
+  description: "Competitive SEO market intelligence: backlink profile (overview, links, referring domains/IPs, anchors, pages, authority-score trend) and keyword metrics via the Semrush v4 REST API.",
+  auth: {
+    kind: "api-key",
+    hint: "Semrush API key from Subscription info \u2192 API units. Sent as the `Authorization: Apikey <key>` header."
+  },
+  category: "market-intelligence",
+  defaultConsistencyModel: "cache",
+  baseUrl: "https://api.semrush.com",
+  credentialPlacement: { kind: "header", header: "Authorization", prefix: "Apikey " },
+  capabilities: [
+    {
+      name: "backlinks.overview",
+      class: "read",
+      description: "Aggregated backlink metrics for a target: total backlinks, referring domains, authority score, follow/nofollow split, referring IPs.",
+      parameters: {
+        type: "object",
+        properties: {
+          url: { type: "string", description: "Target host, subdomain, folder, or page, e.g. semrush.com." },
+          scope: {
+            type: "string",
+            description: "Which part of the URL to analyze: ROOT_DOMAIN | SUBDOMAIN | SUBFOLDER | PAGE."
+          },
+          fields: { type: "string", description: "Comma-separated subset of response fields (all by default)." }
+        },
+        required: ["url", "scope"]
+      },
+      request: {
+        method: "GET",
+        path: "/apis/v4/backlinks/v1/overview",
+        query: { url: "{url}", scope: "{scope}", fields: "{fields}" }
+      }
+    },
+    {
+      name: "backlinks.summary",
+      class: "read",
+      description: "Monthly historical trend of authority score, backlinks count, and referring domains. date_from/date_to are YYYY-MM.",
+      parameters: {
+        type: "object",
+        properties: {
+          url: { type: "string", description: "Target host/subdomain/folder/page." },
+          scope: { type: "string", description: "ROOT_DOMAIN | SUBDOMAIN | SUBFOLDER | PAGE." },
+          date_from: { type: "string", description: "Start month, YYYY-MM." },
+          date_to: { type: "string", description: "End month, YYYY-MM." },
+          fields: { type: "string" },
+          limit: { type: "integer" }
+        },
+        required: ["url", "scope"]
+      },
+      request: {
+        method: "GET",
+        path: "/apis/v4/backlinks/v1/summary",
+        query: {
+          url: "{url}",
+          scope: "{scope}",
+          date_from: "{date_from}",
+          date_to: "{date_to}",
+          fields: "{fields}",
+          limit: "{limit}"
+        }
+      }
+    },
+    {
+      name: "backlinks.links",
+      class: "read",
+      description: "Paginated list of individual backlinks: anchor text, source/target URLs, domain & page authority, follow/nofollow, first/last seen.",
+      parameters: {
+        type: "object",
+        properties: {
+          url: { type: "string" },
+          scope: { type: "string", description: "ROOT_DOMAIN | SUBDOMAIN | SUBFOLDER | PAGE." },
+          fields: { type: "string" },
+          order_by: { type: "string", description: "Field to sort by." },
+          direction: { type: "string", description: "ASC | DESC." },
+          limit: { type: "integer" },
+          offset: { type: "integer" },
+          filter: { type: "string", description: "Field-operator-value filter expression, e.g. is_follow=1." }
+        },
+        required: ["url", "scope"]
+      },
+      request: {
+        method: "GET",
+        path: "/apis/v4/backlinks/v1/links",
+        query: {
+          url: "{url}",
+          scope: "{scope}",
+          fields: "{fields}",
+          order_by: "{order_by}",
+          direction: "{direction}",
+          limit: "{limit}",
+          offset: "{offset}",
+          filter: "{filter}"
+        }
+      }
+    },
+    {
+      name: "backlinks.ref_domains",
+      class: "read",
+      description: "Referring domains with per-domain backlink counts, domain authority score, country, IP, and follow/new/lost status.",
+      parameters: {
+        type: "object",
+        properties: {
+          url: { type: "string" },
+          scope: { type: "string", description: "ROOT_DOMAIN | SUBDOMAIN | SUBFOLDER | PAGE." },
+          fields: { type: "string" },
+          order_by: { type: "string" },
+          direction: { type: "string" },
+          limit: { type: "integer" },
+          offset: { type: "integer" },
+          filter: { type: "string" }
+        },
+        required: ["url", "scope"]
+      },
+      request: {
+        method: "GET",
+        path: "/apis/v4/backlinks/v1/ref-domains",
+        query: {
+          url: "{url}",
+          scope: "{scope}",
+          fields: "{fields}",
+          order_by: "{order_by}",
+          direction: "{direction}",
+          limit: "{limit}",
+          offset: "{offset}",
+          filter: "{filter}"
+        }
+      }
+    },
+    {
+      name: "backlinks.ref_ips",
+      class: "read",
+      description: "Referring IP addresses with backlink count, referring-domain count, and country.",
+      parameters: {
+        type: "object",
+        properties: {
+          url: { type: "string" },
+          scope: { type: "string", description: "ROOT_DOMAIN | SUBDOMAIN | SUBFOLDER | PAGE." },
+          fields: { type: "string" },
+          order_by: { type: "string" },
+          direction: { type: "string" },
+          limit: { type: "integer" },
+          offset: { type: "integer" }
+        },
+        required: ["url", "scope"]
+      },
+      request: {
+        method: "GET",
+        path: "/apis/v4/backlinks/v1/ref-ips",
+        query: {
+          url: "{url}",
+          scope: "{scope}",
+          fields: "{fields}",
+          order_by: "{order_by}",
+          direction: "{direction}",
+          limit: "{limit}",
+          offset: "{offset}"
+        }
+      }
+    },
+    {
+      name: "backlinks.anchors",
+      class: "read",
+      description: "Backlink anchor texts with per-anchor backlink count, referring domains, and domain/page authority scores.",
+      parameters: {
+        type: "object",
+        properties: {
+          url: { type: "string" },
+          scope: { type: "string", description: "ROOT_DOMAIN | SUBDOMAIN | SUBFOLDER | PAGE." },
+          fields: { type: "string" },
+          order_by: { type: "string" },
+          direction: { type: "string" },
+          limit: { type: "integer" },
+          offset: { type: "integer" }
+        },
+        required: ["url", "scope"]
+      },
+      request: {
+        method: "GET",
+        path: "/apis/v4/backlinks/v1/anchors",
+        query: {
+          url: "{url}",
+          scope: "{scope}",
+          fields: "{fields}",
+          order_by: "{order_by}",
+          direction: "{direction}",
+          limit: "{limit}",
+          offset: "{offset}"
+        }
+      }
+    },
+    {
+      name: "backlinks.pages",
+      class: "read",
+      description: "Pages on the target domain that receive backlinks, with per-page backlink and referring-domain counts.",
+      parameters: {
+        type: "object",
+        properties: {
+          url: { type: "string" },
+          scope: { type: "string", description: "ROOT_DOMAIN | SUBDOMAIN | SUBFOLDER | PAGE." },
+          fields: { type: "string" },
+          order_by: { type: "string" },
+          direction: { type: "string" },
+          limit: { type: "integer" },
+          offset: { type: "integer" },
+          filter: { type: "string" }
+        },
+        required: ["url", "scope"]
+      },
+      request: {
+        method: "GET",
+        path: "/apis/v4/backlinks/v1/pages",
+        query: {
+          url: "{url}",
+          scope: "{scope}",
+          fields: "{fields}",
+          order_by: "{order_by}",
+          direction: "{direction}",
+          limit: "{limit}",
+          offset: "{offset}",
+          filter: "{filter}"
+        }
+      }
+    },
+    {
+      name: "backlinks.score_profile",
+      class: "read",
+      description: "Authority Score distribution of a target\u2019s backlink profile \u2014 the breakdown of backlink quality scores.",
+      parameters: {
+        type: "object",
+        properties: {
+          url: { type: "string" },
+          scope: { type: "string", description: "ROOT_DOMAIN | SUBDOMAIN | SUBFOLDER | PAGE." },
+          fields: { type: "string" }
+        },
+        required: ["url", "scope"]
+      },
+      request: {
+        method: "GET",
+        path: "/apis/v4/backlinks/v1/score-profile",
+        query: { url: "{url}", scope: "{scope}", fields: "{fields}" }
+      }
+    },
+    {
+      name: "backlinks.comparison",
+      class: "read",
+      description: "Compare the backlink profiles of up to 10 targets side by side. `urls` is comma-separated; scope here supports ROOT_DOMAIN | SUBDOMAIN | PAGE only (no SUBFOLDER).",
+      parameters: {
+        type: "object",
+        properties: {
+          urls: { type: "string", description: "Comma-separated list of up to 10 target URLs." },
+          scope: { type: "string", description: "ROOT_DOMAIN | SUBDOMAIN | PAGE." },
+          fields: { type: "string" }
+        },
+        required: ["urls", "scope"]
+      },
+      request: {
+        method: "GET",
+        path: "/apis/v4/backlinks/v1/comparison",
+        query: { urls: "{urls}", scope: "{scope}", fields: "{fields}" }
+      }
+    },
+    {
+      name: "keyword.metrics",
+      class: "read",
+      description: "Keyword metrics for a single keyword (Semrush v4 keyword surface): search volume, CPC, keyword difficulty, competition, trend, SERP features, and search intent.",
+      parameters: {
+        type: "object",
+        properties: {
+          keyword: { type: "string", description: "The keyword phrase to look up." },
+          country: { type: "string", description: "Database/country code, e.g. us, uk, de." },
+          month: { type: "string", description: "Optional month for the metric snapshot, YYYY-MM." }
+        },
+        required: ["keyword", "country"]
+      },
+      request: {
+        method: "GET",
+        path: "/apis/v4/keywords/v1/metrics",
+        query: { keyword: "{keyword}", country: "{country}", month: "{month}" }
+      }
+    }
+  ]
+});
+
+// src/connectors/adapters/cognism.ts
+var cognismConnector = declarativeRestConnector({
+  kind: "cognism",
+  displayName: "Cognism",
+  description: "B2B sales intelligence: search and enrich contacts and companies against the Cognism database, then redeem records for full contact data (emails, phones, firmographics).",
+  auth: {
+    kind: "api-key",
+    hint: "Cognism API token from Profile Settings \u2192 API. Sent as the `Authorization: Bearer <token>` header."
+  },
+  category: "sales-intelligence",
+  defaultConsistencyModel: "authoritative",
+  baseUrl: "https://app.cognism.com/api/search",
+  credentialPlacement: { kind: "bearer" },
+  capabilities: [
+    {
+      name: "contact.search",
+      class: "read",
+      description: "Search the Cognism contact database by persona/firmographic filters. Returns a preview list with data-presence flags and a redeemId per record (no PII). Free. Follow with contact.redeem to fetch full data.",
+      parameters: {
+        type: "object",
+        properties: {
+          filters: {
+            type: "object",
+            description: 'Search filter body, e.g. { jobTitles: ["CTO"], excludeJobTitles: ["CEO"], regions: ["EMEA"], countries: ["US"], emailQuality: { highPlus: true }, account: { names: ["Acme"] } }. All fields optional; pass {} to match broadly.'
+          },
+          lastReturnedKey: { type: "string", description: "Pagination cursor from a previous page (linear only)." },
+          indexSize: { type: "integer", description: "Page size, 20\u2013100 (default 20)." }
+        },
+        required: ["filters"]
+      },
+      request: {
+        method: "POST",
+        path: "/contact/search",
+        query: { lastReturnedKey: "{lastReturnedKey}", indexSize: "{indexSize}" },
+        body: "{filters}"
+      }
+    },
+    {
+      name: "contact.enrich",
+      class: "read",
+      description: "Match a single contact by known identifiers (email, linkedinUrl, domain, name + company). Returns one best-match preview with matchScore, data-presence flags, and a redeemId (no PII). Free. Follow with contact.redeem.",
+      parameters: {
+        type: "object",
+        properties: {
+          match: {
+            type: "object",
+            description: 'Identifier body, e.g. { email: "jane@acme.com", linkedinUrl: "...", domain: "acme.com", minMatchScore: 30, firstName, lastName, jobTitle, companyName }. At least one identifier recommended.'
+          }
+        },
+        required: ["match"]
+      },
+      request: { method: "POST", path: "/contact/enrich", body: "{match}" }
+    },
+    {
+      name: "contact.redeem",
+      class: "mutation",
+      description: "Fetch full contact profiles (email, mobile, direct dial, LinkedIn, seniority, \u2026) for redeemIds obtained from contact.search/contact.enrich. CONSUMES 1 credit per contact redeemed. 1\u201320 redeemIds per call.",
+      parameters: {
+        type: "object",
+        properties: {
+          redeemIds: {
+            type: "array",
+            items: { type: "string" },
+            description: "redeemId values from contact.search/contact.enrich (1\u201320)."
+          }
+        },
+        required: ["redeemIds"]
+      },
+      request: { method: "POST", path: "/contact/redeem", body: { redeemIds: "{redeemIds}" } },
+      cas: "native-idempotency",
+      externalEffect: true
+    },
+    {
+      name: "account.search",
+      class: "read",
+      description: "Search the Cognism company/account database by name, industry, location, size, revenue. Returns matching accounts with data-presence flags and redeemIds. Free. Follow with account.redeem.",
+      parameters: {
+        type: "object",
+        properties: {
+          filters: {
+            type: "object",
+            description: 'Account filter body, e.g. { names: ["Acme Corp"], industries: ["SaaS"], countries: ["US"], regions: ["EMEA"], employeeCount: {...}, revenue: {...} }. All fields optional.'
+          },
+          lastReturnedKey: { type: "string" },
+          indexSize: { type: "integer", description: "Page size, 20\u2013100." }
+        },
+        required: ["filters"]
+      },
+      request: {
+        method: "POST",
+        path: "/account/search",
+        query: { lastReturnedKey: "{lastReturnedKey}", indexSize: "{indexSize}" },
+        body: "{filters}"
+      }
+    },
+    {
+      name: "account.enrich",
+      class: "read",
+      description: "Match a company/account by domain, website, linkedinUrl, or name. Returns one best-match preview with data-presence flags and a redeemId. Free. Follow with account.redeem.",
+      parameters: {
+        type: "object",
+        properties: {
+          match: {
+            type: "object",
+            description: 'Identifier body, e.g. { domain: "cognism.com" } or { website, linkedinUrl, name }.'
+          }
+        },
+        required: ["match"]
+      },
+      request: { method: "POST", path: "/account/enrich", body: "{match}" }
+    },
+    {
+      name: "account.redeem",
+      class: "read",
+      description: "Fetch full company/account profiles (domain, revenue, employeeCount, industry, \u2026) for redeemIds from account.search/account.enrich. Free (account redeem does not consume credits).",
+      parameters: {
+        type: "object",
+        properties: {
+          redeemIds: {
+            type: "array",
+            items: { type: "string" },
+            description: "redeemId values from account.search/account.enrich."
+          }
+        },
+        required: ["redeemIds"]
+      },
+      request: { method: "POST", path: "/account/redeem", body: { redeemIds: "{redeemIds}" } }
+    }
+  ]
+});
+
+// src/connectors/adapters/clay.ts
+var clayConnector = {
+  manifest: {
+    kind: "clay",
+    displayName: "Clay",
+    description: "Push rows into a Clay table to trigger GTM enrichment workflows. Clay has no general REST API \u2014 this sends a JSON row to your table\u2019s inbound webhook URL; enriched results flow back out via Clay\u2019s HTTP API action (received through the clay webhook provider).",
+    auth: {
+      kind: "api-key",
+      hint: "Optional Clay table webhook token (x-clay-webhook-auth), shown once when you add a webhook source to a table. Leave blank if the table\u2019s webhook has no token. The per-table webhook URL goes in the connection metadata as `webhookUrl`."
+    },
+    category: "crm",
+    defaultConsistencyModel: "advisory",
+    capabilities: [
+      {
+        name: "push_row",
+        class: "mutation",
+        description: "Send a flat JSON object to the configured Clay table webhook URL, creating a new row. Keys map to table columns (no fixed schema). Processing is asynchronous \u2014 the response acknowledges receipt but does not return enriched data.",
+        cas: "native-idempotency",
+        externalEffect: true,
+        parameters: {
+          type: "object",
+          additionalProperties: true,
+          description: 'Flat JSON whose keys become Clay table columns, e.g. { "firstName": "Jane", "email": "jane@acme.com", "company": "Acme" }.'
+        }
+      }
+    ]
+  },
+  async executeMutation(inv) {
+    const url = readWebhookUrl(inv.source.metadata);
+    const body = JSON.stringify(inv.args ?? {});
+    const headers = { "content-type": "application/json" };
+    const token = clayToken(inv.source.credentials);
+    if (token) headers["x-clay-webhook-auth"] = token;
+    const res = await fetch(url, {
+      method: "POST",
+      headers,
+      body,
+      signal: AbortSignal.timeout(15e3)
+    });
+    if (res.status === 401 || res.status === 403) {
+      throw new CredentialsExpired(`Clay rejected the webhook token (${res.status})`, inv.source.id);
+    }
+    if (!res.ok) {
+      throw new Error(`clay push_row ${res.status}: ${(await res.text().catch(() => res.statusText)).slice(0, 200)}`);
+    }
+    const data = await res.json().catch(() => ({}));
+    return {
+      status: "committed",
+      data,
+      committedAt: Date.now(),
+      idempotentReplay: false
+    };
+  },
+  async test(source) {
+    try {
+      readWebhookUrl(source.metadata);
+      return { ok: true };
+    } catch (err) {
+      return { ok: false, reason: err instanceof Error ? err.message : String(err) };
+    }
+  }
+};
+function readWebhookUrl(metadata) {
+  const value = metadata.webhookUrl;
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error("clay DataSource.metadata.webhookUrl is missing");
+  }
+  return new URL(value).toString();
+}
+function clayToken(credentials) {
+  if (credentials.kind === "api-key" && credentials.apiKey) return credentials.apiKey;
+  return void 0;
+}
+
+// src/connectors/adapters/zoominfo.ts
+var zoominfoConnector = declarativeRestConnector({
+  kind: "zoominfo",
+  displayName: "ZoomInfo",
+  description: "Search and enrich contacts and companies, plus buyer-intent signals, business Scoops, and company news, via the ZoomInfo GTM Data API. Search is free; enrich consumes bulk-data credits.",
+  auth: {
+    kind: "oauth2",
+    authorizationUrl: "https://api.zoominfo.com/gtm/oauth/v1/authorize",
+    tokenUrl: "https://api.zoominfo.com/gtm/oauth/v1/token",
+    scopes: [
+      "api:data:contact",
+      "api:data:company",
+      "api:data:intent",
+      "api:data:scoops",
+      "api:data:news"
+    ],
+    clientIdEnv: "ZOOMINFO_OAUTH_CLIENT_ID",
+    clientSecretEnv: "ZOOMINFO_OAUTH_CLIENT_SECRET"
+  },
+  category: "sales-intelligence",
+  defaultConsistencyModel: "authoritative",
+  baseUrl: "https://api.zoominfo.com",
+  // `users/usage` is a free GET that proves the access token is valid.
+  test: { method: "GET", path: "/gtm/data/v1/users/usage" },
+  capabilities: [
+    {
+      name: "contact.search",
+      class: "read",
+      description: "Search the contact database by firmographic/persona criteria. Returns ranked matches with stable contactId values and basic info only (no emails/phones). Free. Pass contactId to contact.enrich for full detail.",
+      parameters: {
+        type: "object",
+        properties: {
+          data: {
+            type: "object",
+            description: 'Search criteria wrapped under `data`, e.g. { companyName, jobTitle: ["VP Sales"], managementLevel, zipCode }. Resolve valid field names via lookup.search_fields (entity=contact, fieldType=input).'
+          },
+          pageNumber: { type: "integer", description: "Page number, >= 1 (default 1)." },
+          pageSize: { type: "integer", description: "Page size, 1\u2013100 (default 25)." },
+          sort: { type: "string", description: "Sort field; prefix with - for descending." }
+        },
+        required: ["data"]
+      },
+      request: {
+        method: "POST",
+        path: "/gtm/data/v1/contacts/search",
+        query: { "page[number]": "{pageNumber}", "page[size]": "{pageSize}", sort: "{sort}" },
+        body: { data: "{data}" }
+      }
+    },
+    {
+      name: "company.search",
+      class: "read",
+      description: "Search the company database by firmographic filters (industry, revenue, employee count, geography, tech stack). Returns basic company info and stable companyId values. Free.",
+      parameters: {
+        type: "object",
+        properties: {
+          data: {
+            type: "object",
+            description: "Search criteria under `data`, e.g. { companyName, industry, employeeCount, revenue, location, technologies }. Resolve fields via lookup.search_fields (entity=company, fieldType=input)."
+          },
+          pageNumber: { type: "integer" },
+          pageSize: { type: "integer" },
+          sort: { type: "string" }
+        },
+        required: ["data"]
+      },
+      request: {
+        method: "POST",
+        path: "/gtm/data/v1/companies/search",
+        query: { "page[number]": "{pageNumber}", "page[size]": "{pageSize}", sort: "{sort}" },
+        body: { data: "{data}" }
+      }
+    },
+    {
+      name: "intent.search",
+      class: "read",
+      description: "Search for companies showing buyer-intent signals across 1\u201350 intent topics. Returns ranked companies with intent signal scores. Free.",
+      parameters: {
+        type: "object",
+        properties: {
+          data: {
+            type: "object",
+            description: 'Criteria under `data`, must include topics: ["cybersecurity", "cloud migration"] plus optional filters.'
+          },
+          pageNumber: { type: "integer" },
+          pageSize: { type: "integer" },
+          sort: { type: "string" }
+        },
+        required: ["data"]
+      },
+      request: {
+        method: "POST",
+        path: "/gtm/data/v1/intent/search",
+        query: { "page[number]": "{pageNumber}", "page[size]": "{pageSize}", sort: "{sort}" },
+        body: { data: "{data}" }
+      }
+    },
+    {
+      name: "scoops.search",
+      class: "read",
+      description: "Search real-time business-intelligence signals (Scoops: hiring, expansion, tech changes) across ZoomInfo companies. Free; each scoop counts against the record limit.",
+      parameters: {
+        type: "object",
+        properties: {
+          data: { type: "object", description: "Scoop filter criteria under `data`." },
+          pageNumber: { type: "integer" },
+          pageSize: { type: "integer" },
+          sort: { type: "string", description: "e.g. scoopId | originalPublishedDate; default -originalPublishedDate." }
+        },
+        required: ["data"]
+      },
+      request: {
+        method: "POST",
+        path: "/gtm/data/v1/scoops/search",
+        query: { "page[number]": "{pageNumber}", "page[size]": "{pageSize}", sort: "{sort}" },
+        body: { data: "{data}" }
+      }
+    },
+    {
+      name: "news.search",
+      class: "read",
+      description: "Search news articles across ZoomInfo companies. All filters optional but at least one must be set. Free; each article counts as one record. No sort param.",
+      parameters: {
+        type: "object",
+        properties: {
+          data: { type: "object", description: "News filter criteria under `data`, e.g. { companyId, keywords }." },
+          pageNumber: { type: "integer" },
+          pageSize: { type: "integer" }
+        },
+        required: ["data"]
+      },
+      request: {
+        method: "POST",
+        path: "/gtm/data/v1/news/search",
+        query: { "page[number]": "{pageNumber}", "page[size]": "{pageSize}" },
+        body: { data: "{data}" }
+      }
+    },
+    {
+      name: "contact.enrich",
+      class: "mutation",
+      description: "Enrich up to 25 contacts with full detail (email, phone, jobTitle, 300+ fields). Best practice: contact.search first, then pass contactId. CONSUMES 1 bulk-data credit per matched record returned (waived if under management). `data` carries matchPersonInput + outputFields (+ optional requiredFields).",
+      parameters: {
+        type: "object",
+        properties: {
+          data: {
+            type: "object",
+            description: 'Enrich body under `data`, e.g. { matchPersonInput: [{ contactId } | { firstName, lastName, companyName, emailAddress }], outputFields: ["id","email","phone","jobTitle"], requiredFields: [] }.'
+          }
+        },
+        required: ["data"]
+      },
+      request: { method: "POST", path: "/gtm/data/v1/contacts/enrich", body: { data: "{data}" } },
+      cas: "native-idempotency",
+      externalEffect: true
+    },
+    {
+      name: "company.enrich",
+      class: "mutation",
+      description: "Enrich up to 25 companies with 300+ data points (firmographics, technographics). Best practice: company.search first, then pass companyId. CONSUMES 1 bulk-data credit per matched record. `data` carries matchCompanyInput + outputFields.",
+      parameters: {
+        type: "object",
+        properties: {
+          data: {
+            type: "object",
+            description: 'Enrich body under `data`, e.g. { matchCompanyInput: [{ companyId } | { companyName, website }], outputFields: ["id","name","website","industry","employeeCount","revenue"], requiredFields: [] }.'
+          }
+        },
+        required: ["data"]
+      },
+      request: { method: "POST", path: "/gtm/data/v1/companies/enrich", body: { data: "{data}" } },
+      cas: "native-idempotency",
+      externalEffect: true
+    },
+    {
+      name: "intent.enrich",
+      class: "mutation",
+      description: "Fetch intent signals for a specific known company (companyId, companyName, or companyWebsite) across 1\u201350 topics. CONSUMES bulk-data credits per enriched company.",
+      parameters: {
+        type: "object",
+        properties: {
+          data: { type: "object", description: "Body under `data`, e.g. { companyId, topics: [...] }." },
+          pageNumber: { type: "integer" },
+          pageSize: { type: "integer" }
+        },
+        required: ["data"]
+      },
+      request: {
+        method: "POST",
+        path: "/gtm/data/v1/intent/enrich",
+        query: { "page[number]": "{pageNumber}", "page[size]": "{pageSize}" },
+        body: { data: "{data}" }
+      },
+      cas: "native-idempotency",
+      externalEffect: true
+    },
+    {
+      name: "scoops.enrich",
+      class: "mutation",
+      description: "Fetch Scoops for a specific known company (at least one company identifier). CONSUMES 1 credit per enriched company; each returned scoop counts against the record limit.",
+      parameters: {
+        type: "object",
+        properties: {
+          data: { type: "object", description: "Body under `data`, e.g. { companyId }." },
+          pageNumber: { type: "integer" },
+          pageSize: { type: "integer" }
+        },
+        required: ["data"]
+      },
+      request: {
+        method: "POST",
+        path: "/gtm/data/v1/scoops/enrich",
+        query: { "page[number]": "{pageNumber}", "page[size]": "{pageSize}" },
+        body: { data: "{data}" }
+      },
+      cas: "native-idempotency",
+      externalEffect: true
+    },
+    {
+      name: "news.enrich",
+      class: "mutation",
+      description: "Fetch categorized news coverage for a specific known company (at least one company identifier). CONSUMES bulk-data credits per enriched company.",
+      parameters: {
+        type: "object",
+        properties: {
+          data: { type: "object", description: "Body under `data`, e.g. { companyId }." },
+          pageNumber: { type: "integer" },
+          pageSize: { type: "integer" }
+        },
+        required: ["data"]
+      },
+      request: {
+        method: "POST",
+        path: "/gtm/data/v1/news/enrich",
+        query: { "page[number]": "{pageNumber}", "page[size]": "{pageSize}" },
+        body: { data: "{data}" }
+      },
+      cas: "native-idempotency",
+      externalEffect: true
+    },
+    {
+      name: "lookup.data",
+      class: "read",
+      description: "Retrieve enumerated valid values for a filter field (industries, regions, job functions, management levels, technologies, intent topics). Use to build valid search bodies. Free.",
+      parameters: {
+        type: "object",
+        properties: {
+          fieldName: { type: "string", description: "The filter field to enumerate, e.g. industry, managementLevel." },
+          category: { type: "string" },
+          parentCategory: { type: "string" },
+          subCategory: { type: "string" },
+          vendor: { type: "string" }
+        },
+        required: ["fieldName"]
+      },
+      request: {
+        method: "GET",
+        path: "/gtm/data/v1/lookup/{fieldName}",
+        query: {
+          "filter[category]": "{category}",
+          "filter[parentCategory]": "{parentCategory}",
+          "filter[subCategory]": "{subCategory}",
+          "filter[vendor]": "{vendor}"
+        }
+      }
+    },
+    {
+      name: "lookup.search_fields",
+      class: "read",
+      description: "Discover the valid input and output field names for a search/enrich entity. REQUIRED to build correct search/enrich bodies and enrich outputFields. Free.",
+      parameters: {
+        type: "object",
+        properties: {
+          entity: { type: "string", description: "company | contact | scoop | news | intent." },
+          fieldType: { type: "string", description: "input | output." }
+        },
+        required: ["entity", "fieldType"]
+      },
+      request: {
+        method: "GET",
+        path: "/gtm/data/v1/lookup/search",
+        query: { "filter[entity]": "{entity}", "filter[fieldType]": "{fieldType}" }
+      }
+    },
+    {
+      name: "usage.get",
+      class: "read",
+      description: "Return the current user\u2019s API usage and limits (credits consumed, request counts, entitlements). Free.",
+      parameters: { type: "object", properties: {} },
+      request: { method: "GET", path: "/gtm/data/v1/users/usage" }
+    }
+  ]
+});
+
+// src/connectors/adapters/paychex.ts
+var paychexConnector = declarativeRestConnector({
+  kind: "paychex",
+  displayName: "Paychex",
+  description: "Read HR and payroll data from Paychex: companies, workers, worker profiles, compensation, pay rates, communications, and federal tax setup.",
+  auth: {
+    kind: "oauth2",
+    grantType: "client_credentials",
+    tokenUrl: "https://api.paychex.com/auth/oauth/v2/token",
+    scopes: [],
+    clientIdEnv: "PAYCHEX_OAUTH_CLIENT_ID",
+    clientSecretEnv: "PAYCHEX_OAUTH_CLIENT_SECRET"
+  },
+  category: "hr",
+  defaultConsistencyModel: "authoritative",
+  baseUrl: { metadataKey: "apiBaseUri", fallback: "https://api.paychex.com" },
+  // Listing companies is the cheapest read that proves the client-credentials
+  // token is valid and the app has been granted access.
+  test: { method: "GET", path: "/companies" },
+  capabilities: [
+    {
+      name: "companies.list",
+      class: "read",
+      description: "List all companies the app has been granted access to. Each carries the companyId (UUID) needed for company-scoped calls.",
+      parameters: {
+        type: "object",
+        properties: {
+          limit: { type: "integer", description: "Page size, max 100 (default 25)." },
+          offset: { type: "integer", description: "Zero-based pagination offset." },
+          displayid: { type: "string", description: "Filter by the company display id." }
+        }
+      },
+      request: {
+        method: "GET",
+        path: "/companies",
+        query: { limit: "{limit}", offset: "{offset}", displayid: "{displayid}" }
+      }
+    },
+    {
+      name: "companies.get",
+      class: "read",
+      description: "Read a single company by companyId.",
+      parameters: {
+        type: "object",
+        properties: { companyId: { type: "string" } },
+        required: ["companyId"]
+      },
+      request: { method: "GET", path: "/companies/{companyId}" }
+    },
+    {
+      name: "companies.workers.list",
+      class: "read",
+      description: "List workers (employees + contractors) for a company. Minimal fields per worker (givenName, familyName, legalId, workerId); sub-resources are separate calls. Use statusType=ACTIVE to exclude terminated workers.",
+      parameters: {
+        type: "object",
+        properties: {
+          companyId: { type: "string" },
+          limit: { type: "integer", description: "Page size, max 100." },
+          offset: { type: "integer" },
+          statusType: { type: "string", description: "e.g. ACTIVE to exclude terminated workers." },
+          employeeId: { type: "string", description: "Filter to a specific employee id." }
+        },
+        required: ["companyId"]
+      },
+      request: {
+        method: "GET",
+        path: "/companies/{companyId}/workers",
+        query: {
+          limit: "{limit}",
+          offset: "{offset}",
+          statusType: "{statusType}",
+          employeeId: "{employeeId}"
+        }
+      }
+    },
+    {
+      name: "workers.get",
+      class: "read",
+      description: "Full profile for a single worker: demographics, employment type, hire date, current status, job info.",
+      parameters: {
+        type: "object",
+        properties: { workerId: { type: "string" } },
+        required: ["workerId"]
+      },
+      request: { method: "GET", path: "/workers/{workerId}" }
+    },
+    {
+      name: "workers.compensation.get",
+      class: "read",
+      description: "Compensation overview for a worker: payFrequency, flsaStatus, calculatedAnnualPay, calculatedPayPeriod, defaultOvertimeFactor (with HATEOAS links to payrates and paystandards).",
+      parameters: {
+        type: "object",
+        properties: { workerId: { type: "string" } },
+        required: ["workerId"]
+      },
+      request: { method: "GET", path: "/workers/{workerId}/compensation" }
+    },
+    {
+      name: "workers.compensation.payrates.list",
+      class: "read",
+      description: "All pay rate profiles for a worker (up to 25): rateId, startDate, rateType, amount, standardHours, standardOvertime. `asof` scopes to an effective date.",
+      parameters: {
+        type: "object",
+        properties: {
+          workerId: { type: "string" },
+          asof: { type: "string", description: "Effective date to scope the rates to (YYYY-MM-DD)." }
+        },
+        required: ["workerId"]
+      },
+      request: {
+        method: "GET",
+        path: "/workers/{workerId}/compensation/payrates",
+        query: { asof: "{asof}" }
+      }
+    },
+    {
+      name: "workers.compensation.paystandards.get",
+      class: "read",
+      description: "Pay standards for a worker: payFrequency (WEEKLY/BI_WEEKLY/SEMI_MONTHLY/MONTHLY), defaultOvertimeFactor, calculatedPayPeriod, calculatedAnnualSalary.",
+      parameters: {
+        type: "object",
+        properties: { workerId: { type: "string" } },
+        required: ["workerId"]
+      },
+      request: { method: "GET", path: "/workers/{workerId}/compensation/paystandards" }
+    },
+    {
+      name: "workers.communications.list",
+      class: "read",
+      description: "Worker contact info (email addresses, phone numbers) \u2014 not embedded in the base worker profile.",
+      parameters: {
+        type: "object",
+        properties: { workerId: { type: "string" } },
+        required: ["workerId"]
+      },
+      request: { method: "GET", path: "/workers/{workerId}/communications" }
+    },
+    {
+      name: "workers.federaltax.get",
+      class: "read",
+      description: "W-4 federal tax withholding configuration for a worker.",
+      parameters: {
+        type: "object",
+        properties: { workerId: { type: "string" } },
+        required: ["workerId"]
+      },
+      request: { method: "GET", path: "/workers/{workerId}/federaltax" }
+    }
+  ]
+});
+
+// src/connectors/adapters/adp.ts
+var adpConnector = declarativeRestConnector({
+  kind: "adp",
+  displayName: "ADP",
+  description: "Read HR and payroll data from ADP Workforce Now: workers, worker demographics, pay statements, and pay distributions. Requires mutual-TLS client certificates (see adapter notes) in addition to OAuth2.",
+  auth: {
+    kind: "oauth2",
+    authorizationUrl: "https://accounts.adp.com/auth/oauth/v2/authorize",
+    tokenUrl: "https://accounts.adp.com/auth/oauth/v2/token",
+    scopes: [
+      "hr/workerInformationManagement/read",
+      "payroll/payStatementManagement/read"
+    ],
+    clientIdEnv: "ADP_OAUTH_CLIENT_ID",
+    clientSecretEnv: "ADP_OAUTH_CLIENT_SECRET"
+  },
+  category: "hr",
+  defaultConsistencyModel: "authoritative",
+  baseUrl: "https://api.adp.com",
+  // ADP requires a roleCode on most HR/payroll endpoints; practitioner is the
+  // broadest read role. (PII stays masked unless the caller opts into
+  // `Accept: application/json;masked=false`.)
+  defaultHeaders: { roleCode: "practitioner" },
+  test: { method: "GET", path: "/hr/v2/workers/meta" },
+  capabilities: [
+    {
+      name: "worker.list",
+      class: "read",
+      description: "Collection of all workers for the authenticated client. OData paging via $top/$skip (default 50, max 100); total at meta.totalNumber. The associateOID on each worker is the key for per-worker endpoints. SSN/birth date are masked.",
+      parameters: {
+        type: "object",
+        properties: {
+          top: { type: "integer", description: "OData $top page size (default 50, max 100)." },
+          skip: { type: "integer", description: "OData $skip offset for pagination." },
+          filter: { type: "string", description: "OData $filter expression." },
+          select: { type: "string", description: "OData $select field projection." }
+        }
+      },
+      request: {
+        method: "GET",
+        path: "/hr/v2/workers",
+        query: { $top: "{top}", $skip: "{skip}", $filter: "{filter}", $select: "{select}" }
+      }
+    },
+    {
+      name: "worker.get",
+      class: "read",
+      description: "A single worker by Associate OID (aoid). SSN/birth date are masked unless unmasking is requested.",
+      parameters: {
+        type: "object",
+        properties: {
+          aoid: { type: "string", description: "Associate OID from worker.list." },
+          select: { type: "string", description: "OData $select field projection." }
+        },
+        required: ["aoid"]
+      },
+      request: {
+        method: "GET",
+        path: "/hr/v2/workers/{aoid}",
+        query: { $select: "{select}" }
+      }
+    },
+    {
+      name: "worker.demographics.list",
+      class: "read",
+      description: "Worker collection WITHOUT PII/SPI (no SSN, no full birth date) \u2014 a lighter payload than worker.list. OData paging supported.",
+      parameters: {
+        type: "object",
+        properties: {
+          top: { type: "integer" },
+          skip: { type: "integer" },
+          filter: { type: "string" },
+          select: { type: "string" }
+        }
+      },
+      request: {
+        method: "GET",
+        path: "/hr/v2/worker-demographics",
+        query: { $top: "{top}", $skip: "{skip}", $filter: "{filter}", $select: "{select}" }
+      }
+    },
+    {
+      name: "worker.demographics.get",
+      class: "read",
+      description: "Demographic data for one worker by Associate OID, without PII/SPI.",
+      parameters: {
+        type: "object",
+        properties: {
+          aoid: { type: "string" },
+          select: { type: "string" }
+        },
+        required: ["aoid"]
+      },
+      request: {
+        method: "GET",
+        path: "/hr/v2/worker-demographics/{aoid}",
+        query: { $select: "{select}" }
+      }
+    },
+    {
+      name: "paystatements.list",
+      class: "read",
+      description: "Pay statements for one worker: payDate, net/gross pay amounts, total hours, and a statement image URI. Use numberoflastpaydates to cap results.",
+      parameters: {
+        type: "object",
+        properties: {
+          aoid: { type: "string", description: "Associate OID from worker.list." },
+          numberoflastpaydates: { type: "integer", description: "Limit to the N most recent pay dates." }
+        },
+        required: ["aoid"]
+      },
+      request: {
+        method: "GET",
+        path: "/payroll/v1/workers/{aoid}/pay-statements",
+        query: { numberoflastpaydates: "{numberoflastpaydates}" }
+      }
+    },
+    {
+      name: "paystatements.get",
+      class: "read",
+      description: "Full detail of one pay statement: pay period, net/gross/YTD amounts, earnings, deductions, and memos. The pay-statement id is resolved from paystatements.list.",
+      parameters: {
+        type: "object",
+        properties: {
+          aoid: { type: "string" },
+          payStatementId: { type: "string", description: "Pay statement id from paystatements.list." }
+        },
+        required: ["aoid", "payStatementId"]
+      },
+      request: { method: "GET", path: "/payroll/v1/workers/{aoid}/pay-statements/{payStatementId}" }
+    },
+    {
+      name: "paydistributions.get",
+      class: "read",
+      description: "Direct-deposit distribution setup for one worker: accounts, routing numbers, distribution amounts, and remaining-balance flags.",
+      parameters: {
+        type: "object",
+        properties: { aoid: { type: "string" } },
+        required: ["aoid"]
+      },
+      request: { method: "GET", path: "/payroll/v2/workers/{aoid}/pay-distributions" }
+    }
+  ]
+});
+
 // src/connectors/adapters/ashby.ts
 var ashbyConnector = declarativeRestConnector({
   kind: "ashby",
@@ -118839,6 +120404,13 @@ export {
   apitableConnector,
   aminosConnector,
   apolloConnector,
+  similarwebConnector,
+  semrushConnector,
+  cognismConnector,
+  clayConnector,
+  zoominfoConnector,
+  paychexConnector,
+  adpConnector,
   ashbyConnector,
   assemblyaiConnector,
   avianConnector,
@@ -119192,4 +120764,4 @@ export {
   pipedreamConnector,
   adapters_exports
 };
-//# sourceMappingURL=chunk-4TI3WXAD.js.map
+//# sourceMappingURL=chunk-COKK7BOH.js.map