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
/**
* Dynamic pricing rules for a specific agent skill.
*
* Every verb is owner-only: a rule set is a seller's unpublished strategy
* (scheduled discounts, deactivated experiments), not public catalog data. The
* price a buyer actually pays is resolved server-side by
* api/_lib/skill-pricing-rules.js and published through the public skill
* endpoints; nothing outside Creator Studio reads this one.
*
* Routes:
* GET /api/agents/:id/pricing-rules?skill=:skill list rules for skill
* POST /api/agents/:id/pricing-rules create rule
* PATCH /api/agents/:id/pricing-rules/:ruleId update rule
* DELETE /api/agents/:id/pricing-rules/:ruleId deactivate rule
*/
import { z } from 'zod';
import { sql } from '../../_lib/db.js';
import { getSessionUser } from '../../_lib/auth.js';
import { cors, json, method, wrap, error, readJson, rateLimited } from '../../_lib/http.js';
import { limits, clientIp } from '../../_lib/rate-limit.js';
import { requireCsrf } from '../../_lib/csrf.js';
import { isUuid } from '../../_lib/validate.js';
const RULE_TYPES = ['first_n_purchases', 'after_n_purchases', 'time_window'];
const createSchema = z.object({
skill_name: z.string().trim().min(1).max(100),
rule_type: z.enum(RULE_TYPES),
threshold: z.number().int().min(1).optional(),
price_amount: z.number().int().min(1),
currency_mint: z.string().trim().min(1).max(100),
chain: z.string().trim().min(1).max(20).default('solana'),
start_at: z.string().datetime().optional(),
end_at: z.string().datetime().optional(),
priority: z.number().int().min(0).max(100).default(0),
}).refine(d => {
if (d.rule_type !== 'time_window') return true;
return d.start_at || d.end_at;
}, { message: 'time_window rules require start_at or end_at' }).refine(d => {
if (d.rule_type === 'time_window') return true;
return Number.isInteger(d.threshold);
}, { message: 'threshold required for first_n_purchases and after_n_purchases rules' });
const patchSchema = z.object({
threshold: z.number().int().min(1).optional(),
price_amount: z.number().int().min(1).optional(),
start_at: z.string().datetime().optional().nullable(),
end_at: z.string().datetime().optional().nullable(),
priority: z.number().int().min(0).max(100).optional(),
is_active: z.boolean().optional(),
});
export default wrap(async (req, res) => {
if (cors(req, res, { methods: 'GET,POST,PATCH,DELETE,OPTIONS', credentials: true })) return;
const url = new URL(req.url, 'http://x');
const parts = url.pathname.split('/').filter(Boolean);
const agentId = url.searchParams.get('id') || parts[2] || null;
const ruleId = url.searchParams.get('rule_id') || parts[4] || null;
if (!agentId || !isUuid(agentId))
return error(res, 400, 'validation_error', 'valid agent id required');
if (req.method === 'GET') return handleList(req, res, agentId);
if (req.method === 'POST' && !ruleId) return handleCreate(req, res, agentId);
if (req.method === 'PATCH' && ruleId) return handlePatch(req, res, agentId, ruleId);
if (req.method === 'DELETE' && ruleId) return handleDelete(req, res, agentId, ruleId);
return error(res, 405, 'method_not_allowed', 'method not allowed');
});
async function ownerCheck(req, res, agentId) {
const user = await getSessionUser(req);
if (!user) { error(res, 401, 'unauthorized', 'sign in required'); return null; }
const [agent] = await sql`
SELECT id FROM agent_identities WHERE id = ${agentId} AND user_id = ${user.id} AND deleted_at IS NULL
`;
if (!agent) { error(res, 403, 'forbidden', 'not your agent'); return null; }
return user;
}
async function handleList(req, res, agentId) {
if (!method(req, res, ['GET'])) return;
// Reads are gated too: the list includes deactivated rules and time windows
// that have not opened yet, which is the seller's pricing plan, not a price
// a buyer is entitled to see ahead of time.
if (!(await ownerCheck(req, res, agentId))) return;
const url = new URL(req.url, 'http://x');
const skill = req.query?.skill || url.searchParams.get('skill') || null;
const rules = await sql`
SELECT id, skill_name, rule_type, threshold, price_amount, currency_mint, chain,
start_at, end_at, priority, is_active, created_at
FROM skill_pricing_rules
WHERE agent_id = ${agentId}
${skill ? sql`AND skill_name = ${skill}` : sql``}
ORDER BY skill_name, priority ASC, created_at ASC
`;
return json(res, 200, { data: { rules } });
}
async function handleCreate(req, res, agentId) {
if (!method(req, res, ['POST'])) return;
const user = await ownerCheck(req, res, agentId);
if (!user) return;
if (!(await requireCsrf(req, res, user.id))) return;
const rl = await limits.authIp(clientIp(req));
if (!rl.success) return rateLimited(res, rl);
const body = await readJson(req).catch(() => null);
if (!body) return error(res, 400, 'validation_error', 'request body required');
const parsed = createSchema.safeParse(body);
if (!parsed.success)
return error(res, 400, 'validation_error', parsed.error.issues[0]?.message || 'invalid input');
const { skill_name, rule_type, threshold, price_amount, currency_mint, chain, start_at, end_at, priority } = parsed.data;
const [rule] = await sql`
INSERT INTO skill_pricing_rules
(agent_id, skill_name, rule_type, threshold, price_amount, currency_mint, chain, start_at, end_at, priority)
VALUES
(${agentId}, ${skill_name}, ${rule_type}, ${threshold ?? null}, ${price_amount},
${currency_mint}, ${chain}, ${start_at ?? null}, ${end_at ?? null}, ${priority})
RETURNING id, skill_name, rule_type, threshold, price_amount, currency_mint, chain, start_at, end_at, priority, is_active, created_at
`;
return json(res, 201, { data: { rule } });
}
async function handlePatch(req, res, agentId, ruleId) {
if (!method(req, res, ['PATCH'])) return;
if (!isUuid(ruleId)) return error(res, 400, 'validation_error', 'invalid rule id');
const user = await ownerCheck(req, res, agentId);
if (!user) return;
if (!(await requireCsrf(req, res, user.id))) return;
const body = await readJson(req).catch(() => null);
const parsed = patchSchema.safeParse(body || {});
if (!parsed.success)
return error(res, 400, 'validation_error', parsed.error.issues[0]?.message || 'invalid input');
const { threshold, price_amount, start_at, end_at, priority, is_active } = parsed.data;
// start_at/end_at are nullable on purpose: sending an explicit null is how a
// seller reopens a time window that had a bound. COALESCE alone cannot express
// that: it reads an explicit null exactly like an omitted key and keeps the
// old timestamp, so the write returned 200 while silently discarding the
// clear. Distinguish "present and null" from "absent" before the query runs.
const clearStart = Object.hasOwn(parsed.data, 'start_at') && start_at === null;
const clearEnd = Object.hasOwn(parsed.data, 'end_at') && end_at === null;
const [existing] = await sql`
SELECT id FROM skill_pricing_rules WHERE id = ${ruleId} AND agent_id = ${agentId}
`;
if (!existing) return error(res, 404, 'not_found', 'rule not found');
await sql`
UPDATE skill_pricing_rules SET
threshold = COALESCE(${threshold ?? null}, threshold),
price_amount = COALESCE(${price_amount ?? null}, price_amount),
start_at = CASE WHEN ${clearStart}::boolean THEN NULL
ELSE COALESCE(${start_at ?? null}, start_at) END,
end_at = CASE WHEN ${clearEnd}::boolean THEN NULL
ELSE COALESCE(${end_at ?? null}, end_at) END,
priority = COALESCE(${priority ?? null}, priority),
is_active = COALESCE(${is_active ?? null}, is_active),
updated_at = now()
WHERE id = ${ruleId} AND agent_id = ${agentId}
`;
return json(res, 200, { data: { ok: true } });
}
async function handleDelete(req, res, agentId, ruleId) {
if (!method(req, res, ['DELETE'])) return;
if (!isUuid(ruleId)) return error(res, 400, 'validation_error', 'invalid rule id');
const user = await ownerCheck(req, res, agentId);
if (!user) return;
if (!(await requireCsrf(req, res, user.id))) return;
await sql`
UPDATE skill_pricing_rules SET is_active = false, updated_at = now()
WHERE id = ${ruleId} AND agent_id = ${agentId}
`;
return json(res, 200, { data: { ok: true } });
}