gtm-now 0.10.5 → 0.10.7

package/dist/index.js

@@ -9481,13 +9481,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 +9578,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;
@@ -10784,7 +10794,7 @@ var init_prospect = __esm({
     prospectTools = [
       {
         name: "gtm_find_companies",
-        description: "Discover companies matching ICP criteria via DiscoLike, Apollo, or StoreLeads. Supports lookalike discovery, ICP text, tech stack filtering. Use gtm_tool_help for full parameter details.",
+        description: 'Discover companies matching ICP criteria via DiscoLike, Apollo, StoreLeads, or Exa (semantic/neural search). Use provider: "exa" for meaning-based search that understands intent, not just keywords.',
         inputSchema: {
           type: "object",
           properties: {
@@ -10890,7 +10900,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 +10989,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: [
@@ -11526,7 +11540,15 @@ For DTC/e-commerce brands, use provider: "storeleads" \u2014 it has revenue esti
 
 Tip: DiscoLike lookalike mode is extremely powerful. If you have 2-3 example companies, use the domains parameter to find hundreds of similar ones.
 
-Single domain lookup: passing just domain (no icp_text, domains, category, tech_stack, or country) does a direct company profile fetch with rich data (growth signals, engagement metrics, tech stack from vendors). This is for researching ONE specific company, not discovery.`,
+Single domain lookup: passing just domain (no icp_text, domains, category, tech_stack, or country) does a direct company profile fetch with rich data (growth signals, engagement metrics, tech stack from vendors). This is for researching ONE specific company, not discovery.
+
+Exa (provider: "exa") \u2014 semantic/neural search:
+- Meaning-based ICP matching: "B2B SaaS companies selling to healthcare, not healthtech vendors" actually works
+- Best for: nuanced ICP descriptions where keyword matching fails
+- Uses icp_text for semantic search, domains for lookalike discovery
+- Does NOT return employee count, industry, or tech stack \u2014 use for discovery, then enrich with DiscoLike or Apollo
+- Must be explicitly selected with provider: "exa" (not auto-selected)
+- Requires GTM_EXA_API_KEY env var`,
       gtm_find_people: `Find contacts at companies by job title, company, or domain. Returns name, title, email (when available), phone, and LinkedIn URL.
 
 Powered by DiscoLike Contacts, Apollo, or BetterContact depending on configuration.
@@ -11864,171 +11886,451 @@ 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;
-}
-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;
+// src/providers/waterfall.ts
+function getCacheKey(contact) {
+  if (!contact.linkedin_url) return null;
+  return contact.linkedin_url.toLowerCase().trim();
 }
-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);
+function isExhaustedError(error) {
+  const msg = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+  return EXHAUSTION_PATTERNS.some((p) => msg.includes(p));
 }
-var controlSet;
-var init_manifest_validation = __esm({
-  "src/providers/manifest-validation.ts"() {
-    "use strict";
-    init_manifests();
-    init_manifest_types();
-    controlSet = new Set(CONTROL_PARAMS);
+function isRateLimitError(error) {
+  if (error instanceof Error && "status" in error) {
+    return error.status === 429;
   }
-});
-
-// src/utils/result-writer.ts
-import * as fs from "fs";
-import * as path from "path";
-import * as os from "os";
-function shouldWriteToFile(count, output) {
-  if (output === "file") return true;
-  if (output === "inline") return false;
-  if (output === "csv") return false;
-  return count > FILE_OUTPUT_THRESHOLD;
+  const msg = error instanceof Error ? error.message : String(error);
+  return msg.includes("429") || msg.toLowerCase().includes("rate limit");
 }
-function writeResultsFile(tool, results, meta, resultsDir = DEFAULT_RESULTS_DIR) {
-  fs.mkdirSync(resultsDir, { recursive: true });
-  const timestamp = formatTimestamp(/* @__PURE__ */ new Date());
-  const filename = `${tool}-${timestamp}.jsonl`;
-  const filePath = path.join(resultsDir, filename);
-  const metaLine = JSON.stringify({ _meta: { ...meta, timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
-  const dataLines = results.map((r) => JSON.stringify(r));
-  const content = [metaLine, ...dataLines].join("\n") + "\n";
-  fs.writeFileSync(filePath, content, "utf-8");
-  try {
-    cleanOldResults(7, resultsDir);
-  } catch {
-  }
-  return filePath;
+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);
+      }
+    );
+  });
 }
-function writeResultsCsv(tool, results, resultsDir = DEFAULT_RESULTS_DIR) {
-  fs.mkdirSync(resultsDir, { recursive: true });
-  const timestamp = formatTimestamp(/* @__PURE__ */ new Date());
-  const filename = `${tool}-${timestamp}.csv`;
-  const filePath = path.join(resultsDir, filename);
-  if (results.length === 0) {
-    fs.writeFileSync(filePath, "", "utf-8");
-    return filePath;
-  }
-  const headers = Object.keys(results[0]);
-  const headerLine = headers.map(escapeCsvField).join(",");
-  const dataLines = results.map(
-    (row) => headers.map((h) => escapeCsvField(formatCsvValue(row[h]))).join(",")
-  );
-  const content = [headerLine, ...dataLines].join("\n") + "\n";
-  fs.writeFileSync(filePath, content, "utf-8");
-  try {
-    cleanOldResults(7, resultsDir);
-  } catch {
+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 filePath;
-}
-function formatCsvValue(value) {
-  if (value === null || value === void 0) return "";
-  if (Array.isArray(value)) return value.join(";");
-  if (typeof value === "object") return JSON.stringify(value);
-  return String(value);
+  await Promise.all(Array.from({ length: Math.min(concurrency, contacts.length) }, () => worker()));
+  return results;
 }
-function escapeCsvField(value) {
-  if (value.includes(",") || value.includes('"') || value.includes("\n")) {
-    return `"${value.replace(/"/g, '""')}"`;
-  }
-  return value;
+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
+  };
 }
-function cleanOldResults(maxAgeDays, resultsDir = DEFAULT_RESULTS_DIR) {
-  let entries;
-  try {
-    entries = fs.readdirSync(resultsDir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1e3;
-  for (const entry of entries) {
-    if (!entry.isFile() || !entry.name.endsWith(".jsonl")) continue;
-    const filePath = path.join(resultsDir, entry.name);
-    try {
-      const stat = fs.statSync(filePath);
-      if (stat.mtimeMs < cutoff) {
-        fs.unlinkSync(filePath);
+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;
       }
-    } catch {
+      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;
     }
   }
-}
-function formatTimestamp(date) {
-  const pad = (n) => String(n).padStart(2, "0");
-  return `${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}-${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`;
-}
-var FILE_OUTPUT_THRESHOLD, DEFAULT_RESULTS_DIR;
-var init_result_writer = __esm({
-  "src/utils/result-writer.ts"() {
-    "use strict";
-    FILE_OUTPUT_THRESHOLD = 20;
-    DEFAULT_RESULTS_DIR = path.join(os.homedir(), ".gtm", "results");
+  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()
+    });
   }
-});
-
-// src/handlers/prospect.ts
-var prospect_exports = {};
-__export(prospect_exports, {
-  handleProspect: () => handleProspect
-});
-function deduplicatePeople(people) {
-  const seen = /* @__PURE__ */ new Set();
+  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/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({
+  "src/providers/manifest-validation.ts"() {
+    "use strict";
+    init_manifests();
+    init_manifest_types();
+    controlSet = new Set(CONTROL_PARAMS);
+  }
+});
+
+// src/utils/result-writer.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+function shouldWriteToFile(count, output) {
+  if (output === "file") return true;
+  if (output === "inline") return false;
+  if (output === "csv") return false;
+  return count > FILE_OUTPUT_THRESHOLD;
+}
+function writeResultsFile(tool, results, meta, resultsDir = DEFAULT_RESULTS_DIR) {
+  fs.mkdirSync(resultsDir, { recursive: true });
+  const timestamp = formatTimestamp(/* @__PURE__ */ new Date());
+  const filename = `${tool}-${timestamp}.jsonl`;
+  const filePath = path.join(resultsDir, filename);
+  const metaLine = JSON.stringify({ _meta: { ...meta, timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
+  const dataLines = results.map((r) => JSON.stringify(r));
+  const content = [metaLine, ...dataLines].join("\n") + "\n";
+  fs.writeFileSync(filePath, content, "utf-8");
+  try {
+    cleanOldResults(7, resultsDir);
+  } catch {
+  }
+  return filePath;
+}
+function writeResultsCsv(tool, results, resultsDir = DEFAULT_RESULTS_DIR) {
+  fs.mkdirSync(resultsDir, { recursive: true });
+  const timestamp = formatTimestamp(/* @__PURE__ */ new Date());
+  const filename = `${tool}-${timestamp}.csv`;
+  const filePath = path.join(resultsDir, filename);
+  if (results.length === 0) {
+    fs.writeFileSync(filePath, "", "utf-8");
+    return filePath;
+  }
+  const headers = Object.keys(results[0]);
+  const headerLine = headers.map(escapeCsvField).join(",");
+  const dataLines = results.map(
+    (row) => headers.map((h) => escapeCsvField(formatCsvValue(row[h]))).join(",")
+  );
+  const content = [headerLine, ...dataLines].join("\n") + "\n";
+  fs.writeFileSync(filePath, content, "utf-8");
+  try {
+    cleanOldResults(7, resultsDir);
+  } catch {
+  }
+  return filePath;
+}
+function formatCsvValue(value) {
+  if (value === null || value === void 0) return "";
+  if (Array.isArray(value)) return value.join(";");
+  if (typeof value === "object") return JSON.stringify(value);
+  return String(value);
+}
+function escapeCsvField(value) {
+  if (value.includes(",") || value.includes('"') || value.includes("\n")) {
+    return `"${value.replace(/"/g, '""')}"`;
+  }
+  return value;
+}
+function cleanOldResults(maxAgeDays, resultsDir = DEFAULT_RESULTS_DIR) {
+  let entries;
+  try {
+    entries = fs.readdirSync(resultsDir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1e3;
+  for (const entry of entries) {
+    if (!entry.isFile() || !entry.name.endsWith(".jsonl")) continue;
+    const filePath = path.join(resultsDir, entry.name);
+    try {
+      const stat = fs.statSync(filePath);
+      if (stat.mtimeMs < cutoff) {
+        fs.unlinkSync(filePath);
+      }
+    } catch {
+    }
+  }
+}
+function formatTimestamp(date) {
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}-${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`;
+}
+var FILE_OUTPUT_THRESHOLD, DEFAULT_RESULTS_DIR;
+var init_result_writer = __esm({
+  "src/utils/result-writer.ts"() {
+    "use strict";
+    FILE_OUTPUT_THRESHOLD = 20;
+    DEFAULT_RESULTS_DIR = path.join(os.homedir(), ".gtm", "results");
+  }
+});
+
+// src/handlers/prospect.ts
+var prospect_exports = {};
+__export(prospect_exports, {
+  handleProspect: () => handleProspect
+});
+function deduplicatePeople(people) {
+  const seen = /* @__PURE__ */ new Set();
   return people.filter((p) => {
     const key = p.linkedin_url ?? p.email ?? `${p.first_name}_${p.last_name}_${p.company}`;
     if (seen.has(key)) return false;
@@ -12191,6 +12493,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
@@ -12257,6 +12596,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 } : {}
   };
@@ -12264,7 +12604,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();
@@ -12272,266 +12614,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, {
@@ -13440,7 +13522,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;
@@ -13750,6 +13833,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