gtm-now 0.9.0 → 0.10.0

package/dist/index.js

@@ -10339,7 +10339,7 @@ var init_harvest = __esm({
     HarvestApiAdapter = class {
       name = "harvest";
       capabilities = ["extract_linkedin"];
-      notes = "Best for: LinkedIn profile scraping, post search, engagement mining, activity signals. Called directly by gtm_linkedin tool.";
+      notes = "Best for: LinkedIn profile scraping, post search, engagement mining, activity signals. Called by gtm_extract for LinkedIn types.";
       client;
       credentialsCached = null;
       constructor(apiKey) {
@@ -10621,7 +10621,7 @@ var init_prospect = __esm({
     prospectTools = [
       {
         name: "gtm_find_companies",
-        description: 'Discover companies matching your ICP criteria. Powered by DiscoLike (60M+ companies from web/SSL crawl data) and optionally Apollo.\n\nDiscoLike strengths:\n- Lookalike discovery: give it 1-10 seed domains, get similar companies\n- ICP text matching: describe your ideal customer in plain English\n- Tech stack filtering: find companies using specific technologies\n- Website content analysis: matches against actual site content\n- Best for: B2B companies, local businesses, professional services, healthcare\n\nFor DTC/e-commerce brands, use `provider: "storeleads"` \u2014 it has revenue estimates and category data that neither DiscoLike nor Apollo provides.\n\nTip: DiscoLike lookalike mode is extremely powerful. If you have 2-3 example companies, use the domains parameter to find hundreds of similar ones.\n\nSingle 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.',
+        description: "Discover companies matching ICP criteria via DiscoLike, Apollo, or StoreLeads. Supports lookalike discovery, ICP text, tech stack filtering. Use gtm_tool_help for full parameter details.",
         inputSchema: {
           type: "object",
           properties: {
@@ -10714,7 +10714,12 @@ var init_prospect = __esm({
             output: {
               type: "string",
               enum: ["file", "inline"],
-              description: 'Output mode. "file" writes results to JSONL file (auto when >100 results). "inline" returns in response.'
+              description: 'Output mode. "file" writes results to JSONL file (auto when >20 results). "inline" returns in response.'
+            },
+            detail: {
+              type: "string",
+              enum: ["summary", "full"],
+              description: 'Response detail level. "summary" (default) returns slim results. "full" includes applied_filters and all metadata.'
             }
           },
           required: []
@@ -10722,7 +10727,7 @@ var init_prospect = __esm({
       },
       {
         name: "gtm_find_people",
-        description: 'Find contacts at companies by job title, company, or domain. Returns name, title, email (when available), phone, and LinkedIn URL.\n\nPowered by DiscoLike Contacts, Apollo, or BetterContact depending on configuration.\n\nDiscoLike strengths:\n- Domain-based search: pass company_domain or company_domains[] for multi-domain batch\n- Seniority filtering (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern)\n- Industry + skills filtering to narrow results without post-processing\n- email_validated flag for pre-verified emails only\n- Employee/revenue range filters for company-level targeting\n- Returns validated emails when available\n\nResponse is slim by default (name, title, email, company, company_domain, linkedin). Pass fields: "all" for full payload.\n\nAfter finding people, use:\n- gtm_enrich to get verified email/phone if not returned (company_domain field is pipeline-compatible)\n- gtm_linkedin to check LinkedIn activity and engagement signals\n\nKnown limitations:\n- department + seniority filters combined may return 0 results (Disco API uses strict AND). Use one or the other.',
+        description: 'Find contacts by job title, company, or domain. Returns name, title, email, LinkedIn URL. Slim by default; pass fields: "all" for full payload.',
         inputSchema: {
           type: "object",
           properties: {
@@ -10821,7 +10826,12 @@ var init_prospect = __esm({
             output: {
               type: "string",
               enum: ["file", "inline"],
-              description: 'Output mode. "file" writes results to JSONL file (auto when >100 results). "inline" returns in response.'
+              description: 'Output mode. "file" writes results to JSONL file (auto when >20 results). "inline" returns in response.'
+            },
+            detail: {
+              type: "string",
+              enum: ["summary", "full"],
+              description: 'Response detail level. "summary" (default) returns slim results. "full" includes applied_filters and all metadata.'
             }
           },
           required: []
@@ -10839,7 +10849,7 @@ var init_enrich = __esm({
     enrichTools = [
       {
         name: "gtm_enrich",
-        description: "Email and phone enrichment via waterfall \u2014 tries multiple providers in order, stops on first match. Supports 1-100 contacts per call.\n\nAlways do a dry_run first for batches > 5 to preview cost.\n\nProviders (in configured waterfall order):\n- Prospeo: email finder, good hit rate on LinkedIn-active professionals\n- BetterContact: email + phone, charges only on successful find\n\nInput needs: first_name + last_name minimum. Adding company_domain dramatically improves hit rates. LinkedIn URL is the gold standard input.\n\nTip: 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.",
+        description: "Email/phone enrichment via waterfall \u2014 tries providers in order, stops on first match. Always dry_run first for batches > 5.",
         inputSchema: {
           type: "object",
           properties: {
@@ -10874,7 +10884,12 @@ var init_enrich = __esm({
               description: "Provider order override (uses client default if omitted)"
             },
             verify: { type: "boolean", default: true },
-            dry_run: { type: "boolean", default: false }
+            dry_run: { type: "boolean", default: false },
+            detail: {
+              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.'
+            }
           },
           required: ["contacts"]
         }
@@ -10905,30 +10920,78 @@ var init_extract = __esm({
     extractTools = [
       {
         name: "gtm_extract",
-        description: "Extract structured data from a URL. Supports LinkedIn profiles, LinkedIn posts, and web pages. Optionally specify which fields to extract. Provider is auto-selected based on URL type (LinkedIn vs web).",
+        description: "Extract data from LinkedIn (profiles, posts, engagement, search) or web pages. HarvestAPI charges per request.",
         inputSchema: {
           type: "object",
+          required: ["type"],
           properties: {
+            type: {
+              type: "string",
+              enum: [
+                "linkedin_profile",
+                "linkedin_posts",
+                "linkedin_engagement",
+                "linkedin_search",
+                "linkedin_company_posts",
+                "web_page"
+              ],
+              description: "Content type to extract"
+            },
             url: {
               type: "string",
-              description: "URL to extract data from (LinkedIn profile/post URL or any web page)"
+              description: "URL to extract data from (required for web_page)"
             },
-            type: {
+            linkedin_url: {
+              type: "string",
+              description: "LinkedIn profile URL (required for linkedin_profile)"
+            },
+            find_email: {
+              type: "boolean",
+              description: "Find email via SMTP verification \u2014 uses extra credits (linkedin_profile only)"
+            },
+            profile: {
+              type: "string",
+              description: "LinkedIn URL or publicIdentifier (required for linkedin_posts)"
+            },
+            company: {
+              type: "string",
+              description: "Company LinkedIn URL or universalName (required for linkedin_company_posts)"
+            },
+            posted_within: {
+              type: "string",
+              enum: ["24h", "week", "month"],
+              description: "Filter posts by recency (linkedin_posts, linkedin_search, linkedin_company_posts)"
+            },
+            post_url: {
+              type: "string",
+              description: "LinkedIn post URL (required for linkedin_engagement)"
+            },
+            engagement_type: {
               type: "string",
-              enum: ["linkedin_profile", "linkedin_post", "web_page"],
-              description: "Content type (auto-detected from URL if omitted)"
+              enum: ["comments", "reactions", "both"],
+              description: "Type of engagement to retrieve (default: both)"
+            },
+            query: {
+              type: "string",
+              description: "Keyword search (required for linkedin_search)"
+            },
+            sort: {
+              type: "string",
+              enum: ["relevance", "date"],
+              description: "Sort order for linkedin_search"
             },
+            limit: { type: "number", description: "Max results to return (max 100)" },
             fields: {
               type: "array",
               items: { type: "string" },
               description: 'Specific fields to extract (e.g., ["name", "title", "company", "about"]). Extracts all available fields if omitted.'
             },
-            provider: {
+            detail: {
               type: "string",
-              description: "Provider override (auto-selected based on URL type if omitted)"
+              enum: ["summary", "full"],
+              description: 'Response detail level. "summary" (default) returns counts and key fields only \u2014 truncates post text, omits individual engagement items. "full" returns complete data including all post content and engager lists.'
             }
-          },
-          required: ["url"]
+          }
         }
       }
     ];
@@ -10964,6 +11027,11 @@ var init_fetch = __esm({
             params: {
               type: "object",
               description: "URL query parameters"
+            },
+            detail: {
+              type: "string",
+              enum: ["summary", "full"],
+              description: 'Response detail level. "summary" (default) omits response headers and truncates large bodies. "full" returns complete response including all headers.'
             }
           },
           required: ["url"]
@@ -11017,7 +11085,7 @@ var init_campaign = __esm({
     campaignTools = [
       {
         name: "gtm_campaign",
-        description: "Manage cold email campaigns. List campaigns, get stats, add leads, or create a new campaign. Supports PlusVibe, Instantly, and Smartlead providers.",
+        description: "Manage cold email and LinkedIn outreach campaigns. List, stats, add_leads, or create. Supports PlusVibe, Instantly, SmartLead, HeyReach.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11035,7 +11103,14 @@ var init_campaign = __esm({
               items: {
                 type: "object",
                 properties: {
-                  email: { type: "string" },
+                  email: {
+                    type: "string",
+                    description: "Email address (required for email campaigns)"
+                  },
+                  linkedin_url: {
+                    type: "string",
+                    description: "LinkedIn profile URL (required for LinkedIn outreach campaigns)"
+                  },
                   first_name: { type: "string" },
                   last_name: { type: "string" },
                   company: { type: "string" },
@@ -11043,10 +11118,9 @@ var init_campaign = __esm({
                     type: "object",
                     description: "Custom merge fields for email personalization"
                   }
-                },
-                required: ["email"]
+                }
               },
-              description: "Leads to add (required for add_leads action)"
+              description: "Leads to add (required for add_leads action). Each lead needs at least email or linkedin_url."
             },
             name: {
               type: "string",
@@ -11054,54 +11128,12 @@ var init_campaign = __esm({
             },
             provider: {
               type: "string",
-              description: "Provider override (uses first available campaign_email provider if omitted)"
-            }
-          },
-          required: ["action"]
-        }
-      }
-    ];
-  }
-});
-
-// src/tools/outreach.ts
-var outreachTools;
-var init_outreach = __esm({
-  "src/tools/outreach.ts"() {
-    "use strict";
-    outreachTools = [
-      {
-        name: "gtm_outreach",
-        description: "Manage LinkedIn outreach campaigns. List campaigns, get stats, or add leads to a LinkedIn outreach campaign. Leads require a LinkedIn profile URL.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            action: {
-              type: "string",
-              enum: ["list", "stats", "add_leads"],
-              description: "Action to perform: list (all campaigns), stats (campaign metrics), add_leads (push contacts)"
-            },
-            campaign_id: {
-              type: "string",
-              description: "Campaign ID (required for stats and add_leads)"
+              description: "Provider override (auto-selects based on available campaign_email or outreach_linkedin provider if omitted)"
             },
-            leads: {
-              type: "array",
-              items: {
-                type: "object",
-                properties: {
-                  linkedin_url: { type: "string" },
-                  first_name: { type: "string" },
-                  last_name: { type: "string" },
-                  company: { type: "string" }
-                },
-                required: ["linkedin_url"]
-              },
-              description: "Leads to add (required for add_leads action). Each lead must have a LinkedIn profile URL."
-            },
-            provider: {
+            detail: {
               type: "string",
-              description: "Provider override (uses first available outreach_linkedin provider if omitted)"
+              enum: ["summary", "full"],
+              description: 'Response detail level. "summary" (default) returns key stats only. "full" returns all campaign data.'
             }
           },
           required: ["action"]
@@ -11177,7 +11209,7 @@ var init_status = __esm({
     statusTools = [
       {
         name: "gtm_status",
-        description: "Check provider health, credit balances, and active configuration. Shows which providers are configured, their capabilities, remaining credits, and the current client context.",
+        description: "Check provider health, credit balances, and active configuration.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11190,6 +11222,11 @@ var init_status = __esm({
             provider: {
               type: "string",
               description: "Check a specific provider only (checks all configured providers if omitted)"
+            },
+            detail: {
+              type: "string",
+              enum: ["summary", "full"],
+              description: 'Response detail level. "summary" (default) returns provider name, health, and credits only. "full" includes capabilities, notes, and unconfigured tool details.'
             }
           },
           required: []
@@ -11237,71 +11274,125 @@ var init_configure = __esm({
   }
 });
 
-// src/tools/linkedin.ts
-var linkedinTools;
-var init_linkedin = __esm({
-  "src/tools/linkedin.ts"() {
+// src/tools/feedback.ts
+var feedbackTools;
+var init_feedback = __esm({
+  "src/tools/feedback.ts"() {
     "use strict";
-    linkedinTools = [
+    feedbackTools = [
       {
-        name: "gtm_linkedin",
-        description: "LinkedIn intelligence \u2014 profile scraping, post search, and engagement mining. Powered by HarvestAPI.\n\nWhen to use:\n- Scrape a LinkedIn profile for headline, experience, skills, follower count\n- Check if someone is active on LinkedIn (recent posts, engagement levels)\n- Find people who comment on or react to specific posts (warm lead mining)\n- Search LinkedIn posts by keyword to find thought leaders\n- Monitor competitor or industry content for engagers\n\nWhen NOT to use:\n- Finding people by job title at a company \u2014 use gtm_find_people instead\n- Email enrichment \u2014 use gtm_enrich instead\n- Non-LinkedIn web scraping \u2014 use gtm_extract instead\n\nPairs well with:\n- gtm_find_people \u2192 gtm_linkedin (find contacts, then check LinkedIn activity)\n- gtm_linkedin engagement \u2192 gtm_enrich (find engagers, then get emails)\n- gtm_storeleads \u2192 gtm_find_people \u2192 gtm_linkedin (DTC brands \u2192 CEOs \u2192 activity check)\n\nNote: HarvestAPI charges per request. For engagement mining, each post lookup counts as a request. Use limit to control costs.",
+        name: "gtm_feedback",
+        description: "Submit feedback, bug reports, feature requests, or provider requests. Use this to report issues with gtm-now or request new data providers and capabilities. Feedback is stored for the gtm-now maintainers to review.",
         inputSchema: {
           type: "object",
-          required: ["action"],
           properties: {
-            action: {
-              type: "string",
-              enum: ["profile", "posts", "engagement", "company_posts", "search_posts"],
-              description: "Action to perform"
-            },
-            linkedin_url: {
-              type: "string",
-              description: "LinkedIn profile URL (required for profile action)"
-            },
-            find_email: {
-              type: "boolean",
-              description: "Find email via SMTP verification \u2014 uses extra credits (profile action only)"
-            },
-            profile: {
-              type: "string",
-              description: "LinkedIn URL or publicIdentifier (required for posts action)"
-            },
-            company: {
-              type: "string",
-              description: "Company LinkedIn URL or universalName (required for company_posts action)"
-            },
-            posted_within: {
-              type: "string",
-              enum: ["24h", "week", "month"],
-              description: "Filter posts by recency"
-            },
-            post_url: {
-              type: "string",
-              description: "LinkedIn post URL (required for engagement action)"
-            },
-            engagement_type: {
+            type: {
               type: "string",
-              enum: ["comments", "reactions", "both"],
-              description: "Type of engagement to retrieve (default: both)"
+              enum: ["bug", "feature_request", "provider_request"],
+              description: 'Type of feedback: "bug" for something broken, "feature_request" for new capabilities, "provider_request" for requesting a new data provider integration'
             },
-            query: {
+            message: {
               type: "string",
-              description: "Keyword search (required for search_posts action)"
+              description: "Describe the issue, request, or suggestion in detail"
             },
-            sort: {
-              type: "string",
-              enum: ["relevance", "date"],
-              description: "Sort order for search_posts"
-            },
-            limit: { type: "number", description: "Max results to return (max 100)" }
-          }
+            context: {
+              type: "object",
+              description: "Optional context \u2014 tool name, error_code, args used, provider, etc. Include anything that helps reproduce or understand the feedback."
+            }
+          },
+          required: ["type", "message"]
         }
       }
     ];
   }
 });
 
+// src/tools/descriptions.ts
+var TOOL_DESCRIPTIONS;
+var init_descriptions = __esm({
+  "src/tools/descriptions.ts"() {
+    "use strict";
+    TOOL_DESCRIPTIONS = {
+      gtm_find_companies: `Discover companies matching your ICP criteria. Powered by DiscoLike (60M+ companies from web/SSL crawl data) and optionally Apollo.
+
+DiscoLike strengths:
+- Lookalike discovery: give it 1-10 seed domains, get similar companies
+- ICP text matching: describe your ideal customer in plain English
+- Tech stack filtering: find companies using specific technologies
+- Website content analysis: matches against actual site content
+- Best for: B2B companies, local businesses, professional services, healthcare
+
+For DTC/e-commerce brands, use provider: "storeleads" \u2014 it has revenue estimates and category data that neither DiscoLike nor Apollo provides.
+
+Tip: DiscoLike lookalike mode is extremely powerful. If you have 2-3 example companies, use the domains parameter to find hundreds of similar ones.
+
+Single domain lookup: passing just domain (no icp_text, domains, category, tech_stack, or country) does a direct company profile fetch with rich data (growth signals, engagement metrics, tech stack from vendors). This is for researching ONE specific company, not discovery.`,
+      gtm_find_people: `Find contacts at companies by job title, company, or domain. Returns name, title, email (when available), phone, and LinkedIn URL.
+
+Powered by DiscoLike Contacts, Apollo, or BetterContact depending on configuration.
+
+DiscoLike strengths:
+- Domain-based search: pass company_domain or company_domains[] for multi-domain batch
+- Seniority filtering (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern)
+- Industry + skills filtering to narrow results without post-processing
+- email_validated flag for pre-verified emails only
+- Employee/revenue range filters for company-level targeting
+- Returns validated emails when available
+
+Response is slim by default (name, title, email, company, company_domain, linkedin). Pass fields: "all" for full payload.
+
+After finding people, use:
+- gtm_enrich to get verified email/phone if not returned (company_domain field is pipeline-compatible)
+- 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.`,
+      gtm_enrich: `Email and phone enrichment via waterfall \u2014 tries multiple providers in order, stops on first match. Supports 1-100 contacts per call.
+
+Always do a dry_run first for batches > 5 to preview cost.
+
+Providers (in configured waterfall order):
+- Prospeo: email finder, good hit rate on LinkedIn-active professionals
+- BetterContact: email + phone, charges only on successful find
+
+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.`,
+      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.
+
+When to use:
+- Scrape a LinkedIn profile for headline, experience, skills, follower count
+- Check if someone is active on LinkedIn (recent posts, engagement levels)
+- Find people who comment on or react to specific posts (warm lead mining)
+- Search LinkedIn posts by keyword to find thought leaders
+- Monitor competitor or industry content for engagers
+- Scrape any web page for structured data
+
+When NOT to use:
+- Finding people by job title at a company \u2014 use gtm_find_people instead
+- Email enrichment \u2014 use gtm_enrich instead
+
+Pairs well with:
+- gtm_find_people \u2192 gtm_extract (find contacts, then check LinkedIn activity)
+- gtm_extract linkedin_engagement \u2192 gtm_enrich (find engagers, then get emails)
+- gtm_storeleads \u2192 gtm_find_people \u2192 gtm_extract (DTC brands \u2192 CEOs \u2192 activity check)
+
+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_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.",
+      gtm_tool_help: "Get the full parameter schema for a specific GTM tool. Use this to see exactly what arguments a tool accepts before calling gtm_execute.",
+      gtm_execute: "Gateway to execute any GTM tool by name. Use gtm_guide for workflow recipes, gtm_tool_help for parameter schemas, then this to execute.",
+      gtm_feedback: "Submit feedback, bug reports, feature requests, or provider requests. Feedback is stored for the gtm-now maintainers to review."
+    };
+  }
+});
+
 // src/tools/index.ts
 var capabilityTools, guideTool, toolHelpTool, executeTool, metaTools, tools, toolsByName, toolCategories, workflowRecipes;
 var init_tools = __esm({
@@ -11313,22 +11404,20 @@ var init_tools = __esm({
     init_fetch();
     init_ai();
     init_campaign();
-    init_outreach();
     init_crm();
     init_status();
     init_configure();
-    init_linkedin();
+    init_feedback();
     init_prospect();
     init_enrich();
     init_extract();
     init_fetch();
     init_ai();
     init_campaign();
-    init_outreach();
     init_crm();
     init_status();
     init_configure();
-    init_linkedin();
+    init_descriptions();
     capabilityTools = [
       ...prospectTools,
       ...enrichTools,
@@ -11336,11 +11425,10 @@ var init_tools = __esm({
       ...fetchTools,
       ...aiTools,
       ...campaignTools,
-      ...outreachTools,
       ...crmTools,
       ...statusTools,
       ...configureTools,
-      ...linkedinTools
+      ...feedbackTools
     ];
     guideTool = {
       name: "gtm_guide",
@@ -11406,11 +11494,9 @@ var init_tools = __esm({
       fetch: fetchTools.map((t) => t.name),
       ai: aiTools.map((t) => t.name),
       campaign: campaignTools.map((t) => t.name),
-      outreach: outreachTools.map((t) => t.name),
       crm: crmTools.map((t) => t.name),
       status: statusTools.map((t) => t.name),
       configure: configureTools.map((t) => t.name),
-      linkedin: linkedinTools.map((t) => t.name),
       meta: metaTools.map((t) => t.name)
     };
     workflowRecipes = {
@@ -11425,28 +11511,28 @@ Start by identifying what kind of companies you're targeting:
    \u2192 gtm_find_people({ company_domain: "...", job_title: "CEO" })
 3. gtm_enrich (dry_run first) \u2014 get verified emails
    \u2192 gtm_enrich({ contacts: [...], find: ["email"], dry_run: true })
-4. Optional: gtm_linkedin \u2014 check if they're active on LinkedIn
-   \u2192 gtm_linkedin({ action: "profile", linkedin_url: "..." })
+4. Optional: gtm_extract \u2014 check if they're active on LinkedIn
+   \u2192 gtm_extract({ type: "linkedin_profile", linkedin_url: "..." })
 
 ## B2B / SaaS / Services with websites
 1. gtm_find_companies \u2014 use DiscoLike ICP text or lookalikes
    \u2192 gtm_find_companies({ icp_text: "...", limit: 100 })
 2. gtm_find_people \u2014 find contacts by title
 3. gtm_enrich \u2014 get verified emails
-4. gtm_campaign or gtm_outreach \u2014 push to campaigns
+4. gtm_campaign \u2014 push to email or LinkedIn campaigns
 
 ## LinkedIn-native prospects
 1. gtm_find_people \u2014 search by title + company
-2. gtm_linkedin \u2014 scrape profiles for activity signals
-   \u2192 gtm_linkedin({ action: "profile", linkedin_url: "..." })
+2. gtm_extract \u2014 scrape profiles for activity signals
+   \u2192 gtm_extract({ type: "linkedin_profile", linkedin_url: "..." })
 3. gtm_enrich \u2014 get emails for active prospects
-4. gtm_outreach \u2014 LinkedIn campaign, or gtm_campaign for email
+4. gtm_campaign \u2014 push to LinkedIn or email campaign
 
 ## Engagement-based (warm leads)
-1. gtm_linkedin (search_posts) \u2014 find relevant content
-   \u2192 gtm_linkedin({ action: "search_posts", query: "...", sort: "date" })
-2. gtm_linkedin (engagement) \u2014 extract commenters/reactors
-   \u2192 gtm_linkedin({ action: "engagement", post_url: "...", engagement_type: "both" })
+1. gtm_extract (linkedin_search) \u2014 find relevant content
+   \u2192 gtm_extract({ type: "linkedin_search", query: "...", sort: "date" })
+2. gtm_extract (linkedin_engagement) \u2014 extract commenters/reactors
+   \u2192 gtm_extract({ type: "linkedin_engagement", post_url: "...", engagement_type: "both" })
 3. gtm_enrich \u2014 get emails
 4. gtm_campaign \u2014 personalized outreach referencing their engagement
 
@@ -11502,10 +11588,10 @@ Always verify emails before pushing to campaigns. Bounced emails hurt sender rep
    \u2192 gtm_ai({ action: "personalize", data: [...], prompt: "Write a LinkedIn connection request referencing their recent post" })
 
 3. LIST CAMPAIGNS \u2014 Find or identify the target outreach campaign
-   \u2192 gtm_outreach({ action: "list" })
+   \u2192 gtm_campaign({ action: "list", provider: "heyreach" })
 
 4. PUSH \u2014 Add leads to LinkedIn outreach campaign
-   \u2192 gtm_outreach({ action: "add_leads", campaign_id: "...", leads: [{ linkedin_url: "..." }] })
+   \u2192 gtm_campaign({ action: "add_leads", campaign_id: "...", provider: "heyreach", leads: [{ linkedin_url: "..." }] })
 
 ## Key principle
 LinkedIn outreach requires LinkedIn profile URLs \u2014 not emails. Extract profile data first for personalization.`,
@@ -11537,7 +11623,7 @@ Call gtm_guide with one of these tasks:
 
 New tools available:
 - gtm_find_companies (provider: storeleads) \u2014 Search 1.2M+ e-commerce stores by category, revenue, platform
-- gtm_linkedin \u2014 LinkedIn profile scraping, post search, engagement mining
+- gtm_extract \u2014 LinkedIn profiles, posts, engagement mining, search + web page scraping
 
 For any task: always dry_run enrichment batches > 5 to preview cost before executing.`
     };
@@ -11662,7 +11748,7 @@ var FILE_OUTPUT_THRESHOLD, DEFAULT_RESULTS_DIR;
 var init_result_writer = __esm({
   "src/utils/result-writer.ts"() {
     "use strict";
-    FILE_OUTPUT_THRESHOLD = 100;
+    FILE_OUTPUT_THRESHOLD = 20;
     DEFAULT_RESULTS_DIR = path.join(os.homedir(), ".gtm", "results");
   }
 });
@@ -11907,10 +11993,46 @@ function isRateLimitError(error) {
   const msg = error instanceof Error ? error.message : String(error);
   return msg.includes("429") || msg.toLowerCase().includes("rate limit");
 }
+function withTimeout(promise, ms, label) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(
+      () => reject(new Error(`Provider timeout: ${label} did not respond within ${ms}ms`)),
+      ms
+    );
+    promise.then(
+      (val) => {
+        clearTimeout(timer);
+        resolve(val);
+      },
+      (err) => {
+        clearTimeout(timer);
+        reject(err);
+      }
+    );
+  });
+}
 async function runWaterfall(contacts, config, registry) {
   const results = [];
   const exhausted = /* @__PURE__ */ new Set();
+  const batchDeadline = Date.now() + (config.batchTimeoutMs ?? DEFAULT_BATCH_TIMEOUT_MS);
   for (const contact of contacts) {
+    if (Date.now() > batchDeadline) {
+      results.push({
+        contact,
+        attempts: [
+          {
+            provider: "waterfall",
+            capability: "enrich_email",
+            found: false,
+            charged: false,
+            duration_ms: 0,
+            error: "Batch timeout exceeded \u2014 skipped remaining contacts"
+          }
+        ],
+        charged: false
+      });
+      continue;
+    }
     const result = await enrichContact(contact, config, registry, exhausted);
     results.push(result);
   }
@@ -11999,11 +12121,20 @@ async function enrichField(contact, field, config, registry, exhausted) {
       const start = Date.now();
       try {
         let value;
+        const providerTimeoutMs = config.providerTimeoutMs ?? DEFAULT_PROVIDER_TIMEOUT_MS;
         if (field === "email" && "enrichEmail" in provider) {
-          const result = await provider.enrichEmail(contact);
+          const result = await withTimeout(
+            provider.enrichEmail(contact),
+            providerTimeoutMs,
+            providerName
+          );
           value = result?.email;
         } else if (field === "phone" && "enrichPhone" in provider) {
-          const result = await provider.enrichPhone(contact);
+          const result = await withTimeout(
+            provider.enrichPhone(contact),
+            providerTimeoutMs,
+            providerName
+          );
           value = result?.phone;
         }
         const found = !!value;
@@ -12079,7 +12210,7 @@ function dryRunWaterfall(contactsCount, config, registry) {
     confirm: "Call gtm_enrich again without dry_run to execute."
   };
 }
-var enrichmentCache, DEFAULT_PRICING, EXHAUSTION_PATTERNS, WATERFALL_RETRY_DELAYS;
+var enrichmentCache, DEFAULT_PRICING, EXHAUSTION_PATTERNS, WATERFALL_RETRY_DELAYS, DEFAULT_PROVIDER_TIMEOUT_MS, DEFAULT_BATCH_TIMEOUT_MS;
 var init_waterfall = __esm({
   "src/providers/waterfall.ts"() {
     "use strict";
@@ -12101,6 +12232,8 @@ var init_waterfall = __esm({
       "not accessible with this api_key on a free plan"
     ];
     WATERFALL_RETRY_DELAYS = [2e3, 5e3, 1e4];
+    DEFAULT_PROVIDER_TIMEOUT_MS = 15e3;
+    DEFAULT_BATCH_TIMEOUT_MS = 3e5;
   }
 });
 
@@ -12109,6 +12242,19 @@ var enrich_exports = {};
 __export(enrich_exports, {
   handleEnrich: () => handleEnrich
 });
+function slimEnrichResults(results) {
+  return results.map((r) => {
+    const slim = {};
+    if (r.email) slim.email = r.email;
+    if (r.phone) slim.phone = r.phone;
+    if (r.email_status) slim.email_status = r.email_status;
+    if (r.email_provider) slim.email_provider = r.email_provider;
+    if (r.phone_provider) slim.phone_provider = r.phone_provider;
+    slim.charged = r.charged;
+    slim.name = `${r.contact.first_name} ${r.contact.last_name}`;
+    return slim;
+  });
+}
 async function handleEnrich(name, args, ctx) {
   if (name === "gtm_verify") {
     return verifyEmail(args, ctx);
@@ -12152,11 +12298,12 @@ 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";
   return {
     total: results.length,
     found,
     missed: results.length - found,
-    results
+    results: detail === "full" ? results : slimEnrichResults(results)
   };
 }
 async function verifyEmail(args, ctx) {
@@ -12185,45 +12332,156 @@ var extract_exports = {};
 __export(extract_exports, {
   handleExtract: () => handleExtract
 });
+function slimPost(post) {
+  const slim = {};
+  for (const [key, value] of Object.entries(post)) {
+    if (key === "text" && typeof value === "string") {
+      slim.text = value.length > POST_TEXT_LIMIT ? value.slice(0, POST_TEXT_LIMIT) + "..." : value;
+    } else if (key === "images" || key === "documents" || key === "media") {
+      if (Array.isArray(value) && value.length > 0) slim[`${key}_count`] = value.length;
+    } else {
+      slim[key] = value;
+    }
+  }
+  return slim;
+}
+function slimProfile(profile) {
+  const PROFILE_FIELDS = [
+    "firstName",
+    "lastName",
+    "headline",
+    "location",
+    "summary",
+    "followerCount",
+    "connectionCount",
+    "email",
+    "publicIdentifier",
+    "industryName",
+    "company"
+  ];
+  const slim = {};
+  for (const field of PROFILE_FIELDS) {
+    if (field in profile && profile[field] != null) slim[field] = profile[field];
+  }
+  return slim;
+}
 async function handleExtract(args, ctx) {
+  const type = args.type;
+  if (type.startsWith("linkedin_")) {
+    return handleLinkedinExtract(type, args, ctx);
+  }
+  return handleWebExtract(args, ctx);
+}
+async function handleWebExtract(args, ctx) {
   const target = {
     url: args.url,
-    type: args.type,
+    type: "web_page",
     fields: args.fields
   };
-  const capability = target.type === "web_page" ? "extract_web" : "extract_linkedin";
   const providerName = args.provider || void 0;
-  const providers = providerName ? [ctx.registry.get(providerName)].filter(Boolean) : ctx.registry.getForCapability(capability);
+  const providers = providerName ? [ctx.registry.get(providerName)].filter(Boolean) : ctx.registry.getForCapability("extract_web");
   if (providers.length === 0) {
     throw createGtmError(
       "EXTRACTION_FAILED",
-      `No providers configured for ${capability}. Add a provider with that capability.`
+      "No providers configured for extract_web. Add a provider with that capability."
     );
   }
-  const provider = providers[0];
-  if (provider.name === "harvest" && capability === "extract_linkedin") {
-    return extractViaHarvest(provider, target);
-  }
-  const extractor = provider;
+  const extractor = providers[0];
   return extractor.extract(target);
 }
-async function extractViaHarvest(harvest, target) {
-  if (target.type === "linkedin_profile") {
-    const profile = await harvest.getProfile(target.url, true);
-    return {
-      data: profile,
-      source: target.url,
-      provider: "harvest"
-    };
+async function handleLinkedinExtract(type, args, ctx) {
+  const adapter = ctx.registry.get("harvest");
+  if (!adapter) {
+    throw Object.assign(
+      new Error(
+        "HarvestAPI provider not configured. Add harvest.api_key to your config.yaml or set GTM_HARVEST_API_KEY environment variable."
+      ),
+      { statusCode: 503 }
+    );
+  }
+  const detail = args.detail ?? "summary";
+  const isSummary = detail !== "full";
+  switch (type) {
+    case "linkedin_profile": {
+      const url = args.linkedin_url || args.url;
+      const profile = await adapter.getProfile(url, args.find_email);
+      return {
+        type: "linkedin_profile",
+        provider: "harvest",
+        profile: isSummary ? slimProfile(profile) : profile
+      };
+    }
+    case "linkedin_posts": {
+      const result = await adapter.getProfilePosts({
+        profile: args.profile,
+        postedLimit: args.posted_within
+      });
+      return {
+        type: "linkedin_posts",
+        provider: "harvest",
+        count: result.elements.length,
+        posts: isSummary ? result.elements.map((p) => slimPost(p)) : result.elements,
+        ...detail === "full" && { pagination: result.pagination }
+      };
+    }
+    case "linkedin_company_posts": {
+      const result = await adapter.getCompanyPosts({
+        company: args.company,
+        postedLimit: args.posted_within
+      });
+      return {
+        type: "linkedin_company_posts",
+        provider: "harvest",
+        count: result.elements.length,
+        posts: isSummary ? result.elements.map((p) => slimPost(p)) : result.elements,
+        ...detail === "full" && { pagination: result.pagination }
+      };
+    }
+    case "linkedin_search": {
+      const result = await adapter.searchPosts(args.query, {
+        sortBy: args.sort,
+        postedLimit: args.posted_within
+      });
+      return {
+        type: "linkedin_search",
+        provider: "harvest",
+        count: result.elements.length,
+        posts: isSummary ? result.elements.map((p) => slimPost(p)) : result.elements,
+        ...detail === "full" && { pagination: result.pagination }
+      };
+    }
+    case "linkedin_engagement": {
+      const result = await adapter.getPostEngagement(
+        args.post_url,
+        args.engagement_type ?? "both"
+      );
+      if (isSummary) {
+        return {
+          type: "linkedin_engagement",
+          provider: "harvest",
+          comments_count: result.comments.length,
+          reactions_count: result.reactions.length
+        };
+      }
+      return {
+        type: "linkedin_engagement",
+        provider: "harvest",
+        comments_count: result.comments.length,
+        reactions_count: result.reactions.length,
+        comments: result.comments,
+        reactions: result.reactions
+      };
+    }
+    default:
+      throw new Error(`Unknown extract type: ${type}`);
   }
-  throw new Error(
-    'LinkedIn post extraction is not supported by harvest. Use gtm_linkedin with action "posts" instead.'
-  );
 }
+var POST_TEXT_LIMIT;
 var init_extract2 = __esm({
   "src/handlers/extract.ts"() {
     "use strict";
     init_errors();
+    POST_TEXT_LIMIT = 200;
   }
 });
 
@@ -12273,11 +12531,19 @@ async function handleFetch(args) {
     } else {
       responseBody = await response.text();
     }
-    return {
-      status: response.status,
-      headers: Object.fromEntries(response.headers.entries()),
-      body: responseBody
-    };
+    const detail = args.detail ?? "summary";
+    if (detail === "full") {
+      return {
+        status: response.status,
+        headers: Object.fromEntries(response.headers.entries()),
+        body: responseBody
+      };
+    }
+    let slimBody = responseBody;
+    if (typeof responseBody === "string" && responseBody.length > BODY_TRUNCATE_LIMIT) {
+      slimBody = responseBody.slice(0, BODY_TRUNCATE_LIMIT) + `... (truncated, ${responseBody.length} chars total)`;
+    }
+    return { status: response.status, body: slimBody };
   } catch (error) {
     logError("handler:gtm_fetch", error instanceof Error ? error : new Error(String(error)), {
       url: fullUrl,
@@ -12288,7 +12554,7 @@ async function handleFetch(args) {
     clearTimeout(timeout);
   }
 }
-var BLOCKED_PATTERNS, BLOCKED_HOSTS;
+var BLOCKED_PATTERNS, BLOCKED_HOSTS, BODY_TRUNCATE_LIMIT;
 var init_fetch2 = __esm({
   "src/handlers/fetch.ts"() {
     "use strict";
@@ -12305,6 +12571,7 @@ var init_fetch2 = __esm({
       /^fe80:/
     ];
     BLOCKED_HOSTS = ["localhost", "0.0.0.0", "[::1]"];
+    BODY_TRUNCATE_LIMIT = 2e3;
   }
 });
 
@@ -12426,36 +12693,95 @@ var campaign_exports = {};
 __export(campaign_exports, {
   handleCampaign: () => handleCampaign
 });
-async function handleCampaign(args, ctx) {
-  const action = args.action;
+function resolveChannel(args, ctx) {
   const providerName = args.provider || void 0;
-  const providers = providerName ? [ctx.registry.get(providerName)].filter(Boolean) : ctx.registry.getForCapability("campaign_email");
-  if (providers.length === 0) {
+  if (providerName) {
+    const provider = ctx.registry.get(providerName);
+    if (!provider) {
+      throw createGtmError(
+        "PROVIDER_NOT_CONFIGURED",
+        `Provider "${providerName}" not found. Check your config or use action: "list" without a provider to discover available campaigns.`
+      );
+    }
+    if (provider.capabilities.includes("outreach_linkedin")) {
+      return {
+        type: "linkedin",
+        manager: provider,
+        providerName: provider.name
+      };
+    }
+    if (provider.capabilities.includes("campaign_email")) {
+      return {
+        type: "email",
+        manager: provider,
+        providerName: provider.name
+      };
+    }
     throw createGtmError(
       "PROVIDER_NOT_CONFIGURED",
-      "No providers configured for email campaigns. Add a provider with campaign_email capability."
+      `Provider "${providerName}" does not support campaign_email or outreach_linkedin.`
     );
   }
-  const provider = providers[0];
-  const manager = provider;
+  const emailProviders = ctx.registry.getForCapability("campaign_email");
+  if (emailProviders.length > 0) {
+    const provider = emailProviders[0];
+    return {
+      type: "email",
+      manager: provider,
+      providerName: provider.name
+    };
+  }
+  const linkedinProviders = ctx.registry.getForCapability("outreach_linkedin");
+  if (linkedinProviders.length > 0) {
+    const provider = linkedinProviders[0];
+    return {
+      type: "linkedin",
+      manager: provider,
+      providerName: provider.name
+    };
+  }
+  throw createGtmError(
+    "PROVIDER_NOT_CONFIGURED",
+    "No providers configured for campaigns. Add a provider with campaign_email or outreach_linkedin capability."
+  );
+}
+async function handleCampaign(args, ctx) {
+  const action = args.action;
+  const channel = resolveChannel(args, ctx);
   switch (action) {
     case "list":
-      return { provider: provider.name, campaigns: await manager.listCampaigns() };
+      return { provider: channel.providerName, campaigns: await channel.manager.listCampaigns() };
     case "stats": {
       const campaignId = args.campaign_id;
       if (!campaignId)
         throw createGtmError("QUERY_INVALID", "campaign_id is required for stats action");
-      return manager.getCampaignStats(campaignId);
+      return channel.manager.getCampaignStats(campaignId);
     }
     case "add_leads": {
       const campaignId = args.campaign_id;
-      const leads = args.leads;
+      const rawLeads = args.leads;
       if (!campaignId)
         throw createGtmError("QUERY_INVALID", "campaign_id is required for add_leads action");
-      if (!leads?.length)
+      if (!rawLeads?.length)
         throw createGtmError("QUERY_INVALID", "leads array is required for add_leads action");
+      if (channel.type === "linkedin") {
+        const leads2 = rawLeads.map((l) => ({
+          linkedin_url: l.linkedin_url,
+          first_name: l.first_name,
+          last_name: l.last_name,
+          company: l.company
+        }));
+        return channel.manager.addLeadsToCampaign(campaignId, leads2);
+      }
+      const leads = rawLeads.map((l) => ({
+        email: l.email,
+        first_name: l.first_name,
+        last_name: l.last_name,
+        company: l.company,
+        custom_fields: l.custom_fields
+      }));
       try {
-        return await manager.addLeadsToCampaign(campaignId, leads);
+        return await channel.manager.addLeadsToCampaign(campaignId, leads);
       } catch (error) {
         if (error instanceof ApiClientError && (error.message.includes("Validation error") || error.statusCode === 400 || error.statusCode === 422)) {
           throw createGtmError(
@@ -12468,15 +12794,21 @@ async function handleCampaign(args, ctx) {
       }
     }
     case "create": {
+      if (channel.type === "linkedin") {
+        throw createGtmError(
+          "PROVIDER_NOT_CONFIGURED",
+          "LinkedIn outreach providers do not support campaign creation via API. Create campaigns directly in the provider dashboard."
+        );
+      }
       const name = args.name;
       if (!name) throw createGtmError("QUERY_INVALID", "name is required for create action");
-      if (!manager.createCampaign) {
+      if (!channel.manager.createCampaign) {
         throw createGtmError(
           "PROVIDER_NOT_CONFIGURED",
-          `Provider "${provider.name}" does not support campaign creation. Currently only PlusVibe supports this action.`
+          `Provider "${channel.providerName}" does not support campaign creation. Currently only PlusVibe supports this action.`
         );
       }
-      return manager.createCampaign(name);
+      return channel.manager.createCampaign(name);
     }
     default:
       throw createGtmError("QUERY_INVALID", `Unknown campaign action: ${action}`);
@@ -12490,47 +12822,6 @@ var init_campaign2 = __esm({
   }
 });
 
-// src/handlers/outreach.ts
-var outreach_exports = {};
-__export(outreach_exports, {
-  handleOutreach: () => handleOutreach
-});
-async function handleOutreach(args, ctx) {
-  const action = args.action;
-  const providerName = args.provider || void 0;
-  const providers = providerName ? [ctx.registry.get(providerName)].filter(Boolean) : ctx.registry.getForCapability("outreach_linkedin");
-  if (providers.length === 0) {
-    throw new Error(
-      "No providers configured for LinkedIn outreach. Add a provider with outreach_linkedin capability."
-    );
-  }
-  const provider = providers[0];
-  const manager = provider;
-  switch (action) {
-    case "list":
-      return { provider: provider.name, campaigns: await manager.listCampaigns() };
-    case "stats": {
-      const campaignId = args.campaign_id;
-      if (!campaignId) throw new Error("campaign_id is required for stats action");
-      return manager.getCampaignStats(campaignId);
-    }
-    case "add_leads": {
-      const campaignId = args.campaign_id;
-      const leads = args.leads;
-      if (!campaignId) throw new Error("campaign_id is required for add_leads action");
-      if (!leads?.length) throw new Error("leads array is required for add_leads action");
-      return manager.addLeadsToCampaign(campaignId, leads);
-    }
-    default:
-      throw new Error(`Unknown outreach action: ${action}`);
-  }
-}
-var init_outreach2 = __esm({
-  "src/handlers/outreach.ts"() {
-    "use strict";
-  }
-});
-
 // src/handlers/crm.ts
 var crm_exports = {};
 __export(crm_exports, {
@@ -12631,6 +12922,17 @@ async function handleStatus(args, ctx) {
     })
   );
   const client = ctx.session.getActiveContext();
+  const detail = args.detail ?? "summary";
+  if (detail !== "full") {
+    return {
+      client: client.clientName,
+      providers: results.map(({ provider, healthy, credits }) => ({
+        provider,
+        healthy,
+        ...credits && { credits }
+      }))
+    };
+  }
   const configuredCapabilities = new Set(results.flatMap((r) => r.capabilities));
   const unconfigured = TOOL_CAPABILITY_REQUIREMENTS.filter(
     (req) => !configuredCapabilities.has(req.capability)
@@ -12649,7 +12951,7 @@ var init_status2 = __esm({
     init_dist();
     TOOL_CAPABILITY_REQUIREMENTS = [
       {
-        tool: "gtm_linkedin",
+        tool: "gtm_extract",
         requires: "harvest",
         capability: "extract_linkedin",
         setup: "Set GTM_HARVEST_API_KEY or add harvest.api_key to config.yaml"
@@ -12679,10 +12981,10 @@ var init_status2 = __esm({
         setup: "Set GTM_PLUSVIBE_API_KEY, GTM_INSTANTLY_API_KEY, or GTM_SMARTLEAD_API_KEY"
       },
       {
-        tool: "gtm_outreach",
+        tool: "gtm_campaign",
         requires: "heyreach",
         capability: "outreach_linkedin",
-        setup: "Set GTM_HEYREACH_API_KEY"
+        setup: "Set GTM_HEYREACH_API_KEY (LinkedIn outreach via gtm_campaign)"
       },
       { tool: "gtm_crm", requires: "attio", capability: "crm_read", setup: "Set GTM_ATTIO_API_KEY" },
       {
@@ -12753,90 +13055,59 @@ var init_configure2 = __esm({
   }
 });
 
-// src/handlers/linkedin.ts
-var linkedin_exports = {};
-__export(linkedin_exports, {
-  handleLinkedin: () => handleLinkedin
+// src/handlers/feedback.ts
+var feedback_exports = {};
+__export(feedback_exports, {
+  handleFeedback: () => handleFeedback
 });
-async function handleLinkedin(args, ctx) {
-  const adapter = ctx.registry.get("harvest");
-  if (!adapter) {
-    throw Object.assign(
-      new Error(
-        "HarvestAPI provider not configured. Add harvest.api_key to your config.yaml or set GTM_HARVEST_API_KEY environment variable."
-      ),
-      { statusCode: 503 }
+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 action = args.action;
-  switch (action) {
-    case "profile": {
-      const profile = await adapter.getProfile(
-        args.linkedin_url,
-        args.find_email
-      );
-      return { action: "profile", provider: "harvest", profile };
-    }
-    case "posts": {
-      const result = await adapter.getProfilePosts({
-        profile: args.profile,
-        postedLimit: args.posted_within
-      });
-      return {
-        action: "posts",
-        provider: "harvest",
-        count: result.elements.length,
-        posts: result.elements,
-        pagination: result.pagination
-      };
-    }
-    case "company_posts": {
-      const result = await adapter.getCompanyPosts({
-        company: args.company,
-        postedLimit: args.posted_within
-      });
-      return {
-        action: "company_posts",
-        provider: "harvest",
-        count: result.elements.length,
-        posts: result.elements,
-        pagination: result.pagination
-      };
-    }
-    case "search_posts": {
-      const result = await adapter.searchPosts(args.query, {
-        sortBy: args.sort,
-        postedLimit: args.posted_within
-      });
-      return {
-        action: "search_posts",
-        provider: "harvest",
-        count: result.elements.length,
-        posts: result.elements,
-        pagination: result.pagination
-      };
-    }
-    case "engagement": {
-      const result = await adapter.getPostEngagement(
-        args.post_url,
-        args.engagement_type ?? "both"
-      );
-      return {
-        action: "engagement",
-        provider: "harvest",
-        comments_count: result.comments.length,
-        reactions_count: result.reactions.length,
-        comments: result.comments,
-        reactions: result.reactions
-      };
-    }
-    default:
-      throw new Error(`Unknown linkedin action: ${action}`);
+  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}`,
+      {
+        details: { status: response.status, body }
+      }
+    );
   }
+  const [created] = await response.json();
+  return {
+    submitted: true,
+    id: created?.id,
+    type: input.type,
+    message: `Feedback submitted. Thank you! (ID: ${created?.id ?? "unknown"})`
+  };
 }
-var init_linkedin2 = __esm({
-  "src/handlers/linkedin.ts"() {
+var SUPABASE_URL, SUPABASE_KEY;
+var init_feedback2 = __esm({
+  "src/handlers/feedback.ts"() {
     "use strict";
+    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 ?? "";
   }
 });
 
@@ -12850,13 +13121,34 @@ function isRateLimitError2(error) {
 async function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function withHandlerTimeout(promise, ms) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(
+      () => reject(
+        Object.assign(new Error(`Tool call timed out after ${ms}ms`), { code: "HANDLER_TIMEOUT" })
+      ),
+      ms
+    );
+    promise.then(
+      (val) => {
+        clearTimeout(timer);
+        resolve(val);
+      },
+      (err) => {
+        clearTimeout(timer);
+        reject(err);
+      }
+    );
+  });
+}
 async function handleToolCall(name, args, ctx) {
   let lastError;
   for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
     try {
-      const result = await dispatch(name, args, ctx);
+      const timeoutMs = args._testTimeoutMs ?? HANDLER_TIMEOUT_MS;
+      const result = await withHandlerTimeout(dispatch(name, args, ctx), timeoutMs);
       return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) ?? "{}" }]
+        content: [{ type: "text", text: JSON.stringify(result) ?? "{}" }]
       };
     } catch (error) {
       lastError = error;
@@ -12868,6 +13160,13 @@ async function handleToolCall(name, args, ctx) {
       break;
     }
   }
+  if (lastError instanceof Error && "code" in lastError && lastError.code === "HANDLER_TIMEOUT") {
+    const wrapped2 = createGtmError("HANDLER_TIMEOUT", lastError.message);
+    return {
+      content: [{ type: "text", text: JSON.stringify(wrapped2) }],
+      isError: true
+    };
+  }
   if (isGtmError(lastError)) {
     return {
       content: [{ type: "text", text: JSON.stringify(lastError) }],
@@ -12915,10 +13214,6 @@ async function dispatch(name, args, ctx) {
       const { handleCampaign: handleCampaign2 } = await Promise.resolve().then(() => (init_campaign2(), campaign_exports));
       return handleCampaign2(args, ctx);
     }
-    case "gtm_outreach": {
-      const { handleOutreach: handleOutreach2 } = await Promise.resolve().then(() => (init_outreach2(), outreach_exports));
-      return handleOutreach2(args, ctx);
-    }
     case "gtm_crm": {
       const { handleCrm: handleCrm2 } = await Promise.resolve().then(() => (init_crm2(), crm_exports));
       return handleCrm2(args, ctx);
@@ -12931,9 +13226,9 @@ async function dispatch(name, args, ctx) {
       const { handleConfigure: handleConfigure2 } = await Promise.resolve().then(() => (init_configure2(), configure_exports));
       return handleConfigure2(args, ctx);
     }
-    case "gtm_linkedin": {
-      const { handleLinkedin: handleLinkedin2 } = await Promise.resolve().then(() => (init_linkedin2(), linkedin_exports));
-      return handleLinkedin2(args, ctx);
+    case "gtm_feedback": {
+      const { handleFeedback: handleFeedback2 } = await Promise.resolve().then(() => (init_feedback2(), feedback_exports));
+      return handleFeedback2(args);
     }
     // ─── Meta-Tools ───────────────────────────────────────
     case "gtm_guide": {
@@ -12949,7 +13244,7 @@ async function dispatch(name, args, ctx) {
       }
       const result = {
         name: tool.name,
-        description: tool.description,
+        description: TOOL_DESCRIPTIONS[tool.name] ?? tool.description,
         inputSchema: tool.inputSchema
       };
       const toolKey = toolName.replace("gtm_", "");
@@ -12972,7 +13267,7 @@ async function dispatch(name, args, ctx) {
       throw new Error(`Unknown tool: ${name}`);
   }
 }
-var MAX_RETRIES, BASE_DELAY_MS;
+var MAX_RETRIES, BASE_DELAY_MS, HANDLER_TIMEOUT_MS;
 var init_handlers = __esm({
   "src/handlers/index.ts"() {
     "use strict";
@@ -12980,8 +13275,10 @@ var init_handlers = __esm({
     init_errors();
     init_manifests();
     init_tools();
+    init_descriptions();
     MAX_RETRIES = 3;
     BASE_DELAY_MS = 1e3;
+    HANDLER_TIMEOUT_MS = 12e4;
   }
 });
 
@@ -13002,7 +13299,7 @@ function validateToolArgs(toolName, args) {
   }
   return { success: true, data: result.data };
 }
-var contactInputSchema, campaignLeadSchema, outreachLeadSchema, toolSchemas, TOOL_NAMES;
+var contactInputSchema, campaignLeadSchema, detailSchema, toolSchemas, TOOL_NAMES;
 var init_validation = __esm({
   "src/validation.ts"() {
     "use strict";
@@ -13014,18 +13311,16 @@ var init_validation = __esm({
       linkedin_url: z2.string().optional()
     });
     campaignLeadSchema = z2.object({
-      email: z2.string().email("email must be a valid email address"),
+      email: z2.string().email("email must be a valid email address").optional(),
+      linkedin_url: z2.string().min(1, "linkedin_url is required").optional(),
       first_name: z2.string().optional(),
       last_name: z2.string().optional(),
       company: z2.string().optional(),
       custom_fields: z2.record(z2.string()).optional()
+    }).refine((data) => !!data.email || !!data.linkedin_url, {
+      message: "At least one of email or linkedin_url is required"
     });
-    outreachLeadSchema = z2.object({
-      linkedin_url: z2.string().min(1, "linkedin_url is required"),
-      first_name: z2.string().optional(),
-      last_name: z2.string().optional(),
-      company: z2.string().optional()
-    });
+    detailSchema = z2.enum(["summary", "full"]).optional();
     toolSchemas = {
       // 1. Company discovery
       gtm_find_companies: z2.object({
@@ -13049,7 +13344,8 @@ var init_validation = __esm({
         platform: z2.string().optional(),
         min_revenue: z2.number().optional(),
         max_revenue: z2.number().optional(),
-        output: z2.enum(["file", "inline"]).optional()
+        output: z2.enum(["file", "inline"]).optional(),
+        detail: detailSchema
       }),
       // 2. People/contact search
       gtm_find_people: z2.object({
@@ -13089,16 +13385,43 @@ var init_validation = __esm({
         max_employees: z2.number().int().min(1).optional(),
         revenue_range: z2.string().optional(),
         fields: z2.union([z2.literal("all"), z2.array(z2.string())]).optional(),
-        output: z2.enum(["file", "inline"]).optional()
+        output: z2.enum(["file", "inline"]).optional(),
+        detail: detailSchema
       }).refine(
         (data) => !!(data.job_title || data.company_name || data.company_domain || data.company_domains && data.company_domains.length > 0 || data.seniority && data.seniority.length > 0 || data.filter_industry && data.filter_industry.length > 0 || data.skills && data.skills.length > 0 || data.location),
         {
           message: "At least one search filter required (job_title, company_name, company_domain, company_domains, seniority, filter_industry, skills, or location)"
         }
       ),
-      // LinkedIn intelligence — HarvestAPI
-      gtm_linkedin: z2.object({
-        action: z2.enum(["profile", "posts", "engagement", "company_posts", "search_posts"]),
+      // 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"),
+        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
+      }),
+      // 4. Email verification
+      gtm_verify: z2.object({
+        email: z2.string().email("email must be a valid email address")
+      }),
+      // 5. Extract/scrape — web pages + all LinkedIn intelligence
+      gtm_extract: z2.object({
+        type: z2.enum(
+          [
+            "linkedin_profile",
+            "linkedin_posts",
+            "linkedin_engagement",
+            "linkedin_search",
+            "linkedin_company_posts",
+            "web_page"
+          ],
+          {
+            message: "type must be one of: linkedin_profile, linkedin_posts, linkedin_engagement, linkedin_search, linkedin_company_posts, web_page"
+          }
+        ),
+        url: z2.string().url("url must be a valid URL").optional(),
         linkedin_url: z2.string().optional(),
         find_email: z2.boolean().optional(),
         profile: z2.string().optional(),
@@ -13108,53 +13431,38 @@ var init_validation = __esm({
         engagement_type: z2.enum(["comments", "reactions", "both"]).optional(),
         query: z2.string().optional(),
         sort: z2.enum(["relevance", "date"]).optional(),
-        limit: z2.number().int().min(1).max(100).optional()
+        limit: z2.number().int().min(1).max(100).optional(),
+        fields: z2.array(z2.string()).optional(),
+        detail: detailSchema
       }).refine(
         (data) => {
-          switch (data.action) {
-            case "profile":
-              return !!data.linkedin_url;
-            case "engagement":
+          switch (data.type) {
+            case "linkedin_profile":
+              return !!(data.linkedin_url || data.url);
+            case "linkedin_posts":
+              return !!data.profile;
+            case "linkedin_engagement":
               return !!data.post_url;
-            case "search_posts":
+            case "linkedin_search":
               return !!data.query;
-            case "posts":
-              return !!data.profile;
-            case "company_posts":
+            case "linkedin_company_posts":
               return !!data.company;
+            case "web_page":
+              return !!data.url;
             default:
               return true;
           }
         },
-        { message: "Missing required field for the specified action" }
+        { message: "Missing required field for the specified type" }
       ),
-      // 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"),
-        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()
-      }),
-      // 4. Email verification
-      gtm_verify: z2.object({
-        email: z2.string().email("email must be a valid email address")
-      }),
-      // 5. Extract/scrape
-      gtm_extract: z2.object({
-        url: z2.string().url("url must be a valid URL"),
-        type: z2.enum(["linkedin_profile", "linkedin_post", "web_page"], {
-          message: "type must be one of: linkedin_profile, linkedin_post, web_page"
-        }),
-        fields: z2.array(z2.string()).optional()
-      }),
       // 6. Raw HTTP fetch
       gtm_fetch: z2.object({
         url: z2.string().url("url must be a valid URL"),
         method: z2.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).optional(),
         headers: z2.record(z2.string()).optional(),
         body: z2.record(z2.unknown()).optional(),
-        params: z2.record(z2.string()).optional()
+        params: z2.record(z2.string()).optional(),
+        detail: detailSchema
       }),
       // 7. AI data operations
       gtm_ai: z2.object({
@@ -13167,7 +13475,7 @@ var init_validation = __esm({
         prompt: z2.string().optional(),
         model: z2.string().optional()
       }),
-      // 8. Cold email campaign management
+      // 8. Campaign management (cold email + LinkedIn outreach)
       gtm_campaign: z2.object({
         action: z2.enum(["list", "stats", "add_leads", "create"], {
           message: "action must be one of: list, stats, add_leads, create"
@@ -13175,15 +13483,8 @@ var init_validation = __esm({
         campaign_id: z2.string().optional(),
         leads: z2.array(campaignLeadSchema).optional(),
         name: z2.string().optional(),
-        provider: z2.string().optional()
-      }),
-      // 9. LinkedIn outreach management
-      gtm_outreach: z2.object({
-        action: z2.enum(["list", "stats", "add_leads"], {
-          message: "action must be one of: list, stats, add_leads"
-        }),
-        campaign_id: z2.string().optional(),
-        leads: z2.array(outreachLeadSchema).optional()
+        provider: z2.string().optional(),
+        detail: detailSchema
       }),
       // 10. CRM read/write
       gtm_crm: z2.object({
@@ -13196,7 +13497,8 @@ var init_validation = __esm({
       }),
       // 11. Provider status/credits
       gtm_status: z2.object({
-        provider: z2.string().optional()
+        provider: z2.string().optional(),
+        detail: detailSchema
       }),
       // 12. Configuration management
       gtm_configure: z2.object({
@@ -13229,6 +13531,14 @@ var init_validation = __esm({
       gtm_execute: z2.object({
         tool: z2.string().min(1, "tool is required"),
         arguments: z2.record(z2.unknown()).optional()
+      }),
+      // 16. Feedback
+      gtm_feedback: z2.object({
+        type: z2.enum(["bug", "feature_request", "provider_request"], {
+          message: "type must be one of: bug, feature_request, provider_request"
+        }),
+        message: z2.string().min(1, "message is required"),
+        context: z2.record(z2.unknown()).optional()
       })
     };
     TOOL_NAMES = Object.keys(toolSchemas);
@@ -13299,15 +13609,16 @@ function createServer() {
           isError: true
         };
       }
+      const fullDescription = TOOL_DESCRIPTIONS[tool.name] ?? tool.description;
       return {
         content: [
           {
             type: "text",
-            text: JSON.stringify(
-              { name: tool.name, description: tool.description, inputSchema: tool.inputSchema },
-              null,
-              2
-            )
+            text: JSON.stringify({
+              name: tool.name,
+              description: fullDescription,
+              inputSchema: tool.inputSchema
+            })
           }
         ]
       };