gtm-now 0.10.6 → 0.10.8

package/dist/index.js

@@ -205,7 +205,8 @@ var init_config = __esm({
       GTM_SMARTLEAD_API_KEY: "smartlead",
       GTM_HARVEST_API_KEY: "harvest",
       GTM_STORELEADS_API_KEY: "storeleads",
-      GTM_EXA_API_KEY: "exa"
+      GTM_EXA_API_KEY: "exa",
+      GTM_LEADMAGIC_API_KEY: "leadmagic"
     };
     ENV_WORKSPACE_MAP = {
       GTM_PLUSVIBE_WORKSPACE_ID: "plusvibe"
@@ -8737,6 +8738,111 @@ var init_client25 = __esm({
   }
 });
 
+// ../integrations/dist/leadmagic.js
+var LeadMagicClient;
+var init_leadmagic2 = __esm({
+  "../integrations/dist/leadmagic.js"() {
+    "use strict";
+    init_base_client();
+    LeadMagicClient = class extends BaseApiClient {
+      constructor(config) {
+        super({
+          name: "LeadMagic",
+          baseUrl: config.baseUrl ?? "https://api.leadmagic.io",
+          headers: { "X-API-Key": config.apiKey },
+          timeoutMs: config.timeoutMs
+        });
+      }
+      // ─── People ──────────────────────────────────────────────────────────────────
+      async findEmail(params) {
+        return this.request("/v1/people/email-finder", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async validateEmail(params) {
+        return this.request("/v1/people/email-validation", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async findMobile(params) {
+        return this.request("/v1/people/mobile-finder", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async searchProfile(params) {
+        return this.request("/v1/people/profile-search", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async findEmployees(params) {
+        return this.request("/v1/people/employee-finder", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async findRole(params) {
+        return this.request("/v1/people/role-finder", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async emailToProfile(params) {
+        return this.request("/v1/people/b2b-profile", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async profileToEmail(params) {
+        return this.request("/v1/people/b2b-profile-email", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async findPersonalEmail(params) {
+        return this.request("/v1/people/personal-email-finder", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async detectJobChange(params) {
+        return this.request("/v1/people/job-change-detector", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      // ─── Companies ───────────────────────────────────────────────────────────────
+      async searchCompany(params) {
+        return this.request("/v1/companies/company-search", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async searchCompetitors(params) {
+        return this.request("/v1/companies/competitors-search", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async getCompanyFunding(params) {
+        return this.request("/v1/companies/company-funding", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+      async getTechnographics(params) {
+        return this.request("/v1/companies/technographics", {
+          method: "POST",
+          body: JSON.stringify(params)
+        });
+      }
+    };
+  }
+});
+
 // ../integrations/dist/index.js
 var init_dist2 = __esm({
   "../integrations/dist/index.js"() {
@@ -8778,6 +8884,7 @@ var init_dist2 = __esm({
     init_factory();
     init_client24();
     init_client25();
+    init_leadmagic2();
   }
 });
 
@@ -9481,13 +9588,14 @@ function mapSeniority(values) {
 function isApiClientError(error, statusCode) {
   return error instanceof Error && "statusCode" in error && error.statusCode === statusCode;
 }
-var PROSPEO_PAGE_SIZE, SENIORITY_TO_PROSPEO, ProspeoMcpAdapter;
+var PROSPEO_PAGE_SIZE, MAX_PAGES, SENIORITY_TO_PROSPEO, ProspeoMcpAdapter;
 var init_prospeo2 = __esm({
   "src/providers/adapters/prospeo.ts"() {
     "use strict";
     init_dist();
     init_dist2();
     PROSPEO_PAGE_SIZE = 25;
+    MAX_PAGES = 40;
     SENIORITY_TO_PROSPEO = {
       c_suite: "C-Suite",
       founder: "Founder/Owner",
@@ -9577,24 +9685,33 @@ var init_prospeo2 = __esm({
             { statusCode: 400 }
           );
         }
-        const page = query.offset ? Math.floor(query.offset / PROSPEO_PAGE_SIZE) + 1 : 1;
+        const requestedLimit = query.limit ?? PROSPEO_PAGE_SIZE;
+        const startPage = query.offset ? Math.floor(query.offset / PROSPEO_PAGE_SIZE) + 1 : 1;
         try {
-          const response = await this.client.searchPeople({ page, filters });
-          if (response.error || !response.results?.length) return [];
-          return response.results.map((r) => ({
-            first_name: r.person?.first_name ?? "",
-            last_name: r.person?.last_name ?? "",
-            job_title: r.person?.current_job_title ?? void 0,
-            company: r.company?.name ?? void 0,
-            company_domain: r.company?.domain ?? void 0,
-            email: r.person?.email?.email ?? void 0,
-            phone: r.person?.mobile?.mobile ?? void 0,
-            linkedin_url: r.person?.linkedin_url ?? void 0,
-            seniority: r.person?.job_history?.[0]?.seniority ?? void 0,
-            department: r.person?.job_history?.[0]?.departments?.[0] ?? void 0,
-            location: r.person?.location ? [r.person.location.city, r.person.location.state, r.person.location.country].filter(Boolean).join(", ") : void 0,
-            sources: [this.name]
-          }));
+          const allResults = [];
+          let page = startPage;
+          while (allResults.length < requestedLimit && page < startPage + MAX_PAGES) {
+            const response = await this.client.searchPeople({ page, filters });
+            if (response.error || !response.results?.length) break;
+            const mapped = response.results.map((r) => ({
+              first_name: r.person?.first_name ?? "",
+              last_name: r.person?.last_name ?? "",
+              job_title: r.person?.current_job_title ?? void 0,
+              company: r.company?.name ?? void 0,
+              company_domain: r.company?.domain ?? void 0,
+              email: r.person?.email?.email ?? void 0,
+              phone: r.person?.mobile?.mobile ?? void 0,
+              linkedin_url: r.person?.linkedin_url ?? void 0,
+              seniority: r.person?.job_history?.[0]?.seniority ?? void 0,
+              department: r.person?.job_history?.[0]?.departments?.[0] ?? void 0,
+              location: r.person?.location ? [r.person.location.city, r.person.location.state, r.person.location.country].filter(Boolean).join(", ") : void 0,
+              sources: [this.name]
+            }));
+            allResults.push(...mapped);
+            if (response.results.length < PROSPEO_PAGE_SIZE) break;
+            page++;
+          }
+          return allResults.slice(0, requestedLimit);
         } catch (error) {
           if (isApiClientError(error, 400)) {
             const body = error.responseBody;
@@ -10539,6 +10656,193 @@ var init_exa = __esm({
   }
 });
 
+// src/providers/adapters/leadmagic.ts
+function mapEmailQuality(status) {
+  switch (status) {
+    case "valid":
+      return "95%";
+    case "valid_catch_all":
+      return "80%";
+    case "catch_all":
+      return "60%";
+    default:
+      return "50%";
+  }
+}
+function mapVerificationStatus(status) {
+  switch (status) {
+    case "valid":
+      return "deliverable";
+    case "valid_catch_all":
+      return "catch_all_safe";
+    case "catch_all":
+      return "catch_all_not_safe";
+    case "invalid":
+      return "undeliverable";
+    default:
+      return "unknown";
+  }
+}
+var LeadMagicAdapter2;
+var init_leadmagic3 = __esm({
+  "src/providers/adapters/leadmagic.ts"() {
+    "use strict";
+    init_dist();
+    init_dist2();
+    LeadMagicAdapter2 = class {
+      name = "leadmagic";
+      capabilities = [
+        "enrich_email",
+        "enrich_phone",
+        "verify_email",
+        "find_people"
+      ];
+      notes = "Best for: email enrichment (name+domain), email validation (0.05 credits), mobile finder (needs LinkedIn URL, 5 credits), employee lists (0.05/employee). Also supports: profile search, company search, technographics, funding, competitors, job change detection. Pay-on-find pricing \u2014 free when no result.";
+      client;
+      constructor(apiKey) {
+        this.client = new LeadMagicClient({ apiKey });
+      }
+      async checkCredentials() {
+        try {
+          await this.client.validateEmail({ email: "test@example.com" });
+          return true;
+        } catch (error) {
+          logError(
+            "leadmagic:checkCredentials",
+            error instanceof Error ? error : new Error(String(error))
+          );
+          return false;
+        }
+      }
+      async checkCredits() {
+        return null;
+      }
+      // ─── EmailEnricher ──────────────────────────────────────
+      async enrichEmail(contact) {
+        try {
+          if (contact.first_name && contact.last_name && (contact.company_domain || contact.company)) {
+            const response = await this.client.findEmail({
+              first_name: contact.first_name,
+              last_name: contact.last_name,
+              domain: contact.company_domain,
+              company_name: !contact.company_domain ? contact.company : void 0
+            });
+            if (response.email && response.status !== "not_found") {
+              return {
+                email: response.email,
+                quality: mapEmailQuality(response.status),
+                provider: this.name
+              };
+            }
+          }
+          if (contact.linkedin_url) {
+            const response = await this.client.profileToEmail({
+              profile_url: contact.linkedin_url
+            });
+            if (response.email) {
+              return {
+                email: response.email,
+                quality: "80%",
+                // Profile-to-email doesn't return validation status
+                provider: this.name
+              };
+            }
+          }
+          return null;
+        } catch (error) {
+          logError("leadmagic:enrichEmail", error instanceof Error ? error : new Error(String(error)));
+          return null;
+        }
+      }
+      // ─── PhoneEnricher ──────────────────────────────────────
+      async enrichPhone(contact) {
+        try {
+          const response = await this.client.findMobile({
+            profile_url: contact.linkedin_url,
+            work_email: void 0,
+            // Could pass email if available
+            personal_email: void 0
+          });
+          if (!response.mobile_number) return null;
+          return {
+            phone: response.mobile_number,
+            provider: this.name
+          };
+        } catch (error) {
+          logError("leadmagic:enrichPhone", error instanceof Error ? error : new Error(String(error)));
+          return null;
+        }
+      }
+      // ─── EmailVerifier ──────────────────────────────────────
+      async verifyEmail(email) {
+        try {
+          const response = await this.client.validateEmail({ email });
+          return {
+            email: response.email ?? email,
+            valid: response.email_status === "valid" || response.email_status === "valid_catch_all",
+            status: mapVerificationStatus(response.email_status),
+            provider: this.name
+          };
+        } catch (error) {
+          logError("leadmagic:verifyEmail", error instanceof Error ? error : new Error(String(error)));
+          return {
+            email,
+            valid: false,
+            status: "unknown",
+            provider: this.name
+          };
+        }
+      }
+      // ─── PeopleFinder ───────────────────────────────────────
+      async findPeople(query) {
+        try {
+          if (query.job_title && (query.company_domain || query.company_name)) {
+            const response = await this.client.findRole({
+              job_title: query.job_title,
+              company_domain: query.company_domain,
+              company_name: !query.company_domain ? query.company_name : void 0
+            });
+            if (response.first_name && response.last_name) {
+              return [
+                {
+                  first_name: response.first_name,
+                  last_name: response.last_name,
+                  job_title: response.job_title ?? void 0,
+                  company: response.company_name ?? void 0,
+                  company_domain: response.company_website ?? query.company_domain ?? void 0,
+                  linkedin_url: response.profile_url ?? void 0,
+                  sources: [this.name]
+                }
+              ];
+            }
+            return [];
+          }
+          if (query.company_domain || query.company_name) {
+            const response = await this.client.findEmployees({
+              company_domain: query.company_domain,
+              company_name: !query.company_domain ? query.company_name : void 0,
+              limit: query.limit ?? 20
+            });
+            if (!response.data?.length) return [];
+            return response.data.map((emp) => ({
+              first_name: emp.first_name ?? "",
+              last_name: emp.last_name ?? "",
+              job_title: emp.title ?? void 0,
+              company: emp.company_name ?? void 0,
+              company_domain: emp.website ?? query.company_domain ?? void 0,
+              sources: [this.name]
+            }));
+          }
+          return [];
+        } catch (error) {
+          logError("leadmagic:findPeople", error instanceof Error ? error : new Error(String(error)));
+          return [];
+        }
+      }
+    };
+  }
+});
+
 // src/providers/adapters/index.ts
 var init_adapters = __esm({
   "src/providers/adapters/index.ts"() {
@@ -10556,6 +10860,7 @@ var init_adapters = __esm({
     init_storeleads();
     init_harvest();
     init_exa();
+    init_leadmagic3();
   }
 });
 
@@ -10588,6 +10893,8 @@ function createAdapter(name, config) {
       return config.api_key ? new HarvestApiAdapter(config.api_key) : null;
     case "exa":
       return config.api_key ? new ExaAdapter(config.api_key) : null;
+    case "leadmagic":
+      return config.api_key ? new LeadMagicAdapter2(config.api_key) : null;
     default:
       return null;
   }
@@ -10890,7 +11197,7 @@ var init_prospect = __esm({
       },
       {
         name: "gtm_find_people",
-        description: 'Find contacts by job title, company, or domain. Returns name, title, email, LinkedIn URL. Slim by default; pass fields: "all" for full payload.',
+        description: 'Find contacts by job title, company, or domain. Returns name, title, email, LinkedIn URL. Slim by default; pass fields: "all" for full payload. Pass enrich: true to resolve full emails inline (avoids a separate gtm_enrich call).',
         inputSchema: {
           type: "object",
           properties: {
@@ -10979,6 +11286,10 @@ var init_prospect = __esm({
               type: "string",
               description: 'Company revenue range as "min,max" (e.g., "1000000,10000000")'
             },
+            enrich: {
+              type: "boolean",
+              description: "Resolve full email addresses inline. Some providers return masked emails (e.g., j***@company.com) in search results. Pass enrich: true to run waterfall enrichment on those contacts automatically, so you get real emails without a separate gtm_enrich call."
+            },
             fields: {
               description: 'Response fields. Defaults to slim (name, title, email, company, company_domain, linkedin). Pass "all" for full payload including skills, phone, seniority, department, connections. Or pass an array of specific field names.',
               oneOf: [
@@ -11872,61 +12183,342 @@ For any task: always dry_run enrichment batches > 5 to preview cost before execu
   }
 });
 
-// src/providers/types.ts
-function applySlimFields(obj, fields) {
-  const result = {};
-  for (const field of fields) {
-    if (field in obj) {
-      result[field] = obj[field];
-    }
-  }
-  return result;
+// src/providers/waterfall.ts
+function getCacheKey(contact) {
+  if (!contact.linkedin_url) return null;
+  return contact.linkedin_url.toLowerCase().trim();
 }
-var SLIM_COMPANY_FIELDS, SLIM_PERSON_FIELDS;
-var init_types3 = __esm({
-  "src/providers/types.ts"() {
-    "use strict";
-    SLIM_COMPANY_FIELDS = [
-      "domain",
-      "name",
-      "industry",
-      "employees",
-      "country"
-    ];
-    SLIM_PERSON_FIELDS = [
-      "first_name",
-      "last_name",
-      "job_title",
-      "email",
-      "company",
-      "company_domain",
-      "linkedin_url"
-    ];
+function isExhaustedError(error) {
+  const msg = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+  return EXHAUSTION_PATTERNS.some((p) => msg.includes(p));
+}
+function isRateLimitError(error) {
+  if (error instanceof Error && "status" in error) {
+    return error.status === 429;
   }
-});
-
-// src/providers/manifest-validation.ts
-function validateParams(provider, tool, args) {
-  const manifest = getToolManifest(provider, tool);
-  if (!manifest) return [];
-  const supported = new Set(manifest.supported_params);
-  const warnings = [];
-  for (const [key, value] of Object.entries(args)) {
-    if (value === void 0 || value === null) continue;
-    if (controlSet.has(key)) continue;
-    if (!supported.has(key)) {
-      const alternatives = Object.entries(MANIFESTS).filter(([_, m]) => m[tool]?.supported_params.includes(key)).map(([name]) => name);
-      const suggestion = alternatives.length > 0 ? ` Use provider: '${alternatives[0]}' for ${key} filtering.` : "";
-      warnings.push(`${key} is not supported by ${provider}.${suggestion}`);
+  const msg = error instanceof Error ? error.message : String(error);
+  return msg.includes("429") || msg.toLowerCase().includes("rate limit");
+}
+function withTimeout(promise, ms, label) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(
+      () => reject(new Error(`Provider timeout: ${label} did not respond within ${ms}ms`)),
+      ms
+    );
+    promise.then(
+      (val) => {
+        clearTimeout(timer);
+        resolve(val);
+      },
+      (err) => {
+        clearTimeout(timer);
+        reject(err);
+      }
+    );
+  });
+}
+async function runWaterfall(contacts, config, registry) {
+  const exhausted = /* @__PURE__ */ new Set();
+  const batchDeadline = Date.now() + (config.batchTimeoutMs ?? DEFAULT_BATCH_TIMEOUT_MS);
+  const concurrency = config.concurrency ?? 1;
+  if (concurrency <= 1) {
+    const results2 = [];
+    for (const contact of contacts) {
+      if (Date.now() > batchDeadline) {
+        results2.push(makeTimeoutResult(contact));
+        continue;
+      }
+      const result = await enrichContact(contact, config, registry, exhausted);
+      results2.push(result);
+    }
+    return results2;
+  }
+  const results = new Array(contacts.length);
+  let nextIndex = 0;
+  async function worker() {
+    while (nextIndex < contacts.length) {
+      const i = nextIndex++;
+      if (Date.now() > batchDeadline) {
+        results[i] = makeTimeoutResult(contacts[i]);
+        continue;
+      }
+      results[i] = await enrichContact(contacts[i], config, registry, exhausted);
     }
   }
-  return warnings;
-}
-function clampLimit(provider, tool, limit) {
-  const manifest = getToolManifest(provider, tool);
-  if (!manifest) return limit ?? 50;
-  if (limit === void 0) return manifest.default_limit;
-  return Math.min(limit, manifest.max_limit);
+  await Promise.all(Array.from({ length: Math.min(concurrency, contacts.length) }, () => worker()));
+  return results;
+}
+function makeTimeoutResult(contact) {
+  return {
+    contact,
+    attempts: [
+      {
+        provider: "waterfall",
+        capability: "enrich_email",
+        found: false,
+        charged: false,
+        duration_ms: 0,
+        error: "Batch timeout exceeded \u2014 skipped remaining contacts"
+      }
+    ],
+    charged: false
+  };
+}
+async function enrichContact(contact, config, registry, exhausted) {
+  const attempts = [];
+  let email;
+  let emailProvider;
+  let phone;
+  let phoneProvider;
+  let charged = false;
+  const cacheKey = getCacheKey(contact);
+  const cached = cacheKey ? enrichmentCache.get(cacheKey) : null;
+  for (const field of config.find) {
+    const capability = field === "email" ? "enrich_email" : "enrich_phone";
+    const cachedValue = cached?.[field];
+    if (cachedValue) {
+      if (field === "email") {
+        email = cachedValue;
+        emailProvider = cached.provider;
+      }
+      if (field === "phone") {
+        phone = cachedValue;
+        phoneProvider = cached.provider;
+      }
+      attempts.push({
+        provider: cached.provider,
+        capability,
+        found: true,
+        charged: false,
+        duration_ms: 0,
+        cached: true
+      });
+      continue;
+    }
+    const fieldResult = await enrichField(contact, field, config, registry, exhausted);
+    attempts.push(...fieldResult.attempts);
+    if (field === "email" && fieldResult.value) {
+      email = fieldResult.value;
+      emailProvider = fieldResult.provider;
+      charged = true;
+    } else if (field === "phone" && fieldResult.value) {
+      phone = fieldResult.value;
+      phoneProvider = fieldResult.provider;
+      charged = true;
+    }
+  }
+  if (cacheKey && (email || phone)) {
+    const existing = enrichmentCache.get(cacheKey);
+    enrichmentCache.set(cacheKey, {
+      email: email ?? existing?.email,
+      phone: phone ?? existing?.phone,
+      provider: attempts.find((a) => a.found && !a.cached)?.provider ?? existing?.provider ?? "unknown",
+      timestamp: Date.now()
+    });
+  }
+  return {
+    contact,
+    email,
+    phone,
+    email_provider: emailProvider,
+    phone_provider: phoneProvider,
+    attempts,
+    charged
+  };
+}
+async function enrichField(contact, field, config, registry, exhausted) {
+  const capability = field === "email" ? "enrich_email" : "enrich_phone";
+  const attempts = [];
+  for (const providerName of config.providers) {
+    if (exhausted.has(providerName)) {
+      attempts.push({
+        provider: providerName,
+        capability,
+        found: false,
+        charged: false,
+        duration_ms: 0,
+        error: "Skipped \u2014 provider exhausted (no credits remaining this batch)"
+      });
+      continue;
+    }
+    const provider = registry.get(providerName);
+    if (!provider || !provider.capabilities.includes(capability)) continue;
+    for (let retryAttempt = 0; retryAttempt <= WATERFALL_RETRY_DELAYS.length; retryAttempt++) {
+      const start = Date.now();
+      try {
+        let value;
+        const providerTimeoutMs = config.providerTimeoutMs ?? DEFAULT_PROVIDER_TIMEOUT_MS;
+        if (field === "email" && "enrichEmail" in provider) {
+          const result = await withTimeout(
+            provider.enrichEmail(contact),
+            providerTimeoutMs,
+            providerName
+          );
+          value = result?.email;
+        } else if (field === "phone" && "enrichPhone" in provider) {
+          const result = await withTimeout(
+            provider.enrichPhone(contact),
+            providerTimeoutMs,
+            providerName
+          );
+          value = result?.phone;
+        }
+        const found = !!value;
+        attempts.push({
+          provider: providerName,
+          capability,
+          found,
+          charged: found,
+          duration_ms: Date.now() - start
+        });
+        if (found && config.stopOnFirst) {
+          return { value, provider: providerName, attempts };
+        }
+        break;
+      } catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        if (isExhaustedError(error)) {
+          exhausted.add(providerName);
+          attempts.push({
+            provider: providerName,
+            capability,
+            found: false,
+            charged: false,
+            duration_ms: Date.now() - start,
+            error: `Provider exhausted \u2014 skipping for remaining contacts: ${errorMsg}`
+          });
+          break;
+        }
+        if (isRateLimitError(error) && retryAttempt < WATERFALL_RETRY_DELAYS.length) {
+          const delay = WATERFALL_RETRY_DELAYS[retryAttempt];
+          await new Promise((r) => setTimeout(r, delay));
+          continue;
+        }
+        attempts.push({
+          provider: providerName,
+          capability,
+          found: false,
+          charged: false,
+          duration_ms: Date.now() - start,
+          error: errorMsg
+        });
+        logError(
+          `waterfall:${providerName}`,
+          error instanceof Error ? error : new Error(String(error)),
+          { contact: `${contact.first_name} ${contact.last_name}` }
+        );
+        break;
+      }
+    }
+  }
+  return { attempts };
+}
+function dryRunWaterfall(contactsCount, config, registry) {
+  const activeProviders = config.providers.filter((name) => registry.get(name));
+  const costs = {};
+  for (const name of activeProviders) {
+    const pricing = DEFAULT_PRICING[name];
+    if (pricing?.estimated_cost_per_hit) {
+      costs[name] = pricing.estimated_cost_per_hit;
+    } else if (pricing?.estimated_cost_per_lookup) {
+      costs[name] = `${pricing.estimated_cost_per_lookup}/lookup`;
+    } else {
+      costs[name] = "unknown";
+    }
+  }
+  return {
+    dry_run: true,
+    contacts_count: contactsCount,
+    waterfall: activeProviders,
+    pricing_model: "pay-on-find",
+    estimated_cost_per_hit: costs,
+    note: "Charged only when contact info is found. No result = no charge.",
+    confirm: "Call gtm_enrich again without dry_run to execute."
+  };
+}
+var enrichmentCache, DEFAULT_PRICING, EXHAUSTION_PATTERNS, WATERFALL_RETRY_DELAYS, DEFAULT_PROVIDER_TIMEOUT_MS, DEFAULT_BATCH_TIMEOUT_MS;
+var init_waterfall = __esm({
+  "src/providers/waterfall.ts"() {
+    "use strict";
+    init_dist();
+    enrichmentCache = /* @__PURE__ */ new Map();
+    DEFAULT_PRICING = {
+      bettercontact: { charged_only_on_find: true, estimated_cost_per_hit: "$0.10" },
+      prospeo: { charged_only_on_find: true, estimated_cost_per_hit: "$0.05" },
+      apollo: { charged_only_on_find: false, estimated_cost_per_lookup: "$0.03" },
+      hunter: { charged_only_on_find: true, estimated_cost_per_hit: "$0.05" },
+      leadmagic: { charged_only_on_find: true, estimated_cost_per_hit: "$0.03" }
+    };
+    EXHAUSTION_PATTERNS = [
+      "insufficient credits",
+      "no credits",
+      "0 credits",
+      "plan limit",
+      "quota exceeded",
+      "upgrade your plan",
+      "not accessible with this api_key on a free plan"
+    ];
+    WATERFALL_RETRY_DELAYS = [2e3, 5e3, 1e4];
+    DEFAULT_PROVIDER_TIMEOUT_MS = 15e3;
+    DEFAULT_BATCH_TIMEOUT_MS = 3e5;
+  }
+});
+
+// src/providers/types.ts
+function applySlimFields(obj, fields) {
+  const result = {};
+  for (const field of fields) {
+    if (field in obj) {
+      result[field] = obj[field];
+    }
+  }
+  return result;
+}
+var SLIM_COMPANY_FIELDS, SLIM_PERSON_FIELDS;
+var init_types3 = __esm({
+  "src/providers/types.ts"() {
+    "use strict";
+    SLIM_COMPANY_FIELDS = [
+      "domain",
+      "name",
+      "industry",
+      "employees",
+      "country"
+    ];
+    SLIM_PERSON_FIELDS = [
+      "first_name",
+      "last_name",
+      "job_title",
+      "email",
+      "company",
+      "company_domain",
+      "linkedin_url"
+    ];
+  }
+});
+
+// src/providers/manifest-validation.ts
+function validateParams(provider, tool, args) {
+  const manifest = getToolManifest(provider, tool);
+  if (!manifest) return [];
+  const supported = new Set(manifest.supported_params);
+  const warnings = [];
+  for (const [key, value] of Object.entries(args)) {
+    if (value === void 0 || value === null) continue;
+    if (controlSet.has(key)) continue;
+    if (!supported.has(key)) {
+      const alternatives = Object.entries(MANIFESTS).filter(([_, m]) => m[tool]?.supported_params.includes(key)).map(([name]) => name);
+      const suggestion = alternatives.length > 0 ? ` Use provider: '${alternatives[0]}' for ${key} filtering.` : "";
+      warnings.push(`${key} is not supported by ${provider}.${suggestion}`);
+    }
+  }
+  return warnings;
+}
+function clampLimit(provider, tool, limit) {
+  const manifest = getToolManifest(provider, tool);
+  if (!manifest) return limit ?? 50;
+  if (limit === void 0) return manifest.default_limit;
+  return Math.min(limit, manifest.max_limit);
 }
 var controlSet;
 var init_manifest_validation = __esm({
@@ -12199,6 +12791,43 @@ async function findPeople(args, ctx) {
   };
   const results = await finder.findPeople(query);
   const dedupedResults = deduplicatePeople(results);
+  const shouldEnrich = args.enrich ?? false;
+  let enrichedCount = 0;
+  if (shouldEnrich) {
+    const needsEnrichment = dedupedResults.filter(
+      (r) => !r.email || r.email.includes("*")
+    );
+    if (needsEnrichment.length > 0) {
+      try {
+        const contacts = needsEnrichment.map((r) => ({
+          first_name: r.first_name,
+          last_name: r.last_name,
+          company: r.company,
+          company_domain: r.company_domain,
+          linkedin_url: r.linkedin_url
+        }));
+        const clientConfig = ctx.session.getActiveContext().config;
+        const waterfallProviders = clientConfig.waterfall?.email ?? ["prospeo"];
+        const waterfallConfig = {
+          providers: waterfallProviders,
+          find: ["email"],
+          verify: false,
+          stopOnFirst: true,
+          concurrency: 5
+        };
+        const enrichResults = await runWaterfall(contacts, waterfallConfig, ctx.registry);
+        for (let i = 0; i < needsEnrichment.length; i++) {
+          const enriched = enrichResults[i];
+          if (enriched?.email) {
+            needsEnrichment[i].email = enriched.email;
+            enrichedCount++;
+          }
+        }
+      } catch (error) {
+        logError("prospect:inlineEnrich", error instanceof Error ? error : new Error(String(error)));
+      }
+    }
+  }
   const resultsWithAlias = dedupedResults.map((r) => ({
     ...r,
     company_domain: r.company_domain ?? r.company
@@ -12265,6 +12894,7 @@ async function findPeople(args, ctx) {
     has_more,
     offset,
     ...Object.keys(applied_filters).length > 0 && { applied_filters },
+    ...shouldEnrich && { enriched: enrichedCount },
     people: slimmedResults,
     ...warnings?.length ? { warnings } : {}
   };
@@ -12272,7 +12902,9 @@ async function findPeople(args, ctx) {
 var init_prospect2 = __esm({
   "src/handlers/prospect.ts"() {
     "use strict";
+    init_dist();
     init_errors();
+    init_waterfall();
     init_types3();
     init_manifest_validation();
     init_result_writer();
@@ -12280,266 +12912,6 @@ var init_prospect2 = __esm({
   }
 });
 
-// src/providers/waterfall.ts
-function getCacheKey(contact) {
-  if (!contact.linkedin_url) return null;
-  return contact.linkedin_url.toLowerCase().trim();
-}
-function isExhaustedError(error) {
-  const msg = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
-  return EXHAUSTION_PATTERNS.some((p) => msg.includes(p));
-}
-function isRateLimitError(error) {
-  if (error instanceof Error && "status" in error) {
-    return error.status === 429;
-  }
-  const msg = error instanceof Error ? error.message : String(error);
-  return msg.includes("429") || msg.toLowerCase().includes("rate limit");
-}
-function withTimeout(promise, ms, label) {
-  return new Promise((resolve, reject) => {
-    const timer = setTimeout(
-      () => reject(new Error(`Provider timeout: ${label} did not respond within ${ms}ms`)),
-      ms
-    );
-    promise.then(
-      (val) => {
-        clearTimeout(timer);
-        resolve(val);
-      },
-      (err) => {
-        clearTimeout(timer);
-        reject(err);
-      }
-    );
-  });
-}
-async function runWaterfall(contacts, config, registry) {
-  const results = [];
-  const exhausted = /* @__PURE__ */ new Set();
-  const batchDeadline = Date.now() + (config.batchTimeoutMs ?? DEFAULT_BATCH_TIMEOUT_MS);
-  for (const contact of contacts) {
-    if (Date.now() > batchDeadline) {
-      results.push({
-        contact,
-        attempts: [
-          {
-            provider: "waterfall",
-            capability: "enrich_email",
-            found: false,
-            charged: false,
-            duration_ms: 0,
-            error: "Batch timeout exceeded \u2014 skipped remaining contacts"
-          }
-        ],
-        charged: false
-      });
-      continue;
-    }
-    const result = await enrichContact(contact, config, registry, exhausted);
-    results.push(result);
-  }
-  return results;
-}
-async function enrichContact(contact, config, registry, exhausted) {
-  const attempts = [];
-  let email;
-  let emailProvider;
-  let phone;
-  let phoneProvider;
-  let charged = false;
-  const cacheKey = getCacheKey(contact);
-  const cached = cacheKey ? enrichmentCache.get(cacheKey) : null;
-  for (const field of config.find) {
-    const capability = field === "email" ? "enrich_email" : "enrich_phone";
-    const cachedValue = cached?.[field];
-    if (cachedValue) {
-      if (field === "email") {
-        email = cachedValue;
-        emailProvider = cached.provider;
-      }
-      if (field === "phone") {
-        phone = cachedValue;
-        phoneProvider = cached.provider;
-      }
-      attempts.push({
-        provider: cached.provider,
-        capability,
-        found: true,
-        charged: false,
-        duration_ms: 0,
-        cached: true
-      });
-      continue;
-    }
-    const fieldResult = await enrichField(contact, field, config, registry, exhausted);
-    attempts.push(...fieldResult.attempts);
-    if (field === "email" && fieldResult.value) {
-      email = fieldResult.value;
-      emailProvider = fieldResult.provider;
-      charged = true;
-    } else if (field === "phone" && fieldResult.value) {
-      phone = fieldResult.value;
-      phoneProvider = fieldResult.provider;
-      charged = true;
-    }
-  }
-  if (cacheKey && (email || phone)) {
-    const existing = enrichmentCache.get(cacheKey);
-    enrichmentCache.set(cacheKey, {
-      email: email ?? existing?.email,
-      phone: phone ?? existing?.phone,
-      provider: attempts.find((a) => a.found && !a.cached)?.provider ?? existing?.provider ?? "unknown",
-      timestamp: Date.now()
-    });
-  }
-  return {
-    contact,
-    email,
-    phone,
-    email_provider: emailProvider,
-    phone_provider: phoneProvider,
-    attempts,
-    charged
-  };
-}
-async function enrichField(contact, field, config, registry, exhausted) {
-  const capability = field === "email" ? "enrich_email" : "enrich_phone";
-  const attempts = [];
-  for (const providerName of config.providers) {
-    if (exhausted.has(providerName)) {
-      attempts.push({
-        provider: providerName,
-        capability,
-        found: false,
-        charged: false,
-        duration_ms: 0,
-        error: "Skipped \u2014 provider exhausted (no credits remaining this batch)"
-      });
-      continue;
-    }
-    const provider = registry.get(providerName);
-    if (!provider || !provider.capabilities.includes(capability)) continue;
-    for (let retryAttempt = 0; retryAttempt <= WATERFALL_RETRY_DELAYS.length; retryAttempt++) {
-      const start = Date.now();
-      try {
-        let value;
-        const providerTimeoutMs = config.providerTimeoutMs ?? DEFAULT_PROVIDER_TIMEOUT_MS;
-        if (field === "email" && "enrichEmail" in provider) {
-          const result = await withTimeout(
-            provider.enrichEmail(contact),
-            providerTimeoutMs,
-            providerName
-          );
-          value = result?.email;
-        } else if (field === "phone" && "enrichPhone" in provider) {
-          const result = await withTimeout(
-            provider.enrichPhone(contact),
-            providerTimeoutMs,
-            providerName
-          );
-          value = result?.phone;
-        }
-        const found = !!value;
-        attempts.push({
-          provider: providerName,
-          capability,
-          found,
-          charged: found,
-          duration_ms: Date.now() - start
-        });
-        if (found && config.stopOnFirst) {
-          return { value, provider: providerName, attempts };
-        }
-        break;
-      } catch (error) {
-        const errorMsg = error instanceof Error ? error.message : String(error);
-        if (isExhaustedError(error)) {
-          exhausted.add(providerName);
-          attempts.push({
-            provider: providerName,
-            capability,
-            found: false,
-            charged: false,
-            duration_ms: Date.now() - start,
-            error: `Provider exhausted \u2014 skipping for remaining contacts: ${errorMsg}`
-          });
-          break;
-        }
-        if (isRateLimitError(error) && retryAttempt < WATERFALL_RETRY_DELAYS.length) {
-          const delay = WATERFALL_RETRY_DELAYS[retryAttempt];
-          await new Promise((r) => setTimeout(r, delay));
-          continue;
-        }
-        attempts.push({
-          provider: providerName,
-          capability,
-          found: false,
-          charged: false,
-          duration_ms: Date.now() - start,
-          error: errorMsg
-        });
-        logError(
-          `waterfall:${providerName}`,
-          error instanceof Error ? error : new Error(String(error)),
-          { contact: `${contact.first_name} ${contact.last_name}` }
-        );
-        break;
-      }
-    }
-  }
-  return { attempts };
-}
-function dryRunWaterfall(contactsCount, config, registry) {
-  const activeProviders = config.providers.filter((name) => registry.get(name));
-  const costs = {};
-  for (const name of activeProviders) {
-    const pricing = DEFAULT_PRICING[name];
-    if (pricing?.estimated_cost_per_hit) {
-      costs[name] = pricing.estimated_cost_per_hit;
-    } else if (pricing?.estimated_cost_per_lookup) {
-      costs[name] = `${pricing.estimated_cost_per_lookup}/lookup`;
-    } else {
-      costs[name] = "unknown";
-    }
-  }
-  return {
-    dry_run: true,
-    contacts_count: contactsCount,
-    waterfall: activeProviders,
-    pricing_model: "pay-on-find",
-    estimated_cost_per_hit: costs,
-    note: "Charged only when contact info is found. No result = no charge.",
-    confirm: "Call gtm_enrich again without dry_run to execute."
-  };
-}
-var enrichmentCache, DEFAULT_PRICING, EXHAUSTION_PATTERNS, WATERFALL_RETRY_DELAYS, DEFAULT_PROVIDER_TIMEOUT_MS, DEFAULT_BATCH_TIMEOUT_MS;
-var init_waterfall = __esm({
-  "src/providers/waterfall.ts"() {
-    "use strict";
-    init_dist();
-    enrichmentCache = /* @__PURE__ */ new Map();
-    DEFAULT_PRICING = {
-      bettercontact: { charged_only_on_find: true, estimated_cost_per_hit: "$0.10" },
-      prospeo: { charged_only_on_find: true, estimated_cost_per_hit: "$0.05" },
-      apollo: { charged_only_on_find: false, estimated_cost_per_lookup: "$0.03" },
-      hunter: { charged_only_on_find: true, estimated_cost_per_hit: "$0.05" }
-    };
-    EXHAUSTION_PATTERNS = [
-      "insufficient credits",
-      "no credits",
-      "0 credits",
-      "plan limit",
-      "quota exceeded",
-      "upgrade your plan",
-      "not accessible with this api_key on a free plan"
-    ];
-    WATERFALL_RETRY_DELAYS = [2e3, 5e3, 1e4];
-    DEFAULT_PROVIDER_TIMEOUT_MS = 15e3;
-    DEFAULT_BATCH_TIMEOUT_MS = 3e5;
-  }
-});
-
 // src/handlers/enrich.ts
 var enrich_exports = {};
 __export(enrich_exports, {
@@ -13448,7 +13820,8 @@ async function createTable(args) {
     const body = await response.json().catch(() => ({}));
     throw new Error(`Viewer API error ${response.status}: ${JSON.stringify(body)}`);
   }
-  return response.json();
+  const result = await response.json();
+  return { ...result, row_ids: rows.map((r) => r._row_id) };
 }
 async function updateTable(args) {
   const tableId = args.table_id;
@@ -13758,6 +14131,7 @@ var init_validation = __esm({
         min_employees: z2.number().int().min(0).optional(),
         max_employees: z2.number().int().min(1).optional(),
         revenue_range: z2.string().optional(),
+        enrich: z2.boolean().optional(),
         fields: z2.union([z2.literal("all"), z2.array(z2.string())]).optional(),
         output: z2.enum(["file", "inline", "csv"]).optional(),
         detail: detailSchema