Add application files

app.py

@@ -589,8 +589,20 @@ def get_contacts_html() -> str:
         </div>
         """
 
-    html = ""
+    html = """
+    <div style="background: var(--info-bg, #d1ecf1); border: 1px solid var(--info-border, #bee5eb); border-radius: 8px; padding: 12px 16px; margin-bottom: 16px;">
+        <div style="font-size: 13px; color: var(--info-text, #0c5460);">
+            <strong>ℹ️ Contact Sources:</strong> Names are sourced from LinkedIn searches and company team pages.
+            Email addresses use common business formats. Contacts marked <strong>VERIFIED</strong> were found in public web sources.
+        </div>
+    </div>
+    """
     for c in reversed(knowledge_base["contacts"]):
+        is_verified = c.get("verified", False)
+        source = c.get("source", "unknown")
+        verified_badge = "VERIFIED" if is_verified else "ESTIMATED"
+        badge_class = "badge-engaged" if is_verified else "badge-researched"
+        source_text = "from web search" if is_verified else "estimated"
         html += f"""
         <div class="prospect-card" style="padding: 16px 20px;">
             <div style="display: flex; justify-content: space-between; align-items: center;">
@@ -598,9 +610,9 @@ def get_contacts_html() -> str:
                     <div style="font-weight: 600; color: var(--text-primary);">👤 {c.get("name", "Unknown")}</div>
                     <div style="font-size: 13px; color: var(--text-secondary); margin-top: 4px;">{c.get("title", "Unknown title")}</div>
                     <div style="font-size: 13px; color: var(--text-secondary);">🏢 {c.get("company", "Unknown company")}</div>
-                    {f'<div style="font-size: 13px; color: var(--primary-blue); margin-top: 4px;">📧 {c.get("email")}</div>' if c.get("email") else ''}
+                    {f'<div style="font-size: 13px; color: var(--primary-blue); margin-top: 4px;">📧 {c.get("email")} <span style="font-size: 11px; color: var(--text-secondary);">({source_text})</span></div>' if c.get("email") else ''}
                 </div>
-                <span class="prospect-card-badge badge-researched">FOUND</span>
+                <span class="prospect-card-badge {badge_class}">{verified_badge}</span>
             </div>
         </div>
         """
@@ -879,50 +891,50 @@ async def discover_prospects(num_prospects: int, progress=gr.Progress()):
 About {client_name}:
 {client_info}
 
-IMPORTANT: You MUST use the tools to save data. Follow these steps for EACH prospect:
-
-1. Use search_web to find {num_prospects} companies that would be ideal customers for {client_name}
-2. For EACH company found, you MUST:
-   a. Use save_prospect tool with these parameters:
-      - prospect_id: unique ID like "prospect_1"
-      - company_id: unique ID like "company_1"
-      - company_name: the company name
-      - company_domain: the company website domain
-      - fit_score: 1-100 score
-      - metadata: {{"summary": "company description", "industry": "their industry", "fit_reason": "why they're a good fit"}}
-
-   b. Use save_contact tool for 2-3 decision makers with:
-      - contact_id: unique ID like "contact_1"
-      - company_id: same company_id as above
-      - company_name: THE ACTUAL COMPANY NAME (e.g., "Acme Corp", NOT "company_1")
-      - email: their email using format "[email protected]"
-      - first_name: their first name
-      - last_name: their last name
-      - title: their job title (CEO, VP Sales, CTO, Marketing Director, etc.)
-
-   c. Use send_email tool to draft a PERSONALIZED outreach email:
-      - to: the contact email (use format: [email protected])
-      - subject: Compelling subject mentioning BOTH {client_name} and the prospect company name
-      - body: A personalized email that includes:
-        * Greeting using the contact's first name
-        * Specific reference to the prospect company's business/recent news
-        * Clear explanation of how {client_name} can help THIS specific company
-        * Mention their industry and specific challenges they face
-        * A concrete call-to-action (demo, call, meeting)
-        * Professional sign-off
+CRITICAL: Use the find_verified_contacts tool to get REAL contacts. NEVER make up contact names or emails.
+
+WORKFLOW - Follow these steps:
+
+STEP 1: Find prospect companies
+- Use search_web to find {num_prospects} companies that would benefit from {client_name}'s services
+- Look for REAL, INDEPENDENT companies (not acquired/merged ones)
+- Example: Deliverr was acquired by Shopify - skip such companies
+
+STEP 2: For EACH prospect company found:
+   a. Save the prospect using save_prospect tool:
+      {{"prospect_id": "prospect_1", "company_id": "company_1", "company_name": "ActualCompanyName", "company_domain": "actualcompany.com", "fit_score": 85, "metadata": {{"industry": "...", "fit_reason": "..."}}}}
+
+   b. Find REAL contacts using find_verified_contacts tool (THIS IS REQUIRED):
+      {{"company_name": "ActualCompanyName", "company_domain": "actualcompany.com", "target_titles": ["CEO", "Founder", "VP Sales", "CTO"], "max_contacts": 3}}
+
+      This tool will:
+      - Search LinkedIn for real executives
+      - Scrape company team/about pages
+      - Return ONLY verified names found on the web
+      - Automatically save contacts to the database
+
+   c. If find_verified_contacts returns contacts, draft email using send_email tool:
+      - Use the REAL contact info returned by find_verified_contacts
+      - to: contact email from the tool result
+      - subject: Reference {client_name} AND the prospect's business
+      - body: Personalized email with real facts
       - prospect_id: the prospect_id from step a
 
-IMPORTANT EMAIL GUIDELINES:
-- DO NOT write generic emails. Each email must be specific to the prospect.
-- Reference the prospect's actual business, industry, or recent activities
-- Explain why {client_name} is relevant to THEIR specific situation
-- Keep emails concise (3-4 paragraphs max)
+   d. If find_verified_contacts returns no contacts:
+      - Note: "No verified contacts found - leadership info not publicly available"
+      - Do NOT make up contacts
+      - Skip email for this prospect
 
-Focus on finding companies that:
-- Would benefit from {client_name}'s products/services
-- Are in industries that match {client_name}'s target market
+IMPORTANT RULES:
+- ALWAYS use find_verified_contacts to get contacts - NEVER invent names
+- The find_verified_contacts tool does real web scraping to find actual executives
+- If no contacts are found, that's OK - report it honestly
+- Companies with no public leadership info should still be saved as prospects
 
-After processing all {num_prospects} prospects, provide a brief summary of what you found."""
+After processing {num_prospects} prospects, provide summary:
+- Prospects saved (with company names)
+- Verified contacts found (or "none found" per company)
+- Emails drafted (only for companies with verified contacts)"""
 
     prospects_found = []
     contacts_found = []
@@ -1033,6 +1045,31 @@ After processing all {num_prospects} prospects, provide a brief summary of what
                     else:
                         output += f"   ✅ Contact saved\n"
 
+                elif tool == "find_verified_contacts":
+                    # Handle verified contacts from the enhanced contact finder
+                    if isinstance(result, dict):
+                        status = result.get("status", "")
+                        found_contacts = result.get("contacts", [])
+                        message = result.get("message", "")
+
+                        if status == "success" and found_contacts:
+                            output += f"   ✅ Found {len(found_contacts)} verified contacts:\n"
+                            for c in found_contacts:
+                                contact_data = {
+                                    "name": c.get("name", "Unknown"),
+                                    "email": c.get("email", ""),
+                                    "title": c.get("title", ""),
+                                    "company": c.get("company", current_prospect_name or ""),
+                                    "verified": c.get("verified", True),
+                                    "source": c.get("source", "web_search")
+                                }
+                                contacts_found.append(contact_data)
+                                output += f"      • {contact_data['name']} ({contact_data['title']}) - {contact_data['email']}\n"
+                        elif status == "no_contacts_found":
+                            output += f"   ℹ️ {message}\n"
+                        else:
+                            output += f"   ⚠️ Contact search: {message}\n"
+
                 elif tool == "send_email":
                     output += f"   ✅ Email drafted\n"
                     # Mark prospect as having email drafted
@@ -1102,10 +1139,11 @@ After processing all {num_prospects} prospects, provide a brief summary of what
 
                     if contacts_found:
                         output += "\n### 👥 Decision Makers Found\n\n"
+                        output += "> ⚠️ **Note:** Names are from web searches. Emails are *estimated* ([email protected] format). Please verify before outreach.\n\n"
                         for c in contacts_found:
                             output += f"- **{c.get('name', 'Unknown')}** - {c.get('title', 'Unknown')} at {c.get('company', 'Unknown')}\n"
                             if c.get('email'):
-                                output += f"  - Email: {c.get('email')}\n"
+                                output += f"  - Email: {c.get('email')} *(estimated)*\n"
 
                     if emails_drafted:
                         output += "\n### ✉️ Emails Drafted\n\n"

mcp/agents/autonomous_agent_hf.py

@@ -172,33 +172,38 @@ class AutonomousMCPAgentHF:
         # System prompt for the agent
         system_prompt = """You are an autonomous AI agent for B2B sales automation.
 
-You have access to MCP (Model Context Protocol) tools that let you:
-- Search the web for company information and news
-- Save prospects, companies, contacts, and facts to a database
-- Send emails and manage email threads
-- Schedule meetings and generate calendar invites
+You have access to MCP tools including:
+- search_web: Search the web for company information
+- save_prospect: Save a prospect company to the database
+- find_verified_contacts: Find REAL decision-makers using LinkedIn search and web scraping (USE THIS!)
+- send_email: Draft outreach emails
 
-CRITICAL: You MUST call tools to save data. Do NOT just describe what you would do - actually call the tools!
+CRITICAL: Use find_verified_contacts to get REAL contacts. NEVER make up names or emails!
 
-TOOL CALL FORMAT - You must output valid JSON for each tool call:
-```json
+REQUIRED WORKFLOW for each prospect:
+1. search_web to find prospect companies
+2. save_prospect with company info
+3. find_verified_contacts to get REAL executives (this does LinkedIn + web scraping)
+4. send_email ONLY using contacts returned by find_verified_contacts
+
+TOOL CALL FORMAT - output valid JSON:
+
+For prospects:
 {"prospect_id": "prospect_1", "company_id": "company_1", "company_name": "Acme Corp", "company_domain": "acme.com", "fit_score": 85}
-```
 
-Example workflow:
-1. Call search_web to find companies
-2. For EACH company found, call save_prospect with JSON parameters
-3. For EACH contact, call save_contact with JSON like:
-   {"contact_id": "contact_1", "company_id": "company_1", "email": "[email protected]", "first_name": "John", "last_name": "Smith", "title": "CEO"}
-4. Call send_email to draft outreach
+For finding REAL contacts (REQUIRED):
+{"company_name": "Acme Corp", "company_domain": "acme.com", "target_titles": ["CEO", "Founder", "VP Sales"], "max_contacts": 3}
+
+The find_verified_contacts tool will:
+- Search LinkedIn for real executives
+- Scrape company team/about pages
+- Return ONLY real names found on the web
+- Automatically save verified contacts
 
-IMPORTANT RULES:
-- ALWAYS use tool calls with proper JSON parameters - never just describe the action
-- Use realistic email formats: [email protected]
-- Each tool call must have all required fields
-- Do NOT hallucinate or make up contact details without calling save_contact tool
+If find_verified_contacts returns no contacts, report: "No verified contacts found for [Company]"
+Do NOT invent contacts - only use what find_verified_contacts returns.
 
-After completing tool calls, provide a brief summary."""
+After completing, summarize prospects and verified contacts found."""
 
         # Initialize conversation
         messages = [
@@ -567,13 +572,18 @@ After completing tool calls, provide a brief summary."""
                     return None
                 keys = set(params.keys())
 
+                # Check for find_verified_contacts patterns (PRIORITY - use this instead of save_contact)
+                if "company_name" in keys and "company_domain" in keys and "target_titles" in keys:
+                    return "find_verified_contacts"
+                if "company_name" in keys and "company_domain" in keys and "max_contacts" in keys:
+                    return "find_verified_contacts"
                 # Check for save_prospect patterns
                 if "prospect_id" in keys or ("company_name" in keys and "fit_score" in keys):
                     return "save_prospect"
                 # Check for save_company patterns
                 if "company_id" in keys and ("name" in keys or "domain" in keys) and "prospect_id" not in keys:
                     return "save_company"
-                # Check for save_contact patterns
+                # Check for save_contact patterns (only for contacts returned by find_verified_contacts)
                 if "contact_id" in keys or ("email" in keys and ("first_name" in keys or "last_name" in keys)):
                     return "save_contact"
                 # Check for send_email patterns
@@ -715,6 +725,77 @@ After completing tool calls, provide a brief summary."""
                 "count": len(results[:max_results])
             }
 
+        # ============ VERIFIED CONTACT FINDER ============
+        elif tool_name == "find_verified_contacts":
+            from services.enhanced_contact_finder import EnhancedContactFinder
+
+            company_name = tool_input["company_name"]
+            company_domain = tool_input["company_domain"]
+            target_titles = tool_input.get("target_titles", ["CEO", "Founder", "VP Sales", "CTO", "Head of Sales"])
+            max_contacts = tool_input.get("max_contacts", 3)
+
+            logger.info(f"Finding verified contacts for {company_name} ({company_domain})")
+
+            # Use the EnhancedContactFinder which does real web scraping and LinkedIn search
+            contact_finder = EnhancedContactFinder(mcp_registry=self.mcp_registry)
+
+            try:
+                contacts = await contact_finder.find_real_contacts(
+                    company_name=company_name,
+                    domain=company_domain,
+                    target_titles=target_titles,
+                    max_contacts=max_contacts
+                )
+
+                # Convert contacts to serializable format
+                contact_list = []
+                for contact in contacts:
+                    contact_data = {
+                        "id": contact.id,
+                        "name": contact.name,
+                        "email": contact.email,
+                        "title": contact.title,
+                        "company": company_name,
+                        "domain": company_domain,
+                        "verified": True,  # These come from real web searches
+                        "source": "web_search_and_scraping"
+                    }
+                    contact_list.append(contact_data)
+
+                    # Also save to store automatically
+                    await self.mcp_registry.store.save_contact({
+                        "id": contact.id,
+                        "company_id": company_domain.replace(".", "_"),
+                        "email": contact.email,
+                        "first_name": contact.name.split()[0] if contact.name else "",
+                        "last_name": contact.name.split()[-1] if contact.name and len(contact.name.split()) > 1 else "",
+                        "title": contact.title
+                    })
+
+                if contact_list:
+                    return {
+                        "status": "success",
+                        "contacts": contact_list,
+                        "count": len(contact_list),
+                        "message": f"Found {len(contact_list)} verified contacts at {company_name}"
+                    }
+                else:
+                    return {
+                        "status": "no_contacts_found",
+                        "contacts": [],
+                        "count": 0,
+                        "message": f"No verified contacts found for {company_name}. Leadership information may not be publicly available."
+                    }
+
+            except Exception as e:
+                logger.error(f"Error finding contacts for {company_name}: {str(e)}")
+                return {
+                    "status": "error",
+                    "contacts": [],
+                    "count": 0,
+                    "message": f"Error searching for contacts: {str(e)}"
+                }
+
         # ============ STORE MCP SERVER ============
         elif tool_name == "save_prospect":
             prospect_data = {

mcp/tools/definitions.py

@@ -201,9 +201,37 @@ MCP_TOOLS: List[Dict[str, Any]] = [
             "required": ["fact_id", "company_id", "fact_type", "content"]
         }
     },
+    {
+        "name": "find_verified_contacts",
+        "description": "Find REAL verified decision-makers at a company using LinkedIn search, team page scraping, and web research. This tool searches the web to find actual executives - DO NOT make up contact names. Use this INSTEAD of save_contact to get real contacts.",
+        "input_schema": {
+            "type": "object",
+            "properties": {
+                "company_name": {
+                    "type": "string",
+                    "description": "The company name to find contacts for"
+                },
+                "company_domain": {
+                    "type": "string",
+                    "description": "The company website domain (e.g., 'acme.com')"
+                },
+                "target_titles": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "List of job titles to search for (e.g., ['CEO', 'VP Sales', 'CTO'])"
+                },
+                "max_contacts": {
+                    "type": "integer",
+                    "description": "Maximum number of contacts to find (default: 3)",
+                    "default": 3
+                }
+            },
+            "required": ["company_name", "company_domain"]
+        }
+    },
     {
         "name": "save_contact",
-        "description": "Save a contact person (decision-maker) for a company.",
+        "description": "Save a contact person that was found by find_verified_contacts. Only use this for contacts returned by find_verified_contacts - NEVER make up contact information.",
         "input_schema": {
             "type": "object",
             "properties": {