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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
/**
* Agent reviews API.
* ──────────────────
* GET /api/marketplace/agents/:id/reviews — list reviews + summary
* POST /api/marketplace/agents/:id/reviews — upsert caller's review
* body: { rating: 1..5, body?: string<=2000 }
* DELETE /api/marketplace/agents/:id/reviews — delete caller's review
*
* Routed via vercel.json — see top of file path patterns.
*
* Schema lives in api/_lib/migrations/2026-05-21-agent-reviews.sql.
* One review per (agent_id, user_id); POST upserts in place.
*/
import { z } from 'zod';
import { sql } from '../_lib/db.js';
import { authenticateBearer, extractBearer, getSessionUser } from '../_lib/auth.js';
import { cors, error, json, method, readJson, wrap, rateLimited } from '../_lib/http.js';
import { clientIp, limits } from '../_lib/rate-limit.js';
import { requireCsrf } from '../_lib/csrf.js';
import { isUuid } from '../_lib/validate.js';
import { publishUserEvent } from '../_lib/feed.js';
import { attestReview } from '../_lib/review-attest.js';
const reviewSchema = z.object({
rating: z.number().int().min(1).max(5),
body: z.string().trim().max(2000).optional().nullable(),
});
async function resolveAuth(req) {
const session = await getSessionUser(req);
if (session) return { userId: session.id };
const bearer = await authenticateBearer(extractBearer(req));
if (bearer) return { userId: bearer.userId };
return null;
}
export default wrap(async (req, res) => {
// CORS first, before any input validation. Answering the preflight from inside
// the per-method handlers meant a malformed agent id (and a preflight that did
// not name its method) fell out as a bare 400 with no CORS headers at all, so
// the browser reported a CORS failure instead of the validation error the
// caller actually needed to see.
if (cors(req, res, { methods: 'GET,POST,DELETE,OPTIONS', credentials: true })) return;
const url = new URL(req.url, 'http://x');
const parts = url.pathname.split('/').filter(Boolean); // [api, marketplace, agents, :id, reviews]
const agentId = url.searchParams.get('agent_id') || parts[3];
if (!agentId || !isUuid(agentId)) {
return error(res, 400, 'validation_error', 'agent_id required');
}
if (req.method === 'GET') return handleList(req, res, agentId);
if (req.method === 'POST') return handleUpsert(req, res, agentId);
if (req.method === 'DELETE') return handleDelete(req, res, agentId);
return error(res, 405, 'method_not_allowed', 'GET/POST/DELETE only');
});
// ── list + summary ───────────────────────────────────────────────────────────
async function handleList(req, res, agentId) {
if (!method(req, res, ['GET'])) return;
const rl = await limits.widgetRead(clientIp(req));
if (!rl.success) return rateLimited(res, rl);
const [agent] = await sql`
SELECT id FROM agent_identities WHERE id = ${agentId} AND deleted_at IS NULL
`;
if (!agent) return error(res, 404, 'not_found', 'agent not found');
const auth = await resolveAuth(req).catch(() => null);
const [summary] = await sql`
SELECT
COALESCE(AVG(rating)::numeric(3,2), 0) AS rating_avg,
COUNT(*)::int AS rating_count,
SUM(CASE WHEN rating = 5 THEN 1 ELSE 0 END)::int AS r5,
SUM(CASE WHEN rating = 4 THEN 1 ELSE 0 END)::int AS r4,
SUM(CASE WHEN rating = 3 THEN 1 ELSE 0 END)::int AS r3,
SUM(CASE WHEN rating = 2 THEN 1 ELSE 0 END)::int AS r2,
SUM(CASE WHEN rating = 1 THEN 1 ELSE 0 END)::int AS r1
FROM agent_reviews
WHERE agent_id = ${agentId}
`;
const rows = await sql`
SELECT r.id, r.rating, r.body, r.created_at, r.updated_at,
r.user_id, u.display_name, u.avatar_url
FROM agent_reviews r
LEFT JOIN users u ON u.id = r.user_id
WHERE r.agent_id = ${agentId}
ORDER BY r.created_at DESC
LIMIT 50
`;
let myReview = null;
if (auth) {
const [mine] = await sql`
SELECT id, rating, body, created_at, updated_at
FROM agent_reviews
WHERE agent_id = ${agentId} AND user_id = ${auth.userId}
`;
if (mine) myReview = mine;
}
const reviews = rows.map((r) => ({
id: r.id,
rating: r.rating,
body: r.body,
created_at: r.created_at,
updated_at: r.updated_at,
author_name: r.display_name || 'Anonymous',
author_avatar: r.avatar_url || null,
is_mine: auth && r.user_id === auth.userId,
}));
return json(
res,
200,
{
data: {
summary: {
rating_avg: Number(summary.rating_avg || 0),
rating_count: summary.rating_count || 0,
breakdown: { 5: summary.r5 || 0, 4: summary.r4 || 0, 3: summary.r3 || 0, 2: summary.r2 || 0, 1: summary.r1 || 0 },
},
reviews,
my_review: myReview,
},
},
{ 'cache-control': 'no-store' },
);
}
// ── upsert ───────────────────────────────────────────────────────────────────
async function handleUpsert(req, res, agentId) {
if (!method(req, res, ['POST'])) return;
const auth = await resolveAuth(req);
if (!auth) return error(res, 401, 'unauthorized', 'sign in required');
if (!(await requireCsrf(req, res, auth.userId))) return;
const rl = await limits.authIp(clientIp(req));
if (!rl.success) return rateLimited(res, rl);
const [agent] = await sql`
SELECT id, user_id, name, erc8004_agent_id, chain_id FROM agent_identities
WHERE id = ${agentId} AND deleted_at IS NULL AND is_published = true
`;
if (!agent) return error(res, 404, 'not_found', 'agent not found');
if (agent.user_id === auth.userId) {
return error(res, 422, 'self_review_forbidden', 'you cannot review your own agent');
}
const body = await readJson(req).catch(() => null);
const parsed = reviewSchema.safeParse(body);
if (!parsed.success) {
return error(res, 400, 'validation_error', parsed.error.issues[0]?.message || 'invalid review');
}
const reviewBody = (parsed.data.body || '').trim() || null;
const [row] = await sql`
INSERT INTO agent_reviews (agent_id, user_id, rating, body)
VALUES (${agentId}, ${auth.userId}, ${parsed.data.rating}, ${reviewBody})
ON CONFLICT (agent_id, user_id)
DO UPDATE SET rating = EXCLUDED.rating, body = EXCLUDED.body, updated_at = now()
RETURNING id, rating, body, created_at, updated_at
`;
const [summary] = await sql`
SELECT
COALESCE(AVG(rating)::numeric(3,2), 0) AS rating_avg,
COUNT(*)::int AS rating_count
FROM agent_reviews WHERE agent_id = ${agentId}
`;
// Notify the owner of a genuinely NEW review (not an edit). On a fresh insert
// created_at === updated_at; an upsert-update bumps updated_at, so this gates
// out edit spam. Fire-and-forget via the existing in-app notification system.
if (+new Date(row.created_at) === +new Date(row.updated_at)) {
const [reviewer] = await sql`
SELECT display_name, username FROM users WHERE id = ${auth.userId} AND deleted_at IS NULL
`;
publishUserEvent(agent.user_id, {
type: 'agent_review',
actor: reviewer?.display_name || reviewer?.username || 'Someone',
agent_id: agentId,
agent_name: agent.name || null,
rating: parsed.data.rating,
link: `/agents/${agentId}`,
});
}
// Anchor the review on Solana — fire-and-forget, never blocks the response.
attestReview({
reviewId: row.id,
updatedAt: row.updated_at,
agentId,
rating: parsed.data.rating,
body: reviewBody,
reviewType: 'agent',
}).catch((err) => {
console.error('[review-attest] agent review anchor failed:', err.message);
});
return json(res, 200, {
data: {
review: row,
summary: {
rating_avg: Number(summary.rating_avg || 0),
rating_count: summary.rating_count || 0,
},
// Returned so the client can offer ERC-8004 user-signed anchoring.
erc8004: agent.erc8004_agent_id
? { agent_id: String(agent.erc8004_agent_id), chain_id: agent.chain_id }
: null,
},
});
}
// ── delete ───────────────────────────────────────────────────────────────────
async function handleDelete(req, res, agentId) {
if (!method(req, res, ['DELETE'])) return;
const auth = await resolveAuth(req);
if (!auth) return error(res, 401, 'unauthorized', 'sign in required');
if (!(await requireCsrf(req, res, auth.userId))) return;
const rl = await limits.authIp(clientIp(req));
if (!rl.success) return rateLimited(res, rl);
await sql`DELETE FROM agent_reviews WHERE agent_id = ${agentId} AND user_id = ${auth.userId}`;
return json(res, 200, { data: { deleted: true } });
}