gtm-now 0.10.8 → 0.10.10

package/dist/index.js

@@ -205,8 +205,7 @@ 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_LEADMAGIC_API_KEY: "leadmagic"
+      GTM_EXA_API_KEY: "exa"
     };
     ENV_WORKSPACE_MAP = {
       GTM_PLUSVIBE_WORKSPACE_ID: "plusvibe"
@@ -8739,107 +8738,10 @@ 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)
-        });
-      }
-    };
   }
 });
 
@@ -9737,7 +9639,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)));
@@ -10656,193 +10559,6 @@ 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"() {
@@ -10860,7 +10576,6 @@ var init_adapters = __esm({
     init_storeleads();
     init_harvest();
     init_exa();
-    init_leadmagic3();
   }
 });
 
@@ -10893,8 +10608,6 @@ 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;
   }
@@ -11190,6 +10903,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: []
@@ -11306,6 +11023,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: []
@@ -11363,9 +11084,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: []
         }
       },
       {
@@ -11608,6 +11337,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"]
@@ -11666,6 +11399,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"]
@@ -11804,11 +11541,18 @@ 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"]
@@ -11839,6 +11583,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
@@ -11865,7 +11611,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.
@@ -11878,7 +11626,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.
 
@@ -11902,8 +11652,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.",
@@ -11916,7 +11666,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";
@@ -12012,6 +11762,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),
@@ -12271,6 +12023,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) {
@@ -12301,6 +12054,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;
@@ -12323,7 +12079,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) {
@@ -12348,6 +12105,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),
@@ -12355,6 +12113,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),
@@ -12372,7 +12131,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) {
@@ -12464,6 +12223,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 = {};
@@ -12696,6 +12572,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;
@@ -12750,9 +12647,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) {
@@ -12793,10 +12692,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) => ({
@@ -12824,7 +12723,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))
+        );
       }
     }
   }
@@ -12853,6 +12755,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") {
@@ -12893,10 +12826,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({
@@ -12905,6 +12840,7 @@ var init_prospect2 = __esm({
     init_dist();
     init_errors();
     init_waterfall();
+    init_table_bridge();
     init_types3();
     init_manifest_validation();
     init_result_writer();
@@ -12937,10 +12873,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) {
@@ -12973,11 +12928,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)
   };
 }
@@ -12999,6 +13008,7 @@ var init_enrich2 = __esm({
     "use strict";
     init_waterfall();
     init_errors();
+    init_table_bridge();
   }
 });
 
@@ -13434,11 +13444,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,
@@ -13446,7 +13483,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,
@@ -13456,7 +13497,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(
@@ -13494,6 +13539,7 @@ var init_campaign2 = __esm({
     "use strict";
     init_dist2();
     init_errors();
+    init_table_bridge();
   }
 });
 
@@ -13521,6 +13567,30 @@ 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);
@@ -13535,7 +13605,10 @@ async function handleCrm(args, ctx) {
     case "find_company": {
       const query = args.query;
       const name = args.name ?? query?.name;
-      if (!name) throw new Error('name is required for find_company action (pass as name="X" or query={"name":"X"})');
+      if (!name)
+        throw new Error(
+          'name is required for find_company action (pass as name="X" or query={"name":"X"})'
+        );
       if (!manager.findCompany) throw new Error("Provider does not support company lookup");
       return manager.findCompany(name);
     }
@@ -13552,6 +13625,7 @@ async function handleCrm(args, ctx) {
 var init_crm2 = __esm({
   "src/handlers/crm.ts"() {
     "use strict";
+    init_table_bridge();
   }
 });
 
@@ -13736,53 +13810,42 @@ __export(feedback_exports, {
   handleFeedback: () => handleFeedback
 });
 async function handleFeedback(args) {
-  const input = args;
-  if (!SUPABASE_KEY) {
-    throw createGtmError(
-      "PROVIDER_NOT_CONFIGURED",
-      "Supabase not configured for feedback. Set GTM_SUPABASE_KEY or SUPABASE_SERVICE_ROLE_KEY env var."
-    );
-  }
-  const row = {
-    type: input.type,
-    message: input.message.trim(),
-    context: input.context ?? {}
-  };
-  const response = await fetch(`${SUPABASE_URL}/rest/v1/gtm_feedback`, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      apikey: SUPABASE_KEY,
-      Authorization: `Bearer ${SUPABASE_KEY}`,
-      Prefer: "return=representation"
-    },
-    body: JSON.stringify(row)
-  });
-  if (!response.ok) {
-    const body = await response.text().catch(() => "unknown");
-    throw createGtmError(
-      "PROVIDER_REQUEST_FAILED",
-      `Failed to submit feedback: ${response.status}`,
-      {
+  const type = args.type;
+  const message = args.message.trim();
+  const context = args.context ?? {};
+  try {
+    const response = await fetch(`${VIEWER_URL2}/api/feedback`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ type, message, context })
+    });
+    if (!response.ok) {
+      const body = await response.text().catch(() => "unknown");
+      throw createGtmError("PROVIDER_REQUEST_FAILED", `Failed to submit feedback: ${response.status}`, {
         details: { status: response.status, body }
-      }
-    );
+      });
+    }
+    const data = await response.json();
+    const created = data[0];
+    return {
+      submitted: true,
+      id: created?.id,
+      type,
+      message: `Feedback submitted. Thank you! (ID: ${created?.id ?? "unknown"})`
+    };
+  } catch (error) {
+    if (error && typeof error === "object" && "error_code" in error) throw error;
+    logError("feedback:submit", error instanceof Error ? error : new Error(String(error)));
+    throw createGtmError("PROVIDER_REQUEST_FAILED", "Failed to submit feedback. Please try again later.");
   }
-  const [created] = await response.json();
-  return {
-    submitted: true,
-    id: created?.id,
-    type: input.type,
-    message: `Feedback submitted. Thank you! (ID: ${created?.id ?? "unknown"})`
-  };
 }
-var SUPABASE_URL, SUPABASE_KEY;
+var VIEWER_URL2;
 var init_feedback2 = __esm({
   "src/handlers/feedback.ts"() {
     "use strict";
+    init_dist();
     init_errors();
-    SUPABASE_URL = process.env.GTM_SUPABASE_URL ?? process.env.SUPABASE_URL ?? "https://qvawbxpijxlwdkolmjrs.supabase.co";
-    SUPABASE_KEY = process.env.GTM_SUPABASE_KEY ?? process.env.SUPABASE_SERVICE_ROLE_KEY ?? "";
+    VIEWER_URL2 = process.env.GTM_VIEWER_URL ?? "https://gtm-viewer-production.up.railway.app";
   }
 });
 
@@ -13807,14 +13870,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_URL3}/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(() => ({}));
@@ -13826,7 +13896,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_URL3}/api/tables/${tableId}`, {
     method: "PATCH",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({ rows })
@@ -13839,18 +13909,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_URL3}/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_URL3;
 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_URL3 = process.env.GTM_VIEWER_URL ?? "https://gtm-viewer-production.up.railway.app";
   }
 });
 
@@ -14092,7 +14162,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({
@@ -14132,6 +14203,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
@@ -14143,12 +14215,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({
@@ -14232,7 +14308,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({
@@ -14241,7 +14318,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({
@@ -14294,7 +14372,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"),
@@ -14333,7 +14413,7 @@ function createServer() {
     { capabilities: { tools: {} } }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools
+    tools: mcpTools
   }));
   server.setRequestHandler(CallToolRequestSchema, async (request, _extra) => {
     const { name, arguments: args = {} } = request.params;