@adrata/adrata-mcp 1.0.0

package/output-formatter.js

@@ -0,0 +1,589 @@
+/**
+ * Output Formatter for Composite Tools
+ *
+ * Formats all composite tool output as sales-flavored markdown.
+ * Tables, scores, progress bars, coaching narratives — NOT raw JSON.
+ * Inspired by Notion's custom markdown approach for token efficiency.
+ */
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+export function progressBar(pct, width = 20) {
+  const filled = Math.round((pct / 100) * width);
+  return '\u2501'.repeat(filled) + '\u2500'.repeat(width - filled) + ` ${pct}%`;
+}
+
+export function scoreEmoji(score, max = 10) {
+  const pct = (score / max) * 100;
+  if (pct >= 80) return '\uD83D\uDD25';
+  if (pct >= 60) return '\u2728';
+  if (pct >= 40) return '\u26A0\uFE0F';
+  return '\u274C';
+}
+
+export function replyTypeEmoji(type) {
+  const map = {
+    positive: '\u2705 Positive',
+    meeting_request: '\uD83D\uDD25 Meeting request',
+    ooo: '\u23F8\uFE0F OOO',
+    not_interested: '\u274C Not interested',
+    question: '\u2753 Question',
+    forward: '\u27A1\uFE0F Forward',
+    bounce: '\u26D4 Bounce',
+    auto_reply: '\uD83E\uDD16 Auto-reply',
+  };
+  return map[type] || type;
+}
+
+export function signalEmoji(type) {
+  const map = {
+    intent: '\uD83D\uDD25',
+    hiring: '\uD83D\uDCC8',
+    leadership_change: '\uD83D\uDC64',
+    funding: '\uD83D\uDCB0',
+    expansion: '\uD83C\uDF1F',
+    tech_stack: '\uD83D\uDD27',
+    news: '\uD83D\uDCF0',
+    competitor: '\u2694\uFE0F',
+  };
+  return map[type] || '\uD83D\uDCA1';
+}
+
+export function daysAgoLabel(dateStr) {
+  if (!dateStr) return '\u2014';
+  const days = Math.floor((Date.now() - new Date(dateStr).getTime()) / 86400000);
+  if (days === 0) return 'Today';
+  if (days === 1) return '1d ago';
+  return `${days}d ago`;
+}
+
+export function formatDate(dateStr) {
+  if (!dateStr) return '\u2014';
+  return new Date(dateStr).toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+}
+
+export function daysSince(dateStr) {
+  if (!dateStr) return null;
+  return Math.floor((Date.now() - new Date(dateStr).getTime()) / 86400000);
+}
+
+export function table(headers, rows) {
+  const hdr = `| ${headers.join(' | ')} |`;
+  const sep = `|${headers.map(() => '------').join('|')}|`;
+  const body = rows.map(r => `| ${r.join(' | ')} |`).join('\n');
+  return `${hdr}\n${sep}\n${body}`;
+}
+
+export function section(title, content) {
+  return `### ${title}\n${content}`;
+}
+
+export function formatFirmographicValue(metric, options = {}) {
+  if (metric === null || metric === undefined || metric === '') return '\u2014';
+  if (typeof metric !== 'object') {
+    return options.currency && typeof metric === 'number'
+      ? formatCurrency(metric, options.currency)
+      : String(metric);
+  }
+  const value = metric?.value ?? null;
+  const range = metric?.range ?? null;
+  const displayValue = value !== null && value !== undefined
+    ? options.currency ? formatCurrency(value, options.currency) : String(value)
+    : range || '\u2014';
+  const status = metric?.status || 'unknown';
+  const confidence = typeof metric?.confidence === 'number'
+    ? `${Math.round(metric.confidence * 100)}%`
+    : '\u2014';
+  const source = formatFirmographicSource(metric?.source);
+  return `${displayValue} (${status}, confidence ${confidence}, source ${source})`;
+}
+
+export function formatCompanyFirmographics(snapshot) {
+  const data = snapshot?.data || snapshot || {};
+  let md = `## ${data.name || 'Company'} \u2014 Firmographics\n\n`;
+  md += section('Employee Count', '');
+  md += `- **Value:** ${formatFirmographicValue(data.employeeCount)}\n`;
+  md += firmographicMetadataLines(data.employeeCount);
+  md += '\n';
+  md += section('Revenue', '');
+  md += `- **Value:** ${formatFirmographicValue(data.revenue, { currency: data.revenue?.currency || 'USD' })}\n`;
+  if (data.revenue?.metric) md += `- **Metric:** ${data.revenue.metric}\n`;
+  md += firmographicMetadataLines(data.revenue);
+  if (Array.isArray(data.revenue?.assumptions) && data.revenue.assumptions.length) {
+    md += `- **Assumptions:** ${data.revenue.assumptions.join('; ')}\n`;
+  }
+  if (Array.isArray(data.missing) && data.missing.length) {
+    md += `\n${section('Missing', data.missing.map(item => `- ${item}`).join('\n') + '\n')}`;
+  }
+  return md;
+}
+
+function firmographicMetadataLines(metric) {
+  let md = '';
+  if (metric?.refreshedAt || metric?.observedAt) {
+    md += `- **Freshness:** ${metric.refreshedAt || metric.observedAt}\n`;
+  }
+  if (Array.isArray(metric?.evidenceUrls) && metric.evidenceUrls.length) {
+    md += `- **Evidence:** ${metric.evidenceUrls.slice(0, 3).join(', ')}\n`;
+  }
+  return md;
+}
+
+function formatFirmographicSource(source) {
+  if (!source) return '\u2014';
+  if (typeof source === 'string') return source;
+  return source.provider || source.name || source.type || 'source metadata';
+}
+
+function formatCurrency(value, currency) {
+  if (typeof value !== 'number' || !Number.isFinite(value)) return String(value);
+  return new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency,
+    maximumFractionDigits: 0,
+  }).format(value);
+}
+
+// ---------------------------------------------------------------------------
+// Composite formatters
+// ---------------------------------------------------------------------------
+
+export function formatQualification(company, icpScore, signals, authority) {
+  const score = icpScore?.score ?? icpScore?.totalScore ?? 0;
+  const signalsList = (signals?.data || signals || []).slice(0, 8);
+  const authorityData = authority?.data || authority || {};
+
+  let md = `## ${company.name || 'Company'} \u2014 ICP Score: ${score}/100\n`;
+  md += progressBar(score) + '\n\n';
+
+  // Signals table
+  const signalRows = signalsList.map(s => [
+    signalEmoji(s.type) + ' ' + (s.type || 'Signal'),
+    String(s.score ?? s.strength ?? '\u2014'),
+    s.detail || s.description || s.summary || '\u2014',
+  ]);
+
+  if (signalRows.length > 0) {
+    md += table(['Signal', 'Score', 'Detail'], signalRows) + '\n\n';
+  }
+
+  // Authority
+  if (authorityData.champion || authorityData.stakeholders) {
+    md += section('Deal Authority', '');
+    if (authorityData.champion) md += `- **Champion:** ${authorityData.champion}\n`;
+    if (authorityData.decisionMaker) md += `- **Decision Maker:** ${authorityData.decisionMaker}\n`;
+    if (authorityData.stakeholders?.length) {
+      md += `- **Stakeholders:** ${authorityData.stakeholders.length} identified\n`;
+    }
+    md += '\n';
+  }
+
+  // Coaching narrative
+  md += section('Your Move', '');
+  if (signalsList.length > 0) {
+    const topSignal = signalsList[0];
+    md += `${topSignal.detail || topSignal.description || 'Recent activity detected'}. `;
+  }
+  md += 'Focus on the strongest signal and open with a question that shows you\'ve done your homework.\n';
+
+  return md;
+}
+
+export function formatCompanyResearch(company, enrichment, signals, competitors) {
+  const c = company || {};
+  let md = `## ${c.name || 'Company'} \u2014 Research Report\n\n`;
+
+  // Overview
+  md += section('Overview', '');
+  md += `- **Industry:** ${c.industry || '\u2014'}\n`;
+  md += `- **Size:** ${formatFirmographicValue(c.firmographics?.employeeCount || c.employeeCount)} employees\n`;
+  md += `- **Revenue:** ${formatFirmographicValue(c.firmographics?.revenue || c.annualRevenue || c.revenue, { currency: c.currency || 'USD' })}\n`;
+  md += `- **Website:** ${c.website || c.domain || '\u2014'}\n`;
+  md += `- **Status:** ${c.status || '\u2014'}\n\n`;
+
+  // Enrichment data
+  const enr = enrichment?.data || enrichment || {};
+  if (enr.techStack || enr.technologies) {
+    md += section('Tech Stack', (enr.techStack || enr.technologies || []).join(', ') + '\n\n');
+  }
+  if (enr.funding || enr.totalFunding) {
+    md += section('Funding', `${enr.funding || enr.totalFunding}\n\n`);
+  }
+  if (enr.news?.length) {
+    md += section('Recent News', enr.news.slice(0, 5).map(n => `- ${n.title || n}`).join('\n') + '\n\n');
+  }
+
+  // Competitors
+  const comps = (competitors?.data || competitors || []).slice(0, 5);
+  if (comps.length > 0) {
+    md += section('Competitors', comps.map(c => `- ${c.name || c}`).join('\n') + '\n\n');
+  }
+
+  // Signals
+  const sigs = (signals?.data || signals || []).slice(0, 5);
+  if (sigs.length > 0) {
+    md += section('Intent Signals', sigs.map(s =>
+      `- ${signalEmoji(s.type)} ${s.detail || s.description || s.type} (${formatDate(s.date || s.createdAt)})`
+    ).join('\n') + '\n\n');
+  }
+
+  return md;
+}
+
+export function formatPersonResearch(person, enrichment, actions) {
+  const p = person || {};
+  let md = `## ${p.name || p.firstName + ' ' + p.lastName || 'Person'}\n\n`;
+
+  md += section('Profile', '');
+  md += `- **Title:** ${p.title || p.currentRole || '\u2014'}\n`;
+  md += `- **Company:** ${p.companyName || '\u2014'}\n`;
+  md += `- **Email:** ${p.email || '\u2014'}\n`;
+  md += `- **Phone:** ${p.phone || '\u2014'}\n`;
+  md += `- **LinkedIn:** ${p.linkedinUrl || '\u2014'}\n`;
+  md += `- **Department:** ${p.department || '\u2014'}\n`;
+  md += `- **Seniority:** ${p.seniority || '\u2014'}\n\n`;
+
+  // Enrichment
+  const enr = enrichment?.data || enrichment || {};
+  if (enr.background || enr.bio) {
+    md += section('Background', (enr.background || enr.bio) + '\n\n');
+  }
+  if (enr.expertise?.length) {
+    md += section('Expertise', enr.expertise.join(', ') + '\n\n');
+  }
+
+  // Recent actions
+  const acts = (actions?.data || actions || []).slice(0, 5);
+  if (acts.length > 0) {
+    md += section('Recent Activity', '');
+    md += acts.map(a => `- ${formatDate(a.createdAt)} \u2014 ${a.type}: ${a.title} ${a.outcome ? '(' + a.outcome + ')' : ''}`).join('\n');
+    md += '\n\n';
+  }
+
+  return md;
+}
+
+export function formatSpeedrunList(items) {
+  const list = (items?.data || items || []).slice(0, 25);
+  if (list.length === 0) return '## Priority Pursuits\n\nNo priority pursuits are ready today. Check back tomorrow or add target accounts.\n';
+
+  let md = `## Today's Priority Pursuits \u2014 ${list.length} Priorities\n\n`;
+  const rows = list.map((item, i) => [
+    String(i + 1),
+    item.personName || item.name || '\u2014',
+    item.companyName || '\u2014',
+    String(item.score || item.rank || '\u2014'),
+    item.reason || item.signal || '\u2014',
+    item.nextAction || '\u2014',
+  ]);
+  md += table(['#', 'Person', 'Company', 'Score', 'Why Now', 'Next Move'], rows);
+  return md;
+}
+
+export function formatNextContacts(contacts, overdueCount, promisesCount) {
+  const list = (contacts?.data || contacts || []).slice(0, 10);
+  if (list.length === 0) return '## Next Contacts\n\nNo contacts queued. Use discover_prospects to find new leads.\n';
+
+  let md = `## Your Next ${list.length} Contacts\n\n`;
+  const rows = list.map((c, i) => [
+    String(i + 1),
+    c.name || c.personName || '\u2014',
+    c.companyName || '\u2014',
+    c.signal ? signalEmoji(c.signalType) + ' ' + c.signal : '\u2014',
+    c.lastAction ? `${c.lastActionType || 'Touch'} ${formatDate(c.lastActionDate)}` : '\u2014',
+    c.daysSinceTouch != null ? `${c.daysSinceTouch}d` : '\u2014',
+    c.nextAction || '\u2014',
+  ]);
+  md += table(['#', 'Person', 'Company', 'Signal', 'Last Touch', 'Days', 'Next Move'], rows);
+
+  const notes = [];
+  if (overdueCount) notes.push(`${overdueCount} overdue`);
+  if (promisesCount) notes.push(`${promisesCount} promises unfulfilled`);
+  if (notes.length > 0) md += `\n\n${notes.join('. ')}.`;
+
+  return md;
+}
+
+export function formatInbox(replies) {
+  const list = (replies?.data || replies || []).slice(0, 15);
+  if (list.length === 0) return '## Inbox\n\nNo new replies. Your sequences are running \u2014 check back later.\n';
+
+  let md = `## ${list.length} New Replies\n\n`;
+  const rows = list.map(r => [
+    r.from || r.sender || '\u2014',
+    r.company || r.companyName || '\u2014',
+    r.subject || '\u2014',
+    replyTypeEmoji(r.replyType || r.type || 'unknown'),
+    r.suggestedAction || r.action || '\u2014',
+  ]);
+  md += table(['From', 'Company', 'Subject', 'Type', 'Action'], rows);
+
+  // Highlight actionable items
+  const actionable = list.filter(r => ['positive', 'meeting_request'].includes(r.replyType || r.type));
+  if (actionable.length > 0) {
+    md += '\n\n';
+    actionable.forEach(r => {
+      md += `**${r.from || r.sender}** \u2014 ${r.suggestedAction || 'Follow up'}.\n`;
+    });
+  }
+
+  return md;
+}
+
+export function formatCompetitiveIntel(company, competitors) {
+  const c = company || {};
+  const comps = (competitors?.data || competitors || []).slice(0, 5);
+  let md = `## Competitive Intel \u2014 ${c.name || 'Target'}\n\n`;
+
+  if (comps.length === 0) {
+    md += 'No competitive data available yet. Run enrichment to gather intel.\n';
+    return md;
+  }
+
+  comps.forEach(comp => {
+    md += `### vs. ${comp.name || comp.competitor || 'Competitor'}\n`;
+    if (comp.strengths) md += `- **Their strengths:** ${comp.strengths}\n`;
+    if (comp.weaknesses) md += `- **Their weaknesses:** ${comp.weaknesses}\n`;
+    if (comp.positioning) md += `- **Our positioning:** ${comp.positioning}\n`;
+    if (comp.recentMoves) md += `- **Recent moves:** ${comp.recentMoves}\n`;
+    md += '\n';
+  });
+
+  return md;
+}
+
+export function formatMeetingBrief(meeting, attendees, companyIntel) {
+  const m = meeting || {};
+  let md = `## Meeting Brief \u2014 ${m.title || m.subject || 'Upcoming Meeting'}\n`;
+  md += `**When:** ${formatDate(m.startTime || m.date)} | **Duration:** ${m.duration || '\u2014'}\n\n`;
+
+  // Attendees
+  const atts = (attendees || []).slice(0, 10);
+  if (atts.length > 0) {
+    md += section('Attendees', '');
+    atts.forEach(a => {
+      md += `- **${a.name || a.email}** \u2014 ${a.title || '\u2014'} at ${a.companyName || '\u2014'}`;
+      if (a.engagementScore) md += ` (engagement: ${a.engagementScore})`;
+      md += '\n';
+    });
+    md += '\n';
+  }
+
+  // Company intel
+  if (companyIntel) {
+    md += section('Company Context', '');
+    md += `- **Industry:** ${companyIntel.industry || '\u2014'}\n`;
+    md += `- **Size:** ${companyIntel.employeeCount || '\u2014'}\n`;
+    if (companyIntel.recentSignals?.length) {
+      md += '- **Recent signals:** ' + companyIntel.recentSignals.slice(0, 3).map(s => s.summary || s.detail || s.type).join('; ') + '\n';
+    }
+    md += '\n';
+  }
+
+  md += section('Talking Points', '');
+  md += '1. Open with a question about their current priorities\n';
+  md += '2. Reference any recent signals or news\n';
+  md += '3. Align your solution to their stated pain points\n';
+
+  return md;
+}
+
+export function formatDealCoaching(opportunity, analysis) {
+  const o = opportunity || {};
+  const a = analysis || {};
+  let md = `## Deal Coaching \u2014 ${o.name || 'Deal'}\n`;
+  md += `**Stage:** ${o.stage || '\u2014'} | **Amount:** $${(o.amount || 0).toLocaleString()} | **Close:** ${formatDate(o.closeDate || o.expectedCloseDate)}\n\n`;
+
+  // MEDDPIC
+  const meddpic = a.meddpic || {};
+  const dimensions = [
+    ['Metrics', meddpic.metrics],
+    ['Economic Buyer', meddpic.economicBuyer],
+    ['Decision Criteria', meddpic.decisionCriteria],
+    ['Decision Process', meddpic.decisionProcess],
+    ['Identify Pain', meddpic.identifyPain],
+    ['Champion', meddpic.champion],
+  ];
+
+  if (Object.keys(meddpic).length > 0) {
+    md += section('MEDDPIC Analysis', '');
+    const rows = dimensions.map(([dim, val]) => {
+      const score = val?.score ?? '\u2014';
+      const detail = val?.detail || val?.notes || val || '\u2014';
+      return [dim, String(score), String(detail)];
+    });
+    md += table(['Dimension', 'Score', 'Status'], rows) + '\n\n';
+  }
+
+  // Risks
+  if (a.risks?.length) {
+    md += section('Risks', a.risks.map(r => `- \u26A0\uFE0F ${r}`).join('\n') + '\n\n');
+  }
+
+  // Next move
+  md += section('Recommended Next Move', a.nextAction || a.recommendation || 'Advance to next stage by confirming decision criteria with the economic buyer.\n');
+
+  return md;
+}
+
+export function formatForecast(data) {
+  const f = data?.data || data || {};
+  let md = '## Pipeline Forecast\n\n';
+
+  if (f.totalPipeline != null) md += `- **Total Pipeline:** $${(f.totalPipeline || 0).toLocaleString()}\n`;
+  if (f.weightedPipeline != null) md += `- **Weighted:** $${(f.weightedPipeline || 0).toLocaleString()}\n`;
+  if (f.commit != null) md += `- **Commit:** $${(f.commit || 0).toLocaleString()}\n`;
+  if (f.bestCase != null) md += `- **Best Case:** $${(f.bestCase || 0).toLocaleString()}\n`;
+  if (f.closedWon != null) md += `- **Closed Won:** $${(f.closedWon || 0).toLocaleString()}\n`;
+  md += '\n';
+
+  // Stage breakdown
+  const stages = f.stageBreakdown || f.stages || [];
+  if (stages.length > 0) {
+    const rows = stages.map(s => [
+      s.stage || s.name,
+      String(s.count || 0),
+      `$${(s.amount || 0).toLocaleString()}`,
+      s.winRate != null ? `${s.winRate}%` : '\u2014',
+    ]);
+    md += table(['Stage', 'Deals', 'Amount', 'Win Rate'], rows) + '\n\n';
+  }
+
+  // At-risk deals
+  if (f.atRisk?.length) {
+    md += section('At-Risk Deals', '');
+    f.atRisk.forEach(d => {
+      md += `- \u26A0\uFE0F **${d.name}** \u2014 $${(d.amount || 0).toLocaleString()} \u2014 ${d.reason || 'Stalled'}\n`;
+    });
+    md += '\n';
+  }
+
+  return md;
+}
+
+export function formatSignalsDashboard(signals) {
+  const list = (signals?.data || signals || []).slice(0, 20);
+  if (list.length === 0) return '## Signals Dashboard\n\nNo active signals. Enable enrichment to start tracking intent.\n';
+
+  let md = `## Signals Dashboard \u2014 ${list.length} Active Signals\n\n`;
+
+  // Group by urgency/type
+  const grouped = {};
+  list.forEach(s => {
+    const key = s.urgency || s.type || 'other';
+    if (!grouped[key]) grouped[key] = [];
+    grouped[key].push(s);
+  });
+
+  Object.entries(grouped).forEach(([key, sigs]) => {
+    md += `### ${key.charAt(0).toUpperCase() + key.slice(1)} (${sigs.length})\n`;
+    sigs.forEach(s => {
+      md += `- ${signalEmoji(s.type)} **${s.companyName || '\u2014'}** \u2014 ${s.detail || s.description || s.type} (${formatDate(s.date || s.createdAt)})\n`;
+    });
+    md += '\n';
+  });
+
+  return md;
+}
+
+export function formatSequence(sequence) {
+  const s = sequence?.data || sequence || {};
+  let md = `## Sequence Created: "${s.name || 'New Sequence'}"\n\n`;
+
+  const steps = s.steps || [];
+  if (steps.length > 0) {
+    const rows = steps.map((step, i) => [
+      String(i + 1),
+      step.type || 'Email',
+      step.delay ? `${step.delay} days` : '\u2014',
+      step.subject || step.description || '\u2014',
+    ]);
+    md += table(['Step', 'Type', 'Delay', 'Subject'], rows) + '\n\n';
+  }
+
+  if (s.optimization) md += `Bandit optimization: ${s.optimization}\n`;
+  if (s.businessHours) md += `Business hours: ${s.businessHours}\n`;
+  md += 'Ready to enroll contacts.\n';
+
+  return md;
+}
+
+export function formatOutreachAnalytics(data) {
+  const d = data?.data || data || {};
+  let md = '## Outreach Analytics\n\n';
+
+  if (d.totalSent != null) md += `- **Sent:** ${d.totalSent}\n`;
+  if (d.openRate != null) md += `- **Open Rate:** ${d.openRate}%\n`;
+  if (d.replyRate != null) md += `- **Reply Rate:** ${d.replyRate}%\n`;
+  if (d.bounceRate != null) md += `- **Bounce Rate:** ${d.bounceRate}%\n`;
+  md += '\n';
+
+  // Per-sequence breakdown
+  const seqs = d.sequences || d.breakdown || [];
+  if (seqs.length > 0) {
+    const rows = seqs.map(s => [
+      s.name || '\u2014',
+      String(s.sent || 0),
+      `${s.openRate || 0}%`,
+      `${s.replyRate || 0}%`,
+      `${s.bounceRate || 0}%`,
+    ]);
+    md += table(['Sequence', 'Sent', 'Opens', 'Replies', 'Bounces'], rows) + '\n';
+  }
+
+  return md;
+}
+
+export function formatEntityTimeline(entity, actions) {
+  const e = entity || {};
+  const acts = (actions?.data || actions || []).slice(0, 25);
+  let md = `## Timeline \u2014 ${e.name || 'Entity'}\n\n`;
+
+  if (acts.length === 0) {
+    md += 'No activity recorded yet.\n';
+    return md;
+  }
+
+  acts.forEach(a => {
+    const icon = a.type === 'email' ? '\u2709\uFE0F' : a.type === 'call' ? '\uD83D\uDCDE' : a.type === 'meeting' ? '\uD83D\uDCC5' : '\uD83D\uDCDD';
+    md += `${icon} **${formatDate(a.createdAt)}** \u2014 ${a.title || a.type}`;
+    if (a.outcome) md += ` (${a.outcome})`;
+    md += '\n';
+  });
+
+  return md;
+}
+
+export function formatDeliverability(data) {
+  const d = data?.data || data || {};
+  let md = '## Deliverability Report\n\n';
+
+  if (d.domainHealth != null) {
+    md += `**Domain Health:** ${d.domainHealth}/100\n`;
+    md += progressBar(d.domainHealth) + '\n\n';
+  }
+
+  if (d.spf) md += `- **SPF:** ${d.spf}\n`;
+  if (d.dkim) md += `- **DKIM:** ${d.dkim}\n`;
+  if (d.dmarc) md += `- **DMARC:** ${d.dmarc}\n`;
+  if (d.blacklisted != null) md += `- **Blacklisted:** ${d.blacklisted ? 'YES \u26A0\uFE0F' : 'No \u2705'}\n`;
+  if (d.inboxPlacement != null) md += `- **Inbox Placement:** ${d.inboxPlacement}%\n`;
+
+  return md;
+}
+
+// ---------------------------------------------------------------------------
+// Generic wrapper: any composite tool can use this to return markdown
+// ---------------------------------------------------------------------------
+
+export function md(text) {
+  return { content: [{ type: 'text', text }] };
+}
+
+export function mdError(message, hint) {
+  let text = `## Error\n\n${message}`;
+  if (hint) text += `\n\n**Hint:** ${hint}`;
+  return { content: [{ type: 'text', text }] };
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@adrata/adrata-mcp",
+  "version": "1.0.0",
+  "description": "Adrata MCP Server — connect Claude Code, Codex, Gemini, Cursor, and other AI tools to your CRM. 80+ tools for companies, people, deals, actions, buyer groups, warm intros, webhooks, intelligence, and more.",
+  "type": "module",
+  "main": "server.js",
+  "bin": {
+    "adrata-mcp": "./server.js"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "test": "node --test server.test.js api-bridge.test.js buyer-group-writes.test.js note-writes.test.js mcp-spec.test.js packaging.test.js security.test.js toolsets.test.js access/auth.test.js access/oauth-callback.test.js access/oauth-session.test.js access/oauth-capabilities.test.js tools/email-tools.test.js tools/scheduling.test.js tools/work-board-tools.test.js governance/money.test.js"
+  },
+  "keywords": [
+    "mcp",
+    "adrata",
+    "crm",
+    "claude",
+    "ai",
+    "sales",
+    "model-context-protocol",
+    "claude-code",
+    "codex",
+    "gemini",
+    "cursor",
+    "windsurf"
+  ],
+  "license": "UNLICENSED",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/adratagit/speedrun"
+  },
+  "homepage": "https://adrata.com",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "server.js",
+    "api-bridge.js",
+    "analytics.js",
+    "security.js",
+    "transport-http.js",
+    "resources.js",
+    "tool-annotations.js",
+    "output-formatter.js",
+    "access/",
+    "tools/",
+    "governance/",
+    "toolsets/",
+    "skills/",
+    "server.json",
+    "README.md",
+    "!**/*.test.js"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^4.4.3"
+  },
+  "overrides": {
+    "@hono/node-server": "2.0.12",
+    "fast-uri": "3.1.4",
+    "hono": "4.12.27"
+  }
+}