Enrichment Configuration

// Full configuration for enrichment request
const result = await abmdev.enrich({
  // Input data
  email: "[email protected]",
  linkedin_url: "linkedin.com/in/janesmith",

  // Source configuration
  sources: ["linkedin", "hunter", "perplexity"],
  require_linkedin: true,

  // AI configuration
  enable_auditor: true,
  models: {
    writer: {
      provider: "anthropic",
      model: "claude-sonnet-4-20250514"
    },
    auditor: {
      provider: "anthropic",
      model: "claude-3-5-haiku-20241022"
    }
  },

  // Per-request instructions (optional) — a free-text brief that
  // supersedes your standing brief for this one job
  instructions: `You are enriching a B2B contact.
Focus on professional background, decision-making authority,
and technology interests. Be concise.`,

  // Quality controls
  min_confidence_to_proceed: 0.7,
  auto_proceed: false,        // Review before CRM writeback

  // CRM integration
  enable_hubspot_writeback: true,
  hubspot_contact_id: "12345" // Optional: update specific contact
});

// Use only specific sources
const result = await abmdev.enrich({
  email: "[email protected]",
  sources: ["linkedin", "hunter"]  // Skip Perplexity and Tavily
});

// Require LinkedIn (fail if unavailable)
const result = await abmdev.enrich({
  email: "[email protected]",
  require_linkedin: true  // Returns error if LinkedIn fails
});

// Company enrichment with web sources only
const result = await abmdev.enrich({
  domain: "acme.com",
  entity_type: "company",
  sources: ["perplexity", "tavily"]  // Skip LinkedIn for companies
});

// Conservative: high confidence required
const result = await abmdev.enrich({
  email: "[email protected]",
  min_confidence_to_proceed: 0.85,  // Only proceed if 85%+ confident
  auto_proceed: true                 // Auto-write to CRM
});

// Review workflow: medium threshold, manual approval
const result = await abmdev.enrich({
  email: "[email protected]",
  min_confidence_to_proceed: 0.5,   // Accept moderate confidence
  auto_proceed: false               // Require manual review
});

// Check result confidence
if (result.metadata.confidence_score >= 0.9) {
  console.log("High confidence - safe for automation");
} else if (result.metadata.confidence_score >= 0.7) {
  console.log("Good confidence - review recommended");
} else {
  console.log("Low confidence - manual verification needed");
}

// Standing brief — set once, feeds every enrichment
await fetch("https://api.abm.dev/v2/config", {
  method: "PATCH",
  headers: { "X-API-Key": ABM_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    enrichment: {
      person_brief: `We sell post-deal integration tooling to UK
accountancy firms. Surface M&A, PE-backing and succession signals.
Keep summaries action-oriented for sales reps.`,
      company_brief: `We target mid-market UK accountancy firms.
Surface growth trajectory, advisory service mix and PE involvement.`
    }
  })
});

// One job, different brief — per-request override
const result = await abmdev.enrich({
  domain: "acme.com",
  entity_type: "company",
  instructions: `Research this company for marketing segmentation:
industry vertical, company size, content channels they engage with,
competitive position. Output should support campaign targeting.`
});

// Run preflight checks only
const preflight = await abmdev.enrich({
  email: "[email protected]",
  preflight_only: true  // Don't execute, just validate
});

// Preflight returns:
// - Source availability (which sources can provide data)
// - Portfolio score (predicted enrichment quality)
// - Estimated fields (what data will be populated)
// - Configuration validation (any issues with your config)

console.log(preflight.preflight);
// {
//   portfolio_score: 0.85,
//   available_sources: ["linkedin", "hunter", "perplexity"],
//   estimated_fields: 34,
//   warnings: [],
//   ready: true
// }

// If ready, proceed with actual enrichment
if (preflight.preflight.ready) {
  const result = await abmdev.enrich({
    email: "[email protected]",
    preflight_only: false
  });
}