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
// HTML rendering and CSS safety helpers for the render_avatar tool.
function esc(s) {
return String(s).replace(/[&<>]/g, (c) => ({ '&': '&', '<': '<', '>': '>' })[c]);
}
function attr(s) {
return String(s).replace(
/[&<>"]/g,
(c) => ({ '&': '&', '<': '<', '>': '>', '"': '"' })[c],
);
}
// CSS inputs land inside a <style> declaration (`background: <value>`), where
// HTML attribute-escaping does not defend against `;}body{…}` breakouts. Only
// allow a strict character class that cannot terminate the declaration/rule.
export function safeCssValue(s, fallback) {
if (!s) return fallback;
const str = String(s).trim();
if (!/^[a-zA-Z0-9 .,%#()\-_/+]+$/.test(str)) return fallback;
// The character class alone still admits `url(//host/pixel.png)`: parens and
// slashes are legal in gradients, so a caller-supplied background could make
// the rendered viewer fetch an arbitrary external resource (a beacon that
// leaks the viewer's IP and referrer). Colors and gradients never need url().
if (/url\s*\(/i.test(str)) return fallback;
if (str.length > 120) return fallback;
return str;
}
export function safeCssLength(s, fallback) {
if (!s) return fallback;
const str = String(s).trim();
if (!/^[0-9]+(?:\.[0-9]+)?(?:px|em|rem|vh|vw|%)$|^auto$|^100%$/.test(str)) return fallback;
return str;
}
// Posters are rendered as an attribute value that the browser fetches; restrict
// to https(:) to block `javascript:` and `data:` URLs that could execute code.
export function safeHttpsUrl(s) {
if (!s) return undefined;
try {
const u = new URL(String(s));
return u.protocol === 'https:' ? u.toString() : undefined;
} catch {
return undefined;
}
}
export function renderModelViewerHtml({ src, name, poster, background, height, width, autoRotate, ar, arHref, cameraOrbit }) {
// Re-sanitize here rather than trusting each call site. The CSS values land
// inside a <style> declaration where attribute-escaping does not stop a
// `;}body{...}` breakout, and every helper below is idempotent, so a caller
// that already ran them (the avatar + studio tools) is unaffected while a
// future one that forgets cannot open a hole.
const bg = safeCssValue(background, 'transparent');
const h = safeCssLength(height, '480px');
const w = safeCssLength(width, '100%');
const orbit = safeCssValue(cameraOrbit, '');
const posterUrl = safeHttpsUrl(poster);
const attrs = [
`src="${attr(src)}"`,
'camera-controls',
'shadow-intensity="1"',
'exposure="1"',
'tone-mapping="aces"',
autoRotate ? 'auto-rotate' : '',
ar ? 'ar ar-modes="webxr scene-viewer quick-look"' : '',
posterUrl ? `poster="${attr(posterUrl)}"` : '',
orbit ? `camera-orbit="${attr(orbit)}"` : '',
`alt="${attr(name || 'Avatar')}"`,
]
.filter(Boolean)
.join(' ');
// arHref: the device-aware /api/ar launch link. model-viewer's own AR button
// only appears on AR-capable browsers and never inside an embedding host's
// sandboxed iframe, so a plain visible link is what makes "place it in your
// home" one tap from anywhere (ChatGPT opens it in the system browser).
const arLink = arHref
? '<a class="ar" href="' + attr(arHref) + '" target="_blank" rel="noopener">View in your space</a>'
: '';
return [
'<!doctype html>',
'<html><head><meta charset="utf-8"><title>' + esc(name || 'Avatar') + '</title>',
'<script type="module" src="https://cdn.jsdelivr.net/npm/@google/[email protected]/dist/model-viewer.min.js"></script>',
'<style>html,body{margin:0;height:100%;background:' + attr(bg) + '}',
'model-viewer{width:' + attr(w) + ';height:' + attr(h) + ';--progress-bar-color:#6a5cff}',
'a.ar{position:absolute;left:50%;transform:translateX(-50%);bottom:14px;font-family:ui-sans-serif,system-ui,sans-serif;' +
'font-size:13px;font-weight:700;color:#0b0c10;background:#6ea8fe;border-radius:999px;padding:9px 16px;' +
'text-decoration:none;box-shadow:0 2px 10px rgba(0,0,0,.35)}',
'a.ar:hover{filter:brightness(1.08)}a.ar:active{transform:translateX(-50%) translateY(1px)}',
'a.ar:focus-visible{outline:2px solid #fff;outline-offset:2px}</style>',
'</head><body>',
'<model-viewer ' + attrs + '></model-viewer>',
arLink,
'</body></html>',
].join('\n');
}
export function formatAvatarList(avatars, { public: isPublic = false } = {}) {
if (!avatars.length) return 'No avatars found.';
return avatars
.map((a) => {
const url = a.model_url ? ` — ${a.model_url}` : '';
const vis = isPublic ? '' : ` [${a.visibility}]`;
return `• ${a.name} (slug: ${a.slug}, id: ${a.id})${vis}${url}`;
})
.join('\n');
}