Ground a customer email

async function groundEmail(companyName) {
  const headers = {
    'Authorization': `Bearer ${process.env.BETA_API_KEY}`,
    'Content-Type': 'application/json'
  };

  // 1. Validate
  const v = await fetch('https://api.getbeta.io/api/v1/validate', {
    method: 'POST',
    headers,
    body: JSON.stringify({ company: companyName })
  }).then(r => r.json());

  if (!v.verified) {
    if (v.needsDisambiguation) {
      // Ask the user to pick from v.alternatives
      return { status: 'ambiguous', alternatives: v.alternatives };
    }
    return { status: 'unknown', message: v.message };
  }

  // 2. Enrich
  const e = await fetch('https://api.getbeta.io/api/v1/enrich', {
    method: 'POST',
    headers,
    body: JSON.stringify({
      company: v.entity.key,
      include: ['intelligence']
    })
  }).then(r => r.json());

  // 3. Return with citation block
  return {
    status: 'ok',
    summary: e.headlineInsight,
    detail: e.context,
    sources_used: e.meta.sources,
    article_count: e.sources_cited,
    confidence: e.confidence,
    audit: {
      resolution_source: e.meta.resolution.source,
      snapshot_at: e.meta.enrichedAt
    }
  };
}