Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

13.7 KB
Raw Blame
/**
 * SSR entry-point for discover detail pages
 * -----------------------------------------
 * GET /api/discover-detail?kind=onchain&chain=<id>&id=<agentId>
 * GET /api/discover-detail?kind=avatar&id=<avatarId>
 * GET /api/discover-detail?kind=solana&asset=<asset_or_registry_ref>
 *
 * Wired to /discover/a/:chainId/:agentId, /discover/a/sol/:asset and
 * /discover/avatar/:id via vercel.json.
 *
 * Returns the detail.html shell with Open Graph + Twitter Card meta tags already
 * baked into the <head>, so link unfurlers (Slack, Discord, X, iMessage) get a
 * real preview. Browsers receive the same HTML; the inline __DETAIL_ITEM__ data
 * lets detail.js render without a second API round-trip.
 */

import { sql } from './_lib/db.js';
import { cors, method, wrap } from './_lib/http.js';
import { CHAIN_BY_ID, tokenExplorerUrl, addressExplorerUrl } from './_lib/erc8004-chains.js';
import { publicUrl, thumbnailUrl } from './_lib/r2.js';
import { isErc8004AgentId, isUuid } from './_lib/validate.js';
import { env } from './_lib/env.js';
import { readEmbedGateByAsset } from './_lib/embed-gate.js';

export default wrap(async (req, res) => {
	if (cors(req, res, { methods: 'GET,OPTIONS' })) return;
	if (!method(req, res, ['GET'])) return;

	const url = new URL(req.url, 'http://x');
	const kind = url.searchParams.get('kind');
	const id = url.searchParams.get('id');
	const origin = env.APP_ORIGIN;

	let item = null;
	let canonicalUrl = origin;
	let ogImageUrl = `${origin}/og-image.png`;

	if (kind === 'onchain') {
		const chainId = parseInt(url.searchParams.get('chain') || '', 10);
		// agent_id is TEXT holding a uint256 token id, so the raw digit string is
		// the only correct comparand: parseInt() rounds anything past 2^53 into
		// exponent notation and silently matches no row, which reads as "this agent
		// has no preview" rather than as the bug it is.
		if (!Number.isFinite(chainId) || !isErc8004AgentId(id)) return sendShell(res, origin, null, null, null);

		const rows = await sql`
			SELECT chain_id, agent_id, owner, name, description, image, glb_url,
			       has_3d, x402_support, registered_at, registered_tx,
			       services, agent_uri
			FROM erc8004_agents_index
			WHERE active = true AND chain_id = ${chainId} AND agent_id = ${id}
			LIMIT 1
		`.catch(() => []);

		if (rows.length) {
			const r = rows[0];
			const chain = CHAIN_BY_ID[r.chain_id];
			item = {
				kind: 'onchain',
				chainId: r.chain_id,
				chainName: chain?.name || `Chain ${r.chain_id}`,
				explorerBase: chain?.explorer || null,
				agentId: r.agent_id,
				owner: r.owner,
				ownerShort: shortAddr(r.owner),
				name: r.name || `Agent #${r.agent_id}`,
				description: r.description || '',
				image: r.image || null,
				glbUrl: r.glb_url || null,
				has3d: r.has_3d,
				x402Support: r.x402_support,
				registeredAt: r.registered_at,
				registeredTx: r.registered_tx || null,
				tokenExplorerUrl: tokenExplorerUrl(r.chain_id, r.agent_id),
				ownerExplorerUrl: addressExplorerUrl(r.chain_id, r.owner),
				viewerUrl: r.glb_url ? `/app#model=${encodeURIComponent(r.glb_url)}` : null,
				services: (r.services || []).map((s) => ({
					name: s?.name || null,
					endpoint: s?.endpoint || null,
					version: s?.version || null,
				})),
			};
			canonicalUrl = `${origin}/discover/a/${chainId}/${id}`;
			ogImageUrl = `${origin}/api/a-og?chain=${chainId}&id=${encodeURIComponent(id)}`;
		}
	} else if (kind === 'solana') {
		const asset = url.searchParams.get('asset');
		if (!asset) return sendShell(res, origin, null, null, null);

		const rows = await sql`
			SELECT ai.id, ai.name, ai.description, ai.wallet_address, ai.skills,
			       ai.meta, ai.created_at,
			       a.thumbnail_key AS avatar_thumb
			FROM agent_identities ai
			LEFT JOIN avatars a ON a.id = ai.avatar_id AND a.deleted_at IS NULL
			WHERE ai.deleted_at IS NULL
			  AND ai.meta->>'chain_type' = 'solana'
			  AND ai.meta->>'sol_mint_address' = ${asset}
			LIMIT 1
		`.catch(() => []);

		if (rows.length) {
			const r = rows[0];
			const network = r.meta?.network || 'mainnet';
			const thumb = thumbnailUrl(r.avatar_thumb);
			item = {
				kind: 'solana',
				asset,
				name: r.name || 'Solana Agent',
				description: r.description || '',
				image: thumb,
				has3d: !!r.avatar_thumb,
				skills: r.skills || [],
				owner: r.wallet_address,
				ownerShort: shortAddr(r.wallet_address),
				createdAt: r.created_at,
				network,
				explorerUrl: `https://solscan.io/token/${asset}`,
				ownerExplorerUrl: r.wallet_address ? `https://solscan.io/account/${r.wallet_address}` : null,
			};
			canonicalUrl = `${origin}/discover/a/sol/${asset}`;
			ogImageUrl = thumb || `${origin}/og-image.png`;
		} else {
			// Not one of ours: fall back to the crawled directory of external Solana
			// agents, the same fallback api/explore-item.js does for the client fetch.
			// Without it the home chain's entire external directory (Metaplex Agent
			// Registry + AgenC) unfurls as a nameless generic card in Slack, Discord,
			// X and iMessage, and ships a generic <title> to crawlers, while the EVM
			// half of the very same /discover grid previews correctly.
			const ext = await sql`
				SELECT source, ref, owner, asset, name, description, image, glb_url,
				       network, registered_at
				FROM solana_agents_index
				WHERE active = true
				  AND (asset = ${asset} OR ref = ${asset})
				LIMIT 1
			`.catch(() => []);

			if (ext.length) {
				const r = ext[0];
				const target = r.asset || r.ref;
				const cluster = r.network === 'devnet' ? '?cluster=devnet' : '';
				item = {
					kind: 'solana',
					asset: target,
					name: r.name || 'Solana Agent',
					description: r.description || '',
					image: r.image || null,
					has3d: !!r.glb_url,
					glbUrl: r.glb_url || null,
					skills: [],
					owner: r.owner || null,
					ownerShort: shortAddr(r.owner),
					createdAt: r.registered_at,
					network: r.network || 'mainnet',
					source: r.source,
					viewerUrl: r.glb_url ? `/app#model=${encodeURIComponent(r.glb_url)}` : null,
					explorerUrl: target ? `https://solscan.io/token/${target}${cluster}` : null,
					ownerExplorerUrl: r.owner ? `https://solscan.io/account/${r.owner}${cluster}` : null,
				};
				canonicalUrl = `${origin}/discover/a/sol/${asset}`;
				ogImageUrl = r.image || `${origin}/og-image.png`;
			}
		}
	} else if (kind === 'avatar') {
		// avatars.id is a uuid column; a malformed id would otherwise reach Postgres
		// as a 22P02 that the .catch() below swallows into an unexplained blank shell.
		if (!isUuid(id)) return sendShell(res, origin, null, null, null);

		const rows = await sql`
			SELECT a.id, a.slug, a.name, a.description, a.storage_key, a.thumbnail_key,
			       a.tags, a.created_at, a.source,
			       coalesce(a.featured, false) AS featured,
			       coalesce(a.view_count, 0)   AS view_count,
			       u.username        AS owner_username,
			       u.display_name    AS owner_display_name,
			       u.wallet_address  AS owner_wallet
			FROM avatars a
			LEFT JOIN users u ON u.id = a.owner_id AND u.deleted_at IS NULL
			WHERE a.deleted_at IS NULL AND a.visibility = 'public' AND a.id = ${id}
			LIMIT 1
		`.catch(() => []);

		if (rows.length) {
			const r = rows[0];
			// A token-gated avatar keeps its model URL out of the page, matching
			// api/embed/resolve.js: the gate is only unlocked through gate-verify.
			const gated = !!(await readEmbedGateByAsset(`avatar:${r.id}`).catch(() => ({ gated: true })));
			const glb = gated ? null : publicUrl(r.storage_key);
			const handle = r.owner_username
				? `@${r.owner_username}`
				: r.owner_wallet
					? shortAddr(r.owner_wallet)
					: null;
			item = {
				kind: 'avatar',
				avatarId: r.id,
				slug: r.slug,
				name: r.name,
				description: r.description || '',
				image: thumbnailUrl(r.thumbnail_key),
				glbUrl: glb,
				has3d: !gated,
				gated,
				tags: r.tags || [],
				source: r.source || null,
				featured: r.featured === true || r.featured === 't',
				viewCount: Number(r.view_count) || 0,
				createdAt: r.created_at,
				viewerUrl: glb ? `/app#model=${encodeURIComponent(glb)}` : null,
				author: handle
					? {
						handle,
						displayName: r.owner_display_name || r.owner_username || handle,
						profileUrl: r.owner_username ? `/u/${r.owner_username}` : null,
					}
					: null,
			};
		}

		if (item) {
			canonicalUrl = `${origin}/avatars/${id}`;
			ogImageUrl = `${origin}/api/avatar/${id}/og`;
		}
	}

	return sendShell(res, origin, item, canonicalUrl, ogImageUrl);
});

function sendShell(res, origin, item, canonicalUrl, ogImageUrl) {
	const title = item ? `${item.name} · three.ws` : 'three.ws';
	const desc = item?.description || (item ? `${item.name} on three.ws` : 'Discover agents on three.ws');
	const canonical = canonicalUrl || `${origin}/discover`;
	const ogImg = ogImageUrl || `${origin}/og-image.png`;

	res.statusCode = 200;
	res.setHeader('content-type', 'text/html; charset=utf-8');
	res.setHeader('cache-control', item
		? 'public, max-age=60, s-maxage=300, stale-while-revalidate=3600'
		: 'public, max-age=10',
	);

	res.end(`<!doctype html>
<html lang="en">
<head>
	<meta charset="utf-8" />
	<meta http-equiv="X-UA-Compatible" content="IE=edge" />
	<title>${esc(title)}</title>
	<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
	<meta name="description" content="${esc(desc)}" />
	<meta name="theme-color" content="#000000" />

	<meta property="og:type" content="profile" />
	<meta property="og:site_name" content="three.ws" />
	<meta property="og:title" content="${esc(title)}" />
	<meta property="og:description" content="${esc(desc)}" />
	<meta property="og:url" content="${esc(canonical)}" />
	<meta property="og:image" content="${esc(ogImg)}" />
	<meta property="og:image:width" content="1200" />
	<meta property="og:image:height" content="630" />

	<meta name="twitter:card" content="summary_large_image" />
	<meta name="twitter:title" content="${esc(title)}" />
	<meta name="twitter:description" content="${esc(desc)}" />
	<meta name="twitter:image" content="${esc(ogImg)}" />

	<link rel="canonical" href="${esc(canonical)}" />
	<link rel="shortcut icon" href="/favicon.ico" />
	<link rel="preconnect" href="https://fonts.googleapis.com" />
	<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
	<link rel="stylesheet" href="/style.css" />
	<link rel="stylesheet" href="/nav.css" />
	<link rel="stylesheet" href="/discover/detail.css" />
	<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Space+Grotesk:wght@500;600;700&display=swap" rel="stylesheet" />
	${item ? `<script>window.__DETAIL_ITEM__ = ${JSON.stringify(item).replace(/</g, '\\u003c')};</script>` : ''}
</head>
<body class="features-page detail-page">
	<header>
		<div id="nav-container"></div>
	</header>
	<script src="/nav.js"></script>

	<main class="detail-main" data-role="main">
		<div class="detail-loading" data-role="loading">
			<div class="detail-skeleton detail-skeleton--hero"></div>
			<div class="detail-skeleton detail-skeleton--title"></div>
			<div class="detail-skeleton detail-skeleton--body"></div>
		</div>

		<div class="detail-error" data-role="error" hidden>
			<div class="detail-error-icon">⚠</div>
			<h2 data-role="error-title">Not found</h2>
			<p data-role="error-msg">This item could not be loaded.</p>
			<a href="/discover" class="detail-btn">← Back to Discover</a>
		</div>

		<div class="detail-content" data-role="content" hidden>
			<nav class="detail-breadcrumb">
				<a href="/discover" class="detail-breadcrumb-link" data-role="back-link">← Discover</a>
			</nav>

			<div class="detail-hero">
				<div class="detail-hero-media" data-role="hero-media"></div>
				<div class="detail-hero-body">
					<div class="detail-badges" data-role="badges"></div>
					<h1 class="detail-name" data-role="name"></h1>
					<p class="detail-desc" data-role="desc" hidden></p>
					<div class="detail-meta-row" data-role="meta-row"></div>
					<div class="detail-actions" data-role="actions"></div>
				</div>
			</div>

			<div class="detail-viewer-wrap" data-role="viewer-wrap" hidden>
				<div class="detail-section-label">3D Preview</div>
				<div class="detail-viewer" data-role="viewer"></div>
			</div>

			<div class="detail-panels">
				<div class="detail-panel" data-role="services-panel" hidden>
					<div class="detail-panel-head">
						<span class="detail-panel-title">Services</span>
						<span class="detail-panel-badge" data-role="service-count">0</span>
					</div>
					<ul class="detail-services" data-role="services"></ul>
				</div>

				<div class="detail-panel" data-role="tags-panel" hidden>
					<div class="detail-panel-head">
						<span class="detail-panel-title">Tags</span>
					</div>
					<div class="detail-tags" data-role="tags"></div>
				</div>

				<div class="detail-panel" data-role="onchain-panel" hidden>
					<div class="detail-panel-head">
						<span class="detail-panel-title">On-chain details</span>
					</div>
					<dl class="detail-dl" data-role="onchain-dl"></dl>
				</div>

				<div class="detail-panel" data-role="avatar-panel" hidden>
					<div class="detail-panel-head">
						<span class="detail-panel-title">Details</span>
					</div>
					<dl class="detail-dl" data-role="avatar-dl"></dl>
				</div>

				<div class="detail-panel" data-role="embed-panel" hidden>
					<div class="detail-panel-head">
						<span class="detail-panel-title">Embed</span>
					</div>
					<div class="detail-embed-tabs" data-role="embed-tabs"></div>
					<div class="detail-embed-panes" data-role="embed-panes"></div>
				</div>
			</div>
		</div>
	</main>

	<script type="module" src="/discover/detail.js"></script>
</body>
</html>`);
}

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

function shortAddr(a) {
	if (!a || a.length < 10) return a || '';
	return `${a.slice(0, 6)}…${a.slice(-4)}`;
}