Add builder intelligence to your product in one call.

const HEY = 'https://heyresearch.xyz';

// Returns a sendMessage payload, or null to stay quiet.
async function heyTelegramReply(token) {
  const r = await fetch(`${HEY}/api/v1/builder?chain=4663&token=${token}`, {
    headers: { 'x-hey-integration': 'my-telegram-bot/1.0.0' },
  });
  if (!r.ok) return null; // 404: HEY has no page · 400: not a token · 429/5xx: stay quiet
  const c = await r.json();

  const lines = [c.hey_project_name];
  if (!c.activity_applies_to_token) {
    lines.push("The project's own site names another contract. HEY's research is about the project, not this token.");
    return { text: lines.join('\n') };
  }
  lines.push('Builder: ' + c.hey_status_label + (c.verified_builder ? ' · Verified builder' : ''));
  if (c.latest_meaningful_ship) lines.push('Latest: ' + c.latest_meaningful_ship.title + ' · ' + ago(c.latest_meaningful_ship.timestamp));
  if (c.meaningful_ships_30d !== null) lines.push('30d: ' + c.meaningful_ships_30d + ' meaningful ships');
  return {
    text: lines.join('\n'),
    reply_markup: { inline_keyboard: [[{ text: 'Evidence on HEY', url: c.project_link }]] },
  };
}

function ago(iso) {
  const h = Math.floor((Date.now() - Date.parse(iso)) / 3600000);
  return h < 24 ? h + 'h ago' : Math.floor(h / 24) + 'd ago';
}

const HEY = 'https://heyresearch.xyz';

// Returns a Discord embed, or null to stay quiet.
async function heyDiscordEmbed(token) {
  const r = await fetch(`${HEY}/api/v1/builder?chain=4663&token=${token}`, {
    headers: { 'x-hey-integration': 'my-discord-bot/1.0.0' },
  });
  if (!r.ok) return null;
  const c = await r.json();
  if (!c.activity_applies_to_token) return null; // the activity is the project's, not this token's

  const fields = [{ name: 'Builder', value: c.hey_status_label + (c.verified_builder ? ' · Verified builder' : ''), inline: true }];
  if (c.meaningful_ships_30d !== null) fields.push({ name: 'Meaningful ships, 30d', value: String(c.meaningful_ships_30d), inline: true });
  if (c.latest_meaningful_ship) fields.push({ name: 'Latest ship', value: c.latest_meaningful_ship.title.slice(0, 200) });
  if (c.latest_change) fields.push({ name: 'Latest change', value: c.latest_change.summary.slice(0, 200) });
  return {
    title: c.hey_project_name,
    url: c.project_link,
    description: c.hey_status_help,
    fields,
    footer: { text: 'Builder intelligence by HEY Research Lab. Not a rating.' },
    timestamp: c.as_of ?? undefined,
  };
}

const HEY = 'https://heyresearch.xyz';

// A side panel beside the chart: the builder half of the picture.
async function heyBuilderPanel(token) {
  const r = await fetch(`${HEY}/api/v1/builder?chain=4663&token=${token}`, {
    headers: { 'x-hey-integration': 'my-terminal/2.3.0' },
  });
  if (r.status === 404) return { state: 'not_indexed', href: (await r.json()).scan_url };
  if (!r.ok) return null;
  const c = await r.json();
  return {
    state: c.activity_applies_to_token ? 'ok' : 'other_contract',
    status: c.hey_status_label,           // HEY's word, never your own
    measured: c.activity_measured,        // false: "not measured yet", not "inactive"
    verified: c.verified_builder,
    latest: c.latest_meaningful_ship,     // null when HEY holds none
    ships30d: c.meaningful_ships_30d,     // null is unknown, never render it as 0
    change: c.latest_change_state === 'recorded' ? c.latest_change : null,
    asOf: c.as_of,
    href: c.activity_applies_to_token ? c.project_link : null,
  };
}

const HEY = 'https://heyresearch.xyz';

// One row on a swap page's token details. Titles come from projects: escape them.
async function heyDexRow(token) {
  const r = await fetch(`${HEY}/api/v1/builder?chain=4663&token=${token}`, {
    headers: { 'x-hey-integration': 'my-dex/1.0.0' },
  });
  if (!r.ok) return '';
  const c = await r.json();
  if (!c.activity_applies_to_token) return '';
  const parts = [esc(c.hey_status_label)];
  if (c.meaningful_ships_30d !== null) parts.push(c.meaningful_ships_30d + ' ships / 30d');
  if (c.latest_meaningful_ship) parts.push('latest: ' + esc(c.latest_meaningful_ship.title));
  return '<div class="hey-row">Builder · ' + parts.join(' · ') +
    ' <a href="' + esc(c.project_link) + '" target="_blank" rel="noopener">Evidence ↗</a></div>';
}

function esc(s) {
  return String(s).replace(/[&<>"']/g, (ch) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[ch]);
}

const HEY = 'https://heyresearch.xyz';

// Under a launch: whether HEY has found a builder behind it yet.
async function heyLaunchBadge(token) {
  const r = await fetch(`${HEY}/api/v1/builder?chain=4663&token=${token}`, {
    headers: { 'x-hey-integration': 'my-launchpad/1.0.0' },
  });
  if (r.status === 404) return { label: 'No HEY research yet', href: (await r.json()).scan_url, image: null };
  if (!r.ok) return null;
  const c = await r.json();
  if (!c.activity_applies_to_token) return null;
  return {
    label: c.verified_builder ? 'Verified builder on HEY' : 'Researched on HEY: ' + c.hey_status_label,
    href: c.project_link,
    image: c.badge_url, // an SVG with the name, status and last ship
  };
}

const HEY = 'https://heyresearch.xyz';

// One line under a contract's address on an explorer page.
async function heyExplorerLine(token) {
  const r = await fetch(`${HEY}/api/v1/builder?chain=4663&token=${token}`, {
    headers: { 'x-hey-integration': 'my-explorer/1.0.0' },
  });
  if (!r.ok) return null;
  const c = await r.json();
  const verification = { VERIFIED: 'named by the project', UNVERIFIED: 'not yet named by the project', MISMATCH: 'the project names another contract' };
  let text = 'HEY: ' + verification[c.token_verification];
  if (c.activity_applies_to_token) {
    text += ' · builder ' + c.hey_status_label.toLowerCase();
    if (c.latest_meaningful_ship) text += ' · last ship ' + c.latest_meaningful_ship.timestamp.slice(0, 10);
  }
  return { text, href: c.activity_applies_to_token ? c.project_link : null };
}

const HEY = 'https://heyresearch.xyz';

// A page of up to 30 tokens in one keyed call (the scan card's bulk form).
async function heyDirectoryRows(tokens, apiKey) {
  const r = await fetch(`${HEY}/api/v1/scan?chain=4663&tokens=${tokens.join(',')}`, {
    headers: { authorization: 'Bearer ' + apiKey, 'x-hey-integration': 'my-directory/1.0.0' },
  });
  if (!r.ok) return [];
  const { items } = await r.json();
  return items.map((item) => {
    if (!item.found) return { token: item.input, label: null, href: null }; // not indexed: print nothing
    return {
      token: item.input,
      label: item.status_label + (item.verified_builder ? ' · Verified builder' : ''),
      // Absent means unknown: only a measured count is a number.
      ships30d: item.activity.meaningful_ships_30d ?? null,
      href: item.activity_applies_to_token ? item.project_link : null,
    };
  });
}

const HEY = 'https://heyresearch.xyz';

// A tool an agent can call. The answer restates HEY; it never adds a verdict.
const heyBuilderTool = {
  name: 'hey_builder_card',
  description: 'Who is building a Robinhood Chain token, what they shipped and HEY\'s evidence. Not a rating, not a price signal.',
  input_schema: { type: 'object', properties: { token: { type: 'string', pattern: '^0x[0-9a-fA-F]{40}$' } }, required: ['token'] },
};

async function heyBuilderToolCall({ token }) {
  const r = await fetch(`${HEY}/api/v1/builder?chain=4663&token=${token}`, {
    headers: { 'x-hey-integration': 'my-agent/0.1.0' },
  });
  if (r.status === 404) return 'HEY has not published a project for this contract. That says nothing about the token.';
  if (!r.ok) return 'HEY did not answer; say nothing about the builder.';
  const c = await r.json();
  const facts = [
    'Project: ' + c.hey_project_name + ' (' + c.hey_project_url + ')',
    'Token named by the project: ' + c.token_verification + (c.activity_applies_to_token ? '' : ' - do not attribute the activity to this token'),
    'Builder status: ' + c.hey_status_label + (c.activity_measured ? '' : ' (building not measured)'),
    'Verified builder: ' + (c.verified_builder ? 'yes' : 'no'),
    'Meaningful ships, 30d: ' + (c.meaningful_ships_30d === null ? 'unknown' : c.meaningful_ships_30d),
  ];
  if (c.latest_meaningful_ship) facts.push('Latest ship: ' + c.latest_meaningful_ship.title + ' at ' + c.latest_meaningful_ship.timestamp + ' [' + c.latest_meaningful_ship.evidence_id + ']');
  if (c.latest_change) facts.push('Latest change: ' + c.latest_change.summary + (c.latest_change.evidence_id ? ' [' + c.latest_change.evidence_id + ']' : ''));
  facts.push('Scored: ' + (c.as_of ?? 'never'), 'Cite: ' + c.project_link, c.disclaimer);
  return facts.join('\n');
}