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
/**
* POST /api/marketplace/start-trial
* Body: { agent_id, skill }
*
* Checks the skill has trial_uses > 0 on agent_skill_prices.
* Inserts a skill_purchases row with status='trial', kind='trial', no payment.
* Rate-limit: one trial per (user, agent, skill).
*
* Auth: browser session cookie (CSRF enforced) OR an API-key bearer token, the
* same pair every other marketplace write accepts. Without the bearer branch a
* script had to scrape a session cookie and mint a CSRF token just to take a
* free trial, while the purchase that follows it took a plain bearer header.
*/
import { z } from 'zod';
import crypto from 'node:crypto';
import { sql } from '../_lib/db.js';
import { authenticateBearer, extractBearer, getSessionUser } from '../_lib/auth.js';
import { cors, json, method, wrap, error, readJson, rateLimited } from '../_lib/http.js';
import { parse } from '../_lib/validate.js';
import { limits, clientIp } from '../_lib/rate-limit.js';
import { requireCsrf } from '../_lib/csrf.js';
const bodySchema = z.object({
agent_id: z.string().uuid(),
skill: z.string().trim().min(1).max(100),
});
export default wrap(async (req, res) => {
if (cors(req, res, { methods: 'POST,OPTIONS', credentials: true })) return;
if (!method(req, res, ['POST'])) return;
const session = await getSessionUser(req);
const bearer = session ? null : await authenticateBearer(extractBearer(req));
const userId = session?.id || bearer?.userId;
if (!userId) return error(res, 401, 'unauthorized', 'sign in required');
// requireCsrf short-circuits on an Authorization: Bearer header, so this is
// a no-op for key callers and still mandatory for cookie callers.
const csrfOk = await requireCsrf(req, res, userId);
if (!csrfOk) return;
const rl = await limits.authIp(clientIp(req));
if (!rl.success) return rateLimited(res, rl);
const body = parse(bodySchema, await readJson(req));
const { agent_id, skill } = body;
// Verify agent exists
const [agent] = await sql`
SELECT id FROM agent_identities WHERE id = ${agent_id} AND deleted_at IS NULL
`;
if (!agent) return error(res, 404, 'not_found', 'agent not found');
// Check skill has trial_uses > 0
const [price] = await sql`
SELECT skill, trial_uses, amount, currency_mint, chain
FROM agent_skill_prices
WHERE agent_id = ${agent_id} AND skill = ${skill} AND is_active = true
`;
if (!price) return error(res, 404, 'not_found', 'skill not found or not priced');
if ((price.trial_uses || 0) <= 0) {
return error(res, 422, 'no_trials', 'this skill does not offer free trials');
}
// Check for existing active (confirmed or trial) purchase — one per (user, agent, skill)
const [existing] = await sql`
SELECT id, status, trial_remaining
FROM skill_purchases
WHERE user_id = ${userId} AND agent_id = ${agent_id} AND skill = ${skill}
AND status IN ('confirmed', 'trial')
LIMIT 1
`;
if (existing) {
if (existing.status === 'confirmed') {
return error(res, 409, 'already_owned', 'you already own this skill');
}
// Active trial — return current state
return json(res, 200, {
data: {
trial_remaining: existing.trial_remaining,
reference: null,
already_trialing: true,
},
});
}
// Check rate-limit: one trial attempt per (user, agent, skill) — look at any prior trial row
const [priorTrial] = await sql`
SELECT id FROM skill_purchases
WHERE user_id = ${userId} AND agent_id = ${agent_id} AND skill = ${skill}
AND kind = 'trial'
LIMIT 1
`;
if (priorTrial) {
return error(res, 409, 'trial_used', 'you have already used the trial for this skill');
}
const reference = crypto.randomBytes(32).toString('hex');
// The checks above are advisory: two clicks a few milliseconds apart both
// read "no trial yet" and both insert. `skill_purchases_one_active_per_beneficiary`
// is what actually enforces one active copy per beneficiary, so the loser of
// that race gets a unique violation. That is the same condition the 409 above
// describes, not a server fault, so answer it the same way instead of 500ing.
let purchase;
try {
[purchase] = await sql`
INSERT INTO skill_purchases
(user_id, agent_id, skill, status, kind, reference, amount, currency_mint, chain, trial_remaining)
VALUES
(${userId}, ${agent_id}, ${skill}, 'trial', 'trial', ${reference},
${price.amount}, ${price.currency_mint}, ${price.chain}, ${price.trial_uses})
RETURNING id, trial_remaining, reference, created_at
`;
} catch (e) {
if (e?.code === '23505' || /duplicate key|unique constraint/i.test(e?.message || '')) {
return error(res, 409, 'trial_used', 'you have already used the trial for this skill');
}
throw e;
}
return json(res, 201, {
data: {
trial_remaining: purchase.trial_remaining,
reference: purchase.reference,
purchase_id: purchase.id,
},
});
});