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
import { z } from 'zod';
import { sql } from '../../../_lib/db.js';
import { getSessionUser, authenticateBearer, extractBearer } from '../../../_lib/auth.js';
import { cors, json, method, readJson, wrap, error, rateLimited } from '../../../_lib/http.js';
import { limits, clientIp } from '../../../_lib/rate-limit.js';
import { parse } from '../../../_lib/validate.js';
import { pinToIPFS, ipfsPinningConfigured } from '../../../_lib/ipfs-pin.js';
const MAX_BYTES = 512 * 1024; // 512 KB per encrypted file
const bodySchema = z.object({
filename: z
.string()
.trim()
.min(1)
.max(260)
.regex(/^[A-Za-z0-9._-]+$/, 'invalid filename characters'),
// base64-encoded bytes (encrypted, or plaintext for MEMORY.md). `Buffer.from`
// never throws on malformed base64: it silently drops the invalid characters
// so garbage would otherwise be pinned to IPFS as a valid-looking CID. The
// shape is enforced here, before any byte reaches a pinning provider.
data: z
.string()
.min(1)
.regex(/^[A-Za-z0-9+/\r\n]+={0,2}$/, 'data must be base64')
.refine((s) => s.replace(/[\r\n]/g, '').length % 4 === 0, 'data must be base64'),
});
// POST /api/agents/:id/memory/pin
// Body: { filename, data } — data is base64-encoded bytes
// Returns: { cid }
export default wrap(async (req, res) => {
if (cors(req, res, { methods: 'POST,OPTIONS', credentials: true })) return;
if (!method(req, res, ['POST'])) return;
const url = new URL(req.url, 'http://x');
const parts = url.pathname.split('/').filter(Boolean);
const agentId = parts[2];
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');
const [agent] =
await sql`SELECT id FROM agent_identities WHERE id = ${agentId} AND user_id = ${userId} AND deleted_at IS NULL`;
if (!agent) return error(res, 404, 'not_found', 'agent not found');
const rl = await limits.upload(userId);
if (!rl.success) return rateLimited(res, rl, 'upload rate exceeded');
const body = parse(bodySchema, await readJson(req));
const buf = Buffer.from(body.data, 'base64');
if (buf.byteLength === 0) {
return error(res, 400, 'validation_error', 'data decodes to zero bytes');
}
if (buf.byteLength > MAX_BYTES) {
return error(res, 413, 'payload_too_large', 'file exceeds 512 KB limit');
}
if (!ipfsPinningConfigured()) {
return error(res, 503, 'pinning_unconfigured', 'no pinning provider configured');
}
// Pinata first, web3.storage on failure: each rung carries its own deadline
// and breaker (api/_lib/ipfs-pin.js), so a sick provider fails over instead
// of holding this request open.
const { cid } = await pinToIPFS(buf, body.filename);
// Record the CID against this agent so the read proxy
// (GET /api/agents/:id/memory/:cid) can verify ownership of the CID itself,
// not just of the agent — otherwise any owner could proxy-fetch any CID.
await sql`
INSERT INTO agent_memory_pins (agent_id, cid, filename, bytes)
VALUES (${agentId}, ${cid}, ${body.filename}, ${buf.byteLength})
ON CONFLICT (agent_id, cid)
DO UPDATE SET filename = excluded.filename, bytes = excluded.bytes
`;
return json(res, 200, { cid });
});