gtm-now 0.10.7 → 0.10.9

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();
   }
 });
 
@@ -9630,7 +9737,8 @@ var init_prospeo2 = __esm({
           return {
             email: response.person.email.email,
             quality: response.person.email.status === "verified" ? "95%" : "70%",
-            provider: this.name
+            provider: this.name,
+            credits_consumed: 1
           };
         } catch (error) {
           logError("prospeo:enrichEmail", error instanceof Error ? error : new Error(String(error)));
@@ -10549,6 +10657,195 @@ 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,
+                credits_consumed: response.credits_consumed
+              };
+            }
+          }
+          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,
+                credits_consumed: response.credits_consumed
+              };
+            }
+          }
+          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"() {
@@ -10566,6 +10863,7 @@ var init_adapters = __esm({
     init_storeleads();
     init_harvest();
     init_exa();
+    init_leadmagic3();
   }
 });
 
@@ -10598,6 +10896,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;
   }
@@ -10893,6 +11193,10 @@ var init_prospect = __esm({
               type: "string",
               enum: ["summary", "full"],
               description: 'Response detail level. "summary" (default) returns slim results. "full" includes applied_filters and all metadata.'
+            },
+            review: {
+              type: "boolean",
+              description: "Create a viewer table with results. Returns table_id and URL for human review. Other tools can read from this table via table_id parameter."
             }
           },
           required: []
@@ -11009,6 +11313,10 @@ var init_prospect = __esm({
               type: "string",
               enum: ["summary", "full"],
               description: 'Response detail level. "summary" (default) returns slim results. "full" includes applied_filters and all metadata.'
+            },
+            review: {
+              type: "boolean",
+              description: "Create a viewer table with results. Returns table_id and URL for human review. Other tools can read from this table via table_id parameter."
             }
           },
           required: []
@@ -11066,9 +11374,17 @@ var init_enrich = __esm({
               type: "string",
               enum: ["summary", "full"],
               description: 'Response detail level. "summary" (default) returns email/phone/providers per contact. "full" includes waterfall attempt details (provider, duration, errors) per contact.'
+            },
+            table_id: {
+              type: "string",
+              description: "Read contacts from a viewer table instead of passing inline. Fetches selected rows, enriches them, and writes results back to the table."
+            },
+            review: {
+              type: "boolean",
+              description: "Create a viewer table with enrichment results."
             }
           },
-          required: ["contacts"]
+          required: []
         }
       },
       {
@@ -11311,6 +11627,10 @@ var init_campaign = __esm({
               type: "string",
               enum: ["summary", "full"],
               description: 'Response detail level. "summary" (default) returns key stats only. "full" returns all campaign data.'
+            },
+            table_id: {
+              type: "string",
+              description: "Read leads from a viewer table instead of passing inline. Fetches selected rows and maps them to campaign leads."
             }
           },
           required: ["action"]
@@ -11369,6 +11689,10 @@ var init_crm = __esm({
             provider: {
               type: "string",
               description: "CRM provider override (uses first available if omitted)"
+            },
+            table_id: {
+              type: "string",
+              description: "Read contacts from a viewer table for bulk create/update. Fetches selected rows and maps them to CRM person records."
             }
           },
           required: ["action"]
@@ -11507,12 +11831,13 @@ var init_review = __esm({
               items: { type: "object" },
               description: "Array of row objects (for create)"
             },
-            table_id: { type: "string", description: "Table ID (for update, get_selected)" },
+            table_id: { type: "string", description: "Table ID (for update, get_selected, or optional client-provided ID on create)" },
             rows: {
               type: "array",
               items: { type: "object" },
               description: "Updated row objects with _row_id (for update)"
-            }
+            },
+            ttl_seconds: { type: "number", description: "Optional TTL override in seconds (default: 24h). For create only." }
           },
           required: ["action"]
         }
@@ -11542,6 +11867,8 @@ Tip: DiscoLike lookalike mode is extremely powerful. If you have 2-3 example com
 
 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.
 
+Pass review: true to push discovery results to a visual review table at view.gtmnow.com so the user can select companies before enrichment or outreach.
+
 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
@@ -11568,7 +11895,9 @@ After finding people, use:
 - gtm_extract to check LinkedIn activity and engagement signals
 
 Known limitations:
-- department + seniority filters combined may return 0 results (Disco API uses strict AND). Use one or the other.`,
+- department + seniority filters combined may return 0 results (Disco API uses strict AND). Use one or the other.
+
+Pass review: true to push results to a visual review table at view.gtmnow.com so the user can select rows before proceeding.`,
       gtm_enrich: `Email enrichment via waterfall \u2014 tries multiple providers in order, stops on first match. Supports 1-100 contacts per call.
 
 IMPORTANT: Defaults to email only. Phone enrichment costs extra per lookup \u2014 only include when the user explicitly asks for phone numbers.
@@ -11581,7 +11910,9 @@ Providers (in configured waterfall order):
 
 Input needs: first_name + last_name minimum. Adding company_domain dramatically improves hit rates. LinkedIn URL is the gold standard input.
 
-Tip: If you got contacts from gtm_find_people with DiscoLike and they already have emails, you may not need enrichment \u2014 check the results first.`,
+Tip: If you got contacts from gtm_find_people with DiscoLike and they already have emails, you may not need enrichment \u2014 check the results first.
+
+Pass table_id to read contacts from an existing review table (selected rows only). Pass review: true to push enrichment results to a new review table.`,
       gtm_verify: "Verify a single email address for deliverability. Returns verification status: deliverable, catch_all_safe, catch_all_not_safe, undeliverable, or unknown. Use this after enrichment or to validate an existing email.",
       gtm_extract: `Extract structured data from any URL or platform. LinkedIn profiles, posts, engagement, search results, company posts, and web pages.
 
@@ -11605,8 +11936,8 @@ Pairs well with:
 Note: HarvestAPI charges per request. For engagement mining, each post lookup counts as a request. Use limit to control costs.`,
       gtm_fetch: "Make an HTTP call to any API endpoint. Use this to pull data from services that don't have a dedicated provider.",
       gtm_ai: "AI-powered data operations: personalize outreach, classify leads, clean data, score prospects, or write copy. Provide an action, input data, and optional prompt. Uses your configured AI provider (Anthropic or OpenAI).",
-      gtm_campaign: "Manage cold email AND LinkedIn outreach campaigns. List campaigns, get stats, add leads, or create a new campaign. Supports PlusVibe, Instantly, and Smartlead (email) and HeyReach (LinkedIn). For email campaigns, leads need an email. For LinkedIn campaigns, leads need a linkedin_url. Each lead must have at least one of email or linkedin_url.",
-      gtm_crm: "Read and write CRM data. Find, create, or update people and companies. Create deals. Supports Attio and other CRM providers.",
+      gtm_campaign: "Manage cold email AND LinkedIn outreach campaigns. List campaigns, get stats, add leads, or create a new campaign. Supports PlusVibe, Instantly, and Smartlead (email) and HeyReach (LinkedIn). For email campaigns, leads need an email. For LinkedIn campaigns, leads need a linkedin_url. Each lead must have at least one of email or linkedin_url. Pass table_id to read leads directly from a review table (selected rows only).",
+      gtm_crm: "Read and write CRM data. Find, create, or update people and companies. Create deals. Supports Attio and other CRM providers. For the create action, pass table_id to bulk-create contacts from a review table (selected rows only).",
       gtm_status: "Check provider health, credit balances, and active configuration. Shows which providers are configured, their capabilities, remaining credits, and the current client context.",
       gtm_configure: "Manage GTM configuration. Switch between clients, view active config, set waterfall order, list available providers.",
       gtm_guide: "CALL THIS FIRST before any multi-step GTM task. Returns step-by-step workflow recipes for common tasks like building a TAM list, running enrichment, or launching cold outreach. Always check the guide before starting work to ensure you follow the correct sequence and avoid wasting credits.",
@@ -11619,7 +11950,7 @@ Note: HarvestAPI charges per request. For engagement mining, each post lookup co
 });
 
 // src/tools/index.ts
-var capabilityTools, guideTool, toolHelpTool, executeTool, metaTools, tools, toolsByName, toolCategories, workflowRecipes;
+var capabilityTools, guideTool, toolHelpTool, executeTool, metaTools, tools, MCP_HIDDEN_TOOLS, mcpTools, toolsByName, toolCategories, workflowRecipes;
 var init_tools = __esm({
   "src/tools/index.ts"() {
     "use strict";
@@ -11715,6 +12046,8 @@ var init_tools = __esm({
     };
     metaTools = [guideTool, toolHelpTool, executeTool];
     tools = [...capabilityTools, ...metaTools];
+    MCP_HIDDEN_TOOLS = /* @__PURE__ */ new Set(["gtm_execute", "gtm_guide", "gtm_tool_help"]);
+    mcpTools = tools.filter((t) => !MCP_HIDDEN_TOOLS.has(t.name));
     toolsByName = new Map(tools.map((tool) => [tool.name, tool]));
     toolCategories = {
       prospect: prospectTools.map((t) => t.name),
@@ -11974,6 +12307,7 @@ async function enrichContact(contact, config, registry, exhausted) {
   let phone;
   let phoneProvider;
   let charged = false;
+  let creditsConsumed;
   const cacheKey = getCacheKey(contact);
   const cached = cacheKey ? enrichmentCache.get(cacheKey) : null;
   for (const field of config.find) {
@@ -12004,6 +12338,9 @@ async function enrichContact(contact, config, registry, exhausted) {
       email = fieldResult.value;
       emailProvider = fieldResult.provider;
       charged = true;
+      if (fieldResult.credits_consumed) {
+        creditsConsumed = (creditsConsumed ?? 0) + fieldResult.credits_consumed;
+      }
     } else if (field === "phone" && fieldResult.value) {
       phone = fieldResult.value;
       phoneProvider = fieldResult.provider;
@@ -12026,7 +12363,8 @@ async function enrichContact(contact, config, registry, exhausted) {
     email_provider: emailProvider,
     phone_provider: phoneProvider,
     attempts,
-    charged
+    charged,
+    ...creditsConsumed !== void 0 && { credits_consumed: creditsConsumed }
   };
 }
 async function enrichField(contact, field, config, registry, exhausted) {
@@ -12051,6 +12389,7 @@ async function enrichField(contact, field, config, registry, exhausted) {
       try {
         let value;
         const providerTimeoutMs = config.providerTimeoutMs ?? DEFAULT_PROVIDER_TIMEOUT_MS;
+        let creditsConsumed;
         if (field === "email" && "enrichEmail" in provider) {
           const result = await withTimeout(
             provider.enrichEmail(contact),
@@ -12058,6 +12397,7 @@ async function enrichField(contact, field, config, registry, exhausted) {
             providerName
           );
           value = result?.email;
+          creditsConsumed = result?.credits_consumed;
         } else if (field === "phone" && "enrichPhone" in provider) {
           const result = await withTimeout(
             provider.enrichPhone(contact),
@@ -12075,7 +12415,7 @@ async function enrichField(contact, field, config, registry, exhausted) {
           duration_ms: Date.now() - start
         });
         if (found && config.stopOnFirst) {
-          return { value, provider: providerName, attempts };
+          return { value, provider: providerName, credits_consumed: creditsConsumed, attempts };
         }
         break;
       } catch (error) {
@@ -12149,7 +12489,8 @@ var init_waterfall = __esm({
       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" }
+      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",
@@ -12166,6 +12507,123 @@ var init_waterfall = __esm({
   }
 });
 
+// src/utils/table-bridge.ts
+function asString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function splitName(full) {
+  const idx = full.indexOf(" ");
+  if (idx === -1) return { first_name: full, last_name: "" };
+  return { first_name: full.slice(0, idx), last_name: full.slice(idx + 1) };
+}
+async function createReviewTable(title, data, options) {
+  try {
+    const rows = data.map((row, i) => ({
+      _row_id: `r${i + 1}`,
+      ...row
+    }));
+    const body = { title, rows };
+    if (options?.table_id !== void 0) body.table_id = options.table_id;
+    if (options?.ttl_seconds !== void 0) body.ttl_seconds = options.ttl_seconds;
+    const response = await fetch(`${VIEWER_URL}/api/tables`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      logError("table-bridge.createReviewTable", new Error(`Viewer returned ${response.status}`), {
+        title,
+        status: response.status
+      });
+      return null;
+    }
+    return await response.json();
+  } catch (error) {
+    logError("table-bridge.createReviewTable", error, { title });
+    return null;
+  }
+}
+async function fetchTableRows(tableId) {
+  try {
+    const response = await fetch(`${VIEWER_URL}/api/tables/${tableId}/selected`);
+    if (!response.ok) {
+      logError("table-bridge.fetchTableRows", new Error(`Viewer returned ${response.status}`), {
+        tableId,
+        status: response.status
+      });
+      return [];
+    }
+    const json = await response.json();
+    return json.rows ?? [];
+  } catch (error) {
+    logError("table-bridge.fetchTableRows", error, { tableId });
+    return [];
+  }
+}
+async function patchTableRows(tableId, rows) {
+  try {
+    const response = await fetch(`${VIEWER_URL}/api/tables/${tableId}`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ rows })
+    });
+    if (!response.ok) {
+      logError("table-bridge.patchTableRows", new Error(`Viewer returned ${response.status}`), {
+        tableId,
+        status: response.status
+      });
+      return false;
+    }
+    return true;
+  } catch (error) {
+    logError("table-bridge.patchTableRows", error, { tableId });
+    return false;
+  }
+}
+function mapRowsToContacts(rows) {
+  return rows.map((row) => {
+    let firstName = asString(row.first_name);
+    let lastName = asString(row.last_name);
+    if (firstName === void 0 || lastName === void 0) {
+      const fullName = asString(row.name) ?? asString(row.full_name);
+      if (fullName) {
+        const parts = splitName(fullName);
+        firstName ??= parts.first_name;
+        lastName ??= parts.last_name;
+      }
+    }
+    return {
+      first_name: firstName ?? "",
+      last_name: lastName ?? "",
+      company: asString(row.company) ?? asString(row.company_name),
+      company_domain: asString(row.company_domain) ?? asString(row.domain),
+      linkedin_url: asString(row.linkedin_url) ?? asString(row.linkedin)
+    };
+  });
+}
+function mapRowsToCampaignLeads(rows) {
+  const leads = [];
+  for (const row of rows) {
+    const email = asString(row.email);
+    if (!email || email.includes("*")) continue;
+    leads.push({
+      email,
+      first_name: asString(row.first_name),
+      last_name: asString(row.last_name),
+      company: asString(row.company) ?? asString(row.company_name)
+    });
+  }
+  return leads;
+}
+var VIEWER_URL;
+var init_table_bridge = __esm({
+  "src/utils/table-bridge.ts"() {
+    "use strict";
+    init_dist();
+    VIEWER_URL = process.env.GTM_VIEWER_URL ?? "https://gtm-viewer-production.up.railway.app";
+  }
+});
+
 // src/providers/types.ts
 function applySlimFields(obj, fields) {
   const result = {};
@@ -12398,6 +12856,27 @@ async function findCompanies(args, ctx) {
   });
   const offset = args.offset ?? 0;
   const has_more = results.length >= effectiveLimit;
+  const hints = [];
+  if (results.length >= effectiveLimit) {
+    hints.push(
+      `Returned ${results.length} results (limit reached). Increase limit or use offset for more.`
+    );
+  }
+  const shouldReview = args.review ?? false;
+  let tableId;
+  let tableUrl;
+  if (shouldReview) {
+    const tableResult = await createReviewTable(
+      `Find Companies: ${query.icp_text ?? query.domain ?? "results"}`,
+      slimmedResults
+    );
+    if (tableResult) {
+      tableId = tableResult.table_id;
+      tableUrl = tableResult.url;
+    } else {
+      hints.push("Review table creation failed \u2014 results returned inline only.");
+    }
+  }
   const applied_filters = {};
   if (query.icp_text) applied_filters.icp_text = query.icp_text;
   if (query.domain) applied_filters.domain = query.domain;
@@ -12452,9 +12931,11 @@ async function findCompanies(args, ctx) {
     count: results.length,
     has_more,
     offset,
+    ...tableId && { table_id: tableId, url: tableUrl },
     ...Object.keys(applied_filters).length > 0 && { applied_filters },
     companies: slimmedResults,
-    ...warnings?.length ? { warnings } : {}
+    ...warnings?.length ? { warnings } : {},
+    ...hints.length > 0 && { hints }
   };
 }
 async function findPeople(args, ctx) {
@@ -12495,10 +12976,10 @@ async function findPeople(args, ctx) {
   const dedupedResults = deduplicatePeople(results);
   const shouldEnrich = args.enrich ?? false;
   let enrichedCount = 0;
+  let needsEnrichmentCount = 0;
   if (shouldEnrich) {
-    const needsEnrichment = dedupedResults.filter(
-      (r) => !r.email || r.email.includes("*")
-    );
+    const needsEnrichment = dedupedResults.filter((r) => !r.email || r.email.includes("*"));
+    needsEnrichmentCount = needsEnrichment.length;
     if (needsEnrichment.length > 0) {
       try {
         const contacts = needsEnrichment.map((r) => ({
@@ -12526,7 +13007,10 @@ async function findPeople(args, ctx) {
           }
         }
       } catch (error) {
-        logError("prospect:inlineEnrich", error instanceof Error ? error : new Error(String(error)));
+        logError(
+          "prospect:inlineEnrich",
+          error instanceof Error ? error : new Error(String(error))
+        );
       }
     }
   }
@@ -12555,6 +13039,37 @@ async function findPeople(args, ctx) {
   if (query.min_employees != null) applied_filters.min_employees = query.min_employees;
   if (query.max_employees != null) applied_filters.max_employees = query.max_employees;
   if (query.revenue_range) applied_filters.revenue_range = query.revenue_range;
+  const hints = [];
+  const maskedCount = dedupedResults.filter((r) => r.email?.includes("*")).length;
+  if (maskedCount > 0) {
+    hints.push(
+      `${maskedCount} emails are masked by the provider. Pass enrich: true to resolve them.`
+    );
+  }
+  if (dedupedResults.length >= effectiveLimit) {
+    hints.push(
+      `Returned ${dedupedResults.length} results (limit reached). Increase limit or use offset for more.`
+    );
+  }
+  if (shouldEnrich && enrichedCount < needsEnrichmentCount) {
+    const failed = needsEnrichmentCount - enrichedCount;
+    hints.push(`${failed} contacts could not be enriched \u2014 missing LinkedIn URL or domain.`);
+  }
+  const shouldReview = args.review ?? false;
+  let tableId;
+  let tableUrl;
+  if (shouldReview) {
+    const tableResult = await createReviewTable(
+      `Find People: ${query.job_title ?? query.company_domain ?? "results"}`,
+      slimmedResults
+    );
+    if (tableResult) {
+      tableId = tableResult.table_id;
+      tableUrl = tableResult.url;
+    } else {
+      hints.push("Review table creation failed \u2014 results returned inline only.");
+    }
+  }
   const providerUsed = provider.name;
   const output = args.output;
   if (output === "csv") {
@@ -12595,10 +13110,12 @@ async function findPeople(args, ctx) {
     count: dedupedResults.length,
     has_more,
     offset,
+    ...tableId && { table_id: tableId, url: tableUrl },
     ...Object.keys(applied_filters).length > 0 && { applied_filters },
     ...shouldEnrich && { enriched: enrichedCount },
     people: slimmedResults,
-    ...warnings?.length ? { warnings } : {}
+    ...warnings?.length ? { warnings } : {},
+    ...hints.length > 0 && { hints }
   };
 }
 var init_prospect2 = __esm({
@@ -12607,6 +13124,7 @@ var init_prospect2 = __esm({
     init_dist();
     init_errors();
     init_waterfall();
+    init_table_bridge();
     init_types3();
     init_manifest_validation();
     init_result_writer();
@@ -12639,10 +13157,29 @@ async function handleEnrich(name, args, ctx) {
   return enrichContacts(args, ctx);
 }
 async function enrichContacts(args, ctx) {
-  const contacts = args.contacts;
+  let contacts = args.contacts;
   const find = args.find ?? ["email"];
   const verify = args.verify ?? true;
   const dryRun = args.dry_run ?? false;
+  const detail = args.detail ?? "summary";
+  const tableId = args.table_id;
+  let rowIds = [];
+  if (tableId) {
+    const tableRows = await fetchTableRows(tableId);
+    if (tableRows.length === 0) {
+      return {
+        total: 0,
+        found: 0,
+        missed: 0,
+        results: [],
+        hints: [
+          "No rows selected in table. User may not have reviewed yet, or may have deselected all."
+        ]
+      };
+    }
+    rowIds = tableRows.map((r) => r._row_id);
+    contacts = mapRowsToContacts(tableRows);
+  }
   const WATERFALL_FIELDS = ["email", "phone"];
   const richFields = find.filter((f) => !WATERFALL_FIELDS.includes(f));
   if (richFields.length > 0) {
@@ -12675,11 +13212,65 @@ async function enrichContacts(args, ctx) {
   }
   const results = await runWaterfall(contacts, config, ctx.registry);
   const found = results.filter((r) => r.email || r.phone).length;
-  const detail = args.detail ?? "summary";
+  if (tableId) {
+    const patchPayload = results.map((r, i) => ({
+      _row_id: rowIds[i],
+      ...r.email && { email: r.email },
+      ...r.email_provider && { email_provider: r.email_provider },
+      ...r.email_status && { email_status: r.email_status }
+    }));
+    await patchTableRows(tableId, patchPayload);
+  }
+  const hints = [];
+  const exhaustedAttempts = results.flatMap(
+    (r) => r.attempts.filter((a) => a.error?.includes("exhausted"))
+  );
+  if (exhaustedAttempts.length > 0) {
+    const provider = exhaustedAttempts[0].provider;
+    hints.push(
+      `${provider} credits exhausted mid-batch. Remaining contacts fell through to next provider.`
+    );
+  }
+  const noLinkedin = contacts.filter((c) => !c.linkedin_url).length;
+  if (noLinkedin > 0) {
+    hints.push(`${noLinkedin} contacts had no LinkedIn URL \u2014 some providers skipped them.`);
+  }
+  const timedOut = results.filter(
+    (r) => r.attempts.some((a) => a.error?.includes("Batch timeout"))
+  ).length;
+  if (timedOut > 0) {
+    hints.push(`Batch timed out with ${timedOut} contacts remaining. Re-run with those contacts.`);
+  }
+  const costMap = /* @__PURE__ */ new Map();
+  for (const r of results) {
+    if (r.credits_consumed && r.email_provider) {
+      costMap.set(r.email_provider, (costMap.get(r.email_provider) ?? 0) + r.credits_consumed);
+    }
+  }
+  const cost = costMap.size > 0 ? Array.from(costMap.entries()).map(([provider, credits]) => ({ provider, credits })) : void 0;
+  const shouldReview = args.review ?? false;
+  let reviewTableId;
+  let reviewUrl;
+  if (shouldReview) {
+    const tableResult = await createReviewTable(
+      "Enrichment Results",
+      detail === "full" ? results : slimEnrichResults(results)
+    );
+    if (tableResult) {
+      reviewTableId = tableResult.table_id;
+      reviewUrl = tableResult.url;
+    } else {
+      hints.push("Review table creation failed \u2014 results returned inline only.");
+    }
+  }
   return {
     total: results.length,
     found,
     missed: results.length - found,
+    ...tableId && { table_id: tableId },
+    ...reviewTableId && { table_id: reviewTableId, url: reviewUrl },
+    ...hints.length > 0 && { hints },
+    ...cost && { cost },
     results: detail === "full" ? results : slimEnrichResults(results)
   };
 }
@@ -12701,6 +13292,7 @@ var init_enrich2 = __esm({
     "use strict";
     init_waterfall();
     init_errors();
+    init_table_bridge();
   }
 });
 
@@ -13136,11 +13728,38 @@ async function handleCampaign(args, ctx) {
     }
     case "add_leads": {
       const campaignId = args.campaign_id;
-      const rawLeads = args.leads;
+      const tableId = args.table_id;
       if (!campaignId)
         throw createGtmError("QUERY_INVALID", "campaign_id is required for add_leads action");
+      const hints = [];
+      let rawLeads = args.leads;
+      if (tableId) {
+        const tableRows = await fetchTableRows(tableId);
+        if (tableRows.length === 0) {
+          return {
+            provider: channel.providerName,
+            added: 0,
+            hints: [
+              "No rows selected in table. User may not have reviewed yet, or may have deselected all."
+            ]
+          };
+        }
+        if (channel.type === "linkedin") {
+          rawLeads = tableRows;
+        } else {
+          const mapped = mapRowsToCampaignLeads(tableRows);
+          const skipped = tableRows.length - mapped.length;
+          if (skipped > 0) {
+            hints.push(`${skipped} rows skipped \u2014 missing email (required for campaign).`);
+          }
+          rawLeads = mapped;
+        }
+      }
       if (!rawLeads?.length)
-        throw createGtmError("QUERY_INVALID", "leads array is required for add_leads action");
+        throw createGtmError(
+          "QUERY_INVALID",
+          "leads array is required for add_leads action (or provide table_id)"
+        );
       if (channel.type === "linkedin") {
         const leads2 = rawLeads.map((l) => ({
           linkedin_url: l.linkedin_url,
@@ -13148,7 +13767,11 @@ async function handleCampaign(args, ctx) {
           last_name: l.last_name,
           company: l.company
         }));
-        return channel.manager.addLeadsToCampaign(campaignId, leads2);
+        const result = await channel.manager.addLeadsToCampaign(campaignId, leads2);
+        return {
+          ...result,
+          ...hints.length > 0 && { hints }
+        };
       }
       const leads = rawLeads.map((l) => ({
         email: l.email,
@@ -13158,7 +13781,11 @@ async function handleCampaign(args, ctx) {
         custom_fields: l.custom_fields
       }));
       try {
-        return await channel.manager.addLeadsToCampaign(campaignId, leads);
+        const result = await channel.manager.addLeadsToCampaign(campaignId, leads);
+        return {
+          ...result,
+          ...hints.length > 0 && { hints }
+        };
       } catch (error) {
         if (error instanceof ApiClientError && (error.message.includes("Validation error") || error.statusCode === 400 || error.statusCode === 422)) {
           throw createGtmError(
@@ -13196,6 +13823,7 @@ var init_campaign2 = __esm({
     "use strict";
     init_dist2();
     init_errors();
+    init_table_bridge();
   }
 });
 
@@ -13223,6 +13851,28 @@ async function handleCrm(args, ctx) {
       return manager.findPerson(query);
     }
     case "create": {
+      const tableId = args.table_id;
+      if (tableId) {
+        const rows = await fetchTableRows(tableId);
+        if (rows.length === 0) {
+          return {
+            created: 0,
+            hints: ["No selected rows found in the review table. Select rows in the viewer and retry."]
+          };
+        }
+        const contacts = mapRowsToContacts(rows);
+        const results = await Promise.allSettled(
+          contacts.map((contact) => manager.createPerson(contact))
+        );
+        const created = results.filter((r) => r.status === "fulfilled").length;
+        const failed = results.filter((r) => r.status === "rejected").length;
+        return {
+          created,
+          failed,
+          total: contacts.length,
+          hints: failed > 0 ? [`${failed} contact(s) failed to create \u2014 check for duplicates or missing fields.`] : void 0
+        };
+      }
       const data = args.data;
       if (!data) throw new Error("data is required for create action");
       return manager.createPerson(data);
@@ -13254,6 +13904,7 @@ async function handleCrm(args, ctx) {
 var init_crm2 = __esm({
   "src/handlers/crm.ts"() {
     "use strict";
+    init_table_bridge();
   }
 });
 
@@ -13509,14 +14160,21 @@ async function handleReview(args) {
 async function createTable(args) {
   const data = args.data;
   const title = args.title ?? "Review Table";
+  const tableId = args.table_id;
+  const ttlSeconds = args.ttl_seconds;
   const rows = data.map((row, i) => ({
     ...row,
     _row_id: row._row_id ?? `r${i + 1}`
   }));
-  const response = await fetch(`${VIEWER_URL}/api/tables`, {
+  const response = await fetch(`${VIEWER_URL2}/api/tables`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ title, rows })
+    body: JSON.stringify({
+      title,
+      rows,
+      ...tableId && { table_id: tableId },
+      ...ttlSeconds && { ttl_seconds: ttlSeconds }
+    })
   });
   if (!response.ok) {
     const body = await response.json().catch(() => ({}));
@@ -13528,7 +14186,7 @@ async function createTable(args) {
 async function updateTable(args) {
   const tableId = args.table_id;
   const rows = args.rows;
-  const response = await fetch(`${VIEWER_URL}/api/tables/${tableId}`, {
+  const response = await fetch(`${VIEWER_URL2}/api/tables/${tableId}`, {
     method: "PATCH",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({ rows })
@@ -13541,18 +14199,18 @@ async function updateTable(args) {
 }
 async function getSelected(args) {
   const tableId = args.table_id;
-  const response = await fetch(`${VIEWER_URL}/api/tables/${tableId}/selected`);
+  const response = await fetch(`${VIEWER_URL2}/api/tables/${tableId}/selected`);
   if (!response.ok) {
     const body = await response.json().catch(() => ({}));
     throw new Error(`Viewer API error ${response.status}: ${JSON.stringify(body)}`);
   }
   return response.json();
 }
-var VIEWER_URL;
+var VIEWER_URL2;
 var init_review2 = __esm({
   "src/handlers/review.ts"() {
     "use strict";
-    VIEWER_URL = process.env.GTM_VIEWER_URL ?? "https://gtm-viewer-production.up.railway.app";
+    VIEWER_URL2 = process.env.GTM_VIEWER_URL ?? "https://gtm-viewer-production.up.railway.app";
   }
 });
 
@@ -13794,7 +14452,8 @@ var init_validation = __esm({
         min_revenue: z2.number().optional(),
         max_revenue: z2.number().optional(),
         output: z2.enum(["file", "inline", "csv"]).optional(),
-        detail: detailSchema
+        detail: detailSchema,
+        review: z2.boolean().optional()
       }),
       // 2. People/contact search
       gtm_find_people: z2.object({
@@ -13834,6 +14493,7 @@ var init_validation = __esm({
         max_employees: z2.number().int().min(1).optional(),
         revenue_range: z2.string().optional(),
         enrich: z2.boolean().optional(),
+        review: z2.boolean().optional(),
         fields: z2.union([z2.literal("all"), z2.array(z2.string())]).optional(),
         output: z2.enum(["file", "inline", "csv"]).optional(),
         detail: detailSchema
@@ -13845,12 +14505,16 @@ var init_validation = __esm({
       ),
       // 3. Enrichment waterfall
       gtm_enrich: z2.object({
-        contacts: z2.array(contactInputSchema).min(1, "contacts must contain at least 1 contact").max(100, "contacts must contain at most 100 contacts"),
+        contacts: z2.array(contactInputSchema).max(100, "contacts must contain at most 100 contacts").optional(),
         find: z2.array(z2.enum(["email", "phone", "title", "company", "funding", "tech_stack"])).optional(),
         waterfall: z2.array(z2.string()).optional(),
         verify: z2.boolean().optional(),
         dry_run: z2.boolean().optional(),
-        detail: detailSchema
+        detail: detailSchema,
+        table_id: z2.string().optional(),
+        review: z2.boolean().optional()
+      }).refine((data) => !!(data.contacts?.length || data.table_id), {
+        message: "At least one of contacts or table_id is required"
       }),
       // 4. Email verification
       gtm_verify: z2.object({
@@ -13934,7 +14598,8 @@ var init_validation = __esm({
         leads: z2.array(campaignLeadSchema).optional(),
         name: z2.string().optional(),
         provider: z2.string().optional(),
-        detail: detailSchema
+        detail: detailSchema,
+        table_id: z2.string().optional()
       }),
       // 10. CRM read/write
       gtm_crm: z2.object({
@@ -13943,7 +14608,8 @@ var init_validation = __esm({
         }),
         query: z2.record(z2.unknown()).optional(),
         data: z2.record(z2.unknown()).optional(),
-        id: z2.string().optional()
+        id: z2.string().optional(),
+        table_id: z2.string().optional()
       }),
       // 11. Provider status/credits
       gtm_status: z2.object({
@@ -13996,7 +14662,9 @@ var init_validation = __esm({
         z2.object({
           action: z2.literal("create"),
           title: z2.string().optional(),
-          data: z2.array(z2.record(z2.unknown())).min(1, "data must contain at least 1 row")
+          data: z2.array(z2.record(z2.unknown())).min(1, "data must contain at least 1 row"),
+          table_id: z2.string().optional(),
+          ttl_seconds: z2.number().optional()
         }),
         z2.object({
           action: z2.literal("update"),
@@ -14035,7 +14703,7 @@ function createServer() {
     { capabilities: { tools: {} } }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools
+    tools: mcpTools
   }));
   server.setRequestHandler(CallToolRequestSchema, async (request, _extra) => {
     const { name, arguments: args = {} } = request.params;