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
// Coverage for api/tty.js, the hosted terminal renderer behind `curl three.ws/tty`.
//
// The renderer itself is tested in packages/tty-3d/tests. What is tested here is
// everything the HTTP boundary owns: what gets rendered, what colour depth a
// caller with no TERM ends up with, and the two answers that must never be
// wrong (a private avatar, and a default model that is read off disk rather
// than fetched from our own origin).
import { describe, it, expect } from 'vitest';
import { existsSync } from 'node:fs';
import { colorModeFor, defaultModelPath, resolveSource } from '../api/tty.js';
describe('colour negotiation', () => {
it('defaults to 256 colour, because curl forwards no terminal hints', () => {
// Truecolor would be prettier and is the wrong default: a terminal that
// cannot do it renders the escape sequences as literal text across the
// user's screen. 256 colour is universally supported by anything that
// renders escapes at all.
expect(colorModeFor({}, {})).toBe('ansi256');
});
it('honours an explicit mode', () => {
expect(colorModeFor({ color: 'mono' }, {})).toBe('mono');
expect(colorModeFor({ color: 'TRUECOLOR' }, {})).toBe('truecolor');
});
it('ignores a mode it does not know rather than failing the request', () => {
expect(colorModeFor({ color: 'sixel' }, {})).toBe('ansi256');
});
it('upgrades when the caller advertises truecolor', () => {
expect(colorModeFor({}, { 'x-color': 'truecolor' })).toBe('truecolor');
});
});
describe('default model', () => {
it('resolves to a file that exists in this checkout', () => {
const path = defaultModelPath();
expect(path).toBeTruthy();
expect(existsSync(path)).toBe(true);
expect(path.endsWith('default.glb')).toBe(true);
});
it('returns null rather than a broken path when nothing is staged', () => {
expect(defaultModelPath('/nonexistent-root-for-this-test')).toBeNull();
});
it('is a filesystem path, never a URL back to our own origin', async () => {
// REGRESSION: building `https://${host}/avatars/default.glb` and fetching
// it made the endpoint guess its own scheme from headers. Behind a proxy
// that does not set x-forwarded-proto that guess is wrong, and the whole
// feature 502s while looking like a model problem.
const source = await resolveSource({});
expect(source.url).not.toMatch(/^https?:\/\//);
expect(existsSync(source.url)).toBe(true);
});
});
describe('source resolution', () => {
it('refuses a URL the SSRF guard rejects', async () => {
await expect(resolveSource({ src: 'http://169.254.169.254/latest/meta-data/' })).rejects.toThrow();
await expect(resolveSource({ src: 'http://127.0.0.1:8080/model.glb' })).rejects.toThrow();
await expect(resolveSource({ src: 'file:///etc/passwd' })).rejects.toThrow();
});
it('returns nothing for an avatar id that does not resolve', async () => {
// A non-UUID short-circuits in getAvatar without touching Postgres, so
// this stays a pure unit test.
expect(await resolveSource({ avatar: 'not-a-uuid' })).toBeNull();
});
});