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
/**
* /animations regression cover for the browse surface's contracts, driven
* against a small stubbed catalogue so each assertion is deterministic:
* • a library clip with no `thumb` in the manifest renders its icon and
* requests nothing (the CDN convention 404s for a third of the catalogue)
* • ?filter= presses the segmented button it filters by, and a ?sort= the
* control cannot represent falls back to Featured instead of blanking it
* • the detail dialog keeps no live transport while nothing is on the stage,
* traps Tab, and hands focus back to the card that opened it
*
* The preview engine itself (three.js, the avatar, the retarget pass) is left
* to boot in the background: every assertion here is about the page's own state
* machine, so none of them wait on WebGL.
*/
import { test, expect } from '@playwright/test';
const CURATED = [
{ name: 'idle', url: '/animations/clips/idle.json', label: 'Idle', icon: '🧍', loop: true, duration: 15.8 },
];
// One library clip with a baked thumbnail, one without. The one without is the
// case that used to cost a doomed cross-origin request per card.
const LIBRARY = {
clips: [
{
name: 'mx-test-thumbed',
label: 'Thumbed Turn',
loop: false,
duration: 1.9,
url: 'https://cdn.example.invalid/animations/library/clips/mx-test-thumbed.json',
thumb: 'https://cdn.example.invalid/animations/library/thumbs/mx-test-thumbed.webp',
},
{
name: 'mx-test-unthumbed',
label: 'Unthumbed Walk',
loop: true,
duration: 2.4,
url: 'https://cdn.example.invalid/animations/library/clips/mx-test-unthumbed.json',
},
],
total: 2,
next_offset: null,
};
// A 1x1 PNG, so a card that does publish a thumbnail keeps its <img> instead of
// falling back to the icon the way a broken one would.
const PIXEL = Buffer.from(
'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
'base64',
);
// The gallery asks for its totals separately (?facets=1) so it never has to hold
// the whole catalogue to count it. Registered after the catalogue route because
// Playwright matches the most recently added route first.
const FACETS = {
total: LIBRARY.clips.length,
categories: [
{ key: 'locomotion', count: 2 },
{ key: 'dance', count: 0 },
],
generated_at: null,
};
async function stubCatalogue(page) {
await page.route('**/animations/manifest.json', (r) => r.fulfill({ json: CURATED }));
await page.route('**/api/animations/library**', (r) => r.fulfill({ json: LIBRARY }));
await page.route('**/api/animations/library?facets=1', (r) => r.fulfill({ json: FACETS }));
await page.route('**/api/animations/clips**', (r) => r.fulfill({ json: { items: [], next_cursor: null } }));
await page.route('https://cdn.example.invalid/**/thumbs/**', (r) =>
r.fulfill({ contentType: 'image/png', body: PIXEL }),
);
// Clip payloads are never awaited here; no assertion depends on a preview.
await page.route('https://cdn.example.invalid/**/clips/**', (r) => r.abort());
}
test.describe('/animations gallery', () => {
test.beforeEach(async ({ page }) => {
await stubCatalogue(page);
});
test('a library clip with no published thumbnail renders its icon and requests nothing', async ({ page }) => {
test.setTimeout(90_000);
const thumbRequests = [];
page.on('request', (r) => {
if (/\/thumbs\//.test(r.url())) thumbRequests.push(r.url());
});
await page.goto('/animations');
await expect(page.locator('.ag-card')).toHaveCount(3);
const unthumbed = page.locator('.ag-card', { hasText: 'Unthumbed Walk' });
await expect(unthumbed.locator('img.ag-card-thumb')).toHaveCount(0);
await expect(unthumbed.locator('.ag-card-thumb-fallback')).toBeVisible();
const thumbed = page.locator('.ag-card', { hasText: 'Thumbed Turn' });
await expect(thumbed.locator('img.ag-card-thumb')).toHaveAttribute(
'src',
LIBRARY.clips[0].thumb,
);
expect(thumbRequests.some((u) => u.includes('mx-test-unthumbed'))).toBe(false);
});
test('?filter= presses its button and an unrepresentable ?sort= falls back to Featured', async ({ page }) => {
test.setTimeout(90_000);
await page.goto('/animations?filter=once&sort=bogus&cat=bogus');
await expect(page.locator('.ag-card')).toHaveCount(1);
await expect(page.locator('[data-role="type-filter"] [data-filter="once"]')).toHaveAttribute(
'aria-pressed',
'true',
);
await expect(page.locator('[data-role="type-filter"] [data-filter=""]')).toHaveAttribute(
'aria-pressed',
'false',
);
await expect(page.locator('[data-role="sort"]')).toHaveValue('featured');
// An unknown category must not filter the grid down to nothing.
await expect(page.locator('.ag-chip[aria-selected="true"]')).toHaveText(/All/);
await expect(page.locator('.ag-card-title')).toHaveText('Thumbed Turn');
});
test('the detail dialog hides the transport until a clip plays, traps Tab, and restores focus', async ({ page }) => {
test.setTimeout(90_000);
await page.goto('/animations');
await expect(page.locator('.ag-card')).toHaveCount(3);
const details = page.locator('.ag-card', { hasText: 'Unthumbed Walk' }).locator('[data-details]');
await details.focus();
await details.click();
const modal = page.locator('[data-role="modal"]');
await expect(modal).toBeVisible();
// Nothing is on the stage yet, so the transport must not be operable.
await expect(page.locator('[data-role="modal-transport"]')).toBeHidden();
// Tab must never walk out of a dialog that claims aria-modal.
for (let i = 0; i < 10; i++) {
await page.keyboard.press('Tab');
const inside = await page.evaluate(() =>
!!document.activeElement?.closest('[data-role="modal"]'),
);
expect(inside).toBe(true);
}
await page.keyboard.press('Escape');
await expect(modal).toBeHidden();
const returned = await page.evaluate(
() => document.activeElement?.getAttribute('aria-label') || '',
);
expect(returned).toContain('Unthumbed Walk');
});
test('a catalogue that answers empty offers publishing; one that errors offers Retry', async ({ page }) => {
test.setTimeout(90_000);
await page.route('**/api/animations/library**', (r) => r.fulfill({ json: { clips: [], next_offset: null } }));
await page.route('**/animations/manifest.json', (r) => r.fulfill({ json: [] }));
await page.goto('/animations');
await expect(page.locator('[data-role="empty"]')).toBeVisible();
await expect(page.locator('[data-role="error"]')).toBeHidden();
// Same empty result, but one source failed: that is an error, not an
// invitation to be the first to publish.
await page.route('**/api/animations/library**', (r) => r.abort());
await page.goto('/animations');
await expect(page.locator('[data-role="error"]')).toBeVisible();
await expect(page.locator('[data-role="empty"]')).toBeHidden();
await expect(page.locator('[data-role="retry"]')).toBeEnabled();
});
});