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
// Fixed slot vocabulary for agent animation gestures.
//
// Two layers live here:
//
// 1. SLOTS + DEFAULT_ANIMATION_MAP: the slot names an agent may override
// (meta.edits.animations) and the clip each one resolves to by default.
// Every value is a real baked clip in public/animations/manifest.json;
// tests/animation-slots.test.js fails the build if one drifts.
// 2. HINT_ALIASES + resolveHint: the skill-side vocabulary. Skills declare
// `animationHint: '<name>'` (src/agent-skills*.js) and the avatar plays
// the matching slot. Hints that are not slot names (the `gesture-*`
// family) alias onto one, so a hint can never resolve to nothing.
export const SLOTS = [
'idle',
'wave',
'nod',
'shake',
'think',
'celebrate',
'concern',
'bow',
'point',
'shrug',
'fidget',
'dance',
'inspect',
'present',
'sign',
'curiosity',
'patience',
'manipulate',
'conjure',
];
export const DEFAULT_ANIMATION_MAP = {
idle: 'idle',
// wave/nod/point/think/shrug each have a dedicated Mixamo clip in the
// manifest. They used to borrow `reaction`/`pray`/`defeated` because the
// dedicated clips had not been baked yet; the borrowed mappings outlived
// their reason and left five real clips unreachable (registry.json
// resolved_issues: wave-slot-mismatch).
wave: 'wave',
nod: 'nod',
// A "no" is a head shake, not a 19-second angry gesture. xbot-head-shake is
// the only baked head-shake clip and retargets like any other (the walk
// state machine already plays it for `disagree`).
shake: 'xbot-head-shake',
think: 'think',
celebrate: 'celebrate',
concern: 'defeated',
// A dedicated, project-authored one-shot. Its reproducible keyframes live in
// scripts/build-original-animations.mjs, so this no longer borrows applause.
bow: 'bow',
point: 'point',
shrug: 'shrug',
// Was 'Fidget', a clip that does not exist (case mismatch against the
// lowercase manifest names too), so the slot silently no-op'd on every agent
// that hit it (registry.json known_issues: broken-fidget-slot). av-waiting looked
// right but measures with an open loop seam and root drift (signatures.json:
// loopClean false), which snaps every cycle on a looping slot;
// av-listening-music is a clean anchored loop with the same restless read.
fidget: 'av-listening-music',
dance: 'rumba',
// Skill-driven slots. Each one exists because a skill emits the matching
// hint; before they were slots those hints hit no clip and no-op'd silently.
inspect: 'lookdown',
present: 'av-brag-claps',
sign: 'xbot-agree',
curiosity: 'av-spy',
// Looping slot, so it needs a clean anchored loop; av-waiting's open seam
// rules it out here too.
patience: 'av-idle-anim',
manipulate: 'av-push-block',
conjure: 'av-conductor',
};
const SLOT_SET = new Set(SLOTS);
/**
* Skill hint → slot, for hints that are not slot names themselves.
* The `gesture-*` family is namespaced by intent in src/agent-skills-scene.js.
*/
export const HINT_ALIASES = {
gesture: 'point',
'gesture-magic': 'conjure',
'gesture-manipulate': 'manipulate',
};
/**
* Resolve a slot name to a concrete animation clip name.
* Checks the agent's override map first, falls back to DEFAULT_ANIMATION_MAP,
* then returns the slot name itself as a last resort.
* @param {string} slot
* @param {Object|null} overrideMap — agent's meta.edits.animations
* @returns {string}
*/
export function resolveSlot(slot, overrideMap) {
if (overrideMap && overrideMap[slot]) return overrideMap[slot];
return DEFAULT_ANIMATION_MAP[slot] ?? slot;
}
/**
* Resolve a skill's `animationHint` to a slot name.
*
* Exact slot names pass through, known aliases map onto a slot, and an unknown
* namespaced hint falls back to its family (`gesture-foo` → the `gesture`
* alias) so a new hint in that family animates instead of no-oping. Returns
* null when nothing matches, which callers treat as "play nothing" rather than
* guessing a wrong clip.
*
* @param {string} hint
* @returns {string|null} slot name, or null if the hint maps to no slot
*/
export function resolveHint(hint) {
const key = String(hint || '').trim().toLowerCase();
if (!key) return null;
if (SLOT_SET.has(key)) return key;
if (HINT_ALIASES[key]) return HINT_ALIASES[key];
const family = key.split('-')[0];
if (SLOT_SET.has(family)) return family;
if (HINT_ALIASES[family]) return HINT_ALIASES[family];
return null;
}