@xuda.io/ai_module 1.1.4674 → 1.1.4675

package/index.mjs

@@ -9094,3 +9094,635 @@ export const get_business_info = async function (uid, name, email, account_profi
     return getDefaultBusinessInfo(name, email, error.message);
   }
 };
+
+export const get_person_info = async function (uid, name, email, account_profile_info, email_context = '') {
+  // ========== HELPER FUNCTIONS ==========
+
+  async function hashString(str) {
+    // Simple hash for context tracking
+    const encoder = new TextEncoder();
+    const data = encoder.encode(str);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray
+      .map((b) => b.toString(16).padStart(2, '0'))
+      .join('')
+      .substring(0, 16);
+  }
+
+  function processPersonInfo(data, originalName, originalEmail, emailContext) {
+    // Ensure basic fields are populated
+    if (!data.person_first_name || !data.person_last_name) {
+      const nameParts = originalName.trim().split(/\s+/);
+      data.person_first_name = data.person_first_name || nameParts[0] || '';
+      data.person_last_name = data.person_last_name || nameParts.slice(1).join(' ') || '';
+    }
+
+    // Set full name if not provided
+    if (!data.person_full_name) {
+      data.person_full_name = `${data.person_first_name} ${data.person_last_name}`.trim();
+    }
+
+    // Ensure email is set
+    data.person_email = data.person_email || originalEmail;
+
+    // Process demographic information
+    data.person_age = processAge(data.person_age);
+    data.person_gender = data.person_gender || 'unknown';
+    data.person_nationality = processNationality(data.person_nationality);
+
+    // Standardize location fields
+    data.person_location_city = cleanText(data.person_location_city);
+    data.person_location_state = cleanStateProvince(data.person_location_state);
+    data.person_location_country = processCountryCode(data.person_location_country);
+
+    // Format full location
+    if (!data.person_location_full || data.person_location_full === 'Not available') {
+      const locationParts = [];
+      if (data.person_location_city && data.person_location_city !== 'Not available') {
+        locationParts.push(data.person_location_city);
+      }
+      if (data.person_location_state && data.person_location_state !== 'Not available') {
+        locationParts.push(data.person_location_state);
+      }
+      if (data.person_location_country && data.person_location_country !== 'Not available') {
+        locationParts.push(countryCodeToName(data.person_location_country));
+      }
+      data.person_location_full = locationParts.length > 0 ? locationParts.join(', ') : 'Not available';
+    }
+
+    // Clean and validate URLs
+    data.person_linkedin = validateURL(data.person_linkedin);
+    data.person_twitter = validateURL(data.person_twitter);
+    data.person_github = validateURL(data.person_github);
+    data.person_website = validateURL(data.person_website);
+
+    // Clean phone number
+    data.person_phone = validatePhoneNumber(data.person_phone);
+
+    // Ensure arrays are properly formatted
+    data.person_skills = ensureArray(data.person_skills);
+    data.person_expertise = ensureArray(data.person_expertise);
+    data.person_education = ensureArray(data.person_education);
+    data.person_languages = ensureArray(data.person_languages);
+    data.person_interests = ensureArray(data.person_interests);
+    data.person_context_insights = ensureArray(data.person_context_insights);
+
+    // Calculate additional metadata
+    data.person_name_initials = getInitials(data.person_first_name, data.person_last_name);
+    data.person_age_range = calculateAgeRange(data.person_age);
+    data.person_seniority_score = calculateSeniorityScore(data);
+    data.person_pronouns = getPronounsFromGender(data.person_gender);
+
+    // Extract insights from email context
+    if (emailContext && !data.person_context_insights) {
+      data.person_context_insights = extractContextInsights(emailContext);
+    }
+
+    // Create structured objects for easier access
+    data.person_demographics = {
+      age: data.person_age,
+      age_range: data.person_age_range,
+      gender: data.person_gender,
+      pronouns: data.person_pronouns,
+      nationality: data.person_nationality,
+      nationality_name: countryCodeToName(data.person_nationality),
+    };
+
+    data.person_contact = {
+      email: data.person_email,
+      phone: data.person_phone,
+      location: {
+        city: data.person_location_city,
+        state: data.person_location_state,
+        country: data.person_location_country,
+        country_name: countryCodeToName(data.person_location_country),
+        full: data.person_location_full,
+      },
+    };
+
+    data.person_professional = {
+      title: data.person_title,
+      company: data.person_company,
+      industry: data.person_industry,
+      career_level: data.person_career_level,
+      years_experience: data.person_years_experience,
+      skills: data.person_skills,
+      expertise: data.person_expertise,
+      education: data.person_education,
+    };
+
+    data.person_online = {
+      linkedin: data.person_linkedin,
+      twitter: data.person_twitter,
+      github: data.person_github,
+      website: data.person_website,
+      other: data.person_social_other || [],
+    };
+
+    // Add context metadata
+    data.context_analysis = {
+      has_context: !!emailContext,
+      context_length: emailContext?.length || 0,
+      extracted_insights: data.person_context_insights || [],
+      context_useful: data.person_has_context_hints || false,
+    };
+
+    // Add timestamp
+    data.retrieved_at = new Date().toISOString();
+
+    return data;
+  }
+
+  function processAge(ageInput) {
+    if (!ageInput || ageInput === 'unknown' || ageInput === 'Not available') {
+      return 'unknown';
+    }
+
+    if (typeof ageInput === 'number') {
+      return Math.max(18, Math.min(100, ageInput));
+    }
+
+    if (typeof ageInput === 'string') {
+      // Parse age ranges like "30-40", "35+", "mid-30s"
+      const rangeMatch = ageInput.match(/(\d+)-(\d+)/);
+      if (rangeMatch) {
+        const avg = Math.floor((parseInt(rangeMatch[1]) + parseInt(rangeMatch[2])) / 2);
+        return avg;
+      }
+
+      const numberMatch = ageInput.match(/\d+/);
+      if (numberMatch) {
+        const age = parseInt(numberMatch[0]);
+        if (age >= 18 && age <= 100) return age;
+      }
+
+      // Handle textual age descriptions
+      const text = ageInput.toLowerCase();
+      if (text.includes('twent') || text.includes('20')) return 25;
+      if (text.includes('thirt') || text.includes('30')) return 35;
+      if (text.includes('fort') || text.includes('40')) return 45;
+      if (text.includes('fift') || text.includes('50')) return 55;
+      if (text.includes('sixt') || text.includes('60')) return 65;
+    }
+
+    return 'unknown';
+  }
+
+  function calculateAgeRange(age) {
+    if (age === 'unknown' || typeof age !== 'number') return 'Unknown';
+
+    if (age < 25) return '18-24';
+    if (age < 30) return '25-29';
+    if (age < 35) return '30-34';
+    if (age < 40) return '35-39';
+    if (age < 50) return '40-49';
+    if (age < 60) return '50-59';
+    return '60+';
+  }
+
+  function processNationality(nationality) {
+    if (!nationality || nationality.toLowerCase() === 'unknown' || nationality.toLowerCase() === 'not available') {
+      return 'unknown';
+    }
+
+    // Convert to uppercase for country codes
+    const upper = nationality.toUpperCase();
+
+    // Map common variations to ISO codes
+    const countryMap = {
+      USA: 'US',
+      'UNITED STATES': 'US',
+      AMERICA: 'US',
+      UK: 'GB',
+      'UNITED KINGDOM': 'GB',
+      ENGLAND: 'GB',
+      SCOTLAND: 'GB',
+      CANADA: 'CA',
+      AUSTRALIA: 'AU',
+      INDIA: 'IN',
+      GERMANY: 'DE',
+      FRANCE: 'FR',
+      CHINA: 'CN',
+      JAPAN: 'JP',
+      BRAZIL: 'BR',
+      MEXICO: 'MX',
+      SPAIN: 'ES',
+      ITALY: 'IT',
+      NETHERLANDS: 'NL',
+      SWEDEN: 'SE',
+      SWITZERLAND: 'CH',
+      'SOUTH KOREA': 'KR',
+      RUSSIA: 'RU',
+    };
+
+    if (countryMap[upper]) {
+      return countryMap[upper];
+    }
+
+    // If it's already a 2-letter code, return it
+    if (/^[A-Z]{2}$/.test(upper)) {
+      return upper;
+    }
+
+    return 'unknown';
+  }
+
+  function processCountryCode(country) {
+    if (!country || country.toLowerCase() === 'not available') {
+      return 'unknown';
+    }
+
+    return processNationality(country);
+  }
+
+  function countryCodeToName(code) {
+    if (!code || code === 'unknown') return 'Unknown';
+
+    const countryNames = {
+      US: 'United States',
+      GB: 'United Kingdom',
+      CA: 'Canada',
+      AU: 'Australia',
+      DE: 'Germany',
+      FR: 'France',
+      JP: 'Japan',
+      CN: 'China',
+      IN: 'India',
+      BR: 'Brazil',
+      MX: 'Mexico',
+      ES: 'Spain',
+      IT: 'Italy',
+      NL: 'Netherlands',
+      SE: 'Sweden',
+      CH: 'Switzerland',
+      KR: 'South Korea',
+      RU: 'Russia',
+    };
+
+    return countryNames[code] || code;
+  }
+
+  function getPronounsFromGender(gender) {
+    switch (gender) {
+      case 'male':
+        return ['he/him', 'his'];
+      case 'female':
+        return ['she/her', 'hers'];
+      case 'non-binary':
+        return ['they/them', 'theirs'];
+      default:
+        return ['unknown'];
+    }
+  }
+
+  function extractContextInsights(emailContext) {
+    if (!emailContext) return [];
+
+    const insights = [];
+    const context = emailContext.toLowerCase();
+
+    // Extract potential job role hints
+    const rolePatterns = {
+      manager: ['manage', 'supervise', 'team lead', 'department head'],
+      engineer: ['engineer', 'developer', 'programmer', 'software'],
+      sales: ['sales', 'account executive', 'business development'],
+      marketing: ['marketing', 'campaign', 'brand', 'social media'],
+      executive: ['ceo', 'cto', 'cfo', 'director', 'vp', 'vice president'],
+    };
+
+    for (const [role, patterns] of Object.entries(rolePatterns)) {
+      if (patterns.some((pattern) => context.includes(pattern))) {
+        insights.push(`Possible ${role} role indicated in email`);
+      }
+    }
+
+    // Extract company hints
+    const companyMatch = context.match(/(?:at|from|of)\s+([A-Z][A-Za-z0-9\s&]+)(?:\s|$)/);
+    if (companyMatch && companyMatch[1].length > 2) {
+      insights.push(`Mentioned company/organization: ${companyMatch[1].trim()}`);
+    }
+
+    // Extract project/technology hints
+    const techMatch = context.match(/(?:using|with|built\s+in)\s+([A-Za-z0-9\s+#]+)(?:\s|$)/);
+    if (techMatch) {
+      insights.push(`Technology mentioned: ${techMatch[1].trim()}`);
+    }
+
+    // Extract urgency/priority
+    if (context.includes('urgent') || context.includes('asap') || context.includes('immediately')) {
+      insights.push('Email suggests urgency or time sensitivity');
+    }
+
+    // Extract tone
+    if (context.includes('thank you') || context.includes('appreciate') || context.includes('grateful')) {
+      insights.push('Email shows appreciative/grateful tone');
+    }
+
+    return insights.slice(0, 5); // Limit to 5 insights
+  }
+
+  // Existing helper functions (kept from previous version)
+  function validateURL(url) {
+    /* ... same as before ... */
+  }
+  function validatePhoneNumber(phone) {
+    /* ... same as before ... */
+  }
+  function cleanText(text) {
+    /* ... same as before ... */
+  }
+  function cleanStateProvince(state) {
+    /* ... same as before ... */
+  }
+  function ensureArray(value) {
+    /* ... same as before ... */
+  }
+  function getInitials(firstName, lastName) {
+    /* ... same as before ... */
+  }
+  function calculateSeniorityScore(data) {
+    /* ... same as before ... */
+  }
+
+  function getDefaultPersonInfo(name, email, emailContext = '', error = null) {
+    const nameParts = name.trim().split(/\s+/);
+    const firstName = nameParts[0] || '';
+    const lastName = nameParts.slice(1).join(' ') || '';
+    const domain = email.includes('@') ? email.split('@')[1] : '';
+    const companyGuess = domain
+      .replace(/\..*$/, '')
+      .replace(/[^a-z]/gi, ' ')
+      .replace(/\b\w/g, (l) => l.toUpperCase());
+
+    // Extract basic insights from email context
+    const contextInsights = emailContext ? extractContextInsights(emailContext) : [];
+
+    return {
+      // Basic Information
+      person_full_name: name,
+      person_first_name: firstName,
+      person_last_name: lastName,
+      person_middle_name: '',
+      person_preferred_name: '',
+
+      // Demographic Information
+      person_age: 'unknown',
+      person_gender: 'unknown',
+      person_nationality: 'unknown',
+      person_age_range: 'Unknown',
+      person_pronouns: ['unknown'],
+
+      // Professional Information
+      person_title: 'Professional',
+      person_company: companyGuess || 'Unknown',
+      person_industry: 'Technology',
+      person_bio: 'Information not available',
+
+      // Location
+      person_location_city: 'Not available',
+      person_location_state: 'Not available',
+      person_location_country: 'unknown',
+      person_location_full: 'Not available',
+
+      // Contact Information
+      person_phone: 'Not available',
+      person_email: email,
+      person_email_alternate: '',
+
+      // Education
+      person_education: [],
+      person_education_highest: 'Not available',
+
+      // Professional Details
+      person_skills: [],
+      person_expertise: [],
+      person_career_level: 'unknown',
+      person_years_experience: 0,
+
+      // Social & Online Presence
+      person_linkedin: 'Not available',
+      person_twitter: 'Not available',
+      person_github: 'Not available',
+      person_website: 'Not available',
+      person_social_other: [],
+
+      // Additional Information
+      person_languages: ['English'],
+      person_interests: [],
+      person_achievements: [],
+      person_current_projects: [],
+      person_context_insights: contextInsights,
+
+      // Metadata
+      person_available_for_opportunities: false,
+      person_last_updated: new Date().toISOString(),
+      person_source_confidence: 0,
+      person_has_context_hints: contextInsights.length > 0,
+
+      // Processed fields
+      person_name_initials: getInitials(firstName, lastName),
+      person_seniority_score: 0,
+
+      // Structured objects
+      person_demographics: {
+        age: 'unknown',
+        age_range: 'Unknown',
+        gender: 'unknown',
+        pronouns: ['unknown'],
+        nationality: 'unknown',
+        nationality_name: 'Unknown',
+      },
+
+      person_contact: {
+        email: email,
+        phone: 'Not available',
+        location: {
+          city: 'Not available',
+          state: 'Not available',
+          country: 'unknown',
+          country_name: 'Unknown',
+          full: 'Not available',
+        },
+      },
+
+      person_professional: {
+        title: 'Professional',
+        company: companyGuess || 'Unknown',
+        industry: 'Technology',
+        career_level: 'unknown',
+        years_experience: 0,
+        skills: [],
+        expertise: [],
+        education: [],
+      },
+
+      person_online: {
+        linkedin: 'Not available',
+        twitter: 'Not available',
+        github: 'Not available',
+        website: 'Not available',
+        other: [],
+      },
+
+      context_analysis: {
+        has_context: !!emailContext,
+        context_length: emailContext?.length || 0,
+        extracted_insights: contextInsights,
+        context_useful: contextInsights.length > 0,
+      },
+
+      retrieved_at: new Date().toISOString(),
+      error: error || 'API call failed',
+    };
+  }
+
+  // Build context-aware prompt
+  let context_prompt = `Research the person: "${name}" (${email}).`;
+
+  if (email_context) {
+    context_prompt += `\n\nEMAIL CONTEXT PROVIDED:\n"${email_context.substring(0, 500)}${email_context.length > 500 ? '...' : ''}"`;
+  }
+
+  context_prompt += `
+            
+            REQUIRED PERSON INFORMATION:
+            1. Full name (first, middle, last)
+            2. Professional title/role
+            3. Company/organization they work for
+            4. Industry/field they work in
+            5. Location (city, state, country)
+            6. Professional biography (1-2 sentences)
+            7. Education background
+            8. Professional skills/expertise
+            9. Social media profiles (LinkedIn, Twitter, GitHub, etc.)
+            10. Personal website or portfolio
+            
+            DEMOGRAPHIC INFORMATION:
+            11. Estimated age (based on career, education, and public information)
+            12. Gender (based on name, pronouns in content, or public profiles)
+            13. Nationality/country of origin (if discernible)
+            
+            CONTACT INFORMATION:
+            14. Phone number (if available)
+            15. Alternate email addresses (if available)
+            16. Physical address (if available and appropriate)
+            
+            ADDITIONAL INSIGHTS:
+            17. Career level (entry, mid, senior, executive, etc.)
+            18. Years of experience
+            19. Notable achievements/awards
+            20. Languages spoken
+            21. Professional interests
+            22. Current projects
+            23. Availability for opportunities
+            
+            INSTRUCTIONS:
+            - Use web search to find accurate, public information
+            - Use email context provided to infer additional details
+            - Respect privacy - only include publicly available information
+            - For age: provide numeric estimate or range (e.g., 35, 30-40, unknown)
+            - For gender: use male/female/non-binary/unknown based on available cues
+            - For country: use 2-letter ISO code (e.g., US, IN, UK)
+            - If information is not available, use "Not available" or appropriate defaults
+            - For location, use standard formats (e.g., "San Francisco, CA, USA")
+            - For social media, provide full URLs when available
+            - Focus on professional information suitable for business networking
+            
+            Be thorough but respectful of privacy boundaries.`;
+
+  const person_info_ret = await submit_chat_gpt_prompt({
+    uid,
+    prompt: context_prompt,
+    model: 'gpt-4o-mini',
+    response_format: z.object({
+      // Basic Information
+      person_full_name: z.string().describe("Person's full name"),
+      person_first_name: z.string().describe('First name'),
+      person_last_name: z.string().describe('Last name'),
+      person_middle_name: z.string().optional().describe('Middle name if available'),
+      person_preferred_name: z.string().optional().describe('Preferred/nickname if different'),
+
+      // Demographic Information
+      person_age: z.union([z.number().int().min(18).max(100), z.string().describe("Age range or 'unknown'")]).describe('Estimated age or range'),
+      person_gender: z.enum(['male', 'female', 'non-binary', 'unknown']).describe('Gender based on available information'),
+      person_nationality: z.string().describe('Country of origin/nationality (2-letter ISO code)'),
+
+      // Professional Information
+      person_title: z.string().describe('Professional title/role'),
+      person_company: z.string().describe('Current company/organization'),
+      person_industry: z.string().describe('Primary industry/field'),
+      person_bio: z.string().describe('Professional biography (1-2 sentences)'),
+
+      // Location
+      person_location_city: z.string().describe('City of residence/work'),
+      person_location_state: z.string().describe('State/province'),
+      person_location_country: z.string().describe('Country (2-letter ISO code)'),
+      person_location_full: z.string().describe('Full location string'),
+
+      // Contact Information
+      person_phone: z.string().describe("Phone number or 'Not available'"),
+      person_email: z.string().describe('Primary email address'),
+      person_email_alternate: z.string().optional().describe('Alternate email if available'),
+
+      // Education
+      person_education: z.array(z.string()).describe('Array of educational institutions/degrees'),
+      person_education_highest: z.string().describe('Highest degree obtained'),
+
+      // Professional Details
+      person_skills: z.array(z.string()).describe('Array of professional skills'),
+      person_expertise: z.array(z.string()).describe('Areas of expertise'),
+      person_career_level: z.enum(['entry', 'mid', 'senior', 'lead', 'manager', 'director', 'executive', 'founder', 'unknown']),
+      person_years_experience: z.number().int().min(0).max(60).describe('Years of professional experience'),
+
+      // Social & Online Presence
+      person_linkedin: z.string().describe("LinkedIn profile URL or 'Not available'"),
+      person_twitter: z.string().describe("Twitter/X profile URL or 'Not available'"),
+      person_github: z.string().describe("GitHub profile URL or 'Not available'"),
+      person_website: z.string().describe("Personal website/portfolio or 'Not available'"),
+      person_social_other: z.array(z.string()).optional().describe('Other social media profiles'),
+
+      // Additional Information
+      person_languages: z.array(z.string()).describe('Languages spoken'),
+      person_interests: z.array(z.string()).describe('Professional/personal interests'),
+      person_achievements: z.array(z.string()).optional().describe('Notable achievements/awards'),
+      person_current_projects: z.array(z.string()).optional().describe('Current projects'),
+
+      // Context Extracted Information
+      person_context_insights: z.array(z.string()).optional().describe('Insights extracted from provided email context'),
+
+      // Metadata
+      person_available_for_opportunities: z.boolean().describe('Open to new opportunities'),
+      person_last_updated: z.string().describe('Date information was last verified'),
+      person_source_confidence: z.number().min(0).max(100).describe('Confidence score for information accuracy'),
+      person_has_context_hints: z.boolean().describe('Whether email context provided useful hints'),
+    }),
+    metadata: {
+      func: 'get_person_info',
+      person_name: name,
+      person_email: email,
+      has_email_context: !!email_context,
+      email_context_length: email_context?.length || 0,
+      context_hash: email_context ? await hashString(email_context.substring(0, 200)) : null,
+    },
+    account_profile_info,
+    tools: [{ type: 'web_search_preview' }],
+  });
+
+  try {
+    if (person_info_ret.code > -1) {
+      const data = typeof person_info_ret.data === 'string' ? JSON.parse(person_info_ret.data) : person_info_ret.data;
+
+      // Process and enhance the data
+      const processedData = processPersonInfo(data, name, email, email_context);
+
+      return processedData;
+    } else {
+      console.error('Person info API call failed:', person_info_ret);
+      return getDefaultPersonInfo(name, email, email_context);
+    }
+  } catch (error) {
+    console.error('Error in get_person_info:', error);
+    return getDefaultPersonInfo(name, email, email_context, error.message);
+  }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xuda.io/ai_module",
-  "version": "1.1.4674",
+  "version": "1.1.4675",
   "description": "Xuda AI Module",
   "main": "index.mjs",
   "type": "module",